docs-site¶
Serves the generated MkDocs static output from ../site using NGINX.
Routing is handled by Traefik with host docs.${DOMAIN}.
Deploy flow:
1. Build docs: make docs
2. Start container: make up-docs-site (or make up)
Below are the configuration files for this service. For details on how to deploy or customize, refer to the README above or the official documentation for the service.
Docker Compose Configuration¶
services:
docs-site:
image: nginx:alpine
container_name: docs-site
restart: unless-stopped
volumes:
- ../site:/usr/share/nginx/html:ro
networks:
- web
labels:
- "traefik.enable=true"
- "traefik.http.routers.docs-site.entrypoints=websecure"
- "traefik.http.routers.docs-site.rule=Host(`docs.${DOMAIN}`)"
- "traefik.http.routers.docs-site.tls=true"
- "traefik.http.routers.docs-site.tls.certresolver=letsencrypt"
- "traefik.http.services.docs-site.loadbalancer.server.port=80"
networks:
web:
external: true