接続とは? - デベロッパーツールコンソール

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

接続とは?

デベロッパーツールコンソールの接続機能を使用して、 などのリソース AWS CodePipeline を外部コードリポジトリに接続 AWS できます。この機能には、独自の API である AWS CodeStar Connections API リファレンス があります。各接続は、 などのサードパーティーのリポジトリに接続するために サービスに付与 AWS できるリソースです BitBucket。例えば、サードパーティーのコードリポジトリに対してコード変更が行われたときにパイプラインをトリガー CodePipeline するように、 で接続を追加できます。各接続には名前が付けられ、接続を参照するために使用される一意の Amazon Resource Name (ARN) に関連付けられます。

接続では何ができますか?

接続を使用して、サードパーティープロバイダーのリソースを次のデベロッパーツールの AWS リソースと統合できます。

  • Bitbucket などのサードパーティープロバイダーに接続し、 などの AWS リソースとのソース統合としてサードパーティー接続を使用します CodePipeline。

  • サードパーティープロバイダー CodePipeline 向けの の CodeBuild ビルドプロジェクト、 CodeDeploy アプリケーション、パイプラインで、 リソース全体の接続へのアクセスを一様に管理します。

  • スタックテンプレートの接続 ARN は、 CodeDeploy の CodeBuild ビルドプロジェクト、アプリケーション、パイプラインに使用します。保存されたシークレットやパラメータを参照 CodePipelineする必要はありません。

どのサードパーティープロバイダーの接続を作成できますか?

接続では、 AWS リソースを以下のサードパーティーのリポジトリに関連付けることができます。

  • Bitbucket Cloud

  • GitHub.com

  • GitHub エンタープライズクラウド

  • GitHub エンタープライズサーバー

  • GitLab.com

    重要

    の接続サポート GitLab には、バージョン 15.x 以降が含まれています。

  • GitLab セルフマネージド型インストール (Enterprise Edition または Community Edition の場合)

接続ワークフローの概要については、「接続を作成または更新するワークフロー」を参照してください。

などのクラウドプロバイダータイプの接続を作成する手順は GitHub、 GitHub Enterprise Server などのインストール済みプロバイダータイプの手順とは異なります。プロバイダーのタイプ別に接続を作成するハイレベルの手順については、「接続の使用」を参照してください。

注記

欧州 (ミラノ) で接続を使用するには AWS リージョン、次のことを行う必要があります。

  1. リージョン固有のアプリをインストールする

  2. リージョンを有効にする

このリージョン固有のアプリで、欧州 (ミラノ) リージョンの接続をサポートします。サードパーティープロバイダーのサイトで公開されているアプリであり、他のリージョンの接続をサポートする既存のアプリとは別のものです。このアプリをインストールすることで、このリージョンでのみサービスとデータを共有することをサードパーティープロバイダーに許可します。アプリをアンインストールすることでいつでもアクセス許可を取り消すことができます。

リージョンを有効にしない限り、サービスはデータを処理または保存しません。このリージョンを有効にすることで、データを処理および保存するアクセス許可をサービスに付与したことになります。

リージョンが有効になっていなくても、リージョン固有のアプリがインストールされたままであれば、サードパーティープロバイダーはお客様のデータをサービスと共有できます。したがって、リージョンを無効にしたら、必ずアプリをアンインストールしてください。詳細については、「リージョンの有効化」を参照してください。

何が 接続と AWS のサービス 統合されますか?

接続を使用して、サードパーティーのリポジトリを他の AWS のサービスと統合できます。接続のサービス統合を確認するには、「AWS CodeStar Connections との製品とサービスの統合」を参照してください。

接続はどのように機能しますか?

接続を作成する前に、サードパーティーアカウントで AWS 認証アプリケーションをインストールするか、そのアプリケーションへのアクセス権を提供する必要があります。接続をインストールした後、このインストールを使用するように更新できます。接続を作成すると、サードパーティーアカウントの AWS リソースへのアクセスを許可します。これにより、 AWS リソースに代わって、サードパーティーアカウントのソースリポジトリなどのコンテンツに接続できるようになります。その後、その接続を他の と共有 AWS のサービス して、リソース間で安全な OAuth 接続を提供できます。

Enterprise Server などの GitHubインストール済みプロバイダータイプへの接続を作成する場合は、まず を使用してホストリソースを作成します AWS Management Console。


        接続 ARNs を使用した AWS リソースとサードパーティーリポジトリ間の接続を示す図。

接続は、接続を作成する AWS アカウント によって所有されます。接続は、接続 ID を含む ARN によって識別されます。接続 ID は、変更または再マッピングできない UUID です。接続を削除して再確立すると、新しい接続 ID が作成されるため、新しい接続 ARN が作成されます。つまり、接続 ARN が再利用されることはありません。

新しく作成された接続が Pending 状態です。接続のセットアップを完了し、接続を Pending 状態から Available 状態に移行するには、サードパーティーのハンドシェイク(OAuthフロー)プロセスが必要です。これが完了すると、接続は Available になり、 などの AWS サービスで使用できます CodePipeline。

