GitHub Actions workflows
Learn how to get started with Actioner's solution for GitHub Actions workflows.
Install GitHub Actions workflows from app directory and start using it by connecting your GitHub and Slack accounts.
Features
Actioner brings your GitHub Actions workflows as ready-to-use actions in Slack, without any configuration!
- Running GitHub Actions workflows in Slack: Get up and running in seconds; no overwhelming configuration or extra effort needed. You can manually run any GitHub workflow right in Slack. As you connect and select your repo and workflow, your GitHub action is automatically generated as a ready-to-run workflow in Slack.
- GitHub Actions workflow notifications in Slack: Whenever you run a workflow, Actioner notifies you with a direct message allowing you to track its progress. You and your teams can also get notified in your preferred channel when a workflow is triggered and view its live status and duration. Actioner also sends the live status and duration of each individual job that is triggered when the workflow is triggered. All messages for individual jobs are collapsed under the same thread, allowing you to track all the context in one place.
Get started as an app admin
Step 1. Install GitHub Actions workflows
Visit GitHub Actions workflows in app directory and click Install button at top right corner.
Step 2. Connect to GitHub and Slack
After installing the app, you'll be prompted to connect your Slack workspace and GitHub account.
Complete GitHub connection
- Click Connect near GitHub connection and proceed to authentication in GitHub via OAuth2.
- You will be asked to sign in to your GitHub account if you haven't already.
- Click Authorize Actioner. You’ll be redirected to Actioner upon successful authorization.
Complete Slack connection
- Click Connect near Slack connection.
- Continue with selecting your Slack workspace.
If your workspace is not available, add it by navigating to Slack connections page from left menu and click + Add new Slack workspace.
Step 3. Complete setup
Run Subscribe to workflow runs. This workflow creates a webhook subscription for the workflow runs and jobs of the selected repository. Following the subscription, you will receive DM notifications for GitHub workflow runs you have started.
Note that you must have the permission to create a webhook in your selected repo to be able to subscribe to workflow runs.
- Enter the owner of your repository.
- Select your repository.
Re-run Subscribe to workflow runs multiple times if you want to subscribe events from multiple repositories.
Run Select channel for workflow runs. You can use this workflow to select a Slack channel to send the run results of a selected GitHub workflow.
- Enter the owner of your repository.
- Select your repository.
- Select your workflow.
- Select your Slack channel to get notifications.
If you want to get notifications for different workflows in different channels, you can re-run Select channel for workflow runs.
Get started as an app user
If you are invited to use this app as a user, you need to complete your GitHub connection. This connection is required for you to run GitHub actions in Slack and get direct messages when you trigger a GitHub action.
- Navigate to GitHub connection, click Connect and proceed to authentication in GitHub via OAuth2.
- You will be asked to sign in to your GitHub account if you haven't already.
- Click Authorize Actioner. You’ll be redirected to Actioner upon successful authorization.
Running GitHub actions in Slack
After completing connection, you can start triggering GitHub actions manually in Slack. To trigger your action manually in Slack, call Actioner from shortcuts, or type /actioner
and select Run workflow. Proceed with below steps:
- Enter the owner of your repository.
- Select your repository.
- Select your workflow.
- Select your branch.
- Fields from your GitHub workflow will be dynamically generated as you select your workflow and branch. These fields are the ones available to run the same action manually in GitHub.
GitHub Actions workflow notifications in Slack
If you are looking to get notified of different workflow statuses in different Slack channels, follow below steps:
- Call Actioner from shortcuts, or type
/actioner
in Slack. - Start typing
Select channel for workflow runs
. - Run it by selecting your repository, workflow and the Slack channel that you want to get notified. Whenever the selected workflow is run, by you or another user, in Slack or in GitHub, Actioner notifies you of the run result on the selected channel.