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

# パートナーの製品とサービスとの統合
<a name="integrations-partners"></a>

CodeDeploy には、次のパートナー製品とサービスとの統合が組み込まれています。


|  |  | 
| --- |--- |
| Ansible |  すでに一連の [Ansible](http://www.ansible.com) プレイブックがあり、実行する場所が必要なだけの場合、Ansible と CodeDeploy のテンプレートは、いくつかのシンプルなデプロイフックによって Ansible をローカルデプロイインスタンスで使用し、プレイブックを実行できることを示します。すでにインベントリを構築して維持するためのプロセスが存在する場合、CodeDeploy エージェントのインストールと実行に使用できる Ansible モジュールもあります。 詳細はこちら: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
| Atlassian - Bamboo と Bitbucket |  [Bamboo](https://www.atlassian.com/software/bamboo/) の CodeDeploy タスクは AppSpec ファイルを含むディレクトリを.zip ファイルに圧縮、ファイルを Amazon S3 にアップロードし、CodeDeploy アプリケーションで提供されている設定に従ってデプロイを開始します。 Atlassian Bitbucket での CodeDeploy のサポートにより、Bitbucket UI からコードを直接 Amazon EC2 インスタンスにプッシュしたり、オンデマンドで任意のデプロイグループにプッシュしたりできます。これは、Bitbucket リポジトリのコードを更新した後、手動でのデプロイプロセスを実行するために、継続的インテグレーション (CI) プラットフォーム、または Amazon EC2 インスタンスにサインインする必要がないことを意味します。 詳細はこちら: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
| Chef |  AWS には、[Chef](https://www.chef.io/) と CodeDeploy を統合するための 2 つのテンプレートサンプルが用意されています。1 つは CodeDeploy エージェントをインストールして起動する Chef クックブックです。これにより CodeDeploy を使用中に Chef でのホストインフラストラクチャの管理を継続することができます。2 番目のサンプルテンプレートでは、CodeDeploy を使用して、各ノードで chef-solo を使用してクックブックとレシピの実行を調整する方法を示します。 詳細はこちら: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
| CircleCI |  [CircleCI](https://circleci.com/) では、自動化テスト、継続的な統合、およびデプロイのツールセットを提供します。CircleCI AWS で使用する IAM ロールを で作成し、circle.yml ファイルでデプロイパラメータを設定したら、CodeDeploy で CircleCI を使用してアプリケーションリビジョンを作成し、Amazon S3 バケットにアップロードしてから、デプロイを開始してモニタリングできます。 詳細はこちら: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
| CloudBees |  ビルド後のアクションとして、[CloudBees](https://www.cloudbees.com/) DEV@cloud で利用可能な CodeDeploy Jenkins プラグインを使用できます。例えば、継続的な配信パイプラインの終了時に、サーバー群にアプリケーションリビジョンをデプロイするために使用できます。 詳細はこちら: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
| Codeship |  [Codeship](https://codeship.com/) を使用して、CodeDeploy 経由でアプリケーションリビジョンをデプロイできます。Codeship UI を使用して、ブランチのデプロイパイプラインに CodeDeploy を追加できます。 詳細はこちら:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
| GitHub |  CodeDeploy を使用して、[GitHub](http://www.github.com) リポジトリからアプリケーションリビジョンをデプロイできます。そのリポジトリのソースコードが変更されるたびに、GitHub リポジトリからデプロイをトリガーすることもできます。 詳細はこちら: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
|  **HashiCorp Consul**  |  オープンソースの HashiCorp Consul ツールを使用して、CodeDeploy でアプリケーションをデプロイする時のアプリケーション環境の状態と安定性を確実にします。Consul を使用して、デプロイ中に検出されるアプリケーションを登録し、アプリケーションおよびノードをメンテナンスモードでデプロイから除外し、ターゲットのインスタンスに異常が生じた場合はデプロイを停止します。 詳細はこちら: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
| Jenkins |  CodeDeploy [Jenkins](http://jenkins-ci.org/) プラグインでは、Jenkins プロジェクトのビルド後のステップを示します。ビルドに成功すると、ワークスペースが圧縮されて Amazon S3 にアップロードされ、新しいデプロイが開始されます。 詳細はこちら:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
| Puppet Labs |  AWS には、[Puppet](https://puppetlabs.com/) と CodeDeploy のサンプルテンプレートが用意されています。最初のテンプレートは CodeDeploy エージェントをインストールして起動する Puppet モジュールです。これにより CodeDeploy を使用中に Puppet でのホストインフラストラクチャの管理を継続することができます。2 番目のサンプルテンプレートでは、CodeDeploy を使用してモジュールとマニフェストの実行を、各ノードのマスターレス puppet で調整する方法を示します。 詳細はこちら:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
| SaltStack |  [SaltStack](https://saltproject.io/index.html) のインフラストラクチャを CodeDeploy と統合できます。CodeDeploy モジュールを使用して、ミニオンズに CodeDeploy エージェントをインストールして実行できます。または、いくつかのシンプルなデプロイフックを使用して、CodeDeploy で Salt States の実行を調整できます。 詳細はこちら:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
|  **TeamCity**  |  CodeDeploy Runner プラグインを使用して、TeamCity からアプリケーションを直接デプロイできます。このプラグインは、アプリケーションリビジョンを準備して Amazon S3 バケットにアップロードし、CodeDeploy アプリケーションでリビジョンを登録し、CodeDeploy のデプロイを作成します。必要に応じて、デプロイが完了するまで待つ TeamCity のビルドステップを追加します。 詳細はこちら: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 
| Travis CI |  [Travis CI](https://travis-ci.com/) を設定して、ビルドが成功した後、CodeDeploy でデプロイメントをトリガーできます。 詳細はこちら:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/integrations-partners.html)  | 

**Topics**
+ [GitHub](integrations-partners-github.md)

# GitHub と CodeDeploy との統合
<a name="integrations-partners-github"></a>

CodeDeploy は、ウェブベースのコードホストおよび共有サービスである [GitHub](https://github.com/about) をサポートします。CodeDeploy は、GitHub リポジトリまたは Amazon S3 バケットに格納されているアプリケーションリビジョンをインスタンスにデプロイできます。CodeDeploy では、EC2 およびオンプレミスデプロイのみ GitHub がサポートされています。

**Topics**
+ [GitHub からの CodeDeploy リビジョンのデプロイ](#github-deployment-steps)
+ [CodeDeploy を使用した GitHub 動作](#github-behaviors)

## GitHub からの CodeDeploy リビジョンのデプロイ
<a name="github-deployment-steps"></a>

GitHub リポジトリからインスタンスへアプリケーションリビジョンをデプロイするには。

1. CodeDeploy およびデプロイする Amazon EC2 インスタンスタイプと互換性があるリビジョンを作成します。

   互換性のあるリビジョンを作成するには、[CodeDeploy のリビジョンを計画する](application-revisions-plan.md) および [CodeDeploy 用のアプリケーション仕様ファイルをリビジョンに追加](application-revisions-appspec-file.md) の手順に従います。

1. GitHub のアカウントを使用して、GitHub リポジトリにリビジョンを追加します。

   GitHub のアカウントを作成するには、「[GitHub への参加](https://github.com/join)」を参照してください。GitHub リポジトリを作成するには、「[Repo の作成](https://help.github.com/articles/create-a-repo/)」を参照してください。

1. CodeDeploy コンソールの**デプロイの作成**ページまたは AWS CLI **create-deployment** コマンドを使用して、GitHub リポジトリから CodeDeploy デプロイ用に設定されたターゲットインスタンスにリビジョンをデプロイします。

   **create-deployment** コマンドを呼び出す場合、最初にコンソールの [**デプロイの作成**] ページを使用して、指定したアプリケーションの推奨 GitHub アカウントの代わりに GitHub を操作するためのアクセス許可を CodeDeploy に付与します。これを行う必要があるのは、アプリケーションごとに 1 度だけです。

   [**Create deployment**] ページを使用して、GitHub レポジトリからデプロイする方法については、「[CodeDeploy でデプロイを作成する](deployments-create.md)」を参照してください。

   **create-deployment** コマンドを呼び出して GitHub レポジトリからデプロイする方法については、「[EC2/ オンプレミスコンピューティングプラットフォームのデプロイ作成 (CLI)](deployments-create-cli.md)」を参照してください。

   CodeDeploy デプロイで使用するためインスタンスを準備する方法については、「[CodeDeploy のためにインスタンスを用いた操作](instances.md)」を参照してください。

詳細については、「[チュートリアル: CodeDeploy を使用して、GitHub からアプリケーションをデプロイします。](tutorials-github.md)」を参照してください。

## CodeDeploy を使用した GitHub 動作
<a name="github-behaviors"></a>

**Topics**
+ [CodeDeploy のアプリケーションを使用した GitHub の認証](#behaviors-authentication)
+ [プライベートおよびパブリックな GitHub リポジトリとの CodeDeploy のやり取り](#behaviors-interactions-private-and-public)
+ [CodeDeploy と組織マネージド型の GitHub リポジトリのやり取り](#behaviors-interactions-organization-managed)
+ [CodeDeploy を使用して CodePipeline から自動的にデプロイする](#behaviors-deploy-automatically)

### CodeDeploy のアプリケーションを使用した GitHub の認証
<a name="behaviors-authentication"></a>

GitHub を操作するためのアクセス許可を CodeDeploy に付与すると、GitHub アカウントとアプリケーションの間の関連付けが CodeDeploy に格納されます。GitHub の他のアカウントにアプリケーションをリンクできます。また、GitHub を操作するための CodeDeploy に対するアクセス許可を取り消すこともできます。

**GitHub アカウントを CodeDeploy のアプリケーションにリンクするには**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) で CodeDeploy コンソールを開きます。
**注記**  
「[CodeDeploy の開始方法](getting-started-codedeploy.md)」で設定したのと同じユーザーでサインインします。

1. ナビゲーションペインで [**デプロイ**] を展開し、[**アプリケーション**] を選択します。

1. 別の GitHub アカウントにリンクするアプリケーションを選択します。

1. アプリケーションにデプロイグループがない場合は、[**デプロイグループの作成**] を選択してグループを作成します。詳細については、「[CodeDeploy でデプロイグループを作成する](deployment-groups-create.md)」を参照してください。次のステップで [**デプロイの作成**] を選択するには、デプロイグループが必要です。

1.  [**デプロイ**] から、[**デプロイの作成**] を選択します。
**注記**  
新しいデプロイを作成する必要はありません。これは現在 GitHub の他のアカウントをアプリケーションにリンクする唯一の方法です。

1.  [**デプロイ設定**] の [**リビジョンタイプ**] で、[**アプリケーションは GitHub に格納されています**] を選択します。

1. 次のいずれかを行います。
   + GitHub アカウントへの AWS CodeDeploy アプリケーションの接続を作成するには、別のウェブブラウザタブで GitHub からサインアウトします。[**GitHub token name (GitHub トークン名)**] に、この接続を識別する名前を入力し、[**GitHub に接続**] を選択します。アプリケーションの GitHub を操作することを CodeDeploy に許可するよう求めるメッセージがウェブページに表示されます。ステップ 10 に進みます。
   + 作成済みの接続を使用するには、その名前を [**GitHub token name (GitHub トークン名)**] で選択してから [**GitHub に接続**] を選択します。ステップ 8 に進みます。
   + 別の GitHub アカウントへの接続を作成するには、ウェブブラウザの別のタブで GitHub からサインアウトします。[**GitHub token name (GitHub トークン名)**] に、接続を識別する名前を入力し、[**GitHub に接続**] を選択します。アプリケーションの GitHub を操作することを CodeDeploy に許可するよう求めるメッセージがウェブページに表示されます。ステップ 10 に進みます。

1. GitHub にまだサインインしていない場合は、[**Sign in**] ページの手順に従い、アプリケーションをリンクする GitHub アカウントにサインインします。

1. [**Authorize application**] を選択します。GitHub は指定したアプリケーションの署名 GitHub アカウントの代わりに、CodeDeploy に GitHub を操作するアクセス許可を付与します。

1. デプロイを作成しない場合は、[**Cancel**] を選択します。

**CodeDeploy が GitHub を操作するためのアクセス許可を取り消すには**

1.  AWS CodeDeploy アクセス許可を取り消したい GitHub アカウントの認証情報を使用して、[GitHub](https://github.com/dashboard) にサインインします。

1. GitHub の [[Applications](https://github.com/settings/applications)] ページを開いて、承認されたアプリケーションのリストで [**CodeDeploy**] を見つけ、アプリケーションの承認取り消しの GitHub の手順に従います。

### プライベートおよびパブリックな GitHub リポジトリとの CodeDeploy のやり取り
<a name="behaviors-interactions-private-and-public"></a>

CodeDeploy は、プライベートおよびパブリックの GitHub リポジトリからのアプリケーションのデプロイをサポートします。ユーザーに代わって GitHub にアクセスするアクセス許可を CodeDeploy に付与した場合、CodeDeploy は、そのユーザーの GitHub アカウントがアクセス権を持つすべてのプライベート GitHub リポジトリに対して読み取り/書き込みアクセス権を持ちます。ただし、CodeDeploy は、GitHub リポジトリからのみ読み込みます。プライベート GitHub のリポジトリに書き込むことはありません。

### CodeDeploy と組織マネージド型の GitHub リポジトリのやり取り
<a name="behaviors-interactions-organization-managed"></a>

デフォルトでは、組織によって管理される GitHub リポジトリ (アカウントのプライベートまたはパブリックリポジトリとは対照的に) は、CodeDeploy を含め、サードパーティアプリケーションへのアクセスを許可しません。デプロイは、組織によるサードパーティアプリケーション制限が GitHub で有効化され、GitHub リポジトリからコードをデプロイしようとすると失敗します。この問題を解決する 2 つの方法があります。
+ 組織のメンバーとして、組織の所有者に CodeDeploy へのアクセスを承認するように要求できます。このアクセスをリクエストする手順は、個々のアカウントに対して、すでに CodeDeploy を認証済みかどうかによって異なります。
  + ユーザーのアカウントに CodeDeploy への認証済みアクセス権がある場合は、「[組織への認証済みアプリケーションの承認リクエスト](https://help.github.com/articles/requesting-organization-approval-for-your-authorized-applications/)」を参照してください。
  + ユーザーのアカウントに CodeDeploy への承認済みアクセス権がまだない場合は、「[組織へのサードパーティアプリケーションの承認リクエスト](https://help.github.com/articles/requesting-organization-approval-for-third-party-applications/)」を参照してください。
+ 組織の所有者は、組織に対するサードパーティアプリケーションの制限を無効にできます。詳細については、「[組織に対するサードパーティアプリケーションの制限の無効化](https://help.github.com/articles/disabling-third-party-application-restrictions-for-your-organization/)」を参照してください。

詳細については、「[サードパーティアプリケーションの制限について](https://help.github.com/articles/about-third-party-application-restrictions/)」を参照してください。

### CodeDeploy を使用して CodePipeline から自動的にデプロイする
<a name="behaviors-deploy-automatically"></a>

ソースコードが変わるたびに CodePipeline からデプロイをトリガーできます。詳細については、「[CodePipeline](https://aws.amazon.com/codepipeline/)」を参照してください。