Como o Image Builder usa o AWS Task Orchestrator and Executor aplicativo para gerenciar componentes - EC2Image Builder
AWSTOE downloadsRegiões compatíveisReferência de comando

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como o Image Builder usa o AWS Task Orchestrator and Executor aplicativo para gerenciar componentes

EC2O Image Builder usa o aplicativo AWS Task Orchestrator and Executor (AWSTOE) para orquestrar fluxos de trabalho complexos, modificar configurações do sistema e testar suas imagens sem a necessidade de scripts ou códigos adicionais de DevOps. Este aplicativo gerencia e executa componentes que implementam seu esquema de documento declarativo.

AWSTOE é um aplicativo independente que o Image Builder instala em suas instâncias de compilação e teste quando você cria uma imagem. Você também pode instalá-lo manualmente nas EC2 instâncias para criar seus próprios componentes personalizados. Ele não requer nenhuma configuração adicional e também pode ser executado localmente.

Conteúdo

AWSTOE downloads

Para instalar AWSTOE, escolha o link de download para sua arquitetura e plataforma. Se você se conectar a um VPC endpoint do seu serviço (Image Builder, por exemplo), ele deverá ter uma política de endpoint personalizada anexada que inclua acesso ao bucket do S3 para downloads. AWSTOE Caso contrário, suas instâncias de compilação e teste não poderão baixar o script bootstrap (bootstrap.sh) e instalar o AWSTOE aplicativo. Para ter mais informações, consulte Crie uma política de VPC endpoint para o Image Builder.

Importante

AWS está eliminando gradualmente o suporte para TLS as versões 1.0 e 1.1. Para acessar o bucket do S3 para AWSTOE downloads, seu software cliente deve usar a TLS versão 1.2 ou posterior. Para obter mais informações, consulte esta publicação do blog de Segurança da AWS.

Arquitetura Plataforma Link para fazer download Exemplo

386

AL 2 e 2023

RHEL7, 8 e 9

Ubuntu 16.04, 18.04, 20.04, 22.04 e 24.04

CentOS 7 e 8

SUSE12 e 15

https://awstoe-<region>.s3.<region>.amazonaws.com/latest/linux/386/awstoe

 https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/386/awstoe

AMD64

Windows Server 2012 R2, 2016, 2019 e 2022

https://awstoe-<region>.s3.<region>.amazonaws.com/latest/windows/amd64/awstoe.exe

 https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/windows/amd64/awstoe.exe

AMD64

AL 2 e 2023

RHEL7, 8 e 9

Ubuntu 16.04, 18.04, 20.04, 22.04 e 24.04

CentOS 7 e 8

CentOS Stream 8

SUSE12 e 15

 https://awstoe-<region>.s3.<region>.amazonaws.com/latest/linux/amd64/awstoe https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/amd64/awstoe
ARM64

AL 2 e 2023

RHEL7, 8 e 9

Ubuntu 16.04, 18.04, 20.04, 22.04 e 24.04

CentOS 7 e 8

CentOS Stream 8

SUSE12 e 15

 https://awstoe-<region>.s3.<region>.amazonaws.com/latest/linux/arm64/awstoe https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/arm64/awstoe

Regiões compatíveis

AWSTOE é suportado como um aplicativo independente nas seguintes regiões.

Região da AWS nome Região da AWS

Leste dos EUA (Ohio)

us-east-2

Leste dos EUA (N. da Virgínia)

us-east-1

AWS GovCloud (Leste dos EUA)

us-gov-east-1

AWS GovCloud (Oeste dos EUA)

us-gov-west-1

Oeste dos EUA (N. da Califórnia)

 us-west-1

Oeste dos EUA (Oregon)

 us-west-2

África (Cidade do Cabo)

 af-south-1

Ásia-Pacífico (Hong Kong)

 ap-east-1

Ásia-Pacífico (Osaka)

 ap-northeast-3

Ásia-Pacífico (Seul)

 ap-northeast-2

Ásia Pacífico (Mumbai)

 ap-south-1

Ásia-Pacífico (Hyderabad)

 ap-south-2

Ásia-Pacífico (Singapura)

 ap-southeast-1

Ásia-Pacífico (Sydney)

 ap-southeast-2

