GitHub Action: Trigger a CloudBees Unify workflow

Use this GitHub Action (GHA) in a GHA workflow to trigger a CloudBees Unify workflow. For more information, refer to CloudBees Unify workflows.

This action is available on the GitHub marketplace.

Inputs

Table 1. Input details
Input name	Data type	Required?	Description
`cloudbees-pat`	String	Yes	The CloudBees Unify personal access token.
`workflow-file-name`	String	Yes	The filename of the CloudBees Unify workflow YAML file to be run.
`cloudbees-url`	String	No	The CloudBees Unify URL. The default value is `https://api.cloudbees.io`.
`component-id`	String	No	The identifier of the CloudBees Unify component where the workflow to be run resides. If the caller GHA workflow has been onboarded to CloudBees Unify, the default is the component ID of where the caller GHA workflow is located.^[1]
`branch-name`	String	No	The repository code branch of the CloudBees Unify workflow to be run. The default is the same branch as the triggering GHA workflow.
`workflow-inputs`	JSON	No	Input parameters required to run the CloudBees Unify workflow, formatted as JSON data in key/value pairs.

^[1] This multi-hexadecimal UUID can be found by:

Navigating to a component on CloudBees Unify.
Locating the ID value in the URL after componentId=.

Output

Table 2. Output details
Output name	Data type	Description
`cbp-run-url`	String	The CloudBees Unify URL of the triggered CloudBees workflow run.

Usage examples

Basic example

The following is a basic example of using the action:

steps:
      - name: Run CloudBees workflow
        uses: cloudbees-io-gha/run-cloudbees-workflow@v1
        with:
          cloudbees-pat: ${{ secrets.MY_PAT }}
          workflow-file-name: "workflow.yaml"▼

Examples using optional inputs

The following example specifies the component ID and the branch name:

steps:
      - name: Run CloudBees workflow main branch
        uses: cloudbees-io-gha/run-cloudbees-workflow@v1
        with:
          cloudbees-pat: ${{ secrets.MY_PAT }}
          workflow-file-name: "workflow.yaml"
          component-id: "1234abcd-56ef-78gh-90ij-123456klmnop"
          branch-name: "main"▼

The following example specifies input parameters:

steps:
      - name: Run CloudBees workflow main branch
        uses: cloudbees-io-gha/run-cloudbees-workflow@v1
        with:
          cloudbees-pat: ${{ secrets.MY_PAT }}
          workflow-file-name: "workflow.yaml"
          workflow-inputs: '{"workflowInput1": "test1","workflowInput2": "test2"}'▼

Full workflow and run example

The following GHA workflow example uses this action to run a CloudBees Unify workflow that prints the cbp-run-url output from the action. For more information on the cloudbees-io-gha/register-build-artifact@v3 action, refer to the action documentation.

Example GHA workflow YAML file

name: Build, publish artifacts, and deploy using the {PRODUCT}

on:
  push:
    branches:
      - test-branch

permissions:
  id-token: write
  contents: write
  packages: write

jobs:
  build-and-push:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          go-version: '1.21'

      - name: Read and increment version
        id: versioning
        run: |
          VERSION_FILE="QA_VERSION"

          if [ ! -f "$VERSION_FILE" ]; then
            echo "1.0.0" > $VERSION_FILE
          fi

          CURRENT_VERSION=$(cat $VERSION_FILE)
          IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT_VERSION"
          PATCH=$((PATCH + 1))
          NEW_VERSION="$MAJOR.$MINOR.$PATCH"

          echo "$NEW_VERSION" > $VERSION_FILE
          echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT

      - name: Build Go application
        run: |
          go mod tidy
          go install .

      - name: Log in to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      - name: Build and push Docker image
        env:
          DOCKER_BUILDKIT: 1
        run: |
          IMAGE_NAME="${{ secrets.DOCKER_USERNAME }}/demo-service"
          IMAGE_VERSION="${{ steps.versioning.outputs.version }}"

          docker build -t $IMAGE_NAME:$IMAGE_VERSION --progress=plain .
          docker tag $IMAGE_NAME:$IMAGE_VERSION $IMAGE_NAME:latest
          docker push $IMAGE_NAME:$IMAGE_VERSION
          docker push $IMAGE_NAME:latest

      - name: Get image digest
        id: image-digest
        run: |
          IMAGE_NAME="${{ secrets.DOCKER_USERNAME }}/demo-service"
          IMAGE_VERSION="${{ steps.versioning.outputs.version }}"

          # Extract digest from pushed image
          DIGEST=$(docker inspect --format='{{index .RepoDigests 0}}' $IMAGE_NAME:$IMAGE_VERSION | awk -F@ '{print $2}')

          echo "Image Digest: $DIGEST"
          echo "digest=$DIGEST" >> $GITHUB_OUTPUT

          URL="docker.io/${{ secrets.DOCKER_USERNAME }}/demo-service:${{ steps.versioning.outputs.version }}"
          echo "url=$URL" >> $GITHUB_OUTPUT

      - name: Register build artifact
        uses: cloudbees-io-gha/register-build-artifact@v3
        with:
          name: "demo-service"
          url: "docker.io/${{ secrets.DOCKER_USERNAME }}/demo-service:${{ steps.versioning.outputs.version }}"
          version: "${{ steps.versioning.outputs.version }}"
          digest: "${{ steps.image-digest.outputs.digest }}"
          type: "docker"


      - name: Run platform workflow
        uses: cloudbees-io-gha/run-cloudbees-workflow@v1
        id: run-my-workflow
        with:
          cloudbees-pat: ${{ secrets.MY_PAT }}
          branch-name: "test-branch"
          workflow-file-name: "deploy-artifact.yaml"
          workflow-inputs: '{"image-name": "demo-service", "image-version": "${{ steps.versioning.outputs.version }}", "digest":"${{ steps.image-digest.outputs.digest }}", "url":"${{ steps.image-digest.outputs.url }}" }'

      - name: Use runUrl output
        run: echo "The CloudBees run URL is ${{ steps.run-my-workflow.outputs.cbp_run_url}}"▼