test workflows #24
Workflow file for this run
This file contains 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: Autoupdate Documentation | |
| # | |
| # Takes care of updating the Vespa documentation. | |
| # | |
| on: | |
| workflow_dispatch: # Allow manual triggering of the workflow | |
| schedule: | |
| - cron: "0 0 * * *" | |
| push: | |
| branches: [push-via-pr] # Test the workflow by pushing to this branch | |
| permissions: | |
| contents: write | |
| pull-requests: write | |
| defaults: | |
| run: | |
| # This ensures that options "pipefail" and "errexit" are set for all steps. | |
| # Ref: https://docs.github.com/en/actions/writing-workflows/workflow-syntax-for-github-actions#defaultsrunshell | |
| shell: bash | |
| # Limit concurrency to better handle commit and push operations. | |
| concurrency: | |
| group: ${{ github.workflow }}-${{ github.ref }} | |
| jobs: | |
| update-vespa-version: | |
| # | |
| # This job updates the Vespa version in the documentation. | |
| # | |
| runs-on: ubuntu-24.04 | |
| concurrency: | |
| group: docs-update | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Setup Dependencies | |
| run: | | |
| sudo apt-get update | |
| sudo apt-get install -y xq | |
| - name: Update Vespa version | |
| id: update-docs | |
| env: | |
| ENABLE_PUSH: ${{ contains(fromJSON('["workflow_dispatch", "schedule"]'), github.event_name) && github.ref_name == 'master' }} | |
| run: | | |
| VESPA_VERSION=$(curl -sSL https://repo1.maven.org/maven2/com/yahoo/vespa/parent/maven-metadata.xml | \ | |
| xq -x '/metadata/versioning/latest') | |
| echo "Vespa version: $VESPA_VERSION" | |
| echo "version=$VESPA_VERSION" >> $GITHUB_OUTPUT | |
| # Update the Vespa version in the documentation configuration file. | |
| sed -i'' "s/\(vespa_version:\) \"[0-9\.]*\"/\1 \"${VESPA_VERSION}\"/" _config.yml | |
| git diff | |
| echo "has-changes=$(git status --short | wc -l)" >> $GITHUB_OUTPUT | |
| - name: Commit changes | |
| if: ${{ steps.update-docs.outputs.has-changes != '0' }} | |
| uses: ./.github/actions/commit-updated-docs | |
| with: | |
| commit-message: "Update Vespa version to ${{ steps.vespa-metadata.outputs.version }}." | |
| files: _config.yml | |
| # push: ${{ env.ENABLE_PUSH == 'true' }} | |
| push: "true" | |
| update-vespa-cli-doc: | |
| # | |
| # This job updates the Vespa CLI documentation. | |
| # | |
| runs-on: ubuntu-latest | |
| env: | |
| VESPA_CLI_DOC_DIR: en/reference/vespa-cli | |
| ENABLE_PUSH: ${{ contains(fromJSON('["workflow_dispatch", "schedule"]'), github.event_name) && github.ref_name == 'master' }} | |
| concurrency: | |
| group: docs-update | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Install Vespa CLI | |
| uses: vespa-engine/setup-vespa-cli-action@v1 | |
| - name: Generate Vespa CLI Documentation | |
| id: update-docs | |
| working-directory: ${{ env.VESPA_CLI_DOC_DIR }} | |
| run: | | |
| vespa gendoc . | |
| for f in $(git status --short . | awk '{print $2}'); do | |
| title=${f//.md/} | |
| title=${title//.\//} | |
| title=${title//_/ } | |
| (echo -e "---\ntitle: $title\nrender_with_liquid: false\n---\n"; cat ${f}) > ${f}.new | |
| mv ${f}.new ${f}; | |
| done | |
| # ensure linka are to .html | |
| sed -i'' 's/\(vespa.*\).md)/\1.html)/' *.md | |
| # create links | |
| sed -i'' 's#\(https://[a-z.]*vespa.ai/[^[:space:]]*\)#[\1](\1)#g' *.md | |
| git diff | |
| echo "has-changes=$(git status --short | wc -l)" >> $GITHUB_OUTPUT | |
| - name: Commit changes | |
| if: ${{ steps.update-docs.outputs.has-changes != '0' }} | |
| uses: ./.github/actions/commit-updated-docs | |
| with: | |
| commit-message: "Update 'Vespa-CLI' reference documentation." | |
| files: ${{ env.VESPA_CLI_DOC_DIR }} | |
| push: "true" | |
| update-metric-reference: | |
| # | |
| # This job updates the Vespa metric reference documentation. | |
| # Ref https://github.com/vespa-engine/vespa/blob/master/metrics/src/main/java/ai/vespa/metrics/docs/MetricDocumentation.java | |
| # | |
| runs-on: ubuntu-24.04 # Use Ubuntu 24.04 for the xq dependency | |
| env: | |
| ENABLE_PUSH: ${{ contains(fromJSON('["workflow_dispatch", "schedule"]'), github.event_name) && github.ref_name == 'master' }} | |
| concurrency: | |
| group: docs-update | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - uses: actions/setup-java@v4 | |
| with: | |
| distribution: "temurin" | |
| java-version: "17" | |
| - name: Setup xq | |
| run: | | |
| sudo apt-get install -y xq | |
| - name: Get Latest Vespa version | |
| id: vespa-metadata | |
| run: | | |
| VESPA_VERSION=$(curl -sSL https://repo1.maven.org/maven2/com/yahoo/vespa/parent/maven-metadata.xml | \ | |
| xq -x '/metadata/versioning/latest') | |
| echo "Using version: $VESPA_VERSION" | |
| echo "version=$VESPA_VERSION" >> $GITHUB_OUTPUT | |
| - name: Update Metric Reference | |
| id: update-docs | |
| env: | |
| VESPA_VERSION: ${{ steps.vespa-metadata.outputs.version }} | |
| run: | | |
| curl -SsLo metrics.jar "https://repo1.maven.org/maven2/com/yahoo/vespa/metrics/${VESPA_VERSION}/metrics-${VESPA_VERSION}.jar" | |
| java -cp metrics.jar ai.vespa.metrics.docs.DocumentationGenerator en/reference | |
| git diff | |
| - name: Commit changes | |
| if: ${{ steps.update-docs.outputs.has-changes != '0' }} | |
| uses: ./.github/actions/commit-updated-docs | |
| with: | |
| commit-message: "Update 'Metric' reference documentation." | |
| files: "en/reference/*-metrics-reference.html" | |
| push: "true" |