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

# 自動更新の設定
<a name="update-configuration-options"></a>

の使用`appsettings.json`設定ファイルを使用して Microsoft Windows 用 Amazon Kinesis エージェントおよび Windows 用 Kinesis エージェントの設定ファイルに自動更新を有効化します。更新動作を制御するには、設定ファイルで `Sources`、`Sinks`、および `Pipes` と同じレベルで `Plugins` のキーと値のペアを指定します。

`Plugins` のキーと値のペアにより、特にソース、シンク、およびパイプのカテゴリに当てはならない、使用する追加の一般的な機能が指定されます。たとえば、Windows 用の Kinesis エージェントを更新するためのプラグインや`appsettings.json`設定ファイルを作成します。プラグインは、JSON オブジェクトとして表され、常に `Type` のキーと値のペアがあります。`Type` により、プラグインに指定できるその他のキーと値のペアが決定されます。以下のプラグインタイプがサポートされています。

`PackageUpdate`  
Windows 用 Kinesis エージェントがパッケージバージョン設定ファイルを定期的にチェックすることを指定します。パッケージバージョンファイルが、異なるバージョンの Kinesis Agent for Windows をインストールする必要があることを示している場合、Kinesis Agent for Windows はそのバージョンをダウンロードしてインストールします。`PackageUpdate` プラグインのキーと値のペアは次のとおりです。    
`Type`  
値は `PackageUpdate` という文字列である必要があり、必須です。  
`Interval`  
文字列として表される分単位の変更についてパッケージバージョンファイルをチェックする頻度を指定します。このキーと値のペアはオプションです。指定がなければ、デフォルト値は 60 分です。値が 1 より小さい場合、更新のチェックは行われません。  
`PackageVersion`  
パッケージバージョンの JSON ファイルの場所を指定します。ファイルはファイル共有 (`file://`)、ウェブサイト (`http://`)、または Amazon S3 (`s3://`). たとえば、値`s3://mycompany/config/agent-package-version.json`は、Windows 用 Kinesis エージェントが`config/agent-package-version.json`ファイルで`mycompany`Amazon S3 バケット｡ そのファイルの内容に基づいて更新を実行する必要があります。  
の値。`PackageVersion`キーと値のペアは、Amazon S3 では大文字と小文字が区別されます。
以下は、パッケージバージョンファイルの内容の例です。  

