CI: add timeout and retry to apt-get install steps #1646
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Build HTML [using jupyter-book] | |
| on: [pull_request] | |
| jobs: | |
| preview: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v7 | |
| with: | |
| fetch-depth: 0 | |
| - name: Setup Anaconda | |
| uses: conda-incubator/setup-miniconda@v4 | |
| with: | |
| auto-update-conda: true | |
| auto-activate-base: true | |
| miniconda-version: 'latest' | |
| python-version: "3.13" | |
| environment-file: environment.yml | |
| activate-environment: quantecon | |
| - name: Graphics Support #TODO: Review if graphviz is needed | |
| timeout-minutes: 10 | |
| run: | | |
| # Retried with a per-attempt timeout: a stalled Ubuntu mirror otherwise | |
| # hangs this step for hours (two 358-minute hangs on 2026-08-18). | |
| pkgs="graphviz" | |
| for attempt in 1 2; do | |
| timeout 4m sudo bash -c "apt-get -qq update && apt-get install -y $pkgs" && break | |
| if [ "$attempt" = 2 ]; then echo "apt-get failed after 2 attempts"; exit 1; fi | |
| echo "apt-get attempt $attempt failed; retrying in 30s"; sleep 30 | |
| done | |
| - name: Install latex dependencies | |
| timeout-minutes: 30 | |
| run: | | |
| # Retried with a per-attempt timeout: a stalled Ubuntu mirror otherwise | |
| # hangs this step for hours (two 358-minute hangs on 2026-08-18). | |
| pkgs="texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended texlive-fonts-extra texlive-xetex latexmk xindy dvipng cm-super" | |
| for attempt in 1 2; do | |
| timeout 14m sudo bash -c "apt-get -qq update && apt-get install -y $pkgs" && break | |
| if [ "$attempt" = 2 ]; then echo "apt-get failed after 2 attempts"; exit 1; fi | |
| echo "apt-get attempt $attempt failed; retrying in 30s"; sleep 30 | |
| done | |
| - name: Display Conda Environment Versions | |
| shell: bash -l {0} | |
| run: conda list | |
| - name: Display Pip Versions | |
| shell: bash -l {0} | |
| run: pip list | |
| - name: Download "build" folder (cache) | |
| uses: dawidd6/action-download-artifact@v21 | |
| with: | |
| workflow: cache.yml | |
| branch: main | |
| name: build-cache | |
| path: _build | |
| # Build Assets (Download Notebooks and PDF via LaTeX) | |
| - name: Build PDF from LaTeX | |
| shell: bash -l {0} | |
| run: | | |
| # This is the FIRST `jb build` in the workflow, and `execute_notebooks: "cache"` | |
| # means only the first build actually executes notebooks — the later | |
| # tojupyter and HTML builds read the cache. So this is the step where a | |
| # CellExecutionError surfaces, and therefore the step that has to gate. | |
| # | |
| # `set -eo pipefail` is required as well as `-W`: `shell: bash -l {0}` is a | |
| # custom shell spec, so GitHub does not inject `-eo pipefail` (it only does | |
| # that for the bare `shell: bash` shorthand). Without it a failing `jb build` | |
| # would be masked by the trailing mkdir/cp, whose exit code becomes the | |
| # step's — and `--keep-going` guarantees the PDF exists for `cp` to succeed on. | |
| set -eo pipefail | |
| jb build lectures --builder pdflatex --path-output ./ -n -W --keep-going | |
| mkdir -p _build/html/_pdf | |
| cp -u _build/latex/*.pdf _build/html/_pdf | |
| - name: Upload Execution Reports (LaTeX) | |
| uses: actions/upload-artifact@v7 | |
| if: failure() | |
| with: | |
| name: execution-reports | |
| path: _build/latex/reports | |
| - name: Build Download Notebooks (sphinx-tojupyter) | |
| shell: bash -l {0} | |
| run: | | |
| jb build lectures --path-output ./ --builder=custom --custom-builder=jupyter | |
| mkdir -p _build/html/_notebooks | |
| cp -u _build/jupyter/*.ipynb _build/html/_notebooks | |
| # Build HTML (Website) | |
| # BUG: rm .doctress to remove `sphinx` rendering issues for ipywidget mimetypes | |
| # and clear the sphinx cache for building final HTML documents. | |
| - name: Build HTML | |
| shell: bash -l {0} | |
| run: | | |
| rm -r _build/.doctrees | |
| jb build lectures --path-output ./ -nW --keep-going | |
| - name: Upload Execution Reports (HTML) | |
| uses: actions/upload-artifact@v7 | |
| if: failure() | |
| with: | |
| name: execution-reports | |
| path: _build/html/reports | |
| - name: Preview Deploy to Netlify | |
| uses: nwtgck/actions-netlify@v4.0 | |
| with: | |
| publish-dir: '_build/html/' | |
| production-branch: main | |
| github-token: ${{ secrets.GITHUB_TOKEN }} | |
| deploy-message: "Preview Deploy from GitHub Actions" | |
| env: | |
| NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }} | |
| NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }} |