Cómo utiliza Image Builder la Ejecutor y orquestador de tareas de AWS aplicación para gestionar los componentes - EC2Image Builder
TOE de AWS descargasRegiones admitidasReferencia de los comandos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cómo utiliza Image Builder la Ejecutor y orquestador de tareas de AWS aplicación para gestionar los componentes

EC2Image Builder utiliza la aplicación Ejecutor y orquestador de tareas de AWS (TOE de AWS) para organizar flujos de trabajo complejos, modificar las configuraciones del sistema y probar las imágenes sin necesidad de códigos o scripts de DevOps adicionales. Esta aplicación administra y ejecuta los componentes que implementan su esquema de documento declarativo.

TOE de AWS es una aplicación independiente que Image Builder instala en sus instancias de compilación y prueba al crear una imagen. También puede instalarla manualmente en las EC2 instancias para crear sus propios componentes personalizados. No requiere ninguna configuración adicional y también se puede ejecutar de forma local.

Contenido

TOE de AWS descargas

Para instalarlo TOE de AWS, elija el enlace de descarga correspondiente a su arquitectura y plataforma. Si se conecta a un VPC punto final para su servicio (Image Builder, por ejemplo), debe tener una política de punto final personalizada adjunta que incluya el acceso al depósito de S3 para las TOE de AWS descargas. De lo contrario, las instancias de compilación y prueba no podrán descargar el script de arranque (bootstrap.sh) ni instalar la TOE de AWS aplicación. Para obtener más información, consulte Crear una política VPC de puntos finales para Image Builder.

importante

AWS está eliminando gradualmente el soporte para TLS las versiones 1.0 y 1.1. Para acceder al depósito de S3 para realizar TOE de AWS descargas, el software de su cliente debe utilizar la TLS versión 1.2 o una posterior. Para obtener más información, consulte esta entrada de blog de seguridad de AWS.

Arquitectura Plataforma Enlace de descarga Ejemplo

386

AL 2 y 2023

RHEL7, 8 y 9

Ubuntu 16.04, 18.04, 20.04, 22.04 y 24.04

CentOS 7 y 8

SUSE12 y 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 y 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 y 2023

RHEL7, 8 y 9

Ubuntu 16.04, 18.04, 20.04, 22.04 y 24.04

CentOS 7 y 8

Flujo 8 de CentOS

SUSE12 y 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 y 2023

RHEL7, 8 y 9

Ubuntu 16.04, 18.04, 20.04, 22.04 y 24.04

CentOS 7 y 8

Flujo 8 de CentOS

SUSE12 y 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

Regiones admitidas

TOE de AWS se admite como aplicación independiente en las siguientes regiones.

Región de AWS nombre Región de AWS

Este de EE. UU. (Ohio)

us-east-2

Este de EE. UU. (Norte de Virginia)

us-east-1

AWS GovCloud (Este de EE. UU.)

us-gov-east-1

AWS GovCloud (Estados Unidos-Oeste)

us-gov-west-1

Oeste de EE. UU. (Norte de California)

 us-west-1

Oeste de EE. UU. (Oregón)

 us-west-2

África (Ciudad del Cabo)

 af-south-1

Asia-Pacífico (Hong Kong)

 ap-east-1

Asia Pacífico (Osaka)

 ap-northeast-3

Asia-Pacífico (Seúl)

 ap-northeast-2

Asia Pacífico (Mumbai)

 ap-south-1

Asia-Pacífico (Hyderabad)

 ap-south-2

Asia-Pacífico (Singapur)

 ap-southeast-1

Asia-Pacífico (Sídney)

 ap-southeast-2

Asia-Pacífico (Yakarta)

 ap-southeast-3

Asia-Pacífico (Tokio)

 ap-northeast-1

Canadá (centro)

 ca-central-1

Europa (Fráncfort)

 eu-central-1

Europa (Zúrich)

 eu-central-2

Europa (Estocolmo)

 eu-north-1

Europa (Milán)

 eu-south-1

Europa (España)

 eu-south-2

Europa (Irlanda)

 eu-west-1

Europa (Londres)

 eu-west-2

Europa (París)

 eu-west-3

Israel (Tel Aviv)

 il-central-1

Oriente Medio (UAE)

 me-central-1

Medio Oriente (Baréin)

 me-south-1

América del Sur (São Paulo)

 sa-east-1

China (Pekín)

 cn-north-1

China (Ningxia)

 cn-northwest-1

TOE de AWS referencia de comando

TOE de AWS es una aplicación de administración de componentes de línea de comandos que se ejecuta en EC2 instancias de Amazon. Cuando Image Builder lanza una instancia de EC2 compilación o prueba, se instala TOE de AWS en la instancia. A continuación, ejecuta TOE de AWS los comandos AWS CLI para instalar o validar los componentes que se especifican en la receta de la imagen o del contenedor.

nota

Algunos módulos de TOE de AWS acción requieren permisos elevados para ejecutarse en un servidor Linux. Para usar permisos elevados, añada el prefijo a la sintaxis del comando con sudo o ejecute el comando sudo su una vez al iniciar sesión antes de ejecutar los comandos que aparecen a continuación. Para obtener más información sobre los módulos de TOE de AWS acción, consulteMódulos de acción compatibles con el administrador de componentes TOE de AWS.

run

Utilice el run comando para ejecutar los scripts de los YAML documentos de uno o más documentos componentes.

validar

