GitHub Actionsの実行結果を毎回GitHub上で確認するのも面倒ですよね。一応失敗したときはメールでお知らせしてくれますが、できればSlackに投げてくれるといろいろ都合が良かったりもします。
そこで今回はActionsの実行結果をSlackへ通知する設定を行います。
目次
基本的な原理
Slackへ通知するにはメールを取り込むなどいくつか方法がありますが、ここでは手軽に使えるWebHookURLを利用します。
GitHub ActionsからSlackへの通知にはcurlなどで直接通信しても良いのですが、今回は便利ライブラリ「Slack Notify」を使います。
Slack側の設定
ちょっと古い記事ですが以下のページなどを参照し、WebHookURLを作成してください。
GitHub側の設定
WebHookURLを登録
Slack側で作成したWebHookURLを保存します。
リポジトリ内のメニュー「Settings」から、左メニューの「Secrets」→「Actions」とたどります。右上にある「New repository secret」ボタンをクリックすると入力画面が表示されます。
Nameに「SLACK_WEBHOOK_URL」、ValueにURLを入力したら「Add secret」ボタンをクリックします。
Nameで指定する文字列は、後述するYAML上から呼び出すときの文字列と同一であれば何でもかまいません。
workflowを作成
リポジトリ直下に.github/workflows
というディレクトリを作成し、その中にnotifytest.yml
など適当なファイル名で以下の様なYAMLを保存します(ファイル名は何でもかまいません)。
※以前書いたGitHubへpushするとAWS S3へファイルを転送するworkflowを元にしています。
name: Deploy to S3
#-------------------------#
# トリガー
#-------------------------#
on:
#-- mainブランチにpushされたら起動する --#
push:
branches:
- main
#-------------------------#
# 環境変数
#-------------------------#
env:
SLACK_WEBHOOK: ${{ secrets.SLACK_WEBHOOK_URL }}
SLACK_USERNAME: DeployBot
SLACK_CHANNEL: develop
SLACK_ICON: https://example.com/image/icon_bot.png
#-------------------------#
# 実際の処理
#-------------------------#
jobs:
build:
#-- 仮想マシンのOSを指定(ここではUbuntuの最新版) --#
runs-on: ubuntu-latest
steps:
#-- Gitリポジトリの内容を取得 --#
- name: Checkout
uses: actions/checkout@v2
#-- デプロイ --#
# この部分は適当に読み飛ばしてください。
- name: Deploy to S3
env:
AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
run:
aws s3 sync --delete --region ap-northeast-1 ./public/ s3://bucket.example.com/
#-- Slack通知 --#
# 成功
- name: Slack Notification on Success
if: ${{ success() }}
uses: rtCamp/action-slack-notify@v2
env:
SLACK_TITLE: Deploy Success
SLACK_COLOR: good
# 失敗
- name: Slack Notification on Failure
if: ${{ failure() }}
uses: rtCamp/action-slack-notify@v2
env:
SLACK_TITLE: Deploy Failure
SLACK_COLOR: danger
それぞれのオプションの意味は、文字列から何となくわかると思いますが、詳しくはライブラリのREADMEを参照ください。
workflow全体の環境変数としても良いですし、各step毎の環境変数として定義してもどちらでも動きます。デフォルトで用意されているアイコンがあまりテンション上がらないので、これは適当に準備した方が良さそうですね。
試してみる
本当にSlackへ通知されるかテストします。ここではリポジトリへ適当なファイルを登録しGitHubへpushします。
GitHubへpush
まずは念の為に現在のブランチがmainであることを確認。
$ git branch
* main
ファイルを登録しpushします。
$ cd (作業ディレクトリの場所)
$ echo 'foo' > public/bar.txt
$ git add .
$ git commit -m 'slack notify test'
$ git push
Actions上のログを確認
GitHub上の「Actions」タブ内で本当に実行されたか確認します。緑色のアイコンが横に表示されていれば成功です。
Slackに通知された!
おもむろにSlackを開くと無事に通知されているのが確認できました。左側の罫線が緑色なら成功、赤なら失敗の通知がそれぞれされているのが分かります。
素材
参考ページ
このブログを応援する
お寄せいただいたお気持ちは全額サーバ代や次の記事を執筆するための原資として活用させていただいております。この記事が参考になった場合などぜひご検討ください。