翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CodeDeploy エージェントをインストールする
EC2 インスタンスまたはオンプレミスサーバーで CodeDeploy を使用するには、まず CodeDeploy エージェントをインストールする必要があります。を使用して CodeDeploy エージェントをインストールおよび更新することをお勧めします AWS Systems Manager。Systems Manager のさらなる詳細については、「[AWS Systems Managerとは](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html)」 を参照してください。デプロイグループの作成時にコンソールで Systems Manager を使用し、CodeDeploy エージェントのインストールと更新スケジュールを設定できます。
コマンドラインを使用して、S3 バケットから直接 CodeDeploy エージェントをインストールすることもできます。
インストールする推奨バージョンについては、「[CodeDeploy エージェントのバージョン履歴](codedeploy-agent.md#codedeploy-agent-version-history)」を参照してください。
**Topics**
+ [
# を使用して CodeDeploy エージェントをインストールする AWS Systems Manager
](codedeploy-agent-operations-install-ssm.md)
+ [
# コマンドラインを使用して CodeDeploy エージェントをインストールする
](codedeploy-agent-operations-install-cli.md)
# を使用して CodeDeploy エージェントをインストールする AWS Systems Manager
AWS マネジメントコンソール または を使用して AWS CLI 、CodeDeploy エージェントを Amazon EC2 またはオンプレミスインスタンスにインストールできます AWS Systems Manager。特定のバージョンをインストールするか、常に最新バージョンのエージェントをインストールするかを選択できます。の詳細については AWS Systems Manager、[「 とは AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html)」を参照してください。
CodeDeploy エージェントをインストールおよび更新するには、 を使用する AWS Systems Manager ことをお勧めします。また、Amazon S3 バケットか らCodeDeploy エージェントをインストールすることもできます。Amazon S3 ダウンロードリンクの使用については、「 [コマンドラインを使用して CodeDeploy エージェントをインストールする](codedeploy-agent-operations-install-cli.md) 」を参照してください。
**Topics**
+ [
## 前提条件
](#install-codedeploy-agent-prereqs)
+ [
## CodeDeploy エージェントをインストールする
](#download-codedeploy-agent-on-EC2-Instance)
## 前提条件
[CodeDeploy の開始方法](getting-started-codedeploy.md) のステップに従って、IAM アクセス許可と AWS CLIを設定します。
Systems Manager を使用してオンプレミスサーバーに CodeDeploy エージェントをインストールする場合は、オンプレミスサーバーを Amazon EC2 Systems Manager に登録する必要があります。詳細については、[AWS Systems Manager ユーザーガイド](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html) の *ハイブリッド環境での Systems Manager のセットアップ* を参照してください。
## CodeDeploy エージェントをインストールする
Systems Manager を使用して CodeDeploy エージェントをインストールする前に、Systems Manager に合わせてインスタンスが適切に設定されていることを確認する必要があります。
### SSM Agent のインストールまたは更新
Amazon EC2 インスタンスでは、CodeDeploy エージェントを使用するにはバージョン 2.3.274.0 以降のインスタンスが実行されている必要があります。CodeDeploy エージェントをインストールする前に、SSM Agent を更新するか、インスタンスにインストールしてください (まだの場合)。
SSM エージェントは、 が提供する一部の Amazon EC2 AMIs にプリインストールされています AWS。詳細については、「[SSM Agent がプリインストールされた Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html)」を参照してください。
**注記**
インスタンスのオペレーティング システムも CodeDeploy エージェントでサポートされていることを確認します。詳細については、「[CodeDeploy エージェントで対応するオペレーティングシステム](codedeploy-agent.md#codedeploy-agent-supported-operating-systems)」を参照してください。
Linux を実行しているインスタンスでの SSM Agent のインストールまたは更新については、[AWS Systems Manager ユーザーガイド](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-agent.html) の *Linux インスタンスでの SSM Agent のインストールおよび設定* を参照してください。
Windows Server を実行しているインスタンスでの SSM Agent のインストールまたは更新については、[AWS Systems Manager ユーザーガイド](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html) の *Windows インスタンスでの SSM Agent のインストールおよび設定* を参照してください。
### (オプション) Systems Manager の前提条件を確認します。
Systems Manager Run Command を使用して CodeDeploy エージェントをインストールする前に、インスタンスが Systems Manager の最低要件を満たしていることを確認してください。詳細については、[AWS Systems Managerユーザーガイド](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html) の「*AWS Systems Manager のセットアップ*」を参照してください。
### CodeDeploy エージェントをインストールする
SSM では、CodeDeploy を一度インストールするか、新しいバージョンをインストールするスケジュールを設定できます。
CodeDeploy エージェントをインストールするには、「ディストリビューターによる`AWSCodeDeployAgent`パッケージのインストールまたは更新」の手順に従って、パッケージを選択します。 [AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html)
# コマンドラインを使用して CodeDeploy エージェントをインストールする
**注記**
エージェントのスケジュールされた更新を設定 AWS Systems Manager できるように、 で CodeDeploy エージェントをインストールすることをお勧めします。詳細については、「[を使用して CodeDeploy エージェントをインストールする AWS Systems Manager](codedeploy-agent-operations-install-ssm.md)」を参照してください。
以下のトピックに従い、コマンドラインを使用して CodeDeploy エージェントをインストールおよび実行します。
**Topics**
+ [
# Amazon Linux または RHEL 用の CodeDeploy エージェントをインストールする
](codedeploy-agent-operations-install-linux.md)
+ [
# Ubuntu サーバー用の CodeDeploy エージェントをインストールする
](codedeploy-agent-operations-install-ubuntu.md)
+ [
# Windows サーバー用の CodeDeploy エージェントです。
](codedeploy-agent-operations-install-windows.md)
# Amazon Linux または RHEL 用の CodeDeploy エージェントをインストールする
インスタンスにサインインし、次のコマンドを一度に 1 つずつ実行します。コマンド `sudo yum update` を最初に実行するのが、`yum` を使用してパッケージをインストールするときのベストプラクティスと考えられていますが、すべてのパッケージを更新しない場合はこのコマンドをスキップできます。
```
sudo yum update
```
```
sudo yum install ruby
```
```
sudo yum install wget
```
(オプション) 以前のエージェントキャッシュ情報の AMI を消去するには、次のスクリプトを実行します。
```
#!/bin/bash
CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent"
$CODEDEPLOY_BIN stop
yum erase codedeploy-agent -y
```
ホームディレクトリに移動します。
```
cd /home/ec2-user
```
**注記**
以前のコマンドで、`/home/ec2-user` は、Amazon Linux または RHEL Amazon EC2 インスタンスのデフォルトのユーザー名を表しています。インスタンスがカスタム AMI を使用して作成された場合、AMI 所有者は別のデフォルトのユーザー名を指定している可能性があります。
CodeDeploy エージェントのインストーラをダウンロードします。
```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```
*bucket-name* は、お住まいの地域用の CodeDeploy リソースキットファイルが含まれている Amazon S3 バケットの名前です。*リージョン識別子* は、お住まいの地域の識別子です。
例えば、次のようになります。
`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`
バケット名とリージョン識別子のリストについては、「[リージョン別リソースキットバケット名](resource-kit.md#resource-kit-bucket-names)」を参照してください。
`install` ファイルに実行権限を設定します。
```
chmod +x ./install
```
CodeDeploy エージェントの最新バージョンをインストールするには:
+
```
sudo ./install auto
```
CodeDeploy エージェントの特定のバージョンをインストールするには:
+ リージョンで使用可能なバージョンを一覧表示します。
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$'
```
+ 以下のいずれかのバージョンをインストールします。
```
sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm
```
**注記**
AWS は、CodeDeploy エージェントの最新マイナーバージョンをサポートしています。現在、最新のマイナーバージョンは 1.7.x です。
サービスが実行されているかどうか確認するには、次のコマンドを実行します。
```
systemctl status codedeploy-agent
```
CodeDeploy エージェントがインストールされて実行されている場合は、「`The AWS CodeDeploy agent is running`」のようなメッセージが表示されます。
「 `error: No AWS CodeDeploy agent running` 」のようなメッセージが表示される場合は、サービスを起動し、次の 2 つのコマンドを一度に 1 つずつ実行します。
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
# Ubuntu サーバー用の CodeDeploy エージェントをインストールする
**注記**
エージェントのスケジュールされた更新を設定 AWS Systems Manager できるように、 で CodeDeploy エージェントをインストールすることをお勧めします。詳細については、「[を使用して CodeDeploy エージェントをインストールする AWS Systems Manager](codedeploy-agent-operations-install-ssm.md)」を参照してください。
**CodeDeploy エージェントを Ubuntu サーバーにインストールするには**
1. インスタンスにサインインします。
1. 次のコマンドを順々に入力します。
```
sudo apt update
```
```
sudo apt install ruby-full
```
```
sudo apt install wget
```
1. 次のコマンドを入力します。
```
cd /home/ubuntu
```
*/home/ubuntu* は、Ubuntu Server インスタンスのデフォルトのユーザー名を表しています。インスタンスがカスタム AMI を使用して作成された場合、AMI 所有者は別のデフォルトのユーザー名を指定している可能性があります。
1. 次のコマンドを入力します。
```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```
*bucket-name* は、お住まいの地域用の CodeDeploy リソースキットファイルが含まれている Amazon S3 バケットの名前です。*リージョン識別子* は、お住まいの地域の識別子です。
例えば、次のようになります。
`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`
バケット名とリージョン識別子のリストについては、「[リージョン別リソースキットバケット名](resource-kit.md#resource-kit-bucket-names)」を参照してください。
1. 次のコマンドを入力します。
```
chmod +x ./install
```
1. 次のいずれかを行います。
+ CodeDeploy エージェントの最新バージョンをサポートされている 20.04 *以外*の Ubuntu にインストールするには:
```
sudo ./install auto
```
+ CodeDeploy エージェントの最新バージョンを Ubuntu Server 20.04 にインストールするには:
**注記**
出力を一時ログファイルに書き込むことで、Ubuntu Server 20.04 の `install` スクリプトにある既知のバグを回避できます。このバグは現在修正中です。
```
sudo ./install auto > /tmp/logfile
```
+ CodeDeploy エージェントの特定のバージョンをサポートされている 20.04 *以外*の Ubuntu Server にインストールするには:
+ リージョンで使用可能なバージョンを一覧表示します。
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
```
+ 以下のいずれかのバージョンをインストールします。
```
sudo ./install auto -v releases/codedeploy-agent-###.deb
```
**注記**
AWS は、CodeDeploy エージェントの最新マイナーバージョンをサポートしています。現在、最新のマイナーバージョンは 1.7.x です。
+ CodeDeploy エージェントの特定のバージョンを Ubuntu Server 20.04 にインストールするには:
+ リージョンで使用可能なバージョンを一覧表示します。
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
```
+ 以下のいずれかのバージョンをインストールします。
```
sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile
```
**注記**
出力を一時ログファイルに書き込むことで、Ubuntu Server 20.04 の `install` スクリプトにある既知のバグを回避できます。このバグは現在修正中です。
**注記**
AWS は、CodeDeploy エージェントの最新マイナーバージョンをサポートしています。現在、最新のマイナーバージョンは 1.7.x です。
**サービスが実行されていることをチェックするには**
1. 次のコマンドを入力します。
```
systemctl status codedeploy-agent
```
CodeDeploy エージェントがインストールされて実行されている場合は、「`The AWS CodeDeploy agent is running`」のようなメッセージが表示されます。
1. 「 `error: No AWS CodeDeploy agent running` 」のようなメッセージが表示される場合は、サービスを起動し、次の 2 つのコマンドを一度に 1 つずつ実行します。
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
# Windows サーバー用の CodeDeploy エージェントです。
Windows サーバーのインスタンスでは、次のいずれかの方法を使用して、CodeDeploy エージェントをダウンロードしてインストールできます。
+ 使用 AWS Systems Manager (推奨)
+ 一連の Windows PowerShell コマンドを実行。
+ 直接ダウンロードリンクを選択。
+ Amazon S3 コピーコマンドを実行してください。
**注記**
CodeDeploy エージェントがインストールされているフォルダは `C:\Program Data\Amazon\CodeDeploy` です。このパスにディレクトリジャンクションまたはシンボリックリンクがないことを確認します。
**Topics**
+ [
## 使用アイテム Systems Manager
](#codedeploy-agent-operations-install-system-manager)
+ [
## Windows PowerShell の使用
](#codedeploy-agent-operations-install-windows-powershell)
+ [
## 直接接続の使用
](#codedeploy-agent-operations-install-windows-direct-link)
+ [
## Amazon S3 コピーコマンドの使用
](#codedeploy-agent-operations-install-windows-s3-copy)
## 使用アイテム Systems Manager
「[を使用して CodeDeploy エージェントをインストールする AWS Systems Manager](codedeploy-agent-operations-install-ssm.md)」の手順に従って CodeDeploy エージェントをインストールします。
## Windows PowerShell の使用
インスタンスにサインインし、Windows PowerShell で次のコマンドを実行します。
1. インターネットからダウンロードされたすべてのスクリプトと設定ファイルが、信頼された発行元によって署名されていることを要求します。実行ポリシーの変更を求められた場合は「 **Y** 」と入力します。
```
Set-ExecutionPolicy RemoteSigned
```
1. をロードします AWS Tools for Windows PowerShell。
```
Import-Module AWSPowerShell
```
1. CodeDeploy エージェントのインストールファイルがダウンロードされた場所で、ディレクトリを作成します。
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
1. `Set-AWSCredential` および `Initialize-AWSDefaultConfiguration` コマンドを使用して AWS 認証情報を設定します。詳細については、[AWS Tools for PowerShell ユーザーガイドにある](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html)「*AWS 認証情報の使用*」を参照してください。
1. CodeDeploy エージェントのインストールファイルをダウンロードします。
**注記**
AWS は、CodeDeploy エージェントの最新マイナーバージョンをサポートしています。現在、最新のマイナーバージョンは 1.7.x です。
CodeDeploy エージェントの最新バージョンをインストールするには:
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
```
CodeDeploy エージェントの特定のバージョンをインストールするには:
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi
```
*バケット名* は、リージョンの CodeDeploy リソースキットファイルが含まれている Amazon S3 バケットの名前です。例えば、米国東部 (オハイオ) リージョンの場合、*バケット名* を `aws-codedeploy-us-east-2` に置き換えます。バケット名のリストについては、「[リージョン別リソースキットバケット名](resource-kit.md#resource-kit-bucket-names)」を参照してください。
1. CodeDeploy エージェントのインストールファイルを実行します。
```
c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
```
サービスが実行されているかどうか確認するには、次のコマンドを実行します。
```
powershell.exe -Command Get-Service -Name codedeployagent
```
CodeDeploy エージェントがインストールされただけで、まだ開始されていない場合は、**Get-Service** コマンドを実行すると、[**ステータス**] に「**Start...**」と表示されます。
```
Status Name DisplayName
------ ---- -----------
Start... codedeployagent CodeDeploy Host Agent Service
```
CodeDeploy エージェントが既に実行されている場合は、**Get-Service** コマンドを実行すると、[**ステータス**] に「**Running**」と表示されます。
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
## 直接接続の使用
Windows サーバーのインスタンスのブラウザのセキュリティ設定でアクセス権限 (例えば、`https://s3.*.amazonaws.com` への) が提供されている場合は、リージョンの直接接続を使用して CodeDeploy エージェントをダウンロードし、インストーラを手動で実行できます。
リンクは以下のとおりです。
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi
```
…*リージョン*はアプリケーションをデプロイする AWS リージョンです。
例えば、次のようになります。
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
```
**重要**
CodeDeploy アプリケーションと同じリージョンから `.msi` ファイルを取得します。別のリージョンを選択すると、`.msi` ファイルを実行したときに `codedeploy-agent-log` ファイルに `inconsistent region` 障害が発生する可能性があります。
## Amazon S3 コピーコマンドの使用
AWS CLI がインスタンスにインストールされている場合は、Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) コマンドを使用して CodeDeploy エージェントをダウンロードし、インストーラを手動で実行できます。詳細については、[「Microsoft Windows AWS Command Line Interface に をインストールする](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html)」を参照してください。
Amazon S3 コマンドは以下のとおりです。
```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region
```
…*リージョン*はアプリケーションをデプロイする AWS リージョンです。
例えば、次のようになります。
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1
```