Holos Action

Holos GitHub action to execute the holos render platform command in your workflow. Useful to fully render configuration manifests when configuration data changes, then update a pull request automatically.

For an example of Kargo automatically bumping the version of add-ons and submitting pull requests, see the documentation on the Holos Kargo integration.

Usage

The following example workflow renders manifests and commits the result to the same branch, useful to see fully rendered configs in pull requests.

# .github/workflows/holos-render-platform.yaml
name: holos render platform
on:
  push:
    branches:
      - 'promotion/*'
jobs:
  holos:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4
      - uses: holos-run/holos-action@v1
        with: # optional, default
          command: holos render platform
      - name: Commit and push changes
        run: |
          git config --global user.name 'GitHub Actions'
          git config --global user.email 'actions@github.com'
          git add deploy/
          git commit -m "holos render platform [skip ci]" || echo "No changes to commit"
          git push

Environment Variables

You may need to pass an environment variable to holos, for example to access a private helm registry.

Pass environment variables to the underlying container using the flags input. The value of this input is passed without modification to docker run. For example:

name: holos render platform
on:
  push:
    branches:
      - 'promotion/*'
jobs:
  holos:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: holos-run/holos-action@v1
        env:
          USERNAME: ${{ vars.USERNAME }}
          PASSWORD: ${{ secrets.PASSWORD }}
        with:
          command: holos render platform # optional
          docker-run-flags: --env USERNAME --env PASSWORD

Support

Community support is provided on a best effort basis. For commercial support options please see support.