Ejecute el validate comando para validar la sintaxis del YAML documento de uno o más documentos componentes.

comando awstoe run

Este comando ejecuta los scripts de los documentos de YAML componentes en el orden en que se incluyen en el archivo de configuración especificado por el --config parámetro o en la lista de documentos de componentes especificada por el --documents parámetro.

nota

Debe especificar exactamente uno de los siguientes parámetros, nunca ambos:

--config

--documents

Sintaxis

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 y opciones

Parámetros
--config . /config-example.json

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

El archivo de configuración (condicional). Este parámetro contiene la ubicación del archivo que contiene los JSON valores de configuración de los componentes que ejecuta este comando. Si especifica los ajustes del comando run en un archivo de configuración, no debe especificar el parámetro --documents. Para obtener más información sobre la configuración de entrada, consulte Configurar la entrada para el comando TOE de AWS run.

Los campos de ubicación válidos se incluyen:

  • Una ruta de archivo local (. /config-example.json)

  • ¿Un S3 () URI s3://bucket/key

--cw-ignore-failures

Forma abreviada: N/A

Ignore los errores de registro de los CloudWatch registros.

--cw-log-group

Forma abreviada: N/A

El LogGroup nombre de los CloudWatch registros.

--cw-log-region

Forma abreviada: N/A

La AWS región que se aplica a los CloudWatch registros.

--cw-log-stream

Forma abreviada: N/A

El LogStream nombre de los CloudWatch registros, que indica TOE de AWS dónde transmitir el console.log archivo.

--document-s3-bucket-owner

Forma abreviada: N/A

El ID de cuenta del propietario del bucket para los documentos URI basados en S3.

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

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

Los documentos componentes (condicionales). Este parámetro contiene una lista separada por comas de las ubicaciones de los archivos para que se ejecuten los documentos de los YAML componentes. Si especifica YAML documentos para el run comando mediante el --documents parámetro, no debe especificarlo. --config

Los campos de ubicación válidos se incluyen:

  • rutas de archivos locales (./component-doc-example.yaml).

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

  • Versión de compilación del componente Image Builder ARNs (arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2021.12.02/1).

nota

No hay espacios entre los elementos de la lista, solo comas.

--execution-id

Forma abreviada: -i

Este es el identificador único que se aplica a la ejecución del comando run actual. Este identificador se incluye en los nombres de los archivos de salida y de registro para identificarlos de forma exclusiva y vincularlos a la ejecución del comando actual. Si se omite esta configuración, genera un. TOE de AWS GUID

--log-directory

Forma abreviada: -i

El directorio de destino donde se TOE de AWS almacenan todos los archivos de registro de la ejecución de este comando. De forma predeterminada, este directorio está ubicado en el siguiente directorio principal: TOE_<DATETIME>_<EXECUTIONID>. Si no especifica el directorio de registro, TOE de AWS utiliza el directorio de trabajo actual (.).

--log-s3-nombre de bucket

Forma abreviada: -b

Si los registros de los componentes se almacenan en Amazon S3 (recomendado), TOE de AWS carga los registros de las aplicaciones de los componentes en el bucket de S3 mencionado en este parámetro.

--log-s3-bucket-owner

Forma abreviada: N/A

Si los registros de los componentes se almacenan en Amazon S3 (recomendado), este es el ID de la cuenta del propietario del depósito en el que se TOE de AWS escriben los archivos de registro.

--log-s3-key-prefix

Forma abreviada: -k

Si los registros de los componentes se almacenan en Amazon S3 (recomendado), este es el prefijo de clave de objeto S3 para la ubicación del registro en el bucket.

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

Forma abreviada: N/A

Los parámetros son variables mutables que se definen en el documento del componente, con ajustes que la aplicación que realiza la llamada puede proporcionar en el tiempo de ejecución.

--phases

Forma abreviada: -p

Una lista separada por comas que especifica qué fases se van a ejecutar a partir de los documentos de los YAML componentes. Si un documento de componentes incluye fases adicionales, no se ejecutarán.

--directorio de estados

Forma abreviada: -s

La ruta del archivo donde se almacenan los archivos de seguimiento de estado.

--version

Forma abreviada: -v

Especifica la versión de la aplicación del componente.

Opciones
--help

Forma abreviada: -h

Muestra un manual de ayuda para utilizar las opciones de la aplicación de administración de componentes.

--trace

Forma abreviada: -t

Permite el registro detallado en la consola.

comando awstoe validate

Al ejecutar este comando, valida la sintaxis del YAML documento para cada uno de los documentos componentes especificados por el --documents parámetro.

Sintaxis

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

Parámetros y opciones

Parámetros
--document-s3-bucket-owner

Forma abreviada: N/A

Se proporcionó el identificador de cuenta de origen de los documentos URI basados en S3.

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

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

Los documentos que lo componen (obligatorios). Este parámetro contiene una lista separada por comas de las ubicaciones de los archivos para que se ejecuten los documentos de los YAML componentes. Los campos de ubicación válidos se incluyen:

  • rutas de archivos locales (./component-doc-example.yaml)

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

  • Versión de compilación del componente Image Builder ARNs (arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2021.12.02/1)

nota

No hay espacios entre los elementos de la lista, solo comas.

Opciones
--help

Forma abreviada: -h

Muestra un manual de ayuda para utilizar las opciones de la aplicación de administración de componentes.

--trace

Forma abreviada: -t

Permite el registro detallado en la consola.