|
| 1 | +name: Validate/build docs |
| 2 | + |
| 3 | +on: |
| 4 | + push: |
| 5 | + paths: |
| 6 | + - 'DC-*' |
| 7 | + - 'adoc/**' |
| 8 | + - 'articles/**' |
| 9 | + - 'common/**' |
| 10 | + - 'concepts/**' |
| 11 | + - 'glues/**' |
| 12 | + - 'images/**' |
| 13 | + - 'references/**' |
| 14 | + - 'snippets/**' |
| 15 | + - 'tasks/**' |
| 16 | + - 'topics/**' |
| 17 | + - 'xml/**' |
| 18 | + # path-ignore: |
| 19 | + - '!templates/**' |
| 20 | + |
| 21 | +jobs: |
| 22 | + select-dc-files: |
| 23 | + runs-on: ubuntu-latest |
| 24 | + outputs: |
| 25 | + validate-list: ${{ steps.select-dc-validate.outputs.dc-list }} |
| 26 | + build-list: ${{ steps.select-dc-build.outputs.dc-list }} |
| 27 | + allow-build: ${{ steps.select-dc-build.outputs.allow-build }} |
| 28 | + relevant-branches: ${{ steps.select-dc-build.outputs.relevant-branches }} |
| 29 | + steps: |
| 30 | + - uses: actions/checkout@v6 |
| 31 | + |
| 32 | + - name: Checking basic soundness of DC files |
| 33 | + uses: openSUSE/doc-ci@gha-select-dcs |
| 34 | + with: |
| 35 | + mode: soundness |
| 36 | + |
| 37 | + - name: Selecting DC files to validate |
| 38 | + id: select-dc-validate |
| 39 | + uses: openSUSE/doc-ci@gha-select-dcs |
| 40 | + with: |
| 41 | + mode: list-validate |
| 42 | + |
| 43 | + - name: Selecting DC files to build |
| 44 | + id: select-dc-build |
| 45 | + uses: openSUSE/doc-ci@gha-select-dcs |
| 46 | + with: |
| 47 | + mode: list-build |
| 48 | + original-org: SUSE |
| 49 | + |
| 50 | + validate: |
| 51 | + runs-on: ubuntu-latest |
| 52 | + needs: select-dc-files |
| 53 | + strategy: |
| 54 | + # don't cancel all validation runners when one of them fails, we want full results |
| 55 | + fail-fast: false |
| 56 | + matrix: |
| 57 | + dc-files: ${{ fromJson(needs.select-dc-files.outputs.validate-list) }} |
| 58 | + steps: |
| 59 | + - uses: actions/checkout@v6 |
| 60 | + - name: Validating DC file(s) ${{ matrix.dc-files }} |
| 61 | + uses: openSUSE/doc-ci@gha-validate |
| 62 | + with: |
| 63 | + dc-files: ${{ matrix.dc-files }} |
| 64 | + |
| 65 | + |
| 66 | + build-html: |
| 67 | + runs-on: ubuntu-latest |
| 68 | + needs: [select-dc-files, validate] |
| 69 | + if: ${{ needs.select-dc-files.outputs.allow-build == 'true' }} |
| 70 | + outputs: |
| 71 | + artifact-name: ${{ steps.build-dc.outputs.artifact-name }} |
| 72 | + artifact-dir: ${{ steps.build-dc.outputs.artifact-dir }} |
| 73 | + strategy: |
| 74 | + matrix: |
| 75 | + dc-files: ${{ fromJson(needs.select-dc-files.outputs.build-list) }} |
| 76 | + steps: |
| 77 | + - uses: actions/checkout@v6 |
| 78 | + - name: Building DC file(s) ${{ matrix.dc-files }} |
| 79 | + id: build-dc |
| 80 | + uses: openSUSE/doc-ci@gha-build |
| 81 | + with: |
| 82 | + dc-files: ${{ matrix.dc-files }} |
| 83 | + - name: Uploading builds as artifact |
| 84 | + uses: actions/upload-artifact@v7 |
| 85 | + with: |
| 86 | + name: ${{ steps.build-dc.outputs.artifact-name }} |
| 87 | + path: ${{ steps.build-dc.outputs.artifact-dir }}/* |
| 88 | + retention-days: 3 |
| 89 | + |
| 90 | + |
| 91 | + publish: |
| 92 | + runs-on: ubuntu-latest |
| 93 | + if: ${{ success() }} |
| 94 | + needs: [select-dc-files, build-html] |
| 95 | + continue-on-error: true |
| 96 | + steps: |
| 97 | + - name: Downloading all build artifacts |
| 98 | + uses: actions/download-artifact@v8 |
| 99 | + with: |
| 100 | + path: artifact-dir |
| 101 | + - name: Publishing builds on susedoc.github.io |
| 102 | + uses: openSUSE/doc-ci@gha-publish |
| 103 | + env: |
| 104 | + DEPLOY_KEY: ${{ secrets.DEPLOY_KEY_SUSE_AI }} |
| 105 | + with: |
| 106 | + artifact-path: artifact-dir |
| 107 | + relevant-dirs: ${{ needs.select-dc-files.outputs.relevant-branches }} |
0 commit comments