Skip to content

estimator done. 35 left #13172

estimator done. 35 left

estimator done. 35 left #13172

Workflow file for this run

# This workflow builds API docs when either:
#
# * A commit is tagged like "docs@foo".
#
# * Someone pushes, to any branch, a commit that touches any of:
# * The parts of the api/ project that are used by the docs.
# * The docs source themselves;
# * The CI/makefile tooling used to build the docs.
name: 'API docs build'
on:
push:
tags:
- 'docs@*'
branches:
# We don't want to do any filtering based on branch name.
# But because we specified `tags`, we need to specify `branches` too,
# or else GitHub will only run this workflow for tag matches
# and not for path matches.
- '**'
paths:
- 'api/**'
- '.github/workflows/docs-build.yaml'
- '.github/actions/python/**'
- '.github/actions/webstack/deploy-to-sandbox/**'
- '.github/workflows/utils.js'
workflow_dispatch:
concurrency:
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}-${{ github.ref_name != 'edge' || github.run_id}}-${{ github.ref_type != 'tag' || github.run_id }}
cancel-in-progress: true
defaults:
run:
shell: bash
jobs:
build:
name: opentrons documentation build
runs-on: 'ubuntu-22.04'
steps:
- uses: 'actions/checkout@v3'
with:
fetch-depth: 0
# https://github.com/actions/checkout/issues/290
- name: 'Fix actions/checkout odd handling of tags'
if: startsWith(github.ref, 'refs/tags')
run: |
git fetch -f origin ${{ github.ref }}:${{ github.ref }}
git checkout ${{ github.ref }}
- uses: 'actions/setup-node@v3'
with:
node-version: '18.19.0'
- uses: 'actions/setup-python@v3'
with:
python-version: '3.10'
- uses: './.github/actions/python/setup'
with:
project: 'api'
- name: 'set complex environment variables'
uses: actions/github-script@v6
with:
script: |
const { buildComplexEnvVars, } = require(`${process.env.GITHUB_WORKSPACE}/.github/workflows/utils.js`)
buildComplexEnvVars(core, context)
- name: 'Build docs'
run: |
make -C api docs
- name: 'Deploy docs to sandbox'
env:
AWS_ACCESS_KEY_ID: ${{ secrets.S3_SANDBOX_KEY_ID }}
AWS_SECRET_ACCESS_KEY: ${{ secrets.S3_SANDBOX_SECRET }}
AWS_DEFAULT_REGION: us-east-2
uses: './.github/actions/webstack/deploy-to-sandbox'
with:
domain: 'docs.opentrons.com'
distPath: './api/docs/dist'
destPrefix: ${{ env.OT_BRANCH }}