GitHub Actions

Set up Score handling with GitHub Actions

humctl is the Humanitec CLI tool that helps manage developer workloads using Score.

Here is how to set up humctl in your GitHub actions workflow.

Usage

To use the humctl GitHub action, add the following step to your workflow:

steps:
  - uses: humanitec/setup-cli-action@v1
    with:
      version: '0.29.0'

This will download and cache the specified version of the humctl CLI and add it to $PATH.

See details on the GitHub action here.

Examples

Using a pinned version

Here is a complete example workflow:

name: Score Example

on: push

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2

    - name: Set up humctl
      uses: humanitec/setup-cli-action@v1
      with:
        version: '0.29.0'

    - name: Check version
      run: humctl version

This installs version 0.29.0 of humctl, adds it to $PATH, and runs humctl version to verify it is set up correctly.

The action caches the humctl binary so it won’t need to download it each run.

Now humctl is installed in your runner and ready for use in any downstream steps. See Score integration for usage instructions and examples.

Using the latest version

The GitHub action supports version ranges which lets you e.g. subscribe to the latest release within a major version to not miss out on new functionalities and improvements while ensuring backwards compatibility.

VS Code Extension