```
{
    "Name": "AWSKinesisTap",
    "Version": "1.0.0.106",
    "PackageUrl": "https://s3-us-west-2.amazonaws.com/kinesis-agent-windows/downloads/AWSKinesisTap.{Version}.nupkg"
}
```
-`Version`キーと値のペアは、Kinesis Agent for Windows がまだインストールされていない場合にどのバージョンをインストールするかを指定します。`PackageUrl` の `{Version}` 変数参照は、`Version` キーと値のペアに指定した値を解決します。この例では、変数は文字列 `1.0.0.106` に解決されます。この変数解決は、パッケージバージョンファイル内の特定の目的のバージョンが格納されている場所が 1 つになるように提供されています。複数のパッケージバージョンファイルを使用して、大規模なデプロイの前に新しいバージョンを検証するために Kinesis Agent for Windows の新しいバージョンを導入するペースを制御できます。Windows の Kinesis エージェントデプロイをロールバックするには、1 つ以上のパッケージバージョンファイルを変更して、環境で機能することがわかっている以前のバージョンの Kinesis Agent for Windows を指定します。  
`PackageVersion` キーと値のペアの値は、異なるパッケージバージョンファイルの自動選択を容易にするための変数の置換の影響を受けます。変数の置換の詳細については、「[シンク変数の置換の設定](sink-object-declarations.md#configuring-kinesis-agent-windows-sink-variable-substitution)」を参照してください。  
`AccessKey`  
Amazon S3 のパッケージバージョンファイルへのアクセスを認証するときに使用するアクセスキーを指定します。このキーと値のペアはオプションです。このキーと値のペアを使用することはお勧めしません。推奨される別の認証方法については、「[認証の設定](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication)」を参照してください。  
`SecretKey`  
Amazon S3 のパッケージバージョンファイルへのアクセスを認証するときに使用するシークレットキーを指定します。このキーと値のペアはオプションです。このキーと値のペアを使用することはお勧めしません。推奨される別の認証方法については、「[認証の設定](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication)」を参照してください。  
`Region`  
Amazon S3 からパッケージバージョンファイルにアクセスするときに使用するリージョンエンドポイントを指定します。このキーと値のペアはオプションです。  
`ProfileName`  
Amazon S3 のパッケージバージョンファイルへのアクセスを認証するときに使用するセキュリティプロファイルを指定します。詳細については、「[認証の設定](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication)」を参照してください。このキーと値のペアはオプションです。  
`RoleARN`  
クロスアカウントのシナリオで Amazon S3 のパッケージバージョンファイルへのアクセスを認証するときに引き受けるロールを指定します。詳細については、「[認証の設定](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication)」を参照してください。このキーと値のペアはオプションです。
`PackageUpdate` プラグインが指定されていない場合、アップデートが必要かどうかを判断するためにパッケージバージョンファイルはチェックされません。

`ConfigUpdate`  
Windows 用 Kinesis エージェントが更新された`appsettings.json`設定ファイルが、ファイル共有、ウェブサイト、または Amazon S3 に保存されています。更新された構成ファイルが存在する場合は、Kinesis Agent for Windows によってダウンロードされインストールされます。`ConfigUpdate`キーと値のペアは次のとおりです。    
`Type`  
値は `ConfigUpdate` という文字列である必要があり、必須です。  
`Interval`  
文字列として表される新しい設定ファイルをチェックする頻度を分単位で指定します。このキーと値のペアはオプションです。指定されていない場合、デフォルトは 5 分です。値が 1 より小さい場合は、設定ファイルの更新は確認されません。  
`Source`  
更新された設定ファイルを検索する場所を指定します。ファイルはファイル共有 (`file://`)、ウェブサイト (`http://`)、または Amazon S3 (`s3://`). たとえば、値`s3://mycompany/config/appsettings.json`は、Windows 用 Kinesis エージェントが`config/appsettings.json`ファイルで`mycompany`Amazon S3 バケット｡  
の値。`Source`Amazon S3 では、キーと値のペアで大文字と小文字が区別されます。
`Source` キーと値のペアの値は、異なる設定ファイルの自動選択を容易にするための変数の置換の影響を受けます。変数の置換の詳細については、「[シンク変数の置換の設定](sink-object-declarations.md#configuring-kinesis-agent-windows-sink-variable-substitution)」を参照してください。  
`Destination`  
ローカルマシンの設定ファイルの保存場所を指定します。これは、相対パス、絶対パス、または `%PROGRAMDATA%` などの環境変数参照を含むパスです。パスが相対パスの場合は、Kinesis Agent for Windows がインストールされている場所に対する相対パスです。通常、値は `.\appsettings.json` である必要があります。このキーと値のペアは必須です。  
`AccessKey`  
Amazon S3 の設定ファイルへのアクセスを認証するときに使用するアクセスキーを指定します。このキーと値のペアはオプションです。このキーと値のペアを使用することはお勧めしません。推奨される別の認証方法については、「[認証の設定](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication)」を参照してください。  
`SecretKey`  
Amazon S3 の設定ファイルへのアクセスを認証するときに使用するシークレットキーを指定します。このキーと値のペアはオプションです。このキーと値のペアを使用することはお勧めしません。推奨される別の認証方法については、「[認証の設定](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication)」を参照してください。  
`Region`  
Amazon S3 から設定ファイルにアクセスするときに使用するリージョンエンドポイントを指定します。このキーと値のペアはオプションです。  
`ProfileName`  
Amazon S3 の設定ファイルへのアクセスを認証するときに使用するセキュリティプロファイルを指定します。詳細については、「[認証の設定](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication)」を参照してください。このキーと値のペアはオプションです。  
`RoleARN`  
クロスアカウントのシナリオで Amazon S3 の設定ファイルへのアクセスを認証するときに引き受けるロールを指定します。詳細については、「[認証の設定](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication)」を参照してください。このキーと値のペアはオプションです。
`ConfigUpdate` プラグインが指定されていない場合、設定ファイルの更新が必要かどうかを判断するために設定ファイルはチェックされません。

以下は、`PackageUpdate` および `ConfigUpdate` プラグインの使用方法を示す `appsettings.json` 設定ファイルの例です。この例では、パッケージバージョンファイルが`mycompany`Amazon S3 バケットという名前の`config/agent-package-version.json`。このファイルは、約 2 時間ごとに変更がないかチェックされます。パッケージバージョンファイルで Kinesis Agent for Windows の異なるバージョンが指定されている場合、指定されたエージェントバージョンはパッケージバージョンファイル内の指定された場所からインストールされます。

また、`appsettings.json`設定ファイルが`mycompany`Amazon S3 バケットという名前の`config/appsettings.json`。約 30 分ごとに、そのファイルは現在の設定ファイルと比較されます。異なる場合は、更新された構成ファイルが Amazon S3 からダウンロードされ、`appsettings.json`設定ファイルを作成します。

```
{
  "Sources": [
    {
      "Id": "ApplicationLogSource",
      "SourceType": "DirectorySource",
      "Directory": "C:\\LogSource\\",
      "FileNameFilter": "*.log",
      "RecordParser": "SingleLine"
    }
  ],
  "Sinks": [
    {
       "Id": "ApplicationLogKinesisFirehoseSink",
       "SinkType": "KinesisFirehose",
       "StreamName": "ApplicationLogFirehoseDeliveryStream",
       "Region": "us-east-1"
    }  
    ],
  "Pipes": [
    {
      "Id": "ApplicationLogSourceToApplicationLogKinesisFirehoseSink",
      "SourceRef": "ApplicationLogSource",
      "SinkRef": "ApplicationLogKinesisFirehoseSink"
    }
  ],
  "Plugins": [
    {
      "Type": "PackageUpdate"
      "Interval": "120",
      "PackageVersion": "s3://mycompany/config/agent-package-version.json"
    },
    {
      "Type": "ConfigUpdate",
      "Interval": "30", 
      "Source": "s3://mycompany/config/appsettings.json",
      "Destination": ".\appSettings.json"      
    }
  ]
}
```