接続する

インテグレーション

接続できるすべてのサービス、接続の仕組み、接続解除で削除されるものの正確な内容。

インテグレーションは、Polylaneをシステムの周囲にあるサービスに接続します。それぞれがエージェントに具体的な作業手段を与えます。このページでは接続と接続解除を一度にまとめて説明し、各プロバイダーのページで繰り返さないようにしています。

できること

ツールを接続すると、エージェントが呼び出せるクエリツールが登録されます。ログの検索、プルリクエストの差分の取得、メトリクスクエリの実行、リソースの記述などです。クラウドプロバイダーを接続すると、そのリソースもトポロジーに同期され、スケジュールされたチェックとプルリクエストレビューがそれを利用します。

接続の仕組み

すべてのプロバイダーには、コンソールのSettings > Integrationsにガイド付きの接続フローがあり、クラウドプロバイダーはSettings > Cloudsにあります。方法はプロバイダーによって異なり、認証情報は暗号化して保存されます。

方法	説明	例
APIキーまたはトークン	プロバイダーのコンソールで作成したキーを貼り付けます。	Datadog、Cloudflare、Linear
OAuth	ブラウザーでプロバイダーにサインインし、アクセスを許可します。	Sentry、Slack、Vercel
アプリのインストール	組織にPolylaneアプリをインストールし、読み取れる範囲を選びます。	GitHub
CloudFormation	アカウントに読み取り専用ロールを作成するスタックをデプロイします。	AWS
Helm	クラスターにエージェントをインストールします。	Kubernetes

各プロバイダーには、セットアップ手順、権限、トラブルシューティングを載せた専用ページが/integrations/<type>にあります。たとえば/integrations/cloudflareです。ブラウザーなしで接続できるプロバイダーには、CIジョブ向けの正確なAPI呼び出しを記したPipelineタブもあります。ターミナルからは、polylane cloud connectとpolylane integration connectが同じフローを実行します。

接続解除の仕組み

接続解除は、Settings > Integrations、クラウドアカウントのページ、またはpolylane integration disconnectとpolylane cloud disconnectから行います。接続解除するとすべての同期とチェックが停止し、Polylaneが保持していた認証情報が削除され、プロバイダー側にPolylaneが設定したものも、プロバイダーのAPIが許す範囲で削除されます。各インテグレーションのページには、削除されるものと残るものが正確に記されており、残るものは常に自分だけが削除できるものです。

プロバイダー側	接続解除で削除されるもの	残るもの
AWS	CloudFormationスタック	IAMロール、そのポリシー、CloudTrailのS3バケット。スタックが意図的に残します
Slack	ボットトークン。取り消されます	Slackアプリのインストールと、Polylaneが作成したチャンネル
GitHub	Polylaneが保持していた認証情報	自動修正のブランチとプルリクエスト、オンボーディングブランチ、過去のコミットに対するチェック実行
Datadog	Polylaneが登録したWebhook	モニター上の`@webhook-polylane`メンションと`polylane:managed`タグ
Vercel	Polylaneが保持していた認証情報	Vercelインテグレーションの設定と`polylane-*`のドレイン

ワークスペースを削除すると、その中のすべてが同じ方法で接続解除されます。例外は1つで、AWSのCloudFormationスタックはアカウント自体を接続解除したときにのみ削除されます。ワークスペースを削除する前にAWSアカウントを接続解除するか、削除後にAWSコンソールでスタックを削除してください。