eoAPI/.github/workflows/deploy_mkdocs.yml at main · developmentseed/eoAPI · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
name: Publish docs via GitHub Pages

on:
  push:
    branches:
      - main
    paths:
      # Only rebuild website when docs have changed
      - 'README.md'
      - 'CHANGES.md'
      - 'CONTRIBUTING.md'
      - 'docs/**'
      - '.github/workflows/deploy_mkdocs.yml'
  workflow_dispatch:  # Allow manual triggering
  schedule:
    # Run daily at 6 AM UTC to check for updates in eoapi-k8s docs
    - cron: '0 6 * * *'

jobs:
  build:
    name: Deploy docs
    runs-on: ubuntu-latest
    steps:
      - name: Checkout main
        uses: actions/checkout@v3

      - name: Checkout eoapi-k8s docs
        uses: actions/checkout@v3
        with:
          repository: developmentseed/eoapi-k8s
          path: eoapi-k8s-temp
          ref: main

      - name: Setup Kubernetes docs directory
        run: |
          mkdir -p docs/src/deployment/kubernetes

          if [ -f "eoapi-k8s-temp/docs/docs-config.json" ]; then
            echo "Using docs-config.json for structured documentation sync"

            find eoapi-k8s-temp/docs -name "*.md" -not -name "README.md" \
              -exec cp {} docs/src/deployment/kubernetes/ \;

            ASSETS_DIR=$(grep -o '"assets_dir": *"[^"]*"' eoapi-k8s-temp/docs/docs-config.json | cut -d'"' -f4)
            if [ -n "$ASSETS_DIR" ] && [ -d "eoapi-k8s-temp/docs/$ASSETS_DIR" ]; then
              cp -r "eoapi-k8s-temp/docs/$ASSETS_DIR" docs/src/deployment/kubernetes/
            fi

            find eoapi-k8s-temp/docs -name "*.svg" \
              -exec cp {} docs/src/deployment/kubernetes/ \;
          else
            echo "Fallback: copying all documentation files"

            find eoapi-k8s-temp/docs -name "*.md" \
              -exec cp {} docs/src/deployment/kubernetes/ \;
            if [ -d "eoapi-k8s-temp/docs/images" ]; then
              cp -r eoapi-k8s-temp/docs/images docs/src/deployment/kubernetes/
            fi
            find eoapi-k8s-temp/docs -name "*.svg" \
              -exec cp {} docs/src/deployment/kubernetes/ \;
          fi

          cat >> docs/src/deployment/kubernetes/index.md << EOF

          ---

          *Documentation last synchronized: $(date -u +"%Y-%m-%d %H:%M:%S UTC")*
          EOF

          rm -rf eoapi-k8s-temp

      - name: Set up Python 3.8
        uses: actions/setup-python@v4
        with:
          python-version: 3.8

      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          python -m pip install -r docs/requirements.txt

      - name: Deploy docs
        run: mkdocs gh-deploy --force -f docs/mkdocs.yml