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à. # In che modo Image Builder utilizza l' AWS Task Orchestrator and Executor applicazione per gestire i componenti EC2 Image Builder utilizza l'applicazione AWS Task Orchestrator and Executor (AWSTOE) per orchestrare flussi di lavoro complessi, modificare le configurazioni di sistema e testare le immagini senza la necessità di script o codice DevOps aggiuntivi. Questa applicazione gestisce ed esegue componenti che implementano lo schema dichiarativo del documento. AWSTOE è un'applicazione autonoma che Image Builder installa nelle sue istanze di build e test quando si crea un'immagine. È inoltre possibile installarla manualmente sulle EC2 istanze per creare componenti personalizzati. Non richiede alcuna configurazione aggiuntiva e può essere eseguito anche in locale. **Topics** + [AWSTOE scarica](#toe-downloads) + [Regioni supportate](#toe-supported-regions) + [AWSTOE riferimento al comando](#toe-commands) + [Configurazione manuale per sviluppare componenti personalizzati con AWSTOE](toe-get-started.md) + [Usa il framework AWSTOE dei documenti dei componenti per i componenti personalizzati](toe-use-documents.md) + [Moduli di azione supportati dal gestore AWSTOE dei componenti](toe-action-modules.md) + [Configurare l'input per il comando AWSTOE run](toe-run-config-input.md) ## AWSTOE scarica Per l'installazione AWSTOE, scegli il link per il download adatto alla tua architettura e piattaforma. Se ti colleghi a un endpoint VPC per il tuo servizio (Image Builder, ad esempio), devi allegare una policy endpoint personalizzata che includa l'accesso al bucket S3 per i download. AWSTOE In caso contrario, le istanze di build e test non saranno in grado di scaricare lo script bootstrap () e installare l'applicazione. `bootstrap.sh` AWSTOE Per ulteriori informazioni, consulta [Crea una policy per gli endpoint VPC per Image Builder](vpc-interface-endpoints.md#vpc-endpoint-policy). **Importante** AWS sta eliminando gradualmente il supporto per le versioni TLS 1.0 e 1.1. Per accedere al bucket S3 per i AWSTOE download, il software client deve utilizzare la versione TLS 1.2 o successiva. Per ulteriori informazioni, consulta questo post sul blog [AWS sulla sicurezza](https://aws.amazon.com/blogs/security/tls-1-2-required-for-aws-endpoints/). | Architettura | Piattaforma | Collegamento per il download | Esempio | | --- | --- | --- | --- | | 386 | AL 2 e 2023
RHEL 7, 8 e 9
Ubuntu 16.04, 18.04, 20.04, 22.04 e 24.04
CentOS 7 e 8
SUSE 12 e 15 | `https://awstoe-.s3..amazonaws.com/latest/linux/386/awstoe` | [https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/386/awstoe](https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/386/awstoe) | | AMD64 | AL 2 e 2023
RHEL 7, 8 e 9
Ubuntu 16.04, 18.04, 20.04, 22.04 e 24.04
CentOS 7 e 8
CentOS Stream 8
SUSE 12 e 15 | https://awstoe-.s3..amazonaws.com/latest/linux/amd64/awstoe | [https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/amd64/awstoe](https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/amd64/awstoe) | | AMD64 | macOS 10.14.x (Mojave), 10.15.x (Catalina), 11.x (Big Sur), 12.x (Monterey) | https://awstoe-{{region}}.s3.{{region}}.amazonaws.com/latest/darwin/amd64/awstoe | [https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/darwin/amd64/awstoe](https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/darwin/amd64/awstoe) | | AMD64 | Windows Server 2012 R2, 2016, 2019 e 2022 | `https://awstoe-.s3..amazonaws.com/latest/windows/amd64/awstoe.exe` | [https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/windows/amd64/awstoe.exe](https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/windows/amd64/awstoe.exe) | | ARM64 | AL 2 e 2023
RHEL 7, 8 e 9
Ubuntu 16.04, 18.04, 20.04, 22.04 e 24.04
CentOS 7 e 8
CentOS Stream 8
SUSE 12 e 15 | https://awstoe-.s3..amazonaws.com/latest/linux/arm64/awstoe | [https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/arm64/awstoe](https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/arm64/awstoe) | ## Regioni supportate AWSTOE è supportata come applicazione autonoma nelle seguenti regioni. | Regione AWS nome | Regione AWS | | --- | --- | | Stati Uniti orientali (Ohio) | us-east-2 | | US East (N. Virginia) | us-east-1 | | AWS GovCloud (Stati Uniti orientali) | us-gov-east-1 | | AWS GovCloud (Stati Uniti occidentali) | us-gov-west-1 | | US West (N. California) | us-west-1 | | US West (Oregon) | us-west-2 | | Africa (Cape Town) | af-south-1 | | Asia Pacifico (Hong Kong) | ap-east-1 | | Asia Pacifico (Osaka-Locale) | ap-northeast-3 | | Asia Pacifico (Seoul) | ap-northeast-2 | | Asia Pacifico (Mumbai) | ap-south-1 | | Asia Pacific (Hyderabad) | ap-south-2 | | Asia Pacific (Singapore) | ap-southeast-1 | | Asia Pacific (Sydney) | ap-southeast-2 | | Asia Pacifico (Giacarta) | ap-southeast-3 | | Asia Pacifico (Tokyo) | ap-northeast-1 | | Canada (Central) | ca-central-1 | | Europa (Francoforte) | eu-central-1 | | Europa (Zurigo) | eu-central-2 | | Europa (Stoccolma) | eu-north-1 | | Europa (Milano) | eu-south-1 | | Europa (Spagna) | eu-south-2 | | Europa (Irlanda) | eu-west-1 | | Europe (London) | eu-west-2 | | Europe (Paris) | eu-west-3 | | Israele (Tel Aviv) | il-central-1 | | Medio Oriente (Emirati Arabi Uniti) | me-central-1 | | Medio Oriente (Bahrein) | me-south-1 | | Sud America (São Paulo) | sa-east-1 | | China (Beijing) | cn-north-1 | | China (Ningxia) | cn-northwest-1 | ## AWSTOE riferimento al comando AWSTOE è un'applicazione di gestione dei componenti a riga di comando che viene eseguita su EC2 istanze Amazon. Quando Image Builder avvia un'istanza di EC2 build o di test, viene installata sull'istanza. AWSTOE Quindi esegue AWSTOE i comandi AWS CLI per installare o convalidare i componenti specificati nell'immagine o nella ricetta del contenitore. **Nota** Alcuni moduli di AWSTOE azione richiedono autorizzazioni elevate per essere eseguiti su un server Linux. Per utilizzare autorizzazioni elevate, inserisci come prefisso la sintassi del comando o esegui **sudo** il **sudo su** comando una sola volta quando accedi prima di eseguire i comandi collegati di seguito. Per ulteriori informazioni sui moduli di AWSTOE azione, vedere. [Moduli di azione supportati dal gestore AWSTOE dei componenti](toe-action-modules.md) ***[run](#cmd-run)*** Utilizzate il **run** comando per eseguire gli script dei documenti YAML per uno o più documenti componenti. ***[validate](#cmd-validate)*** Esegui il **validate** comando per convalidare la sintassi del documento YAML per uno o più documenti componenti. ### comando awstoe run Questo comando esegue gli script dei documenti dei componenti YAML nell'ordine in cui sono inclusi nel file di configurazione specificato dal `--config` parametro o nell'elenco dei documenti dei componenti specificato dal parametro. `--documents` **Nota** È necessario specificare esattamente uno dei seguenti parametri, mai entrambi: --config --documenti #### Sintassi ``` awstoe run [--config ] [--cw-ignore-failures ] [--cw-log-group ] [--cw-log-region {{us-west-2}}] [--cw-log-stream ] [--document-s3-bucket-owner ] [--documents ] [--execution-id ] [--log-directory ] [--log-s3-bucket-name ] [--log-s3-bucket-owner ] [--log-s3-key-prefix ] [--parameters {{name1}}={{value1}},{{name2}}={{value2}}...] [--phases ] [--state-directory ] [--version ] [--help] [--trace] ``` #### Parametri e opzioni Parametri **--config {{`./config-example.json`}}** Forma breve: -c {{`./config-example.json`}} Il file di configurazione *(condizionale*). Questo parametro contiene la posizione del file JSON che contiene le impostazioni di configurazione per i componenti in esecuzione con questo comando. Se si specificano le impostazioni dei **run** comandi in un file di configurazione, non è necessario specificare il `--documents` parametro. Per ulteriori informazioni sulla configurazione degli input, vedere[Configurare l'input per il comando AWSTOE run](toe-run-config-input.md). Le località valide includono: + Un percorso di file locale ({{`./config-example.json`}}) + Un URI S3 () `s3://{{bucket/key}}` **--cw-ignore-failures** Forma breve: N/A Ignora gli errori di registrazione nei registri. CloudWatch **--cw-log-group** Forma breve: N/A Il `LogGroup` nome dei registri. CloudWatch **--cw-log-region** Forma breve: N/A La AWS regione che si applica ai registri. CloudWatch **--cw-log-stream** Forma breve: N/A Il `LogStream` nome dei CloudWatch log, che indica AWSTOE dove trasmettere il file. `console.log` **--document-s3-bucket-owner** Forma breve: N/A L'ID dell'account del proprietario del bucket per i documenti basati su URI S3. **--documenti {{`./doc-1.yaml`,`./doc-n.yaml`}}** Forma breve: -d, {{`./doc-1.yaml`}} {{`./doc-n`}} I documenti componenti *(condizionali*). Questo parametro contiene un elenco separato da virgole di posizioni di file per l'esecuzione dei documenti del componente YAML. Se si specificano documenti YAML per il **run** comando utilizzando il `--documents` parametro, non è necessario specificare il parametro. `--config` Le posizioni valide includono: + percorsi di file locali ({{./component-doc-example.yaml}}). + S3 URIs (`s3://{{bucket/key}}`). + Versione di build del componente Image Builder ARNs (arn:aws:imagebuilder:us-west--- /2021.12.02/1). {{2:123456789012}} {{my-example-component}} Non ci sono spazi tra gli elementi nell'elenco, solo virgole. **--execution-id** Forma breve: -i Questo è l'ID univoco che si applica all'esecuzione del **run** comando corrente. Questo ID è incluso nei nomi dei file di output e di registro, per identificare in modo univoco tali file e collegarli all'esecuzione corrente del comando. Se questa impostazione viene omessa, AWSTOE genera un GUID. **--log-directory** Forma breve: -l La directory di destinazione in cui vengono AWSTOE archiviati tutti i file di registro dell'esecuzione di questo comando. Per impostazione predefinita, questa directory si trova all'interno della seguente directory principale:`TOE__`. Se non si specifica la directory di registro, AWSTOE utilizza la directory di lavoro corrente (`.`). **--log-s3-bucket-name** Forma breve: -b Se i log dei componenti sono archiviati in Amazon S3 (consigliato) AWSTOE , carica i log delle applicazioni dei componenti nel bucket S3 indicato in questo parametro. **--log-s3-bucket-owner** Forma breve: N/A Se i log dei componenti sono archiviati in Amazon S3 (consigliato), questo è l'ID dell'account proprietario per il bucket AWSTOE in cui vengono scritti i file di registro. **--log-s3-key-prefix** Forma breve: -k Se i log dei componenti sono archiviati in Amazon S3 (consigliato), questo è il prefisso della chiave oggetto S3 per la posizione del registro nel bucket. **--parameters =, =... {{name1}} {{value1}} {{name2}} {{value2}}** Forma breve: N/A I parametri sono variabili mutabili definite nel documento del componente, con impostazioni che l'applicazione chiamante può fornire in fase di esecuzione. **--phases** Forma breve: -p Un elenco separato da virgole che specifica quali fasi eseguire dai documenti del componente YAML. Se un documento componente include fasi aggiuntive, queste non verranno eseguite. **--state-directory** Forma breve: -s Il percorso del file in cui sono archiviati i file di tracciamento dello stato. **--versione** Forma breve: -v Specifica la versione dell'applicazione del componente.Opzioni **--help** Forma breve: -h Visualizza un manuale di aiuto per l'utilizzo delle opzioni dell'applicazione di gestione dei componenti. **--trace** Forma breve: -t Abilita la registrazione dettagliata sulla console. ### comando awstoe validate Quando si esegue questo comando, convalida la sintassi del documento YAML per ciascuno dei documenti componenti specificati dal parametro. `--documents` #### Sintassi ``` awstoe validate [--document-s3-bucket-owner ] --documents [--help] [--trace] ``` #### Parametri e opzioni Parametri **--document-s3-bucket-owner** Forma breve: N/A ID dell'account di origine dei documenti basati sull'URI S3 fornito. **--documenti {{`./doc-1.yaml`,`./doc-n.yaml`}}** Forma breve: -d, {{`./doc-1.yaml`}} {{`./doc-n`}} I documenti che lo compongono *(obbligatorio).* Questo parametro contiene un elenco separato da virgole delle posizioni dei file in cui eseguire i documenti del componente YAML. Le posizioni valide includono: + percorsi di file locali ({{./component-doc-example.yaml}}) + S3 URIs () `s3://{{bucket/key}}` + Versione di build del componente Image Builder ARNs (arn:aws:imagebuilder:us-west-527/ /2021.12.02/1) {{2:123456789012}} {{my-example-component}} Non ci sono spazi tra gli elementi nell'elenco, solo virgole.Opzioni **--help** Forma breve: -h Visualizza un manuale di aiuto per l'utilizzo delle opzioni dell'applicazione di gestione dei componenti. **--trace** Forma breve: -t Abilita la registrazione dettagliata sulla console.