翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CodeDeploy エージェントのオペレーションの管理
このセクションの手順では、CodeDeploy エージェントをインストール、アンインストール、再インストール、または更新する方法、および CodeDeploy エージェントが実行されていることを確認する方法について説明します。
**Topics**
+ [CodeDeploy エージェントが実行されていることの確認](codedeploy-agent-operations-verify.md)
+ [CodeDeploy エージェントのバージョンを特定します。](codedeploy-agent-operations-version.md)
+ [CodeDeploy エージェントをインストールする](codedeploy-agent-operations-install.md)
+ [CodeDeploy エージェントを更新する](codedeploy-agent-operations-update.md)
+ [CodeDeploy エージェントをアンインストールする](codedeploy-agent-operations-uninstall.md)
+ [CodeDeploy エージェントログを CloudWatch に送信する](codedeploy-agent-operations-cloudwatch-agent.md)
# CodeDeploy エージェントが実行されていることの確認
このセクションでは、インスタンスで CodeDeploy エージェントが実行を停止した可能性がある場合に実行するコマンドについて説明します。
**Topics**
+ [Amazon Linux または RHEL 用の CodeDeploy エージェントが実行されていることを確認します。](#codedeploy-agent-operations-verify-linux)
+ [Ubuntu サーバーの CodeDeploy エージェントが実行されていることを確認します。](#codedeploy-agent-operations-verify-ubuntu)
+ [Windows サーバーの CodeDeploy エージェントが実行されていることを確認します。](#codedeploy-agent-operations-verify-windows)
## Amazon Linux または RHEL 用の CodeDeploy エージェントが実行されていることを確認します。
CodeDeploy エージェントがインストールされていて実行していることを確認するには、インスタンスにサインインし、次のコマンドを実行します。
```
systemctl status codedeploy-agent
```
コマンドがエラーを返す場合、CodeDeploy エージェントはインストールされていません。「[Amazon Linux または RHEL 用の CodeDeploy エージェントをインストールする](codedeploy-agent-operations-install-linux.md)」で説明されているようにインストールします。
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 エージェントが実行されていることを確認します。
CodeDeploy エージェントがインストールされていて実行していることを確認するには、インスタンスにサインインし、次のコマンドを実行します。
```
systemctl status codedeploy-agent
```
コマンドがエラーを返す場合、CodeDeploy エージェントはインストールされていません。「[Ubuntu サーバー用の CodeDeploy エージェントをインストールする](codedeploy-agent-operations-install-ubuntu.md)」で説明されているようにインストールします。
CodeDeploy エージェントがインストールされて実行されている場合は、「`The AWS CodeDeploy agent is running`」のようなメッセージが表示されます。
「`error: No AWS CodeDeploy agent running`」のようなメッセージが表示される場合は、サービスを起動し、次の 2 つのコマンドを一度に 1 つずつ実行します。
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
## Windows サーバーの CodeDeploy エージェントが実行されていることを確認します。
CodeDeploy エージェントがインストールされていて実行していることを確認するには、インスタンスにサインインし、次のコマンドを実行します。
```
powershell.exe -Command Get-Service -Name codedeployagent
```
次のような出力が表示されます:
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
コマンドがエラーを返す場合、CodeDeploy エージェントはインストールされていません。「[Windows サーバー用の CodeDeploy エージェントです。](codedeploy-agent-operations-install-windows.md)」で説明されているようにインストールします。
`Status` で `Running` 以外の何かが表示される場合は、次のコマンドでサービスを開始します。
```
powershell.exe -Command Start-Service -Name codedeployagent
```
次のコマンドを使ってサービスを再起動できます。
```
powershell.exe -Command Restart-Service -Name codedeployagent
```
次のコマンドを使ってサービスを停止できます。
```
powershell.exe -Command Stop-Service -Name codedeployagent
```
# CodeDeploy エージェントのバージョンを特定します。
インスタンスで実行中の CodeDeploy エージェントのバージョンは、2 つの方法で特定できます。
最初に、バージョン 1.0.1.854 以降の CodeDeploy エージェントでは、インスタンスの `.version` ファイルでバージョン番号を確認できます。次の表に、サポートされるオペレーティングシステムごとの場所とサンプルのバージョン文字列を示します。
| オペレーティングシステム | ファイルの場所 | サンプルの agent\$1version 文字列 |
| --- | --- | --- |
| Amazon Linux および Red Hat Enterprise Linux（RHEL） | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1rpm |
| Ubuntu Server | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1deb |
| Windows サーバー | C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1.version | OFFICIAL\$11.0.1.854\$1msi |
2 番目に、インスタンスでコマンドを実行して、CodeDeploy エージェントのバージョンを確認できます。
**Topics**
+ [Amazon Linux または RHEL でバージョンを確認する](#codedeploy-agent-operations-version-linux)
+ [Ubuntu サーバーでバージョンを確認する](#codedeploy-agent-operations-version-ubuntu)
+ [Windows サーバーでバージョンをを確認する](#codedeploy-agent-operations-version-windows)
## Amazon Linux または RHEL でバージョンを確認する
インスタンスにサインインし、次のコマンドを実行します。
```
sudo yum info codedeploy-agent
```
## Ubuntu サーバーでバージョンを確認する
インスタンスにサインインし、次のコマンドを実行します。
```
sudo dpkg -s codedeploy-agent
```
## Windows サーバーでバージョンをを確認する
インスタンスにサインインし、次のコマンドを実行します。
```
sc qdescription codedeployagent
```
# 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
```
# CodeDeploy エージェントを更新する
AWS Systems Managerを使用して、すべてのサポートされているオペレーティングシステムで CodeDeploy エージェントの自動更新スケジュールを設定できます。また、インスタンスでコマンドを実行して、サポートされているすべてのオペレーティングシステムで更新を強制することもできます。
**Topics**
+ [Amazon Linux または RHEL で CodeDeploy エージェントを更新する](codedeploy-agent-operations-update-linux.md)
+ [Ubuntu サーバーで CodeDeploy エージェントを更新する](codedeploy-agent-operations-update-ubuntu.md)
+ [Windows サーバーで CodeDeploy エージェントを更新する](codedeploy-agent-operations-update-windows.md)
# Amazon Linux または RHEL で CodeDeploy エージェントを更新する
を使用して CodeDeploy エージェントの自動スケジュール更新を設定するには、「 [を使用して CodeDeploy エージェントをインストールする AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html)」の手順 AWS Systems Managerに従います。
CodeDeploy エージェントの更新を強制する場合は、インスタンスにサインインし、次のコマンドを実行します。
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Ubuntu サーバーで CodeDeploy エージェントを更新する
を使用して CodeDeploy エージェントの自動スケジュール更新を設定するには、「 [を使用して CodeDeploy エージェントをインストールする AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html)」の手順 AWS Systems Managerに従います。
CodeDeploy エージェントの更新を強制する場合は、インスタンスにサインインし、次のコマンドを実行します。
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Windows サーバーで CodeDeploy エージェントを更新する
を使用して CodeDeploy エージェントの自動更新を有効にできます AWS Systems Manager。Systems Manager では、Systems Manager State Manager との関連付けを作成して、Amazon EC2 またはオンプレミスインスタンスの更新スケジュールを設定できます。現在のバージョンをアンインストールして新しいバージョンをインストールすることで、CodeDeploy エージェントを手動で更新することもできます。
**Topics**
+ [を使用して CodeDeploy エージェントの自動更新を設定する AWS Systems Manager](#codedeploy-agent-operations-update-windows-ssm)
+ [CodeDeploy エージェントを手動で更新する](#codedeploy-agent-operations-update-windows-manual)
+ [(非推奨) Windows サーバーアップデータを使用して CodeDeploy エージェントを更新する](#codedeploy-agent-operations-update-windows-updater)
## を使用して CodeDeploy エージェントの自動更新を設定する AWS Systems Manager
Systems Manager を設定し、CodeDeploy エージェントの自動更新を有効にするには、「 [を使用して CodeDeploy エージェントをインストールする AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html)」の手順に従います。
## CodeDeploy エージェントを手動で更新する
CodeDeploy エージェントを手動で更新するには、CLI または Systems Manager を使用して最新バージョンをインストールします。「[CodeDeploy エージェントをインストールする](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install.html)」の手順に従います。[CodeDeploy エージェントのアンインストール](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-uninstall.html) の手順に従って、古いバージョンの CodeDeploy エージェントをアンインストールすることをお勧めします。
## (非推奨) Windows サーバーアップデータを使用して CodeDeploy エージェントを更新する
**注記**
Windows サーバー用の CodeDeploy エージェントアップデータは非推奨となり、1.0.1.1597 より後のバージョンには更新されなくりました。
CodeDeploy エージェントの自動更新を有効にするには、新しいインスタンスまたは既存のインスタンスに Windows サーバー用の CodeDeploy エージェントアップデーターをインストールします。アップデータは新しいバージョンを定期的に確認します。新しいバージョンが検出された場合、アップデータは、最新バージョンをインストールする前に、インストールされている場合はエージェントの現在のバージョンをアンインストールします。
アップデータが新しいバージョンが検出したときにデプロイが既に進行中の場合、デプロイは完了するまで続行されます。更新プロセス中にデプロイの開始が試みられた場合、デプロイは失敗します。
CodeDeploy エージェントの更新を強制する場合は、「[Windows サーバー用の CodeDeploy エージェントです。](codedeploy-agent-operations-install-windows.md)」の手順に従います。
Windows サーバーのインスタンスでは、CodeDeploy エージェントアップデーターをダウンロードしてインストールできます。これを行うには、一連の Windows PowerShell コマンドを実行するか、直接ダウンロードリンクを使用するか、または Amazon S3 コピーコマンドを実行します。
**Topics**
+ [Windows PowerShell の使用](#codedeploy-agent-operations-update-windows-powershell)
+ [直接接続の使用](#codedeploy-agent-operations-update-windows-direct-link)
+ [Amazon S3 コピーコマンドの使用](#codedeploy-agent-operations-update-windows-s3-copy)
### Windows PowerShell の使用
インスタンスにサインインし、Windows PowerShell で、一度に 1 つずつ次のコマンドを実行します。
```
Set-ExecutionPolicy RemoteSigned
```
実行ポリシーの変更を求められた場合は、「 **Y** 」を選択し、Windows PowerShell により、インターネットからダウンロードされるすべてのスクリプトと設定ファイルが、信頼された発行元によって署名されていることが要求されるようにします。
```
Import-Module AWSPowerShell
```
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent-updater.msi -File c:\temp\codedeploy-agent-updater.msi
```
```
c:\temp\codedeploy-agent-updater.msi /quiet /l c:\temp\host-agent-updater-log.txt
```
```
powershell.exe -Command Get-Service -Name codedeployagent
```
*バケット名* は、リージョンの CodeDeploy リソースキットファイルが含まれている Amazon S3 バケットの名前です。例えば、米国東部 (オハイオ) リージョンの場合、*バケット名* を `aws-codedeploy-us-east-2` に置き換えます。バケット名のリストについては、「[リージョン別リソースキットバケット名](resource-kit.md#resource-kit-bucket-names)」を参照してください。
更新プロセスのエラーをトラブルシューティングする必要がある場合は、次のコマンドを入力して CodeDeploy エージェントアップデータのログファイルを開きます。
```
notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log
```
### 直接接続の使用
Windows サーバーのインスタンスのブラウザのセキュリティ設定で必要なアクセス許可 (例えば、` http://s3.*.amazonaws.com ` への) が提供されている場合は、直接接続を使用して CodeDeploy エージェントアップデーターをダウンロードできます。
リンクは以下のとおりです。
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent-updater.msi
```
…*リージョン*はアプリケーションを更新する AWS リージョンです。
例えば、次のようになります。
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi
```
### 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-updater.msi codedeploy-agent-updater.msi --region region
```
…*リージョン*はアプリケーションを更新する AWS リージョンです。
例えば、次のようになります。
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region af-south-1
```
# CodeDeploy エージェントをアンインストールする
不要になった場合や、新しいインストールを実行する場合は、インスタンスから CodeDeploy エージェントを削除できます。
## Amazon Linux または RHEL から CodeDeploy エージェントをアンインストールする
CodeDeploy エージェントをアンインストールするには、インスタンスにサインインし、次のコマンドを実行します。
```
sudo yum erase codedeploy-agent
```
## Ubuntu Server から CodeDeploy エージェントをアンインストール
CodeDeploy エージェントをアンインストールするには、インスタンスにサインインし、次のコマンドを実行します。
```
sudo dpkg --purge codedeploy-agent
```
## Windows サーバーから CodeDeploy エージェントをアンインストールする
CodeDeploy エージェントをアンインストールするには、インスタンスにサインインし、次の 3 つのコマンドを 1 つずつ実行します。
```
wmic
```
```
product where name="CodeDeploy Host Agent" call uninstall /nointeractive
```
```
exit
```
または、インスタンスにサインインし、[ **Control Panel (コントロールパネル)** ] で [ **Programs and Features (プログラムと機能)** ] を開き、[ **CodeDeploy Host Agent (CodeDeploy ホストエージェント)** ] を選択してから [ **Uninstall (アンインストール)** ] を選択します。
# CodeDeploy エージェントログを CloudWatch に送信する
CodeDeploy エージェントのメトリクスとログデータを CloudWatch に送信するには、[統合した CloudWatch エージェント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html)、またはより簡単に CloudWatch エージェントを使用します。
以下の手順に従って CloudWatch エージェントをインストールし、CodeDeploy エージェントで使用するように設定します。
## 前提条件
開始する前に、以下のタスクを完了します。
+ CodeDeploy エージェントをインストールし、実行されていることを確認します。詳細については、「[CodeDeploy エージェントをインストールする](codedeploy-agent-operations-install.md)」および「[CodeDeploy エージェントが実行されていることの確認](codedeploy-agent-operations-verify.md)」を参照してください。
+ CloudWatch エージェントをインストールします。詳細については、「[CloudWatch エージェントのインストール](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html)」を参照してください。
+ 次のアクセス権現を CodeDeploy IAM インスタンスプロファイルに追加します。
+ CloudWatchLogsFullAccess
+ CloudWatchAgentServerPolicy
CodeDeploy インスタンスプロファイルの詳細については、[CodeDeploy の開始方法](getting-started-codedeploy.md) の「[ステップ 4: Amazon EC2 インスタンス用の IAM インスタンスプロファイルを作成する](getting-started-create-iam-instance-profile.md)」を参照してください。
## CodeDeploy ログを収集するための CloudWatch エージェントの設定
CloudWatch エージェントは、ウィザードを使用するか、設定ファイルを手動で作成または編集することで設定できます。
**ウィザードを使用して CloudWatch エージェントを設定する (Linux)**
1. 「[CloudWatch エージェント設定ウィザードを実行する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard)」の説明に従ってウィザードを実行します。
1. ウィザードで、`Do you want to monitor any log files?` と表示されたら、**1** と入力します。
1. CodeDeploy エージェントのログファイルを次のように指定します。
1. `Log file path` には、CodeDeploy ログファイルのパス (例: **/var/log/aws/codedeploy-agent/codedeploy-agent.log**) を入力します。
1. `Log group name` には、ロググループ名 (例: **codedeploy-agent-log**) を入力します。
1. `Log stream name` には、ログストリーム名 (例: **\$1instance\$1id\$1-codedeploy-agent-log**) を入力します。
1. `Do you want to specify any additional log files?` と表示されたら、**1** と入力します。
1. CodeDeploy エージェントのデプロイログを次のように指定します。
1. `Log file path` には、CodeDeploy デプロイログファイルのパス (例: **/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**) を入力します。
1. `Log group name` には、ロググループ名 (例: **codedeploy-agent-deployment-log**) を入力します。
1. `Log stream name` には、ログストリーム名 (例: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**) を入力します。
1. `Do you want to specify any additional log files?` と表示されたら、**1** と入力します。
1. CodeDeploy エージェントのアップデータログを次のように指定します。
1. `Log file path` には、CodeDeploy アップデータログファイルのパス (例: **/tmp/codedeploy-agent.update.log**) を入力します。
1. `Log group name` には、ロググループ名 (例: **codedeploy-agent-updater-log**) を入力します。
1. `Log stream name` には、ログストリーム名 (例: **\$1instance\$1id\$1-codedeploy-agent-updater-log**) を入力します。
**ウィザードを使用して CloudWatch エージェントを設定する (Windows)**
1. 「[CloudWatch エージェント設定ウィザードを実行する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard)」の説明に従ってウィザードを実行します。
1. ウィザードで、`Do you want to monitor any customized log files?` と表示されたら、**1** と入力します。
1. CodeDeploy ログファイルを次のように指定します。
1. `Log file path` には、パスまたは CodeDeploy エージェントのログファイル (例: **C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**) を入力します。
1. `Log group name` には、ロググループ名 (例: **codedeploy-agent-log**) を入力します。
1. `Log stream name` には、ログストリーム名 (例: **\$1instance\$1id\$1-codedeploy-agent-log**) を入力します。
1. `Do you want to specify any additional log files?` と表示されたら、**1** と入力します。
1. CodeDeploy エージェントのデプロイログを次のように指定します。
1. `Log file path` には、CodeDeploy デプロイログファイルのパス (例: **C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**) を入力します。
1. `Log group name` には、ロググループ名 (例:**codedeploy-agent-deployment-log**) を入力します。
1. `Log stream name` には、ログストリームの名前 (例: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**) を入力します。
**設定ファイルを手動で作成または編集して CloudWatch エージェントを設定する (Linux)**
1. 「[CloudWatch エージェント設定ファイルを手動で作成または編集する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html)」の説明に従って CloudWatch エージェント設定ファイルを作成または編集します。
1. ファイル名は `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` で、次のコードが含まれていることを確認してください。
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-agent-log"
},
{
"file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
},
{
"file_path": "/tmp/codedeploy-agent.update.log",
"log_group_name": "codedeploy-agent-updater-log",
"log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
}
]
}
}
}
...
```
**設定ファイルを手動で作成または編集して CloudWatch エージェントを設定する (Windows)**
1. 「[CloudWatch エージェント設定ファイルを手動で作成または編集する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html)」の説明に従って CloudWatch エージェント設定ファイルを作成または編集します。
1. ファイル名は `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` で、次のコードが含まれていることを確認してください。
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-codedeploy-agent-log"
},
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
}
]
},
...
}
},
...
```
## CloudWatch エージェントを再起動する
変更を加えたら、「[CloudWatch エージェントを起動する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet)」の説明に従って CloudWatch エージェントを再起動します。