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

接続とは?

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

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

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

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

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

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

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

接続と AWS のサービス 統合するものは何ですか？

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

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

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

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

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

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

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

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

のグローバルリソース AWS CodeConnections

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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