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.

Configuración manual para desarrollar componentes personalizados con TOE de AWS

La aplicación Ejecutor y orquestador de tareas de AWS (TOE de AWS) es una aplicación independiente que crea, valida y ejecuta comandos dentro de un marco de definición de componentes. AWS los servicios se pueden utilizar TOE de AWS para organizar los flujos de trabajo, instalar software, modificar las configuraciones del sistema y probar compilaciones de imágenes.

Siga estos pasos para instalar manualmente la TOE de AWS aplicación y utilizarla como una aplicación independiente para desarrollar componentes personalizados. Image Builder se encarga de estos pasos si utiliza la consola o los AWS CLI comandos de Image Builder para crear componentes personalizados. Para obtener más información, consulte Cree componentes personalizados con Image Builder.

Paso 1: Instalar TOE de AWS

Para desarrollar componentes localmente, descargue e instale la TOE de AWS aplicación.

Paso 2: Defina AWS las credenciales

TOE de AWS requiere AWS credenciales para conectarse a otros Servicios de AWS, como Amazon S3 y Amazon CloudWatch, al ejecutar tareas, como:

Si TOE de AWS ejecuta una instancia EC2, la ejecución TOE de AWS utiliza los mismos permisos que la función de IAM asociada a la instancia EC2.

Para obtener más información acerca de los roles de IAM para EC2, consulte Roles de IAM para Amazon EC2.

Los siguientes ejemplos muestran cómo establecer AWS las credenciales mediante las variables de entorno AWS_ACCESS_KEY_ID yAWS_SECRET_ACCESS_KEY.

Para establecer estas variables en Linux, MacOS, o Unix, utilice export:

$ export AWS_ACCESS_KEY_ID=your_access_key_id

$ export AWS_SECRET_ACCESS_KEY=your_secret_access_key

Para configurar estas variables en Windows mediante PowerShell, utilice$env.

C:\> $env:AWS_ACCESS_KEY_ID=your_access_key_id

C:\> $env:AWS_SECRET_ACCESS_KEY=your_secret_access_key

Para establecer estas variables en Windows con símbolo del sistema, utilice set.

C:\> set AWS_ACCESS_KEY_ID=your_access_key_id

C:\> set AWS_SECRET_ACCESS_KEY=your_secret_access_key

Paso 3: desarrollar los documentos de los componentes a nivel local

TOE de AWS los componentes se crean con documentos YAML de texto simple. Para obtener más información sobre sintaxis de documentos, consulte Utilice el marco de documentos de TOE de AWS componentes para componentes personalizados.

Los siguientes son ejemplos de documentos de componentes de Hello World que le ayudarán a empezar.

hello-world-windows.yml.

name: Hello World
description: This is Hello World testing document for Windows.
schemaVersion: 1.0
phases:
  - name: build
    steps:
      - name: HelloWorldStep
        action: ExecutePowerShell
        inputs:
          commands:
            - Write-Host 'Hello World from the build phase.'
  - name: validate
    steps:
      - name: HelloWorldStep
        action: ExecutePowerShell
        inputs:
          commands:
            - Write-Host 'Hello World from the validate phase.'
  - name: test
    steps:
      - name: HelloWorldStep
        action: ExecutePowerShell
        inputs:
          commands:
            - Write-Host 'Hello World from the test phase.'

hello-world-linux.yml.

name: Hello World
description: This is hello world testing document for Linux.
schemaVersion: 1.0
phases:
  - name: build
    steps:
      - name: HelloWorldStep
        action: ExecuteBash
        inputs:
          commands:
            - echo 'Hello World from the build phase.'
  - name: validate
    steps:
      - name: HelloWorldStep
        action: ExecuteBash
        inputs:
          commands:
            - echo 'Hello World from the validate phase.'
  - name: test
    steps:
      - name: HelloWorldStep
        action: ExecuteBash
        inputs:
          commands:
            - echo 'Hello World from the test phase.'

Paso 4: Validar TOE de AWS los componentes

Puede validar la sintaxis de TOE de AWS los componentes localmente con la TOE de AWS aplicación. Los siguientes ejemplos muestran el validate comando de la TOE de AWS aplicación para validar la sintaxis de un componente sin ejecutarlo.

Windows

C:\> awstoe.exe validate --documents C:\Users\user\Documents\hello-world.yml

Linux

$ awstoe validate --documents /home/user/hello-world.yml

Paso 5: ejecutar TOE de AWS los componentes

La TOE de AWS aplicación puede ejecutar una o más fases de documentos específicos mediante el argumento de la línea de --phases comandos. Los valores admitidos de --phases son build, validate y test. Se pueden introducir varios valores de fase como valores separados por comas.

Al proporcionar una lista de fases, la TOE de AWS aplicación ejecuta secuencialmente las fases especificadas de cada documento. Por ejemplo, TOE de AWS ejecuta las validate fases build y dedocument1.yaml, seguidas de validate las fases build y dedocument2.yaml.

Para garantizar que sus registros se almacenen de forma segura y se conserven para la solución de problemas, le recomendamos configurar el almacenamiento de registros en Amazon S3. En Generador de Imágenes, la ubicación de Amazon S3 para publicar los registros se especifica en la configuración de infraestructura. Para obtener más información acerca de la configuración de la infraestructura, consulte Administre la configuración de la infraestructura de Generador de Imágenes de EC2.

Si no se proporciona una lista de fases, la TOE de AWS aplicación ejecuta todas las fases en el orden indicado en el documento YAML.

Para ejecutar fases específicas en uno o varios documentos, utilice los siguientes comandos.

Fase única

awstoe run --documents hello-world.yml --phases build

Fases múltiples

awstoe run --documents hello-world.yml --phases build,test

Ejecución de documentos

Ejecución de todas las fases en un solo documento

awstoe run --documents documentName.yaml

Ejecución de todas las fases en varios documentos

awstoe run --documents documentName1.yaml,documentName2.yaml

Introduzca la información de Amazon S3 para cargar TOE de AWS los registros desde una ruta local definida por el usuario (recomendado)

awstoe run --documents documentName.yaml --log-s3-bucket-name <S3Bucket> --log-s3-key-prefix <S3KeyPrefix> --log-s3-bucket-owner <S3BucketOwner> --log-directory <local_path>

Ejecución de todas las fases en un solo documento y muestre todos los registros en la consola

awstoe run --documents documentName.yaml --trace

Comando de ejemplo:

awstoe run --documents s3://bucket/key/doc.yaml --phases build,validate

Ejecución del documento con un identificador único

awstoe run --documents <documentName>.yaml --execution-id <user provided id> --phases <comma separated list of phases>

Obtenga ayuda con TOE de AWS

awstoe --help