docker-compose.yml

services:
  # docker-compose run --rm --build --service-ports docs_dev
  # expect service at localhost:8020
  # specify host.docker.internal:8020 in browser
  # equivalen in docker: http://host.docker.internal:8020
  docs_dev:
    # Run the mkdocs builtin development server, with hot-reloading
    container_name: ga_workflows_docs_dev_server
    build:
      context: .
      target: docs_live
    volumes:
      - ./docs/:/docs/
      - ./mkdocs.yml:/mkdocs.yml
      # tox cache
      # - ./.tox/docs-live/:/.tox/docs-live/
    ports:
      - "${GA_WORKFLOWS_DOCS_SERVER_PORT:-8020}:${_GA_DOCS_PORT:-8020}"
    # docker command is not stable, so we override
    command:
      - /.tox/docs-live/bin/python
      - '-m'
      - mkdocs
      - serve
      - '-w'
      - 'docs/'
      - '-w'
      - 'mkdocs.yml'
      - -a
      - '0.0.0.0:${_GA_DOCS_PORT:-8020}'

# docker build --target docs_live -t ga_workflows_docs_dev_server .
# docker run --rm -it -v $(pwd)/docs:/docs/ -v $(pwd)/mkdocs.yml:/mkdocs.yml \
#   -p "${DOCS_HOST_PORT:-8020}:${_GA_DOCS_PORT:-8020}" \
#   ga_workflows_docs_dev_server /.tox/docs-live/bin/python \
#   -m mkdocs serve -w docs/ -w mkdocs.yml -a "0.0.0.0:${_GA_DOCS_PORT:-8020}"

  docs_gen:
    # docker-compose run --rm --build docs_gen
    container_name: ga_workflows_docs_gen
    build:
      context: .
      target: docs_gen
    volumes:
      - ./docs/:/docs/
      - ./scripts/:/scripts/
      - ./.github/workflows/:/.github/workflows/
    entrypoint: /scripts/gen-docs-refs.sh