新しく作成されたホストは Pending 状態です。ホストのセットアップを完了し、ホストを Pending 状態から Available 状態に移行するには、サードパーティーの登録プロセスが必要です。これが完了すると、ホストは Available で、インストール済プロバイダータイプへの接続に使用できます。

接続ワークフローの概要については、「接続を作成または更新するワークフロー」を参照してください。インストール済みプロバイダー用のホスト作成ワークフローの概要については、「ホストを作成または更新するワークフロー」を参照してください。プロバイダーのタイプ別に接続を作成するハイレベルの手順については、「接続の使用」を参照してください。

AWS CodeStar Connections のグローバルリソース

接続はグローバルリソースです。つまり、リソースがすべての AWS リージョンにレプリケートされます。

接続 ARN 形式には作成されたリージョン名が反映されますが、リソースはリージョンに制約されません。接続リソースが作成されたリージョンは、接続リソースデータの更新が制御されるリージョンです。接続リソースデータの更新を制御する API 操作の例として、接続の作成、インストールの更新、接続の削除、接続のタグ付けなどがあります。

接続のホストリソースは、グローバルに利用可能なリソースではありません。ホストリソースは、リソースを作成したリージョンでのみ使用します。

  • 接続は 1 回作成するだけで済みます。その後、任意の AWS リージョンで使用できます。

  • 接続が作成されたリージョンに問題がある場合、接続リソースデータを制御する API は影響を受けますが、他のすべてのリージョンで接続を正常に使用できます。

  • コンソールまたは CLI で接続リソースをリストすると、すべてのリージョンでアカウントに関連付けられているすべての接続リソースが一覧表示されます。

  • コンソールまたは CLI でホストリソースをリストすると、リストには、選択したリージョンのアカウントに関連付けられたホストリソースだけが表示されます。

  • 関連するホストリソースとの接続がリストされている場合、または CLI で一覧表示されている場合、設定されている CLI リージョンに関係なく、出力はホスト ARN を返します。

ホストを作成または更新するワークフロー

インストール済みプロバイダータイプの接続を作成するときは、最初にホストを作成します。

ホストの各状態は以下のとおりです。

  • Pendingpending ホストは作成済みのホストで、使用する前に設定 (available に移行) する必要があります。

  • Available - available ホストを使用することも、接続に渡すこともできます。

ワークフロー: CLI、SDK、または AWS CloudFormationを使用したホストの作成または更新

AWS Command Line Interface (AWS CLI)、 SDK、または を使用してホストを作成するには、 CreateHost API を使用します AWS CloudFormation。作成後、ホストは pending の状態になります。コンソールの [セットアップ] オプションを使用して、プロセスを完了します。

ワークフロー: コンソールを使用したホストの作成または更新

Enterprise Server や GitLab セルフマネージド型など GitHub、インストールされているプロバイダータイプへの接続を作成する場合は、まずホストを作成します。Bitbucket などのクラウドプロバイダーのタイプに接続する場合は、ホストの作成をスキップして、接続の作成を続行します。

コンソールを使用してホストを設定し、ステータスを pending から available に変更します。


          サードパーティープロバイダへの接続を作成するワークフローを示す図。

接続を作成または更新するワークフロー

接続を作成するときは、サードパーティープロバイダーと認証ハンドシェイクをするためのインストールを作成、あるいは既存のインストールを使用します。

接続には、以下のステータスがあります。

  • Pending -A pending 接続は、使用する前に完了(available に移動)する必要があります。

  • Available - アカウント内の他のリソースやユーザーに available 接続を使用または渡すことができます。

  • Error - error 状態の接続は自動的に再試行されます。available になるまで使用できません。

ワークフロー: CLI、SDK、 AWS CloudFormationを使用した接続の作成または更新

CreateConnection API を使用して、 AWS Command Line Interface (AWS CLI)、 SDK、または を使用して接続を作成します AWS CloudFormation。作成後、接続は pending の状態になります。コンソールの [保留中の接続のセットアップ] オプションを使用して、プロセスを完了します。インストールを作成するか、接続に既存のインストールを使用するかを確認するメッセージがコンソールに表示されます。次に、コンソールでハンドシェイクを完了し、[接続の完了] を選択して、接続を available の状態に移行します。

ワークフロー: コンソールとの接続の作成または更新

Enterprise Server などの GitHubインストール済みプロバイダータイプへの接続を作成する場合は、まずホストを作成します。Bitbucket などのクラウドプロバイダーのタイプに接続する場合は、ホストの作成をスキップして、接続の作成を続行します。

コンソールを使用して接続を作成または更新するには、コンソール CodePipeline の編集アクションページを使用してサードパーティープロバイダーを選択します。 コンソールでは、インストールを作成するか、既存のインストールを使用して接続を作成するように求められます。次に、接続の作成を求められます。コンソールがハンドシェイクを完了し、自動的に pending の状態からavailable の状態に移行します。


          サードパーティープロバイダへの接続を作成するワークフローを示す図。

接続を開始するにはどうしたらいいですか?

使用を開始するには、次のいくつかのトピックが役立ちます。