acción 'AWS CDK bootstrap' YAML

La siguiente es la YAML definición de la acción de arranque.AWS CDK Para obtener información sobre cómo utilizar esta acción, consulteCómo iniciar una AWS CDK aplicación con un flujo de trabajo.

Esta definición de acción existe como una sección dentro de un archivo de definición de flujo de trabajo más amplio. Para obtener más información acerca de este archivo, consulte YAMLDefinición del flujo de trabajo.

nota

La mayoría de las YAML propiedades siguientes tienen los elementos de interfaz de usuario correspondientes en el editor visual. Para buscar un elemento de la interfaz de usuario, utilice Ctrl+F. El elemento aparecerá en la lista con su propiedad asociadaYAML.

# The workflow definition starts here.
# See Propiedades de nivel superior for details.
        
Name: MyWorkflow
SchemaVersion: 1.0 
Actions:

# The action definition starts here.    
  CDKBootstrapAction_nn: 
    Identifier: aws/cdk-bootstrap@v2
    DependsOn:
      - action-name
    Compute:  
      Type: EC2 | Lambda
      Fleet: fleet-name
    Timeout: timeout-minutes
    Inputs:
      # Specify a source or an artifact, but not both.
      Sources:
        - source-name-1
      Artifacts:
        - artifact-name
    Outputs:
      Artifacts:
        - Name: cdk_bootstrap_artifacts
          Files: 
            - "cdk.out/**/*"
    Environment:
      Name: environment-name
      Connections:
        - Name: account-connection-name
          Role: iam-role-name
    Configuration:
      Region: us-west-2
      CdkCliVersion: version

CDKBootstrapAction

(Obligatorio)

Especifique el nombre de la acción. Todos los nombres de las acciones deben ser únicos en el flujo de trabajo. Los nombres de las acciones se limitan a caracteres alfanuméricos (a-z, A-Z, 0-9), guiones (-) y guiones bajos (_). No se permiten espacios. No puede utilizar comillas para activar los caracteres especiales y los espacios en los nombres de las acciones.

Predeterminado: CDKBootstrapAction_nn.

Interfaz de usuario correspondiente: pestaña de configuración o nombre para mostrar de la acción

Identifier

(CDKBootstrapAction/Identifier)

(Obligatorio)

Identifica la acción. No cambie esta propiedad a menos que desee cambiar la versión. Para obtener más información, consulte Especificar la versión de la acción que se va a utilizar.

nota

Si se aws/cdk-bootstrap@v2 especifica, la acción se ejecuta en la imagen de marzo de 2024, que incluye herramientas más recientes, como Node.js 18. Si se aws/cdk-bootstrap@v1 especifica, la acción se ejecuta en la imagen de noviembre de 2022, que incluye herramientas antiguas, como Node.js 16.

Predeterminado: aws/cdk-bootstrap@v2.

Interfaz de usuario correspondiente: diagrama de flujo de trabajo/ CDKBootstrapAction _nn/ aws/cdk-bootstrap @v2 label

DependsOn

(CDKBootstrapAction/DependsOn)

(Opcional)

Especifique una acción, un grupo de acciones o una puerta que debe ejecutarse correctamente para que esta acción se ejecute.

Para obtener más información sobre la funcionalidad «depende de», consulte. Secuenciación de acciones

Interfaz de usuario correspondiente: pestaña de entradas/Depende de: opcional

Compute

(CDKBootstrapAction/Compute)

(Opcional)

El motor informático utilizado para ejecutar las acciones del flujo de trabajo. Puede especificar el procesamiento en el nivel del flujo de trabajo o en el nivel de acción, pero no en ambos. Cuando se especifica en el nivel del flujo de trabajo, la configuración de procesamiento se aplica a todas las acciones definidas en el flujo de trabajo. En el nivel del flujo de trabajo, también puedes ejecutar varias acciones en la misma instancia. Para obtener más información, consulte Compartir el cómputo entre acciones.

Interfaz de usuario correspondiente: ninguna

Type

