1.3. Slack と Hybrid Cloud Console のインテグレーション
イベント通知を Slack チャネルまたはユーザーに直接送信するように Hybrid Cloud Console を設定できます。Slack インテグレーションは、すべての Hybrid Cloud Console サービスからのイベントをサポートします。
この例の Slack インテグレーションは、Red Hat Enterprise Linux 用に設定されています。この統合は、Red Hat OpenShift および Hybrid Cloud Console イベントでも機能します。
Slack インテグレーションでは、受信 Webhook を使用してイベントデータを受け取ります。webhook の詳細は、Slack API ドキュメントの Sending messages using incoming webhooks を参照してください。
サポートへの問い合わせ
Hybrid Cloud Console と Slack とのインテグレーションに問題がある場合は、Red Hat に連絡してサポートを依頼してください。Slack はトラブルシューティングを提供しません。Hybrid Cloud Console と Slack のインテグレーションは、Red Hat によって完全にサポートされています。
Help > Open a support case をクリックするか、Help > Support options から他のオプションを表示することで、Hybrid Cloud Console から直接 Red Hat サポートケースを開くことができます。
1.3.1. Slack で受信 Webhook の設定 リンクのコピーリンクがクリップボードにコピーされました!
Slack を Hybrid Cloud Console と統合できるように準備するには、Slack で受信 Webhook を設定する必要があります。
前提条件
- 受信 Webhook を追加する Slack インスタンスでの所有者または管理者の権限を持っている。
- Slack アプリをチャネルに追加するためのアプリマネージャーのアクセス権限がある。
- 通知を受信する Slack チャネルまたはユーザー。
手順
Slack アプリケーションを作成します。
- Slack API Web ページに移動し、Create your Slack app ボタンをクリックします。これにより、Create an app ダイアログが開きます。
- Slack 設定 UI を使用してアプリケーションを作成するには、From scratch を選択します。
アプリケーションの名前を入力し、通知を受信するワークスペースを選択します。
注記管理者の承認が必要であるというメッセージが表示された場合は、次の手順で承認をリクエストできます。
- Create App をクリックして、Slack アプリケーションの作成を完了します。
受信 Webhook を有効にします。
- 左側のナビゲーションパネルの Features 見出しの下にある Incoming Webhooks をクリックします。
- Activate Incoming Webhooks スイッチを On に切り替えます。
- Request to Add New Webhook ボタンをクリックします。必要に応じて、管理者にアプリケーションへのアクセスを許可するメッセージを入力し、Submit Request をクリックします。成功メッセージが表示され、正しく設定されたことが確認されます。
受信 Webhook を作成します。
- ナビゲーションパネルの Settings にある Install App をクリックします。
- Install App セクションで、Install to workspace ボタンをクリックします。
- Slack アプリケーションが通知を投稿するチャネルを選択するか、ダイレクトメッセージとして通知を送信するユーザーを選択します。
- 変更を保存するには、Allow をクリックします。
オプション: Hybrid Cloud Console の通知が Slack にどのように表示されるかを設定します。
- ナビゲーションパネルの Settings で Basic Information をクリックします。
- 下にスクロールして 情報を表示します。
- 必要に応じて、アプリケーションの名前、説明、アイコン、および背景の色を編集します。
- Save Changes をクリックします。
Webhook URL をコピーします。
- Features の下で、Incoming Webhooks をクリックします。
- Webhook URL の横にある Copy ボタンをクリックします。この URL を使用して、「Red Hat Hybrid Cloud Console での Slack インテグレーションの設定」 の Hybrid Cloud Console で統合を設定します。
検証
- 設定中に選択した Slack チャネルまたはユーザーを開き、統合が追加されたことを確認するメッセージを確認します。
1.3.2. Red Hat Hybrid Cloud Console での Slack インテグレーションの設定 リンクのコピーリンクがクリップボードにコピーされました!
Slack で受信 Webhook を設定した後、設定した Slack チャネルまたはユーザーにイベント通知を送信するように Hybrid Cloud Console を設定できます。
前提条件
- Red Hat Hybrid Cloud Console の Organization Administrator または Notifications administrator の権限がある。
手順
必要に応じて、Slack API Web ページにアクセスし、設定した Webhook URL をコピーします。
注記Slack Webhook URL を作成する手順は、「Slack で受信 Webhook の設定」 を参照してください。
- Hybrid Cloud Console で、Settings > Integrations に移動します。
- Communications タブを選択します。
- Add integration をクリックします。
- インテグレーションタイプとして Slack を選択し、Next をクリックします。
- 統合の名前を入力します (例: My Slack notifications)。
- Slack からコピーした Slack Webhook URL を Workspace URL フィールドに貼り付けて、Next をクリックします。
オプション: インテグレーションでイベントを割り当てます。これを行うと、動作グループが自動的に作成されます。
注記このステップを省略し、後でイベントタイプを関連付けることができます。
- OpenShift、Red Hat Enterprise Linux、Console などの製品ファミリーを選択します。
- インテグレーションが反応するイベントタイプを選択し、Next をクリックします。
- インテグレーションの詳細を確認し、Submit をクリックしてインテグレーションを有効にします。
- Integrations ページを更新して、Integrations > Communications リストに Slack インテグレーションを表示します。Last connection attempt のステータスが Ready になっている場合は、接続が Hybrid Cloud Console からの通知を受け入れることができることを示しています。
検証
テスト通知を作成し、Slack を Hybrid Cloud Console に正常に接続していることを確認します。
- Integrations > Communications ページの Slack インテグレーションの横にあるオプションアイコン (⋮) をクリックし、Test をクリックします。
- Integration Test 画面でメッセージを入力し、Send をクリックします。フィールドを空白のままにすると、Hybrid Cloud Console はデフォルトのメッセージを送信します。
- 設定した Slack チャネルを開き、Hybrid Cloud Console から送信されたメッセージを確認します。
- Hybrid Cloud Console で Notifications > Event Log に移動し、Integration: Slack イベントが緑色のラベルでリストされていることを確認します。
1.3.3. Slack 統合のための動作グループの作成 リンクのコピーリンクがクリップボードにコピーされました!
動作グループは、通知サービスが特定のイベントを受信したときに、Slack などの外部サービスにどの通知を送信するかを定義します。イベントは、Red Hat Hybrid Cloud Console サービスから動作グループにリンクできます。
前提条件
Organization Administrator または Notifications administrator のパーミッションを持つユーザーとして Hybrid Cloud Console にログインしている。
注記メールアドレスが Red Hat ログインと同じでない場合、メールアドレスで Hybrid Cloud Console にログインすることはできません。詳細は、ログインの検索 を参照してください。
- Slack 統合を設定している。
手順
- Hybrid Cloud Console で、Settings > Notifications に移動します。
- Notifications で Configure Events を選択します。
- イベント通知動作を設定するアプリケーションバンドルタブ (Red Hat Enterprise Linux、Console、または OpenShift) を選択します。
- Behavior Groups タブをクリックします。
- Create behavior group ウィザードを開くには、Create new group をクリックします。
- 動作グループの名前を入力し、Next をクリックします。
- Actions and Recipients ステップで、Actions ドロップダウンリストから Integration: Slack を選択します。
Recipient ドロップダウンリストから、作成した統合の名前 (たとえば、My Slack notifications) を選択し、Next をクリックします。
- Associate event types ステップで、通知を送信する 1 つ以上のイベント (Policies: Policy triggered など) を選択し、Next をクリックします。
動作グループの設定を確認し、Finish をクリックします。新しい動作グループは、Behavior Groups タブの Notifications > Configure Events ページに表示されます。
注記複数の動作グループを作成および編集して、通知サービスがサポートする追加のプラットフォームを含めることができます。
Settings > Integrations の順に選択し、Communications タブをクリックします。Slack インテグレーションがイベントを Slack に送信する準備ができると、Last connection attempt 列に Ready が表示されます。通知が Slack に正常に到達した場合は、Last connection attempt 列に Success と表示されます。
検証
-
Hybrid Cloud Console 通知をトリガーするイベントを作成します。たとえば、ポリシーイベントをトリガーするシステムで
insights-clientを実行します。 - 数分待ってから Slack に移動します。
- Slack チャネルで、Hybrid Cloud Console からの通知を確認します。
Hybrid Cloud Console で、Settings > Notifications > Event Log に移動して、Integration: Slack のラベルが表示されているイベントを確認します。
- ラベルが緑色であれば、通知は成功しています。
- ラベルが赤色の場合は、インテグレーションを調整する必要がある可能性があります。
インテグレーションが想定どおりに機能しない場合は、受信 Webhook コネクターが Slack で適切に作成されていること、および正しい受信 Webhook URL が Hybrid Cloud Console インテグレーション設定に追加されていることを確認してください。
注記詳細は、通知ドキュメントの 通知失敗のトラブルシューティング を参照してください。