CodeDeploy エージェント設定リファレンス - AWS CodeDeploy

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

CodeDeploy エージェント設定リファレンス

CodeDeploy エージェントをインストールすると、設定ファイルがインスタンスに配置されます。この設定ファイルでは、 がインスタンスとやり取りするときに CodeDeploy 使用するディレクトリパスやその他の設定を指定します。ファイルの一部の設定オプションは変更できます。

Amazon Linux、Ubuntu Server、Red Hat Enterprise Linux (RHEL) インスタンスの場合、設定ファイルの名前は、codedeployagent.yml です。ファイルは、/etc/codedeploy-agent/conf ディレクトリに配置されます。

Windows Server インスタンスの場合、設定ファイルは conf.yml という名前になります。ファイルは、C:\ProgramData\Amazon\CodeDeploy ディレクトリに配置されます。

設定には以下が含まれます。

:log_aws_wire:

true CodeDeploy エージェントが Amazon S3 からワイヤログをキャプチャし、:log_dir: 設定で指定されたcodedeploy-agent.wire.log場所に という名前のファイルに書き込むには、 に設定します。

警告

ワイヤログの取得に必要な時間のみ、:log_aws_wire:true に設定する必要があります。codedeploy-agent.wire.log ファイルは非常に大きなサイズになる場合があります。このファイルのワイヤログ出力には、この設定が true に設定されている間に Amazon S3 との間で転送されたファイルのプレーンテキストの内容などの重要情報が含まれている場合があります。ワイヤログには、 AWS CodeDeploy デプロイに関連するアクティビティだけでなくtrue、この設定が に設定されている間、アカウントに関連付けられたすべての Amazon S3 アクティビティに関する情報が含まれます。

デフォルトの設定は、false です。

この設定は、すべてのインスタンスタイプに適用されます。この設定を使用できるようにするには、この設定を Windows サーバーインスタンスに追加する必要があります。

:log_dir:

CodeDeploy エージェントオペレーションに関連するログファイルが保存されているインスタンス上のフォルダ。

デフォルトの設定は、Amazon Linux、Ubuntu Server、RHEL インスタンス用の '/var/log/aws/codedeploy-agent'、および Windows Server インスタンス用の C:\ProgramData\Amazon\CodeDeploy\log です。

:pid_dir:

codedeploy-agent.pid が保存されているフォルダ。

このファイルには、 CodeDeploy エージェントのプロセス ID (PID) が含まれています。デフォルトの設定は、'/opt/codedeploy-agent/state/.pid' です。

この設定は、Amazon Linux、Ubuntu Server、RHEL インスタンスにのみ適用されます。

:program_name:

CodeDeploy エージェントプログラム名。

デフォルトの設定は、codedeploy-agent です。

この設定は、Amazon Linux、Ubuntu Server、RHEL インスタンスにのみ適用されます。

:root_dir:

関連するリビジョン、デプロイ履歴、およびインスタンスのデプロイスクリプトが保存されるフォルダ。

デフォルトの設定は、Amazon Linux、Ubuntu Server、RHEL インスタンス用の /opt/codedeploy-agent/deployment-root、および Windows Server インスタンス用の C:\ProgramData\Amazon\CodeDeploy です。

:verbose:

CodeDeploy エージェントがインスタンスtrueにデバッグメッセージのログファイルを出力するには、 に設定します。

デフォルトの設定は、false です。

:wait_between_runs:

保留中のデプロイ CodeDeploy の の CodeDeploy エージェントポーリング間隔を秒単位で表します。

デフォルトの設定は、1 です。

:on_premises_config_file:

オンプレミスインスタンスの場合、codedeploy.onpremises.yml ( Ubuntu Server および RHEL の場合)、または conf.onpremises.yml (Windows Server の場合) という名前の設定ファイルの別の場所へのパスです。

デフォルトでは、これらのファイルは Ubuntu Server および RHEL の場合は /etc/codedeploy-agent/conf/codedeploy.onpremises.yml、 Windows Server の場合は C:\ProgramData\Amazon\CodeDeployconf.onpremises.yml に保存されます。

エージェントのバージョン 1.0.1.686 以降で使用できます CodeDeploy。

:proxy_uri:

(オプション) CodeDeploy オペレーション AWS のために CodeDeploy エージェントが接続する HTTP プロキシ。https://user:password@my.proxy:443/path?query のような形式を使用します。

エージェントのバージョン 1.0.1.824 以降で使用できます CodeDeploy。

:max_revisions:

(オプション) CodeDeploy エージェントがアーカイブするデプロイグループのアプリケーションリビジョンの数。指定された数を超えるリビジョンは削除されます。

正の整数を入力します。値を指定しない場合、 は、現在デプロイされているリビジョンに加えて、最新の 5 つのリビジョン CodeDeploy を保持します。

エージェントのバージョン 1.0.1.966 以降でサポートされています CodeDeploy。

:enable_auth_policy:

(オプション) IAM 認証を使用してアクセスコントロールを設定し、 CodeDeploy エージェントが使用している IAM ロールまたはユーザーのアクセス許可を制限するtrue場合は、 に設定します。Amazon Virtual Private Cloud CodeDeploy で を使用する にするには、この値は、true である必要があります。

デフォルトの設定は、false です。

:disable_imds_v1:

この設定は、 CodeDeploy エージェント 1.7.0 以降で使用できます。

IMDSv2 エラーが発生したときに IMDSv1 へのフォールバックを無効にするtrueには、 に設定します。 IMDSv2 デフォルトは です false (フォールバックを有効にします)。

CodeDeploy エージェントの使用

CodeDeploy エージェントオペレーションの管理