Update getting started guide for 25.10 and srl image for greeter app #779
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: CICD | |
| on: | |
| push: | |
| branches: | |
| - main | |
| tags: | |
| - "v*" | |
| pull_request: | |
| env: | |
| MKDOCS_MATERIAL_IMAGE: ghcr.io/eda-labs/mkdocs-material:v9.7.1-1 | |
| jobs: | |
| docs-test: | |
| runs-on: ubuntu-24.04 | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Login to GitHub Container Registry | |
| uses: docker/login-action@v3 | |
| with: | |
| registry: ghcr.io | |
| username: ${{ github.actor }} | |
| password: ${{ secrets.GITHUB_TOKEN }} | |
| - run: docker run -v $(pwd):/docs --entrypoint mkdocs ${MKDOCS_MATERIAL_IMAGE} build --clean --strict | |
| - name: Cache htmltest external links | |
| id: cache-htmltest | |
| uses: actions/cache@v4 | |
| with: | |
| path: tmp/.htmltest | |
| # key will contain hash of all md files to check if files have changed | |
| # when files are changed, a new key name is formed, and thus a new cache will be saved | |
| key: htmltest-${{ hashFiles('docs/**/*.md') }} | |
| # the restore key will fetch any previously saved cache even if there is no match on key | |
| # this allows to use cache from prev runs and update it | |
| restore-keys: | | |
| htmltest- | |
| - name: htmltest | |
| uses: wjdp/htmltest-action@master | |
| with: | |
| config: docs/htmltest.yml | |
| # this action deploys mkdocs-material to gh-pages. It is commented out because we moved to cloudflare pages | |
| # publish-docs-gh-pages: | |
| # runs-on: ubuntu-20.04 | |
| # if: startsWith(github.ref, 'refs/heads/main') | |
| # needs: docs-test | |
| # steps: | |
| # # this is to mitigate unsafe dir errors from git | |
| # # https://github.com/actions/checkout/issues/760 | |
| # - name: Add workspace as safe directory | |
| # run: | | |
| # git config --global --add safe.directory /__w/learn-srlinux/learn-srlinux | |
| # - name: Checkout | |
| # uses: actions/checkout@v3 | |
| # with: | |
| # fetch-depth: 0 | |
| # - name: Login to GitHub Container Registry | |
| # uses: docker/login-action@v1 | |
| # with: | |
| # registry: ghcr.io | |
| # username: ${{ github.actor }} | |
| # password: ${{ secrets.GITHUB_TOKEN }} | |
| # - run: docker run -v $(pwd):/docs --entrypoint ash ghcr.io/srl-labs/mkdocs-material-insiders:$MKDOCS_MATERIAL_VER -c 'git config --global --add safe.directory /docs; mkdocs gh-deploy --force' | |
| publish-docs: | |
| runs-on: ubuntu-24.04 | |
| env: | |
| BRANCH_NAME: ${{ github.head_ref || github.ref_name }} | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| with: | |
| fetch-depth: 0 # needed for commit authors plugin | |
| - name: Login to GitHub Container Registry | |
| uses: docker/login-action@v3 | |
| with: | |
| registry: ghcr.io | |
| username: ${{ github.actor }} | |
| password: ${{ secrets.GITHUB_TOKEN }} | |
| - name: Build docs | |
| run: | | |
| docker run --env CI=true --env MKDOCS_GIT_COMMITTERS_APIKEY=${{ secrets.GITHUB_TOKEN }} -v $(pwd):/docs --user $(id -u):$(id -g) --entrypoint mkdocs ${MKDOCS_MATERIAL_IMAGE} build | |
| - name: Publish to Cloudflare Pages | |
| uses: cloudflare/wrangler-action@v3 | |
| id: wrangler-deploy | |
| env: | |
| CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }} | |
| with: | |
| apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }} | |
| accountId: 62e7f50db0ad5b34dbf1fb9b0ed2ef81 | |
| command: pages deploy site --project-name=learn-srlinux --branch=${{ env.BRANCH_NAME }} | |
| - name: Add deploy comment to PR | |
| uses: actions/github-script@v7 | |
| if: github.event_name == 'pull_request' | |
| with: | |
| script: | | |
| const branchName = process.env.BRANCH_NAME.replace(/\./g, '-'); | |
| github.rest.issues.createComment({ | |
| issue_number: context.issue.number, | |
| owner: context.repo.owner, | |
| repo: context.repo.repo, | |
| body: `🏗 Preview site has been deployed to: | |
| * https://${branchName}.learn-srlinux.pages.dev | |
| * ${{ steps.wrangler-deploy.outputs.deployment-url }} | |
| ` | |
| }) |