(CDKBootstrapAction/Compute/Type)

(Obligatorio si Compute está incluido)

El tipo de motor de cómputo. Puede usar uno de los siguientes valores:

• EC2(editor visual) o EC2 (YAMLeditor)

  Optimizado para ofrecer flexibilidad durante las ejecuciones de acción.

• Lambda (editor visual) o Lambda (YAMLeditor)

  Velocidades de inicio de acciones optimizadas.

Para obtener más información sobre los tipos de computación, consulte Tipos de procesamiento.

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada: opcional/tipo de cálculo

Fleet

(CDKBootstrapAction/Compute/Fleet)

(Opcional)

Especifique la máquina o flota que ejecutará el flujo de trabajo o las acciones del flujo de trabajo. Con las flotas bajo demanda, cuando se inicia una acción, el flujo de trabajo aprovisiona los recursos que necesita y las máquinas se destruyen cuando finaliza la acción. Ejemplos de flotas bajo demanda:Linux.x86-64.Large,. Linux.x86-64.XLarge Para obtener más información sobre las flotas bajo demanda, consulte. Propiedades de la flota bajo demanda

Con las flotas aprovisionadas, puede configurar un conjunto de máquinas dedicadas para ejecutar las acciones de su flujo de trabajo. Estas máquinas permanecen inactivas y listas para procesar las acciones de forma inmediata. Para obtener más información sobre las flotas aprovisionadas, consulte. Propiedades de la flota aprovisionada

Si Fleet se omite, el valor predeterminado es. Linux.x86-64.Large

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada: opcional/Flota de cómputo

Timeout

(CDKBootstrapAction/Timeout)

(Obligatorio)

Especifique la cantidad de tiempo en minutos (YAMLeditor) o en horas y minutos (editor visual) que la acción puede durar antes CodeCatalyst de que finalice la acción. El mínimo es de 5 minutos y el máximo se describe enCuotas para flujos de trabajo en CodeCatalyst. El tiempo de espera predeterminado es el mismo que el tiempo de espera máximo.

Interfaz de usuario correspondiente: pestaña de configuración/tiempo de espera: opcional

Inputs

(CDKBootstrapAction/Inputs)

(Opcional)

La Inputs sección define los datos que necesita la acción de AWS CDK arranque durante la ejecución de un flujo de trabajo.

Interfaz de usuario correspondiente: pestaña de entradas

nota

Solo se permite una entrada (ya sea una fuente o un artefacto) para cada acción de AWS CDK arranque.

Sources

(CDKBootstrapAction/Inputs/Sources)

(Obligatorio si AWS CDK la aplicación está almacenada en un repositorio de fuentes)

Si tu AWS CDK aplicación está almacenada en un repositorio de origen, especifica la etiqueta de ese repositorio de origen. La acción de AWS CDK arranque sintetiza la aplicación en este repositorio antes de iniciar el proceso de arranque. Actualmente, la única etiqueta de repositorio compatible es. WorkflowSource

Si tu AWS CDK aplicación no está incluida en un repositorio de origen, debe residir en un artefacto generado por otra acción.

Para obtener más información sobre orígenes, consulte Conexión de repositorios de origen a flujos de trabajo.

Interfaz de usuario correspondiente: pestaña Entradas/Fuentes (opcional)

Artifacts - input

(CDKBootstrapAction/Inputs/Artifacts)

(Obligatorio si tu AWS CDK aplicación está almacenada en un artefacto de salida de una acción anterior)

Si tu AWS CDK aplicación está incluida en un artefacto generado por una acción anterior, especifica ese artefacto aquí. La acción de AWS CDK arranque sintetiza la aplicación del artefacto especificado en una CloudFormation plantilla antes de iniciar el proceso de arranque. Si tu AWS CDK aplicación no está incluida en un artefacto, debe residir en tu repositorio de origen.

Para obtener más información sobre los artefactos, incluidos ejemplos, consulteCompartir artefactos y archivos entre acciones.

Interfaz de usuario correspondiente: pestaña de entradas/Artefactos (opcional)

