stacklayer/init-container
Lightweight network probe for Kubernetes Init Containers on Azure Kubernetes Service (AKS).
72
stacklayer/init-container repository overview
Stack Layer Init Container Lab Container Image
| Repository | Release Tag |
|---|---|
 |  |
| Architecture | Platform |
 |  |
A secure, non-root, lightweight network probe utility container engineered specifically for Kubernetes initContainers on Azure Kubernetes Service (AKS). It delays application startup by polling target services (databases, APIs, message brokers) over TCP or HTTP until they are healthy and accepting connections, completely eliminating initial startup race conditions and CrashLoopBackOff errors.
📋 Image Specifications & Software Stack
| Component | Version / Specification | Details |
|---|---|---|
| Base OS | Alpine Linux 3.20 | Minimal footprint (~11.8 MB uncompressed) |
| Runtime User | stacklayer (UID 10001) | Security-hardened non-root user execution |
| Core Utilities | bash, netcat-openbsd, curl, dig | DNS resolution and TCP/HTTP socket polling |
| Execution Lifecycle | Run-to-completion (Exit 0 on success) | Designed strictly for Kubernetes initContainers |
| Architectures | linux/amd64, linux/arm64 | Native support for standard x86 and ARM nodes |
🚀 Quick Pull
docker pull stacklayer/init-container:v1.0
🏃 Run with Docker
Test target service connectivity locally using Docker:
docker run --rm \
-e TARGET_HOST="postgres.internal.net" \
-e TARGET_PORT="5432" \
-e TIMEOUT_SECONDS="60" \
stacklayer/init-container:v1.0
⚙️ Environment Variables
| Variable | Description | Default |
|---|---|---|
TARGET_HOST | DNS name or IP address of the target service to poll | stacklayer-postgres-service |
TARGET_PORT | Port number of the target service | 5432 |
TIMEOUT_SECONDS | Maximum seconds to poll before aborting with exit code 1 | 300 |
RETRY_INTERVAL | Seconds to wait between polling attempts | 2 |
📦 Kubernetes Lab Manifests & Full Guide
- 📖 Step-by-Step Guide: Architecting Resilient Pod Startup Order on Azure AKS with Kubernetes Init Containers
- 📁 Ready-to-Use YAML Manifests: StackLayerOfficially/azure-aks-hands-on-labs (09-kubernetes-init-containers-on-aks)
⚠️ Educational & Lab Disclaimer
This container image is built strictly for educational, hands-on lab, and testing purposes within Stack Layer engineering guides. Always ensure cloud resources on Azure Kubernetes Service (AKS) are paused or destroyed after completing your labs to prevent unnecessary compute charges.
Built with ❤️ by the Stack Layer Engineering Team
Tag summary
Content type
Image
Digest
sha256:8c13c25d8…
Size
9.7 MB
Last updated
about 16 hours ago
docker pull stacklayer/init-container:v1.0