GitHub Actions Example
Prerequisites
- Access to a GitHub account and project. Sign up for free here.
- Git must be set up and configured in your Coalesce Org. To use GitHub Actions, you must use GitHub as your git repository.
Upload Actions Secret
To follow best practices, Coalesce recommends that you upload your coa config file as a secure file within the GitHub Actions settings.
- From within your GitHub project, go to Settings → Secrets → Actions

Location of GitHub secrets
- Click New repository secret
- Provide a name for it. In this example we will call it
COA_CONFIG
- Find and open your coa
config
file. Default location is~/.coa
- Copy its contents into the Value field
- Click Add Secret to save
Example Scheduled Refresh Workflow
- From within your GitHub project, go to Actions and click New workflow
- Choose Simple workflow → Configure
- You will be presented with a template YAML file. Provide it a name and replace its content with the Refresh Workflow code below.
name: Refresh Data
on:
# Set a schedule using cron
schedule:
- cron: "0 * * * *"
# This option allows the workflow to be triggered manually
workflow_dispatch:
env:
COA_VERSION: latest # Versions released on NPM here: https://www.npmjs.com/package/@coalescesoftware/coa
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/[email protected]
- uses: actions/[email protected]
with:
node-version: 18
# Fetch coa config secret from GitHub Actions secret repository, then write coa config to a temporary file
- run: echo '${{ secrets.COA_CONFIG }}' >> COA_CONFIG
# Install Coalesce CLI tool, if not installed already
- run: npm list | grep "@coalescesoftware/[email protected]${{ env.COA_VERSION }}" || npm install @coalescesoftware/[email protected]${{ env.COA_VERSION }}
# Execute coa CLI, starting coa refresh
- run: npx coa refresh --config COA_CONFIG
- Commit this file to your repository
- You'll now see your workflow, and it will automatically run every hour. You can also manually run it by clicking Run workflow.

Refresh workflow
Updated 22 days ago