Outputs

(CDKBootstrapAction/Outputs)

(Opcional)

Define los datos que genera la acción durante la ejecución de un flujo de trabajo.

Interfaz de usuario correspondiente: pestaña de salidas

Artifacts - output

(CDKBootstrapAction/Outputs/Artifacts)

(Opcional)

Especifique los artefactos generados por la acción. Puedes hacer referencia a estos artefactos como entrada en otras acciones.

Para obtener más información sobre los artefactos, incluidos ejemplos, consulteCompartir artefactos y archivos entre acciones.

Interfaz de usuario correspondiente: pestaña de salidas/artefactos

Name

(CDKBootstrapAction/Outputs/Artifacts/Name)

(Obligatorio si Artifacts - output está incluido)

Especifique el nombre del artefacto que contendrá la AWS CloudFormation plantilla sintetizada por la acción de AWS CDK arranque en tiempo de ejecución. El valor predeterminado es cdk_bootstrap_artifacts. Si no especificas un artefacto, la acción sintetizará la plantilla, pero no la guardará en un artefacto. Considera la posibilidad de guardar la plantilla sintetizada en un artefacto para conservar un registro de la misma para probarla o solucionar problemas.

Interfaz de usuario correspondiente: pestaña de salidas/Artifactos/Añadir artefacto/Construir nombre de artefacto

Files

(CDKBootstrapAction/Outputs/Artifacts/Files)

(Artifacts - outputObligatorio si está incluido)

Especifique los archivos que desee incluir en el artefacto. Debe especificar si "cdk.out/**/*" desea incluir la AWS CloudFormation plantilla sintetizada de su AWS CDK aplicación.

nota

cdk.outes el directorio predeterminado en el que se guardan los archivos sintetizados. Si especificó un directorio de salida que no sea cdk.out el cdk.json del archivo, especifique ese directorio aquí en lugar decdk.out.

Interfaz de usuario correspondiente: pestaña de salidas/Artifactos/Agregar artefacto/Archivos producidos por build

Environment

(CDKBootstrapAction/Environment)

(Obligatorio)

Especifica el entorno que se va a usar con la acción. CodeCatalyst La acción se conecta al Cuenta de AWS Amazon opcional VPC especificado en el entorno elegido. La acción usa el IAM rol predeterminado especificado en el entorno para conectarse a Amazon y usa el IAM rol especificado en la VPCconexión de Amazon para conectarse a AmazonVPC. Cuenta de AWS

nota

Si el IAM rol predeterminado no tiene los permisos necesarios para la acción, puedes configurar la acción para usar un rol diferente. Para obtener más información, consulte Cambiar el IAM papel de una acción.

Para obtener más información sobre los entornos, consulte Implementación en Cuentas de AWS y VPCs yCreación de un entorno.

Interfaz de usuario correspondiente: pestaña de configuración/entorno

Name

(CDKBootstrapAction/Environment/Name)

(Obligatorio si Environment está incluido)

Especifique el nombre de un entorno existente que desee asociar a la acción.

Interfaz de usuario correspondiente: pestaña de configuración/entorno

Connections

(CDKBootstrapAction/Environment/Connections)

(Opcional en las versiones más recientes de la acción; obligatorio en las versiones anteriores)

Especifique la conexión de cuenta que desee asociar a la acción. Puede especificar un máximo de una conexión de cuenta por debajoEnvironment.

Si no especificas una conexión de cuenta:

• La acción utiliza la Cuenta de AWS conexión y el IAM rol predeterminado especificados en el entorno de la CodeCatalyst consola. Para obtener información sobre cómo añadir una conexión de cuenta y un IAM rol predeterminado al entorno, consulteCreación de un entorno.

• El IAM rol predeterminado debe incluir las políticas y los permisos que requiere la acción. Para determinar cuáles son esas políticas y permisos, consulte la descripción de la propiedad del rol en la documentación de YAML definición de la acción.

