

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

# EC2/ オンプレミスコンピューティングプラットフォームのデプロイ作成 (CLI)
<a name="deployments-create-cli"></a>

を使用して EC2/オンプレミスコンピューティングプラットフォームにリビジョンを AWS CLI デプロイするには:

1. インスタンスを準備し、アプリケーションを作成して、リビジョンをプッシュした後、次のいずれかを実行します。
   + Amazon S3 バケットからリビジョンをデプロイする場合は、そのままステップ 2 に進みます。
   + GitHub リポジトリからリビジョンをデプロイする場合は、まず「[CodeDeploy アプリケーションを GitHub リポジトリに接続します。](deployments-create-cli-github.md)」のステップを完了してからステップ 2 に戻ります。

1. [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) コマンドを呼び出し、指定します。
   + `--application-name`: アプリケーション名。アプリケーション名のリストを表示するには、[list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html) コマンドを呼び出します。
   + `--deployment-group-name`: Amazon EC2 デプロイグループ名。デプロイグループ名のリストを表示するには、[list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html)コマンドを呼び出します。
   + `--revision`: デプロイするリビジョンに関する情報。

     Amazon S3 に格納されているリビジョン。
     + `s3Location`: リビジョンを含む Amazon S3 バケットの名前がリビジョンに含まれています。
     + `s3Location --> key`: アップロードされたリビジョンの名前。
     + `s3Location --> bundleType`: アップロードされたリビジョンの名前とファイル形式。
**注記**  
tar および圧縮 tar アーカイブファイル形式 (.tar および .tar.gz) は、Windows Server インスタンスではサポートされていません。
     + `s3Location --> version`: (オプション) リビジョンの Amazon S3 バージョン ID。(バージョン ID を指定しない場合、CodeDeploy は最新バージョンを使用します。)
     + `s3Location --> eTag`: (オプション) リビジョンの ETag。(ETag が指定されていない場合、CodeDeploy はオブジェクトの検証をスキップします。)

     GitHub で格納されたリビジョンの場合。
     + `gitHubLocation --> repository`: スラッシュ (`/`)、リポジトリの名前が後に続く、リポジトリに割り当てられたリビジョンを含む GitHub ユーザーまたは組織の名前。
     + `gitHubLocation --> commitId`: リビジョンのコミット ID。
   + `--deployment-config-name`: (オプション) 使用するデプロイ設定の名前。デプロイ設定のリストを表示するには、[list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html) コマンドを呼び出します。(指定されない場合、CodeDeploy は特定のデフォルトのデプロイ設定を使用します。)
   + `--ignore-application-stop-failures | --no-ignore-application-stop-failures`:（オプション）`BeforeInstall` デプロイライフサイクルのイベントを続行してインスタンスへのデプロイを続行するかどうか。たとえ `ApplicationStop` デプロイライフサイクルイベントが失敗してもです。
   + `--description`: (オプション) デプロイの説明。
   + `--file-exists-behavior`: (オプション) デプロイプロセスの一環として、CodeDeploy エージェントは、前回のデプロイでインストールされたすべてのファイルを各インスタンスから削除します。前回のデプロイに含まれていないファイルがデプロイ先に表示された場合の処理を選択します。
   + `--target-instances`: Blue/Green デプロイの場合、1 つ以上の Amazon EC2 Auto Scaling グループの名前、または、Amazon EC2 インスタンスを識別するのに使用するタグフィルタキー、型、および値を含む、Blue/Green デプロイの置き換え先環境に属するインスタンスに関する情報です。

**注記**  
Amazon S3 内のリビジョンに関する情報をコマンドラインで直接指定するには、**create-deployment** 呼び出しの一部としてこの構文を使用します。(`version` および `eTag` 設定はオプションです)。  

```
--s3-location bucket=string,key=string,bundleType=tar|tgz|zip,version=string,eTag=string
```
コマンドラインで、GitHub のリビジョンについての情報を直接呼び出す **create-deployment** の一部としてこの構文を使用します。  

```
--github-location repository=string,commitId=string
```
すでにプッシュされているリビジョンについての情報を入手するには、[list-application-revisions](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-application-revisions.html) コマンドを呼び出します。

デプロイの状態を追跡するには、「[CodeDeploy デプロイの詳細を表示する](deployments-view-details.md)」を参照してください。

## create-deployment コマンドリファレンス
<a name="deployments-create-cli-reference"></a>

以下に、`create-deployment` コマンドのコマンド構造とオプションを示します。詳細については、「*AWS CLI コマンドリファレンス*」の「[create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html)」を参照してください。

```
create-deployment
--application-name <value>
[--deployment-group-name <value>]
[--revision <value>]
[--deployment-config-name <value>]
[--description <value>]
[--ignore-application-stop-failures | --no-ignore-application-stop-failures]
[--target-instances <value>]
[--auto-rollback-configuration <value>]
[--update-outdated-instances-only | --no-update-outdated-instances-only]
[--file-exists-behavior <value>]
[--s3-location <value>]
[--github-location <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
```

# CodeDeploy アプリケーションを GitHub リポジトリに接続します。
<a name="deployments-create-cli-github"></a>

を使用して GitHub リポジトリからアプリケーションを初めてデプロイする前に AWS CLI、まず 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. **[Applications]** (アプリケーション) を選択します。

1. [**アプリケーション**] から、GitHub ユーザーアカウントにリンクするアプリケーションを選択し、[**アプリケーションをデプロイする**] を選択します。
**注記**  
デプロイを作成していません。これは現在、GitHub ユーザーアカウントに代わって GitHub を操作するためにアクセス権限を CodeDeploy に付与する唯一の方法です。

1. [**Repository type**] の横の [**My application revision is stored in GitHub**] を選択します。

1. **[Connect to GitHub]** (GitHub に接続) を選択します。
**注記**  
[**Connect to a different GitHub account**] リンクが表示されている場合:  
すでに CodeDeploy が GitHub とやりとりすることを、アプリケーションの別の GitHub アカウントに代わって許可している場合があります。  
CodeDeploy にリンクされているすべてのアプリケーションに対してサインインしている GitHub アカウントに代わって、GitHub を操作する CodeDeploy の承認を取り消した可能性があります。  
詳細については、「[CodeDeploy のアプリケーションを使用した GitHub の認証](integrations-partners-github.md#behaviors-authentication)」を参照してください。

1. GitHub にまだサインインしていない場合は、[**Sign in**] ページの手順に従います。

1. [**Authorize application**] ページで、[**Authorize application**] を選択します。

1. CodeDeploy にアクセス許可が付与されたら、[**キャンセル**] を選択して、「[EC2/ オンプレミスコンピューティングプラットフォームのデプロイ作成 (CLI)](deployments-create-cli.md)」の手順に進んでください。