use _upload_docs job #30889
Workflow file for this run
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 documentation | ||
| on: | ||
| pull_request: | ||
| push: | ||
| branches: | ||
| - main | ||
| - release/* | ||
| tags: | ||
| - v[0-9]+.[0-9]+.[0-9]+ | ||
| - v[0-9]+.[0-9]+.[0-9]+-rc[0-9]+ | ||
| workflow_dispatch: | ||
| schedule: | ||
| - cron: '0 0 * * *' | ||
| jobs: | ||
| build: | ||
| uses: pytorch/test-infra/.github/workflows/linux_job_v2.yml@main | ||
| permissions: | ||
| id-token: write | ||
| contents: read | ||
| strategy: | ||
| matrix: | ||
| include: | ||
| - build-tool: buck2 | ||
| with: | ||
| job-name: Build doc | ||
| runner: linux.2xlarge | ||
| docker-image: executorch-ubuntu-22.04-clang12 | ||
| submodules: 'true' | ||
| repository: pytorch/executorch | ||
| upload-artifact: docs | ||
| timeout: 90 | ||
| script: | | ||
| # The generic Linux job chooses to use base env, not the one setup by the image | ||
| CONDA_ENV=$(conda env list --json | jq -r ".envs | .[-1]") | ||
| conda activate "${CONDA_ENV}" | ||
| BUILD_TOOL=${{ matrix.build-tool }} | ||
| # Setup dependencies as there is no Docker support | ||
| PYTHON_EXECUTABLE=python bash .ci/scripts/setup-linux.sh "${BUILD_TOOL}" | ||
| if [[(${GITHUB_EVENT_NAME} = 'pull_request' && (${GITHUB_BASE_REF} = 'release'*)) || (${GITHUB_REF} = 'refs/heads/release'*) ]]; then | ||
| export CHANNEL=test | ||
| else | ||
| export CHANNEL=nightly | ||
| fi | ||
| # Get the version of ExecuTorch from REF_NAME and save as ET_VERSION_DOCS | ||
| # ET_VERSION_DOCS will be pulled during the doc build to add to the version dropdown | ||
| # on the website. See docs/source/conf.py for details | ||
| GITHUB_REF=${{ github.ref }} | ||
| echo "$GITHUB_REF" | ||
| export ET_VERSION_DOCS="${GITHUB_REF}" | ||
| echo "$ET_VERSION_DOCS" | ||
| set -eux | ||
| # clean up the ${RUNNER_DOCS_DIR} if exists: | ||
| rm -rf "${RUNNER_DOCS_DIR}"/* | ||
| # clean up the ${RUNNER_ARTIFACT_DIR} if exists: | ||
| rm -rf "${RUNNER_ARTIFACT_DIR}"/* | ||
| # Build docset: | ||
| cd docs | ||
| doxygen source/Doxyfile | ||
| make html | ||
| cd .. | ||
| # If it's main branch, add noindex tag to all .html files to exclude from Google Search indexing. | ||
| echo "GitHub Ref: ${GITHUB_REF}" | ||
| if [[ "${{ github.ref }}" == 'refs/heads/main' ]]; then | ||
| find docs/_build/html/ -name "*.html" -print0 | xargs -0 sed -i '/<head>/a \ \ <meta name="robots" content="noindex">'; | ||
| fi | ||
| cp -rf docs/_build/html/* "${RUNNER_DOCS_DIR}" | ||
| mv docs/_build/html "${RUNNER_ARTIFACT_DIR}" | ||
| ls -R "${RUNNER_ARTIFACT_DIR}"/*/*.html | ||
| upload-gh-pages: | ||
|
Check failure on line 83 in .github/workflows/doc-build.yml
|
||
| needs: build | ||
| uses: pytorch/test-infra/.github/workflows/_upload_docs.yml@main | ||
| with: | ||
| docs-branch: gh-pages | ||
| docs-name: docs | ||
| repository: pytorch/executorch | ||
