Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md).
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 iniciar una AWS CDK aplicación con un flujo de trabajo
En esta sección se describe cómo iniciar una AWS CDK aplicación mediante un CodeCatalyst flujo de trabajo. Para ello, debe añadir la acción **Arranque de AWS CDK ** a su flujo de trabajo. La acción **Arranque de AWS CDK ** aprovisiona una pila de arranque en su entorno de AWS mediante la [plantilla moderna](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-template). Si ya existe una pila de arranque, la acción la actualiza si es necesario. Contar con una pila de bootstrap AWS es un requisito previo para implementar una AWS CDK aplicación.
Para obtener más información acerca del arranque, consulte [Bootstrapping](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) en la *Guía para desarrolladores de AWS Cloud Development Kit (AWS CDK) *.
**Topics**
+ [¿Cuándo usar la acción «AWS CDK arrancar»](#cdk-boot-action-when-to-use)
+ [Cómo funciona la acción «AWS CDK bootstrap»](#cdk-boot-action-how-it-works)
+ [Versiones de CDK CLI utilizadas por la acción «AWS CDK bootstrap»](#cdk-boot-action-cdk-version)
+ [Imagen de tiempo de ejecución utilizada por la acción «bootstrap»AWS CDK](#cdk-boot-action-runtime)
+ [Ejemplo: iniciar una aplicación AWS CDK](cdk-boot-action-example-workflow.md)
+ [Añadir la acción 'AWS CDK bootstrap'](cdk-boot-action-add.md)
+ [Variables de 'Arranque de AWS CDK '](cdk-boot-action-variables.md)
+ [Acción 'Arranque de AWS CDK ' en YAML](cdk-boot-action-ref.md)
## ¿Cuándo usar la acción «AWS CDK arrancar»
Use esta acción si tiene un flujo de trabajo que implementa una AWS CDK aplicación y desea implementar (y actualizar, si es necesario) la pila de bootstrap al mismo tiempo. En este caso, añadiría la acción de **AWS CDK arranque** al mismo flujo de trabajo que el que implementa la aplicación. AWS CDK
**No** utilice esta acción si se dan alguna de las siguientes circunstancias:
+ Ya ha implementado una pila de arranque mediante otro mecanismo y desea mantenerla intacta (sin actualizaciones).
+ Desea utilizar una [plantilla de arranque personalizada](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-customizing) que no es compatible con la acción **Arranque de AWS CDK **.
## Cómo funciona la acción «AWS CDK bootstrap»
La acción **Arranque de AWS CDK ** funciona de la siguiente manera:
1. [En tiempo de ejecución, si especificó la versión 1.0.7 o anterior de la acción, la acción descarga la última CLI de CDK (también denominada kit de herramientas) AWS CDK a la imagen de compilación. CodeCatalyst ](build-images.md)
Si especificó la versión 1.0.8 o posterior, la acción viene incluida con una [versión específica](cdk-dep-action.md#cdk-dep-action-cdk-version) de la CLI de CDK, por lo que no se produce ninguna descarga.
1. La acción utiliza la CLI de CDK para ejecutar el comando `cdk bootstrap`. Este comando realiza las tareas de arranque descritas en el tema [Bootstrapping](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) de la *Guía para desarrolladores de AWS Cloud Development Kit (AWS CDK) *.
## Versiones de CDK CLI utilizadas por la acción «AWS CDK bootstrap»
En la siguiente tabla se muestra qué versión de la CLI de CDK utilizan de forma predeterminada las diferentes versiones de la acción **Arranque de AWS CDK **.
**nota**
Puede invalidar la predeterminada. Para obtener más información, consulte [CdkCliVersion](cdk-boot-action-ref.md#cdk.boot.cdk.cli.version) en la [Acción 'Arranque de AWS CDK ' en YAML](cdk-boot-action-ref.md).
| Versión de la acción 'Arranque de AWS CDK ' | AWS CDK Versión CLI |
| --- | --- |
| 1.0.0 – 1.0.7 | más reciente |
| 1.0.8 o posterior | 2.99.1 |
## Imagen de tiempo de ejecución utilizada por la acción «bootstrap»AWS CDK
**La siguiente tabla muestra las imágenes del entorno de ejecución que se CodeCatalyst utilizan para ejecutar diferentes versiones de la AWS CDK acción de arranque.** Las imágenes incluyen diferentes conjuntos de herramientas preinstaladas. Para obtener más información, consulte [Imágenes activas](build-images.md#build-curated-images).
**nota**
Le recomendamos que actualice la acción **Arranque de AWS CDK ** a la versión 2.x para aprovechar las últimas herramientas disponibles en la imagen de marzo de 2024. Para actualizar la acción, defina su propiedad `Identifier` en `aws/cdk-bootstrap@v2` en el archivo de definición de flujo de trabajo. Para obtener más información, consulte [YAML de la acción 'Implementación de AWS CDK '](cdk-dep-action-ref.md).
| Versión de la acción 'Arranque de AWS CDK ' | Imágenes del entorno en tiempo de ejecución |
| --- | --- |
| 1.x | Imágenes de noviembre de 2022 |
| 2.x | Imágenes de marzo de 2024 |
# Ejemplo: iniciar una aplicación AWS CDK
Consulte el [Ejemplo: Implementación de una AWS CDK aplicación](cdk-dep-action-example-workflow.md) en la [Implementación de una AWS CDK aplicación con un flujo de trabajo](cdk-dep-action.md) para ver un flujo de trabajo que incluye la acción **Arranque de AWS CDK **.
# Añadir la acción 'AWS CDK bootstrap'
Siga estas instrucciones para añadir la acción **Arranque de AWS CDK ** a su flujo de trabajo.
**Antes de empezar**
Para poder usar la acción **Arranque de AWS CDK **, asegúrese de tener una aplicación de AWS CDK . La acción de arranque sintetizará la aplicación antes del arranque. AWS CDK Puede escribir la aplicación en cualquier lenguaje de programación compatible con AWS CDK.
Asegúrate de que los archivos de tu AWS CDK aplicación estén disponibles en:
+ Un [repositorio CodeCatalyst de origen](source.md), o
+ Un [artefacto CodeCatalyst de salida](workflows-working-artifacts.md) generado por otra acción del flujo de trabajo
------
#### [ Visual ]
**Para añadir la acción «AWS CDK arrancar» mediante el editor visual**
1. [Abra la CodeCatalyst consola en https://codecatalyst.aws/.](https://codecatalyst.aws/)
1. Elija el proyecto.
1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.
1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.
1. Elija **Edit (Edición de)**.
1. Elija **Visual**.
1. En la parte superior izquierda, seleccione **\$1 Acciones** para abrir el catálogo de acciones.
1. En la lista desplegable, selecciona **Amazon CodeCatalyst**.
1. Busque la acción **Arranque de AWS CDK ** y realice una de las siguientes acciones:
+ Elija el signo más (**\$1**) para añadir la acción al diagrama de flujo de trabajo y abrir su panel de configuración.
O
+ Elija **Arranque de AWS CDK **. Aparecerá el cuadro de diálogo de detalles de la acción. En este cuadro de diálogo:
+ (Opcional) Seleccione **Ver código fuente** para [ver el código fuente de la acción](workflows-view-source.md#workflows-view-source.title).
+ Seleccione **Añadir al flujo de trabajo** para añadir la acción al diagrama de flujo de trabajo y abrir su panel de configuración.
1. En las pestañas **Entradas**, **Configuración** y **Salidas**, complete los campos según sus necesidades. Para obtener una descripción de cada uno de los campos, consulte la [Acción 'Arranque de AWS CDK ' en YAML](cdk-boot-action-ref.md). Esta referencia proporciona información detallada sobre cada campo (y el valor de la propiedad de YAML correspondiente) tal como aparece en el editor visual y el de YAML.
1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo.
1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**.
**nota**
Si la acción **Arranque de AWS CDK ** falla y se produce un error `npm install`, consulte [¿Cómo puedo corregir los errores npm install?](troubleshooting-workflows.md#troubleshooting-workflows-npm) para obtener información sobre cómo corregir el error.
------
#### [ YAML ]
**Para añadir la acción «AWS CDK bootstrap» mediante el editor YAML**
1. [Abre la consola en https://codecatalyst.aws/ CodeCatalyst .](https://codecatalyst.aws/)
1. Elija el proyecto.
1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.
1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.
1. Elija **Edit (Edición de)**.
1. Elija **YAML**.
1. En la parte superior izquierda, seleccione **\$1 Acciones** para abrir el catálogo de acciones.
1. En la lista desplegable, selecciona **Amazon CodeCatalyst**.
1. Busque la acción **Arranque de AWS CDK ** y elija **\$1** para añadirla al diagrama de flujo de trabajo y abrir su panel de configuración.
1. Modifique las propiedades del código de YAML en función de sus necesidades. Encontrará una explicación de todas las propiedades disponibles en la [Acción 'Arranque de AWS CDK ' en YAML](cdk-boot-action-ref.md).
1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo.
1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**.
**nota**
Si la acción **Arranque de AWS CDK ** falla y se produce un error `npm install`, consulte [¿Cómo puedo corregir los errores npm install?](troubleshooting-workflows.md#troubleshooting-workflows-npm) para obtener información sobre cómo corregir el error.
------
# Variables de 'Arranque de AWS CDK '
La acción **Arranque de AWS CDK ** produce y establece las siguientes variables en tiempo de ejecución. Se conocen como *variables predefinidas*.
Para obtener información sobre cómo hacer referencia a estas variables en un flujo de trabajo, consulte [Uso de variables predefinidas](workflows-using-predefined-variables.md).
| Clave | Valor |
| --- | --- |
| deployment-platform | El nombre de la plataforma de implementación. Codificado en `AWS:CloudFormation`. |
| region | El código de región en el Región de AWS que se implementó la pila de AWS CDK arranque durante la ejecución del flujo de trabajo. Ejemplo: `us-west-2` |
| stack-id | El nombre de recurso de Amazon (ARN) de la pila de AWS CDK bootstrap implementada. Ejemplo: `arn:aws:cloudformation:us-west-2:111122223333:stack/codecatalyst-cdk-bootstrap-stack/6aad4380-100a-11ec-a10a-03b8a84d40df` |
| SKIP-DEPLOYMENT | Un valor de `true` indica que se omitió el despliegue de la pila de AWS CDK bootstrap durante la ejecución del flujo de trabajo. Se omitirá la implementación de una pila si no se ha producido ningún cambio en la pila desde la última implementación. Esta variable solo se genera si su valor es `true`. Codificado en `true`. |
# Acción 'Arranque de AWS CDK ' en YAML
La siguiente es la definición en YAML de la acción **Arranque de AWS CDK **. Para obtener información sobre cómo utilizar esta acción, consulte [Cómo iniciar una AWS CDK aplicación con un flujo de trabajo](cdk-boot-action.md).
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 [Definición de flujo de trabajo en YAML](workflow-reference.md).
**nota**
La mayoría de las propiedades de YAML que se muestran a continuación tienen elementos de interfaz de usuario correspondientes en el editor visual. Para buscar un elemento de la interfaz de usuario, use **Ctrl\$1F**. El elemento aparecerá en la lista con su propiedad de YAML asociada.
```
# The workflow definition starts here.
# See Propiedades de nivel superior for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The action definition starts here.
CDKBootstrapAction\$1nn:
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 dentro del flujo de trabajo. Los nombres de las acciones están limitados a caracteres alfanuméricos (a-z, A-Z y 0-9), guiones (-) y guiones bajos (\$1). No se permiten espacios. No puede utilizar comillas para permitir caracteres especiales ni espacios en los nombres de las acciones.
Predeterminado: `CDKBootstrapAction_nn`.
Interfaz de usuario correspondiente: pestaña Configuración/**Nombre de visualización 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 [Especificación de la versión de la acción que se va a utilizar](workflows-action-versions.md).
**nota**
Si se especifica `aws/cdk-bootstrap@v2`, la acción se ejecuta en la [imagen de marzo de 2024](build-images.md#build.default-image), que incluye herramientas más recientes, como Node.js 18. Si se especifica `aws/cdk-bootstrap@v1`, la acción se ejecuta en la [imagen de noviembre de 2022](build-images.md#build.previous-image), que incluye herramientas más antiguas, como Node.js 16.
Predeterminado: `aws/cdk-bootstrap@v2`.
Interfaz de usuario correspondiente: Diagrama de flujo de trabajo/CDKBootstrapAction\$1nn/etiqueta **aws/cdk-bootstrap@v2**
## DependsOn
(*CDKBootstrapAction*/**DependsOn**)
(Opcional)
Especifique la acción, el grupo de acciones o la 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](workflows-depends-on.md).
Interfaz de usuario correspondiente: pestaña Entradas/**Depende de (opcional)**
## Compute
(*CDKBootstrapAction*/**Compute**)
(Opcional)
El motor de computación utilizado para ejecutar las acciones del flujo de trabajo. Puede especificar el motor de computación en el nivel del flujo de trabajo o en el nivel de acción, pero no en ambos. Cuando se especifica en el nivel de flujo de trabajo, la configuración del motor de computación se aplica a todas las acciones definidas en el flujo de trabajo. En el nivel de flujo de trabajo, también puede ejecutar varias acciones en la misma instancia. Para obtener más información, consulte [Uso compartido de recursos de computación entre acciones](compute-sharing.md).
Interfaz de usuario correspondiente: *ninguna*
## Type
(*CDKBootstrapAction*/Compute/**Type**)
(Obligatorio si se incluye [Compute](#cdk.boot.computename))
El tipo de motor de computación. Puede utilizar uno de los siguientes valores:
+ **EC2**(editor visual) o (editor YAML`EC2`)
Optimizado para ofrecer flexibilidad durante las ejecuciones de acciones.
+ **Lambda** (editor visual) o `Lambda` (editor de YAML)
Velocidades de inicio de acciones optimizadas.
Para obtener más información sobre los tipos de computación, consulte [Tipos de computación](workflows-working-compute.md#compute.types).
**Interfaz de usuario correspondiente: configuración tab/Advanced : opcional/tipo de cálculo**
## Fleet
(*CDKBootstrapAction*/Compute/**Fleet**)
(Opcional)
Especifique la máquina o la 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 las flotas bajo demanda](workflows-working-compute.md#compute.on-demand).
Con las flotas aprovisionadas, configura un conjunto de máquinas dedicadas para ejecutar las acciones del flujo de trabajo. Estas máquinas permanecen inactivas, listas para procesar acciones de forma inmediata. Para obtener más información sobre las flotas aprovisionadas, consulte [Propiedades de flotas aprovisionadas](workflows-working-compute.md#compute.provisioned-fleets).
Si `Fleet` se omite, el valor predeterminado es `Linux.x86-64.Large`.
**Interfaz de usuario correspondiente: Configuración: opcional/flota de tab/Advanced cómputo**
## Timeout
(*CDKBootstrapAction*/**Timeout**)
(Obligatorio)
Especifique la cantidad de tiempo en minutos (editor YAML) o en horas y minutos (editor visual) que la acción puede ejecutarse antes de que CodeCatalyst finalice la acción. El mínimo es 5 minutos y el máximo se describe en [Cuotas para flujos de trabajo en CodeCatalyst](workflows-quotas.md). El tiempo de espera predeterminado es el mismo que el tiempo de espera máximo.
Interfaz de usuario correspondiente: pestaña Configuración/**Tiempo de espera (opcional)**
## Inputs
(*CDKBootstrapAction*/**Inputs**)
(Opcional)
La sección `Inputs` define los datos que necesita la acción **Arranque de AWS CDK ** durante la ejecución de un flujo de trabajo.
Interfaz de usuario correspondiente: pestaña **Entradas**
**nota**
Solo se permite una entrada (ya sea un código fuente o un artefacto) para cada acción **Arranque de AWS CDK **.
## Sources
(*CDKBootstrapAction*/Inputs/**Sources**)
(Obligatorio si AWS CDK la aplicación está almacenada en un repositorio de código fuente)
Si tu AWS CDK aplicación está almacenada en un repositorio de origen, especifica la etiqueta de ese repositorio de origen. La acción **Arranque de AWS CDK ** sintetiza la aplicación en este repositorio antes de iniciar el proceso de arranque. Actualmente, la única etiqueta de repositorio admitida 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 código fuente a flujos de trabajo](workflows-sources.md).
Interfaz de usuario correspondiente: pestaña Entradas/**Orígenes (opcional)**
## Artifacts - input
(*CDKBootstrapAction*/Inputs/**Artifacts**)
(Obligatorio si tu AWS CDK aplicación está almacenada en un [artefacto de salida](workflows-working-artifacts-output.md) 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 la aplicación de AWS CDK no está incluida en un artefacto, debe residir en el repositorio de código fuente.
Para obtener más información sobre los artefactos, incluidos ejemplos, consulte [Cómo compartir artefactos y archivos entre acciones](workflows-working-artifacts.md).
Interfaz de usuario correspondiente: pestaña Entradas/**Artefactos (opcional)**
## Outputs
(*CDKBootstrapAction*/**Outputs**)
(Opcional)
Define los datos que necesita una acción durante la ejecución de un flujo de trabajo.
Interfaz de usuario correspondiente: pestaña **Salidas**
## Artifacts - output
(*CDKBootstrapAction*/Outputs/**Artifacts**)
(Opcional)
Especifique el nombre de los artefactos generados por la acción. Puede hacer referencia a estos artefactos como entrada en otras acciones.
Para obtener más información sobre los artefactos, incluidos ejemplos, consulte [Cómo compartir artefactos y archivos entre acciones](workflows-working-artifacts.md).
Interfaz de usuario correspondiente: pestaña Salidas/**Artefactos**
## Name
(*CDKBootstrapAction*/Outputs/Artifacts/**Name**)
(Obligatorio si se incluye [Artifacts - output](#cdk.boot.outputs.artifacts))
**Especifique el nombre del artefacto que contendrá la CloudFormation plantilla sintetizada por la acción de arranque en tiempo de ejecución.AWS CDK ** El valor predeterminado es `cdk_bootstrap_artifacts`. Si no especifica un artefacto, la acción sintetizará la plantilla, pero no la guardará en un artefacto. Considere 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: genera el nombre del artefacto/crea el nombre del tab/Artifacts/Add artefacto**
## Files
(*CDKBootstrapAction*/Outputs/Artifacts/**Files**)
(Obligatorio si se incluye [Artifacts - output](#cdk.boot.outputs.artifacts))
Especifique los archivos que desee incluir en el artefacto. Debes especificar si quieres incluir `"cdk.out/**/*"` la plantilla sintetizada de tu AWS CDK aplicación. CloudFormation
**nota**
`cdk.out` es el directorio predeterminado en el que se guardan los archivos sintetizados. Si especificó un directorio de salida distinto de `cdk.out` en el archivo `cdk.json`, especifique ese directorio aquí en lugar de `cdk.out`.
Interfaz de usuario correspondiente: genera tab/Artifacts/Add artefactos o **archivos** producidos por la compilación
## Environment
(*CDKBootstrapAction*/**Environment**)
(Obligatorio)
Especifica el CodeCatalyst entorno que se va a utilizar con la acción. La acción se conecta a Cuenta de AWS la Amazon VPC opcional especificada en el entorno elegido. La acción utiliza la función de IAM predeterminada especificada en el entorno para conectarse a Cuenta de AWS, y utiliza la función de IAM especificada en la [conexión de Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) para conectarse a la Amazon VPC.
**nota**
Si el rol de IAM predeterminado no tiene los permisos necesarios para la acción, puede configurarla para que utilice un rol diferente. Para obtener más información, consulte [Cambio del rol de IAM de una acción](deploy-environments-switch-role.md).
Para obtener más información sobre los entornos, consulte [Implementación en Cuentas de AWS y VPCs](deploy-environments.md) y [Creación de un entorno](deploy-environments-creating-environment.md).
Interfaz de usuario correspondiente: pestaña Configuración/**Entorno**
## Name
(*CDKBootstrapAction*/Environment/**Name**)
(Obligatorio si se incluye [Environment](#cdk.boot.environment))
Especifique el nombre del entorno existente que desea asociar a la acción.
Interfaz de usuario correspondiente: pestaña Configuración/**Entorno**
## Connections
(*CDKBootstrapAction*/Environment/**Connections**)
(Opcional en las versiones más recientes de la acción; obligatorio en las versiones más antiguas)
Especifique la conexión de cuenta que desee asociar a la acción. Puede especificar un máximo de una conexión de cuenta en `Environment`.
Si no especifica una conexión de cuenta:
+ La acción utiliza la Cuenta de AWS conexión y la función de IAM predeterminada especificadas en el entorno de la consola. CodeCatalyst Para obtener información sobre cómo añadir una conexión de cuenta y un rol de IAM predeterminado al entorno, consulte [Creación de un entorno](deploy-environments-creating-environment.md).
+ El rol de IAM 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 **Role** en la documentación de la definición de YAML de la acción.
Para obtener más información sobre las conexiones de cuenta, consulte [Permitir el acceso a AWS los recursos con conexión Cuentas de AWS](ipa-connect-account.md). Para obtener más información sobre cómo añadir una conexión de cuenta a un entorno, consulte [Creación de un entorno](deploy-environments-creating-environment.md).
Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción.
+ (Versiones más recientes) ¿tab/Environment/WhatLa configuración está lista? *my-environment* **/menú de tres puntos/ Cambiar rol**
+ **(Versiones anteriores) Pestaña de configuración/' '/ conexión de cuenta Environment/account/role AWS **
## Name
(*CDKBootstrapAction*/Environment/Connections/**Name**)
(Obligatorio si se incluye [Connections](#cdk.boot.environment.connections))
Especifique el nombre de la conexión de cuenta.
Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción.
+ (Versiones más recientes) ¿La configuración está lista? tab/Environment/What *my-environment* **/menú de tres puntos/ Cambiar rol**
+ **(Versiones anteriores) Pestaña de configuración/' '/ conexión de cuenta Environment/account/role AWS **
## Role
(*CDKBootstrapAction*/Environment/Connections/**Role**)
(Obligatorio si se incluye [Connections](#cdk.boot.environment.connections))
Especifique el nombre de la función de IAM que la acción de **AWS CDK arranque utiliza para acceder a la pila de arranque** AWS y añadirla. Asegúrese de haber [agregado el rol a su CodeCatalyst espacio](ipa-connect-account-addroles.md) y de que el rol incluya las siguientes políticas.
Si no especifica un rol de IAM, la acción utilizará el rol de IAM predeterminado que aparece en el [entorno](deploy-environments.md) de la consola. CodeCatalyst Si usa el rol predeterminado en el entorno, asegúrese de que tenga las políticas adecuadas.
Puede usar el rol `CodeCatalystWorkflowDevelopmentRole-spaceName` con esta acción, si así lo desea. Para obtener más información acerca de este rol, consulte [Creación del rol **CodeCatalystWorkflowDevelopmentRole-*spaceName*** para su cuenta y su espacio](ipa-iam-roles.md#ipa-iam-roles-service-create). Tenga en cuenta que el rol `CodeCatalystWorkflowDevelopmentRole-spaceName` tiene permisos de acceso total, lo que puede suponer un riesgo para la seguridad. Le recomendamos que utilice este rol solo en tutoriales y situaciones en las que la seguridad no sea un problema.
Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción.
+ (Versiones más recientes) ¿tab/Environment/WhatLa configuración está lista? *my-environment* **/menú de tres puntos/ Cambiar rol**
+ **(Versiones anteriores) Pestaña de configuración/' '/ Rol Environment/account/role**
## 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 **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](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes).
Interfaz de usuario correspondiente: pestaña 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 **Implementación de AWS CDK ** y en la versión 1.0.8 o posterior de la acción **Arranque de AWS CDK **.
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.
O
+ `latest`. Considere la posibilidad de especificar `latest` para aprovechar las características y correcciones más recientes de la CLI de CDK.
La acción descargará la versión especificada (o la última versión) de la AWS CDK CLI a la [imagen de CodeCatalyst compilación](build-images.md) y, a continuación, utilizará esta versión para ejecutar los comandos necesarios para implementar la aplicación CDK o arrancar el entorno. AWS
Para obtener una lista de las versiones de CLI de CDK compatibles que puede utilizar, consulte [Versiones de AWS CDK](https://docs.aws.amazon.com/cdk/api/versions.html).
Si omite esta propiedad, la acción utilizará una versión AWS CDK CLI predeterminada que se describe en uno de los temas siguientes:
+ [Versiones de CDK CLI utilizadas por la acción de «AWS CDK implementar»](cdk-dep-action.md#cdk-dep-action-cdk-version)
+ [Versiones de CDK CLI utilizadas por la acción «AWS CDK bootstrap»](cdk-boot-action.md#cdk-boot-action-cdk-version)
Interfaz de usuario correspondiente: pestaña de configuración/versión **AWS CDK CLI**