接続と切断（Terraform PR エージェント）
このページでは、コンソールから Terraform PR エージェントを GitHub リポジトリに接続する方法について説明します。設定が完了すると、Terraform PR エージェントは GitHub 上の Terraform コードを読み取り、早期アクセス中の DoiT 提供 CloudFlow を通じて Insight が処理された際に修正用プルリクエストを作成できます。
必要な権限
-
Terraform リポジトリをホストしている組織に対する GitHub アクセス。次のいずれかが必要です。
-
GitHub 組織管理者：セットアップ中に IaC Remediation Agent GitHub App をインストールできます。
-
GitHub 組織管理者ではない場合：インストールをリクエストできます。接続が確立される前に、GitHub 組織のオーナーがリクエストを承認する必要があります。
-
GitHub リポジトリを接続する
Terraform PR エージェントをセットアップします。
-
DoiT コンソール にサインインし、上部ナビゲーションのメガメニューから データ取り込みとインテグレーション > Integrations を選択してください。
-
Agents カテゴリタブを選択してください。
-
Terraform PR agent インテグレーションカードで Connect + を選択して、セットアップページを開いてください。
-
Connect Github repositories で Open GitHub marketplace を選択してください。
-
GitHub Marketplace のプロンプトに従い、組織に IaC Remediation Agent をインストールするか、組織管理者でない場合はインストールをリクエストし、接続するリポジトリを選択してください。Terraform ルートモジュールを保持しているリポジトリを含めてください。これらのモジュールが他のリポジトリ内のプライベートモジュールを参照している場合は、それらのリポジトリも選択してください。アクセスがない場合、エージェントは修正を生成する際にモジュール定義を解決できない可能性があります。
このアプリは、修正を作成し、レビュアーからのフィードバックに応答するために、プルリクエストの作成、ブランチのプッシュ、プルリクエストコメントの読み取り権限を必要とします。
あなたが GitHub 組織管理者かどうかに応じて、次のいずれかになります。
-
GitHub 組織管理者：インストールが完了すると、セットアップページに接続済みの組織と選択したリポジトリを含む成功メッセ ージが表示されます。
-
GitHub 組織管理者ではない場合：GitHub はアプリを直接インストールする代わりに、組織のオーナーにインストールリクエストを送信します。DoiT コンソールのセットアップページには、次のいずれかの状態が表示されます。
-
Waiting for approval：セットアップページに、GitHub 組織のオーナーがリクエストを承認する必要があることが表示されます。このページは 10 秒ごとに自動的に承認状況を確認するため、更新する必要はありません。オーナーが承認すると、ページが更新され、成功メッセージが表示されます。
-
Request expired：組織オーナーがリクエストの有効期限までに承認しなかった場合、セットアップページにリクエストの有効期限切れが通知されます。新しいインストールリクエストを送信するには、Restart setup を選択してください。
GitHub でリクエストを承認した組織オーナーには、承認が完了し、DoiT が自動的に接続を完了することを示す確認ページが表示されます。
-
-
GitHub リポジトリを切断する
Terraform PR エージェントの GitHub アクセスを切断するには、GitHub 組織の設定に移動し、IaC Remediation Agent をアンインストールしてください。これにより、エージェントはリポジトリへアクセスできなくなり、新しい修正用プルリクエストも作成されなくなります。
アプリをアンインストールすると、Integrations カタログ内の Terraform PR agent カードは Not connected に戻り、セットアップページには再接続できるように再び Connect + が表示されます。