Ásia-Pacífico (Jacarta)

 ap-southeast-3

Ásia-Pacífico (Tóquio)

 ap-northeast-1

Canadá (Central)

 ca-central-1

Europa (Frankfurt)

 eu-central-1

Europa (Zurique)

 eu-central-2

Europa (Estocolmo)

 eu-north-1

Europa (Milão)

 eu-south-1

Europa (Espanha)

 eu-south-2

Europa (Irlanda)

 eu-west-1

Europa (Londres)

 eu-west-2

Europa (Paris)

 eu-west-3

Israel (Tel Aviv)

 il-central-1

Oriente Médio (UAE)

 me-central-1

Oriente Médio (Barém)

 me-south-1

América do Sul (São Paulo)

 sa-east-1

China (Pequim)

 cn-north-1

China (Ningxia)

 cn-northwest-1

AWSTOE referência de comando

AWSTOE é um aplicativo de gerenciamento de componentes de linha de comando executado em EC2 instâncias da Amazon. Quando o Image Builder inicia uma instância de EC2 compilação ou teste, ele é instalado AWSTOE na instância. Em seguida, ele executa AWSTOE comandos no AWS CLI para instalar ou validar os componentes especificados na imagem ou na receita do contêiner.

nota

Alguns módulos de AWSTOE ação exigem permissões elevadas para serem executados em um servidor Linux. Para usar permissões elevadas, prefixe a sintaxe do comando com sudo ou execute o comando sudo su uma vez ao fazer login antes de executar os comandos vinculados abaixo. Para obter mais informações sobre módulos de AWSTOE ação, consulteMódulos de ação compatíveis com o gerenciador de componentes do AWSTOE.

run

Use o run comando para executar os scripts de YAML documentos para um ou mais documentos componentes.

validar

Execute o validate comando para validar a sintaxe do YAML documento para um ou mais documentos componentes.

comando awstoe run

Esse comando executa os scripts do documento do YAML componente na ordem em que são incluídos no arquivo de configuração especificado pelo --config parâmetro ou na lista de documentos do componente especificada pelo --documents parâmetro.

nota

Você deve especificar exatamente um dos seguintes parâmetros, nunca os dois:

--config

--documents

Sintaxe

awstoe run [--config <file path>] [--cw-ignore-failures <?>] 
      [--cw-log-group <?>] [--cw-log-region us-west-2] [--cw-log-stream <?>] 
      [--document-s3-bucket-owner <owner>] [--documents <file path,file path,...>] 
      [--execution-id <?>] [--log-directory <file path>] 
      [--log-s3-bucket-name <name>] [--log-s3-bucket-owner <owner>] 
      [--log-s3-key-prefix <?>] [--parameters name1=value1,name2=value2...] 
      [--phases <phase name>] [--state-directory <directory path>] [--version <?>] 
      [--help] [--trace]

Parâmetros e opções

Parâmetros
--config . /config-exemplo.json

Forma abreviada: -c . /config-exemplo.json

O arquivo de configuração (condicional). Esse parâmetro contém a localização do JSON arquivo que contém as definições de configuração dos componentes que esse comando está executando. Se você especificar as configurações de run comando em um arquivo de configuração, não deverá especificar o --documents parâmetro. Para obter mais informações sobre a configuração de entrada, consulte Configurar a entrada para o comando de AWSTOE execução.

Localizações válidas incluem:

  • Um caminho de arquivo local (. /config-exemplo.json)

  • E S3 URI () s3://bucket/key

--cw-ignore-failures

Forma abreviada: N/A

Ignore as falhas de CloudWatch registro dos registros.

--cw-log-group

Forma abreviada: N/A

O LogGroup nome dos CloudWatch Logs.

--cw-log-region

Forma abreviada: N/A

A AWS região que se aplica aos CloudWatch registros.

--cw-log-stream

Forma abreviada: N/A

O LogStream nome dos CloudWatch registros, que direciona para AWSTOE onde transmitir o console.log arquivo.

--document-s3-proprietário do bucket

Forma abreviada: N/A

O ID da conta do proprietário do bucket para documentos URI baseados em S3.

--documents . /doc-1.yaml,. /doc-n.yaml

Forma abreviada: -d . /doc-1.yaml,. /doc-n