Para obtener más información sobre las conexiones de cuentas, consultePermitir el acceso a AWS los recursos con conexión Cuentas de AWS. Para obtener información sobre cómo añadir una conexión de cuenta a un entorno, consulteCreación de un entorno.

Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción:

• (Versiones más recientes) Pestaña de configuración/Entorno/Contenido my-environment? /menú de tres puntos/ Cambiar rol

• (Versiones anteriores) Pestaña de configuración/'Entorno/cuenta/role'/ conexión de la cuenta AWS

Name

(CDKBootstrapAction/Environment/Connections/Name)

Connections(Obligatorio si está incluido)

Especifique el nombre de la conexión de la cuenta.

Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción:

• (Versiones más recientes) Pestaña de configuración/Entorno/Contenido my-environment? /menú de tres puntos/ Cambiar rol

• (Versiones anteriores) Pestaña de configuración/'Entorno/cuenta/role'/ conexión de la cuenta AWS

Role

(CDKBootstrapAction/Environment/Connections/Role)

Connections(Obligatorio si está incluido)

Especifique el nombre del IAM rol que utiliza la acción de AWS CDK arranque para acceder a la pila de arranque AWS y añadirla. Asegúrese de haber agregado el rol a su CodeCatalyst espacio y de que el rol incluya las siguientes políticas.

Si no especifica ningún IAM rol, la acción utilizará el IAM rol predeterminado que aparece en el entorno de la CodeCatalyst consola. Si usa el rol predeterminado en el entorno, asegúrese de que tenga las siguientes políticas.

nota

Los permisos que se muestran en la siguiente política de permisos son los necesarios para que el cdk bootstrap comando se inicie en el momento de redactarse este artículo. Estos permisos pueden cambiar si el comando AWS CDK bootstrap cambia.

aviso

Utilice este rol únicamente con la acción AWS CDK bootstrap. Es muy permisivo y su uso con otras acciones puede suponer un riesgo para la seguridad.

• La siguiente política de permisos:

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Sid": "VisualEditor0",
              "Effect": "Allow",
              "Action": [
                  "iam:GetRole",
                  "ssm:GetParameterHistory",
                  "ecr:PutImageScanningConfiguration",
                  "cloudformation:*",
                  "iam:CreateRole",
                  "iam:AttachRolePolicy",
                  "ssm:GetParameters",
                  "iam:PutRolePolicy",
                  "ssm:GetParameter",
                  "ssm:DeleteParameters",
                  "ecr:DeleteRepository",
                  "ssm:PutParameter",
                  "ssm:DeleteParameter",
                  "iam:PassRole",
                  "ecr:SetRepositoryPolicy",
                  "ssm:GetParametersByPath",
                  "ecr:DescribeRepositories",
                  "ecr:GetLifecyclePolicy"
              ],
              "Resource": [
                  "arn:aws:ssm:aws-region:aws-account:parameter/cdk-bootstrap/*",
                  "arn:aws:cloudformation:aws-region:aws-account:stack/CDKToolkit/*",
                  "arn:aws:ecr:aws-region:aws-account:repository/cdk-*",
                  "arn:aws:iam::aws-account:role/cdk-*"
              ]
          },
          {
              "Sid": "VisualEditor1",
              "Effect": "Allow",
              "Action": [
                  "cloudformation:RegisterType",
                  "cloudformation:CreateUploadBucket",
                  "cloudformation:ListExports",
                  "cloudformation:DescribeStackDriftDetectionStatus",
                  "cloudformation:SetTypeDefaultVersion",
                  "cloudformation:RegisterPublisher",
                  "cloudformation:ActivateType",
                  "cloudformation:ListTypes",
                  "cloudformation:DeactivateType",
                  "cloudformation:SetTypeConfiguration",
                  "cloudformation:DeregisterType",
                  "cloudformation:ListTypeRegistrations",
                  "cloudformation:EstimateTemplateCost",
                  "cloudformation:DescribeAccountLimits",
                  "cloudformation:BatchDescribeTypeConfigurations",
                  "cloudformation:CreateStackSet",
                  "cloudformation:ListStacks",
                  "cloudformation:DescribeType",
                  "cloudformation:ListImports",
                  "s3:*",
                  "cloudformation:PublishType",
                  "ecr:CreateRepository",
                  "cloudformation:DescribePublisher",
                  "cloudformation:DescribeTypeRegistration",
                  "cloudformation:TestType",
                  "cloudformation:ValidateTemplate",
                  "cloudformation:ListTypeVersions"
              ],
              "Resource": "*"
          }
      ]
  }

  nota

  La primera vez que utilice el rol, utilice el siguiente comodín en la declaración de política de recursos y, a continuación, defina la política con el nombre del recurso cuando esté disponible.

  "Resource": "*"

