チームのニーズに合わせて、次のようなGitHubインテグレーションのセットアップと管理を行います。
- コミットチェックやPRにGitHubチェックを追加して、mablのテスト結果を確認する
- mablのインサイトに基づいてGitHubのIssueを作成する
- mablのインサイトに基づいてカスタムGitHubイベントを作成する
mablテストのGitHubアクションとしての実行は、GitHubアプリケーション内で別途設定します。この機能のセットアップの詳細については、mablテストを実行するGitHubアクションの記事を参照してください。
インストール
次の手順を実行して、mablワークスペースにGitHubインテグレーションをインストールします。
- mabl bot GitHubアプリケーションページで [Install] ボタンをクリックします。
- インテグレーションをインストールするリポジトリを選択します。mabl botアプリケーションをインストールする権限をお持ちでない場合は、チーム内で適切な権限を持つユーザーにお問い合わせください。
- [Install] ボタンをクリックします。GitHubからmablにリダイレクトされ、mabl内でGitHubインテグレーションの設定を行うことができます。
複数のmablワークスペースのメンバーになっている場合は、プライマリワークスペースにGitHubインテグレーションがインストールされます。プライマリワークスペースを確認または更新する場合は、ユーザー設定に移動してください。
設定
GitHubインテグレーションのインストールが済んだら、[Edit GitHub integration] ページでニーズに合わせて設定を編集できます。
GitHubインテグレーションの設定
以下の設定を編集できます。
- デプロイ時にGitHubチェックを実行する ([Run GitHub checks on deployment])
- GitHubチェックの手動での再実行を許可する ([Allow manually re-running GitHub checks])
- mablのインサイトに対してGitHubのリポジトリディスパッチイベントを作成する ([Create GitHub Repository Dispatch events for mabl insights])
- mablのインサイトに対してGitHubのIssueを作成する ([Create GitHub issues for mabl insights])
インサイトのフィルタリング
mablのインサイトに対するGitHubのIssueまたはリポジトリディスパッチイベントを有効にする場合は、インサイトフィルターを使用して生成するインサイトを制御します。インサイトのタイプ一覧とその説明については、インサイトに関する記事を参照してください。
インサイトのフィルタリング
[Insight statuses] フィルターでは、mablでGitHubのIssueまたはリポジトリディスパッチイベントの作成対象となる特定のタイプのインサイトを表示できます。カテゴリは以下のとおりです。
- アラート (Alert) - プランの失敗やタイミングの大幅な増加など、優先度の高いアラート
- 警告 (Warning) - JavaScriptエラーや視覚的変化など、問題となる可能性のある結果
- OK - 以前のアラートが正常に戻ったもの
- 改善 (Improvement) - 修正されたリンクなど、アプリケーションにおける改善
- 情報 (Info) - 新しいインテグレーションなど、情報の通知
[Plan labels] フィルターは、特定のラベルを持つプランの通知のみを受け取る場合に使用します。複数のラベルが選択されている場合は、一致するプランがいずれかのラベルでタグ付けされると、通知が届きます。
GitHubインテグレーションの管理
mablアプリケーションで [Settings] > [Integration]
に移動し、鉛筆アイコンをクリックしてGitHubインテグレーションの設定を編集します。
インテグレーションの編集
[Edit GitHub integration] ページでは、次の設定を行うことができます。
- GitHubインテグレーションのすべてのコア機能を有効または無効にする
- GitHubプルリクエストの閲覧者がGitHub内からテストを再実行できるようにする
- GitHubのIssueまたはGitHubのリポジトリディスパッチイベントを生成するインサイトのタイプを制御する
GitHubインテグレーションのアンインストール
GitHubインテグレーションをアンインストールするには、mablとGitHubの両方でGitHubインテグレーションを削除する必要があります。
mablでのアンインストール
[Settings] > [INTEGRATIONS]
に移動し、削除するGitHubインテグレーションの横にあるごみ箱アイコンをクリックします。
インテグレーションの削除
GitHubでのアンインストール
[Settings] > [Applications]
に移動し、mabl botアプリケーションの横にある [Configure] をクリックします。mabl botアプリケーションの設定ページで、「Danger Zone」まで下にスクロールして [Uninstall] をクリックします。