Os documentos do componente (condicionais). Esse parâmetro contém uma lista separada por vírgulas dos locais dos arquivos para execução dos documentos do YAML componente. Se você especificar YAML documentos para o run comando usando o --documents parâmetro, não deverá especificar o --config parâmetro.

Localizações válidas incluem:

  • caminhos de arquivo locais (./component-doc-example.yaml).

  • S3 URIs (s3://bucket/key).

  • Versão de compilação do componente Image Builder ARNs (arn:aws:imagebuilder:us-west-2:123456789012/my-example-component/2021.12.02/1).

nota

Não há espaços entre os itens na lista, somente vírgulas.

--execution-id

Forma abreviada: -i

Esse é o ID exclusivo que se aplica à execução do comando run atual. Este ID é incluído nos nomes dos arquivos de saída e log, para identificar esses arquivos de forma exclusiva e vinculá-los à execução atual do comando. Se essa configuração for omitida, AWSTOE gera umGUID.

--log-directory

Forma abreviada: -l

O diretório de destino onde AWSTOE armazena todos os arquivos de log da execução desse comando. Este arquivo está localizado no diretório a seguir, por padrão: TOE_<DATETIME>_<EXECUTIONID>. Se você não especificar o diretório de log, AWSTOE usa o diretório de trabalho atual (.).

--log-s3-nome do bucket

Forma abreviada: -b

Se os registros do componente estiverem armazenados no Amazon S3 (recomendado), AWSTOE carrega os registros do aplicativo do componente para o bucket do S3 nomeado nesse parâmetro.

--log-s3-proprietário do bucket

Forma abreviada: N/A

Se os registros do componente estiverem armazenados no Amazon S3 (recomendado), esse é o ID da conta do proprietário do bucket em que AWSTOE grava os arquivos de log.

--log-s3-key-prefix

Forma abreviada: -k

Se os registros do componente estiverem armazenados no Amazon S3 (recomendado), esse é o prefixo da chave de objeto do S3 para a localização do log no bucket.

--parameters name1=value1,name2=value2...

Forma abreviada: N/A

Os parâmetros são variáveis mutáveis definidas no documento do componente, com configurações que o aplicativo de chamada pode fornecer em tempo de execução.

--phases

Forma abreviada: -p

Uma lista separada por vírgulas que especifica quais fases devem ser executadas a partir dos documentos do YAML componente. Se um documento do componente incluir fases adicionais, elas não serão executadas.

--diretório estadual

Forma abreviada: -s

O caminho do arquivo em que os arquivos de rastreamento de estado são armazenados.

--version

Forma abreviada: -v

Especifica a versão do aplicativo do componente.

Opções
--help

Forma abreviada: -h

Exibe um manual de ajuda para usar as opções do aplicativo de gerenciamento de componentes.

--trace

Forma abreviada: -t

Ativa o registro detalhado no console do.

comando awstoe validate

Quando você executa esse comando, ele valida a sintaxe do YAML documento para cada um dos documentos componentes especificados pelo --documents parâmetro.

Sintaxe

awstoe validate [--document-s3-bucket-owner <owner>] 
      --documents <file path,file path,...> [--help] [--trace]

Parâmetros e opções

Parâmetros
--document-s3-proprietário do bucket

Forma abreviada: N/A

ID da conta de origem dos documentos URI baseados em S3 fornecidos.

--documents . /doc-1.yaml,. /doc-n.yaml

Forma abreviada: -d . /doc-1.yaml,. /doc-n

Os documentos do componente (obrigatório). Esse parâmetro contém uma lista separada por vírgulas dos locais dos arquivos para execução dos documentos do YAML componente. Localizações válidas incluem:

  • caminhos de arquivo locais (./component-doc-example.yaml)

  • S3 URIs () s3://bucket/key

  • Versão de compilação do componente Image Builder ARNs (arn:aws:imagebuilder:us-west-2:123456789012/my-example-component/2021.12.02/1)

nota

Não há espaços entre os itens na lista, somente vírgulas.

Opções
--help

Forma abreviada: -h

Exibe um manual de ajuda para usar as opções do aplicativo de gerenciamento de componentes.

--trace

Forma abreviada: -t

Ativa o registro detalhado no console do.