Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Configurazione di aggiornamenti automatici Utilizzo dell'`appsettings.json`File di configurazione per abilitare gli aggiornamenti automatici di Amazon Kinesis Agent per Microsoft Windows e il file di configurazione per Kinesis Agent per Windows. Per controllare il comportamento di aggiornamento, specificare la coppia chiave-valore `Plugins` allo stesso livello nel file di configurazione di `Sources`, `Sinks` e `Pipes`. La coppia chiave-valore `Plugins` specifica le funzionalità generali aggiuntive da utilizzare che non rientrano specificamente nelle categorie di origini, sink e pipe. Ad esempio, c'è un plug-in per l'aggiornamento di Kinesis Agent per Windows e c'è un plug-in per l'aggiornamento del file`appsettings.json`File di configurazione. I plug-in sono rappresentati come oggetti JSON e hanno sempre a disposizione una coppia chiave-valore `Type`. `Type` definisce le altre coppie chiave-valore che possono essere specificate per il plug-in. Sono supportati i seguenti tipi di plug-in: `PackageUpdate` Specifica che Kinesis Agent per Windows deve controllare periodicamente un file di configurazione della versione del pacchetto. Se il file della versione del pacchetto indica che deve essere installata un'altra versione di Kinesis Agent per Windows, allora Kinesis Agent per Windows scarica tale versione e la installa. Le coppie chiave-valore del plug-in `PackageUpdate` includono: `Type` Il valore deve essere la stringa `PackageUpdate` ed è obbligatorio. `Interval` Specifica la frequenza con cui verificare il file della versione del pacchetto per eventuali modifiche in pochi minuti rappresentate come stringa. Questa coppia chiave-valore è facoltativa. Se non specificato, il valore predefinito è 60 minuti. Se il valore è inferiore a 1, non è possibile verificare gli aggiornamenti. `PackageVersion` Specifica la posizione del file JSON della versione del pacchetto. Il file può risiedere su una condivisione di file (`file://`), un sito web (`http://`), o Amazon S3 (`s3://`). Ad esempio, un valore compreso tra e rappresenta`s3://mycompany/config/agent-package-version.json`indica che Kinesis Agent per Windows deve controllare il contenuto della`config/agent-package-version.json`file nel file`mycompany`Bucket Amazon S3. È necessario eseguire gli aggiornamenti in base al contenuto del file. Il valore della proprietà`PackageVersion`coppia chiave-valore effettua la distinzione tra maiuscole Amazon S3 uscole Di seguito è riportato un esempio dei contenuti di un file della versione di un pacchetto: ``` { "Name": "AWSKinesisTap", "Version": "1.0.0.106", "PackageUrl": "https://s3-us-west-2.amazonaws.com/kinesis-agent-windows/downloads/AWSKinesisTap.{Version}.nupkg" } ``` La`Version`Specifica la versione di Kinesis Agent per Windows da installare se non è già installata. La variabile di riferimento `{Version}` in `PackageUrl` risolve il valore specificato per la coppia chiave-valore `Version`. In questo esempio, la variabile restituisce la stringa `1.0.0.106`. Questa risoluzione di variabile viene fornita in modo che ci sia un'unica posizione della versione del pacchetto di file laddove la versione desiderata specificata viene memorizzata. È possibile utilizzare più file della versione del pacchetto per controllare il ritmo di implementazione di nuove versioni di Kinesis Agent per Windows e convalidare una nuova versione prima di un'implementazione di dimensioni maggiori. Per eseguire il rollback di una distribuzione di Kinesis Agent per Windows, modificare uno o più file della versione del pacchetto per specificare una versione precedente di Kinesis Agent per Windows che funziona correttamente nell'ambiente. Il valore della coppia chiave-valore `PackageVersion` subisce la sostituzione delle variabili per facilitare la selezione automatica dei file della versione di pacchetti differenti. Per ulteriori informazioni sulla sostituzione delle variabili, consulta [Configurazione di sostituzione di variabili sink](sink-object-declarations.md#configuring-kinesis-agent-windows-sink-variable-substitution). `AccessKey` Specifica la chiave di accesso da utilizzare per autenticare l'accesso al file della versione del pacchetto in Amazon S3. Questa coppia chiave-valore è facoltativa. Non è consigliabile utilizzare questa coppia chiave-valore. Per gli approcci di autenticazione alternativi raccomandati, consulta [Configurazione dell'autenticazione](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication). `SecretKey` Specifica la chiave segreta da utilizzare per autenticare l'accesso al file della versione del pacchetto in Amazon S3. Questa coppia chiave-valore è facoltativa. Non è consigliabile utilizzare questa coppia chiave-valore. Per gli approcci di autenticazione alternativi raccomandati, consulta [Configurazione dell'autenticazione](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication). `Region` Specifica l'endpoint della regione da utilizzare per accedere al file della versione del pacchetto da Amazon S3. Questa coppia chiave-valore è facoltativa. `ProfileName` Specifica il profilo di sicurezza da utilizzare per autenticare l'accesso al file della versione del pacchetto in Amazon S3. Per ulteriori informazioni, consulta [Configurazione dell'autenticazione](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication). Questa coppia chiave-valore è facoltativa. `RoleARN` Specifica quale ruolo assumere durante l'autenticazione dell'accesso al file della versione del pacchetto in Amazon S3 in uno scenario tra più account. Per ulteriori informazioni, consulta [Configurazione dell'autenticazione](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication). Questa coppia chiave-valore è facoltativa. Se nessun plug-in `PackageUpdate` viene specificato, allora nessun file della versione del pacchetto viene controllato per stabilire se un aggiornamento è obbligatorio. `ConfigUpdate` Specifica che Kinesis Agent per Windows deve controllare periodicamente la presenza di`appsettings.json`File di configurazione archiviato in una condivisione di file, sito Web o Amazon S3. Se un file di configurazione aggiornato esiste, viene scaricato e installato da Kinesis Agent per Windows.`ConfigUpdate`Le coppie chiave-valore includono quanto segue: `Type` Il valore deve essere la stringa `ConfigUpdate` ed è obbligatorio. `Interval` Specifica la frequenza con cui verificare un nuovo file di configurazione in pochi minuti rappresentato come stringa. Questa coppia chiave-valore è facoltativa e, se non è specificato, il valore predefinito sarà 5 minuti. Se il valore è inferiore a 1, l'aggiornamento del file di configurazione non viene selezionato. `Source` Specifica dove cercare un file di configurazione aggiornato. Il file può risiedere su una condivisione di file (`file://`), un sito web (`http://`), o Amazon S3 (`s3://`). Ad esempio, un valore compreso tra e rappresenta`s3://mycompany/config/appsettings.json`indica che Kinesis Agent per Windows deve verificare la disponibilità di aggiornamenti per`config/appsettings.json`file nel file`mycompany`Bucket Amazon S3. Il valore della proprietà`Source`Specifica la distinzione tra maiuscole e minuscole per Amazon S3. Il valore della coppia chiave-valore `Source` subisce la sostituzione delle variabili per facilitare la selezione automatica di file di configurazione differenti. Per ulteriori informazioni sulla sostituzione delle variabili, consulta [Configurazione di sostituzione di variabili sink](sink-object-declarations.md#configuring-kinesis-agent-windows-sink-variable-substitution). `Destination` Specifica dove archiviare il file di configurazione nel computer locale. Questo può essere un percorso relativo, un percorso assoluto o un percorso contenente riferimenti a variabili di ambiente, ad esempio `%PROGRAMDATA%`. Se il percorso è relativo, è relativo al percorso in cui è installato Kinesis Agent per Windows. In genere, il valore deve essere `.\appsettings.json`. Questa coppia chiave-valore è obbligatoria. `AccessKey` Specifica la chiave di accesso da utilizzare per autenticare l'accesso al file di configurazione in Amazon S3. Questa coppia chiave-valore è facoltativa. Non è consigliabile utilizzare questa coppia chiave-valore. Per gli approcci di autenticazione alternativi raccomandati, consulta [Configurazione dell'autenticazione](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication). `SecretKey` Specifica la chiave segreta da utilizzare per autenticare l'accesso al file di configurazione in Amazon S3. Questa coppia chiave-valore è facoltativa. Non è consigliabile utilizzare questa coppia chiave-valore. Per gli approcci di autenticazione alternativi raccomandati, consulta [Configurazione dell'autenticazione](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication). `Region` Specifica l'endpoint della regione da utilizzare per accedere al file di configurazione da Amazon S3. Questa coppia chiave-valore è facoltativa. `ProfileName` Specifica il profilo di sicurezza da utilizzare per autenticare l'accesso al file di configurazione in Amazon S3. Per ulteriori informazioni, consulta [Configurazione dell'autenticazione](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication). Questa coppia chiave-valore è facoltativa. `RoleARN` Specifica quale ruolo assumere durante l'autenticazione dell'accesso al file di configurazione in Amazon S3 in uno scenario tra più account. Per ulteriori informazioni, consulta [Configurazione dell'autenticazione](sink-object-declarations.md#configuring-kinesis-agent-windows-authentication). Questa coppia chiave-valore è facoltativa. Se nessun plug-in `ConfigUpdate` viene specificato, allora nessun file di configurazione viene controllato per stabilire se un aggiornamento del file di configurazione è obbligatorio. Il seguente file di configurazione di esempio `appsettings.json` dimostra l'utilizzo dei plug-in `PackageUpdate` e `ConfigUpdate`. In questo esempio, c'è un file della versione del pacchetto che si trova nel file`mycompany`Bucket Amazon S3 denominato`config/agent-package-version.json`: . Questo file è selezionato per eventuali modifiche circa ogni 2 ore. Se un'altra versione di Kinesis Agent per Windows è specificata nel file della versione del pacchetto, la versione dell'agente specificata viene installata dal percorso specificato nel file della versione del pacchetto. Inoltre, c'è un file`appsettings.json`file di configurazione archiviato nel file`mycompany`Bucket Amazon S3 denominato`config/appsettings.json`: . Circa ogni 30 minuti, il file viene confrontato con l'attuale file di configurazione. Se sono diversi, il file di configurazione aggiornato viene scaricato da Amazon S3 e installato nel percorso locale tipico per il file`appsettings.json`File di configurazione. ``` { "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" } ] } ```