Build NV-Ingest Documentation (legacy Docker site, artifact only) workflow (NVIDIA/NeMo-Retriever)

# Legacy full-site Docker documentation build (nv-ingest HTML + bundled MkDocs).
#
# Public GitHub Pages at https://nvidia.github.io/NeMo-Retriever/ must be published ONLY by
# nrl-docs-github-pages.yml (mkdocs.yml - 13-section NRL TOC). This workflow
# must not call deploy-pages or it will overwrite that site with the old navigation.
#
# For the same Docker pipeline on every push to main (CI only), see docs-deploy.yml.
name: Build NV-Ingest Documentation (legacy Docker site, artifact only)
 
on:
  workflow_dispatch:
 
permissions:
  contents: read
 
concurrency:
  group: docs-legacy-docker-artifact
  cancel-in-progress: false
 
jobs:
  build:
    timeout-minutes: 30
    runs-on: linux-large-disk
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
 
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3
 
      - name: Build Docker image
        run: |
          docker build -f Dockerfile --target docs --build-arg GIT_COMMIT=${GITHUB_SHA} -t nv-ingest-docs:latest .
 
      - name: Run the container
        run: |
          CONTAINER_ID=$(docker run -d nv-ingest-docs:latest)
          echo "CONTAINER_ID=$CONTAINER_ID" >> $GITHUB_ENV
 
      - name: Wait for the docs generation to complete in the container
        run: |
          EXIT_CODE=$(docker wait $CONTAINER_ID)
          docker logs $CONTAINER_ID
          if [ "$EXIT_CODE" != "0" ]; then
            echo "Error: docs build failed with exit code $EXIT_CODE"
            exit 1
          fi
 
      - name: Copy generated docs site from the container
        run: docker cp $CONTAINER_ID:/workspace/docs/site ./generated-site
 
      - name: Stop and remove the container
        run: docker rm $CONTAINER_ID
 
      - name: Upload legacy Docker site (not deployed to Pages)
        uses: actions/upload-artifact@v4
        with:
          name: nv-ingest-docs-docker-site
          path: ./generated-site