• La siguiente política de confianza personalizada:

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Sid": "",
              "Effect": "Allow",
              "Principal": {
                  "Service":  [
                     "codecatalyst-runner.amazonaws.com",
                     "codecatalyst.amazonaws.com"
                   ]
              },
              "Action": "sts:AssumeRole"
          }
      ]
  }

nota

Si lo deseas, puedes usar el CodeCatalystWorkflowDevelopmentRole-spaceName rol con esta acción. Para obtener más información acerca de este rol, consulte Crear el CodeCatalystWorkflowDevelopmentRole-spaceNamerol para su cuenta y su espacio. Ten en cuenta que el CodeCatalystWorkflowDevelopmentRole-spaceName rol tiene permisos de acceso total, lo que puede suponer un riesgo para la seguridad. Le recomendamos que utilice esta función únicamente en los tutoriales y situaciones en las que la seguridad sea un problema menor.

Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción:

• (Versiones más recientes) Pestaña de configuración/Entorno/Contenido my-environment? /menú de tres puntos/ Cambiar rol

• (Versiones anteriores) Pestaña de configuración/'Entorno/cuenta/role'/ Rol

Configuration

(CDKBootstrapAction/Configuration)

(Obligatorio)

Una sección en la que puede definir las propiedades de configuración de la acción.

Interfaz de usuario correspondiente: pestaña de configuración

Region

(CDKBootstrapAction/Configuration/Region)

(Obligatorio)

Especifique el lugar Región de AWS en el que se desplegará la pila de arranque. Esta región debe coincidir con aquella en la que se implementa AWS CDK la aplicación. Para ver una lista de códigos de regiones, consulte Puntos de conexión regionales.

Interfaz de usuario correspondiente: pestaña de configuración/región

CdkCliVersion

(CDKBootstrapAction/Configuration/CdkCliVersion)

(Opcional)

Esta propiedad está disponible en la versión 1.0.13 o posterior de la acción de AWS CDK despliegue y en la versión 1.0.8 o posterior de la AWS CDK acción de arranque.

Especifique uno de los siguientes valores:

• La versión completa de la interfaz de línea de AWS Cloud Development Kit (AWS CDK) comandos (CLI) (también denominada AWS CDK kit de herramientas) que desea que utilice esta acción. Ejemplo: 2.102.1. Considere la posibilidad de especificar una versión completa para garantizar la coherencia y la estabilidad al crear e implementar la aplicación.

  Or (Disyunción)

• latest. Considere la posibilidad latest de especificarlo para aprovechar las funciones y correcciones más recientes del CDKCLI.

La acción descargará la versión especificada (o la última versión) de la imagen de CodeCatalyst compilación y, AWS CDK CLI a continuación, utilizará esta versión para ejecutar los comandos necesarios para implementar la CDK aplicación o arrancar el AWS entorno.

Para ver una lista de CDK CLI las versiones compatibles que puede utilizar, consulte AWS CDK Versiones.

Si omite esta propiedad, la acción utilizará una AWS CDK CLI versión predeterminada que se describe en uno de los temas siguientes:

• CDKCLIversiones utilizadas por la acción «desplegar»AWS CDK

• CDKCLIversiones utilizadas por la acción «bootstrap»AWS CDK

Interfaz de usuario correspondiente: pestaña/versión de configuración AWS CDK CLI