Skip to main content

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. Use /actioner command in Slack and choose the GitHub Action you want to run from the list.

  • 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.

How to get started​

Step 1. Install GitHub Actions workflows​

Visit GitHub Actions workflows in app directory and click Install button at top right corner.

Install GitHub Actions workflows

Step 2. Connect to GitHub and Slack​

After installing the app, you'll be prompted to connect your Slack workspace and GitHub account.

Connections for GitHub Actions workflows

Complete GitHub connection

  1. Click Connect near GitHub connection and proceed to authentication in GitHub via OAuth2.
  2. You will be asked to sign in to your GitHub account if you haven't already.
  3. Click Authorize Actioner. You’ll be redirected to Actioner upon successful authorization.

Complete Slack connection​

If you have not connected your Slack workspace, you can click Connect near Slack connection.

Slack connection

You can also add your Slack workspace by navigating to Workspace settings page from left menu and then switching to Slack workspace tab.

If you do not see Workspace settings page, contact with your workspace admin.

Step 3. Complete setup​

Setup GitHub Actions workflows

  1. 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.
Tip

Re-run Subscribe to workflow runs multiple times if you want to subscribe events from multiple repositories.

  1. 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.
Tip

If you want to get notifications for different workflows in different channels, you can re-run Select channel for workflow runs.

Step 4. Invite your team​

By default Everyone in your Actioner workspace is added to your app as Runner.

To grant app admin permission to a user, go to the Permissions tab of your app and add users or groups via + Add permission button. If you can't find the users you want to add, ensure they have been invited to your Actioner workspace.

Permissions for GitHub Actions workflows

Get started as a 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.

  1. Navigate to GitHub connection, click Connect and proceed to authentication in GitHub via OAuth2.
  2. You will be asked to sign in to your GitHub account if you haven't already.
  3. 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:

  1. Enter the owner of your repository.
  2. Select your repository.
  3. Select your workflow.
  4. Select your branch.
  5. 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:

  1. Call Actioner from shortcuts, or type /actioner in Slack.
  2. Start typing Select channel for workflow runs.
  3. 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.