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 iw automatically generated as a ready-to-use action 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
Step 1. Install GitHub Actions workflows
Visit this link 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 GitHub account.
Complete GitHub admin connection
- Click Connect near GitHub admin 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 GitHub connection
- Click Connect near GitHub admin 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 your workspace from the left menu and then go to Slack connections page and click + Add Slack workspace.
Step 3. Complete setup actions
Run Subscribe to workflow runs action by selecting your GitHub repository. This action creates a webhook on GitHub and subscribes to the events of the workflow and job runs in the selected repository. After this step, you will start getting direct message notifications whenever you run the selected workflow in GitHub or in Slack. The message contains the live status and duration of the workflow that is triggered and the live status and duration of each individual job in one thread.
TipRe-run Subscribe to workflow runs action multiple times if you want to subscribe events from multiple repositories. Even after you close the setup wizard, you can go to action bar and type
Subscribe to workflow runs
and re-run it. Or call Actioner from shortcuts, or type/actioner
in Slack and typeSubscribe to workflow runs
and re-run it.Run Create action for GitHub workflow action by selecting your repository and workflow. This action dynamically generates a new action for the workflow you select. The new action is generated with the parameters your workflow requires and becomes available to be run in Actioner and Slack. To run the workflow in Slack, you can simply call Actioner from shortcuts, or type
/actioner
, and then type the name of your workflow.TipRe-run Create action for GitHub workflow action multiple times for any GitHub workflow you'd like to run in Slack. Even after you close the setup wizard, you can go to action bar and type
Create action for GitHub workflow
and re-run it. Or call Actioner from shortcuts, or type/actioner
in Slack and typeCreate action for GitHub workflow
and re-run it.
Run Select channel for workflow runs action by selecting your repository, workflow and the Slack channel that you want to get notified in. Whenever a selected workflow is run, by you or another user, in Slack or in GitHub, Actioner sends a notifiction to the selected channel with the results of the workflow that is triggered. You can view the live status and duration of the triggered workflow and the live status and duration of each individual job in one thread.
Tip💡 If you want to get notifications for different workflows in different channels, you can re-run this action.
Step 4. Finish setup guide
When all steps in setup guide are completed, app is ready to be run in Slack.
Get started as an app user
If you are invited to use this app with your colleagues, you only need to connect your Bitbucket account by granting access to Actioner. This connection is required for you to run GitHub actions in Slack and get direct messages for any GitHub Actions workflow run by you.
- 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 workflows in Slack
After completing connection, you can start running GitHub workflows manually in Slack. To trigger your workflow manually in Slack, call Actioner from shortcuts, or type /actioner
and type the name of your workflow. Actioner will automatically suggest the action that will trigger your workflow.
On the opening screen, enter the parameters to run your action. These parameters are the ones you provide to run the same workflow manually in GitHub. They are dynamically generated from the parameters to run your workflow in GitHub. You can run your action in Slack-with the same parameters you trigger the selected workflow 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 this action by selecting your repository, workflow and the Slack channels that you want to get notified in. Whenever a 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.
💡 If you want to get notifications for different workflows in different channels, you can re-run this action.
How to customize this app
Generate different actions to manually run a different GitHub workflow in Slack
If you are looking to generate additional workflows available to be triggered in Slack after the setup, or if you are invited to this app as user, follow the below steps:
- Call Actioner from shortcuts, or type
/actioner
in Slack. - Start typing
Create action for GitHub workflow
. - Run this action by selecting your repository and your workflow.
Get notified for different workflow runs in different Slack channels
If you are looking to generate additional workflow notifications in different Slack channel after the setup, follow the below steps:
- Call Actioner from shortcuts, or type
/actioner
in Slack. - Start typing
Select channel for workflow runs
. - Run this action by seselecting your repository, workflow and the Slack channels that you want to get notified in. Whenever a 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. 💡 If you want to get notifications for different workflows in different channels, you can re-run this action.
FAQs
How to run a GitHub workflow manually in Slack
To trigger your workflow manually in Slack, simply call Actioner app and type the name of your workflow. Actioner will automatically suggest the action that will trigger your workflow.
On the opening screen, enter the parameters to run your action. These parameters are the ones you provide to run the same workflow manually in GitHub. They are dynamically generated from the parameters of your GitHub workflow. You can run your action in Slack with the same parameters you trigger the selected workflow manually in GitHub.