A lightweight web application that shows the FIFA World Cup 2026 (Canada / Mexico / USA) group standings, match results, knockout bracket and statistics, plus curated links to official FIFA resources.
Single static Go binary on a distroless, non-root image. No database, no required configuration: start the container and open your browser.
linux/amd64, linux/arm64/healthz (liveness) and /readyz (readiness) probes, with graceful draining on shutdown/metrics (OpenMetrics, with trace exemplars)OTEL_* variables| Home (dark) | Home (light) |
|---|---|
![]() | ![]() |
| Group Standings (dark) | Knockout Stage (light) |
|---|---|
![]() | ![]() |
Pull the latest image:
docker pull aeciopires/my-world-cup-app:latest
Run it:
docker run --rm -p 8080:8080 aeciopires/my-world-cup-app:latest
Open http://localhost:8080 in your browser.
docker run -d \
--name my-world-cup-app \
--restart unless-stopped \
-p 8080:8080 \
aeciopires/my-world-cup-app:latest
docker logs -f my-world-cup-app # follow the logs
docker stop my-world-cup-app # stop it
Map any host port to the container's port 8080:
docker run -d -p 3000:8080 aeciopires/my-world-cup-app:latest
# http://localhost:3000
You can also change the port the app listens on inside the container:
docker run -d -e PORT=9090 -p 9090:9090 aeciopires/my-world-cup-app:latest
services:
app:
image: aeciopires/my-world-cup-app:latest
container_name: my-world-cup-app
ports:
- "8080:8080"
environment:
LOG_FORMAT: json
restart: unless-stopped
docker compose up -d
The image already declares a HEALTHCHECK, so docker ps reports the container as healthy without extra configuration.
The source repository includes a Helm 4 chart, with probes, a non-root security context and Prometheus scrape annotations already set up:
git clone https://github.com/aeciopires/my-world-cup-app.git
cd my-world-cup-app
helm upgrade --install my-world-cup-app helm/my-world-cup-app \
--namespace my-world-cup-app --create-namespace \
--set image.repository=aeciopires/my-world-cup-app \
--set image.tag=latest
All settings are environment variables. None of them are required, because each has a working default.
| Variable | Default | Description |
|---|---|---|
PORT | 8080 | HTTP listen port |
FETCH_TIMEOUT | 10s | Maximum duration of one data refresh (Go duration, e.g. 15s, 1m) |
LOG_FORMAT | json | json for log collectors, or text for a human-friendly format |
SHUTDOWN_DRAIN_DELAY | 0s | After SIGTERM, how long to keep serving while /readyz returns 503 |
OTEL_EXPORTER_OTLP_ENDPOINT | unset | OTLP/HTTP collector URL (e.g. http://otel-collector:4318). Setting it turns tracing on |
OTEL_SERVICE_NAME | my-world-cup-app | Trace service.name. The other standard OpenTelemetry SDK variables also apply |
WORLDCUP_MATCHES_URL | openfootball 2026/worldcup.json | Match data source |
WORLDCUP_GROUPS_URL | openfootball 2026/worldcup.groups.json | Group assignments source |
WORLDCUP_TEAMS_URL | openfootball 2026/worldcup.teams.json | Team metadata source |
WORLDCUP_STADIUMS_URL | openfootball 2026/worldcup.stadiums.json | Stadium data source |
Example with tracing enabled and human-readable logs:
docker run -d -p 8080:8080 \
-e LOG_FORMAT=text \
-e OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318 \
aeciopires/my-world-cup-app:latest
| Method | Path | Description |
|---|---|---|
GET | / | Home: overview of results and upcoming matches |
GET | /groups | Group standings and each group's matches |
GET | /knockout | Knockout bracket and round-by-round results |
GET | /matches | Every fixture; optional ?round=, ?group=, ?team= filters |
GET | /stats | Top scorers and team records |
GET | /links | Official FIFA resources |
POST | /refresh | Re-fetch tournament data (returns 429 if a refresh is already running) |
GET | /healthz | Liveness probe |
GET | /readyz | Readiness probe |
GET | /metrics | Prometheus / OpenMetrics metrics |
gcr.io/distroless/static-debian13:nonroot, with no shell and no package manager, for a minimal attack surface.65532.CGO_ENABLED=0, stripped), built with Go 1.27.8080./app/server -healthcheck, which runs a local GET /healthz)./app/server.org.opencontainers.image.version, .source, .licenses).| Tag | Description |
|---|---|
latest | Most recent published release |
X.Y.Z (e.g. 1.4.0) | A specific, immutable release. Recommended for production |
Each tag is a multi-arch manifest. Docker pulls the right variant (amd64 or arm64) for your host automatically.
Tournament data comes from the openfootball project. This is an unofficial fan project and is not affiliated with FIFA.
Distributed under the GPL-3.0 license.
Content type
Image
Digest
sha256:28932afc9…
Size
7.1 MB
Last updated
2 days ago
docker pull aeciopires/my-world-cup-app:1.4.0