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. # Implementación de una AWS CDK aplicación con un flujo de trabajo En esta sección, se describe cómo implementar una AWS Cloud Development Kit (AWS CDK) aplicación en tu AWS cuenta mediante un flujo de trabajo. Para ello, debe añadir la acción **Implementación de AWS CDK ** a su flujo de trabajo. La acción de **AWS CDK despliegue** sintetiza y despliega la AWS Cloud Development Kit (AWS CDK) aplicación en. AWS Si tu aplicación ya existe en AWS, la acción la actualiza si es necesario. Para obtener información general sobre cómo escribir aplicaciones con AWS CDK, consulta [¿Qué es AWS CDK?](https://docs.aws.amazon.com/cdk/v2/guide/home.html) en la *Guía para AWS Cloud Development Kit (AWS CDK) desarrolladores*. **Topics** + [Cuándo utilizar la acción «AWS CDK desplegar»](#cdk-dep-action-when-to-use) + [Cómo funciona la acción de «AWS CDK desplegar»](#cdk-dep-action-how-it-works) + [Versiones de CDK CLI utilizadas por la acción de «AWS CDK implementar»](#cdk-dep-action-cdk-version) + [Imagen de tiempo de ejecución utilizada por la acción de «despliegue»AWS CDK](#cdk-dep-action-runtime) + [¿Cuántas pilas puede implementar la acción?](#cdk-dep-action-how-many-stacks) + [Ejemplo: Implementación de una AWS CDK aplicación](cdk-dep-action-example-workflow.md) + [Añadir la acción «AWS CDK desplegar»](cdk-dep-action-add.md) + [Variables de 'Implementación de AWS CDK '](cdk-dep-action-variables.md) + [YAML de la acción 'Implementación de AWS CDK '](cdk-dep-action-ref.md) ## Cuándo utilizar la acción «AWS CDK desplegar» Utilice esta acción si ha desarrollado una aplicación con el AWS CDK y ahora desea implementarla automáticamente como parte de un flujo de trabajo automatizado de integración y entrega continuas (CI/CD). Por ejemplo, es posible que desees implementar tu AWS CDK app automáticamente cada vez que alguien fusione una solicitud de cambios relacionada con la fuente de tu AWS CDK aplicación. ## Cómo funciona la acción de «AWS CDK desplegar» La **AWS CDK implementación** funciona de la siguiente manera: 1. [En tiempo de ejecución, si especificó la versión 1.0.12 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 del CodeCatalyst entorno de ejecución.](#cdk-dep-action-runtime) Si especificó la versión 1.0.13 o posterior, la acción viene incluida con una [versión específica](#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 deploy`. Este comando sintetiza y despliega la aplicación en ella. AWS CDK AWS Para obtener más información sobre este comando, consulte el tema [AWS CDK Toolkit (cdk command)](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html) en la *Guía para desarrolladores de AWS Cloud Development Kit (AWS CDK) *. ## Versiones de CDK CLI utilizadas por la acción de «AWS CDK implementar» 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 **Implementación de AWS CDK **. **nota** Puede invalidar la predeterminada. Para obtener más información, consulte [CdkCliVersion](cdk-dep-action-ref.md#cdk.dep.cdk.cli.version) en la [YAML de la acción 'Implementación de AWS CDK '](cdk-dep-action-ref.md). | Versión de la acción 'Implementación de AWS CDK ' | AWS CDK Versión CLI | | --- | --- | | 1.0.0 – 1.0.12 | más reciente | | 1.0.13 o posterior | 2.99.1 | ## Imagen de tiempo de ejecución utilizada por la acción de «despliegue»AWS CDK En la siguiente tabla se muestran las imágenes del entorno de ejecución que se CodeCatalyst utilizan para ejecutar diferentes versiones de la acción de **AWS CDK despliegue**. 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 **Implementación 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-deploy@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 'Implementación 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 | ## ¿Cuántas pilas puede implementar la acción? La acción **Implementación de AWS CDK ** puede implementar una sola pila. Si tu AWS CDK aplicación consta de varias pilas, debes crear una pila principal con pilas anidadas e implementar la principal mediante esta acción. # Ejemplo: Implementación de una AWS CDK aplicación El siguiente ejemplo de flujo de trabajo incluye la acción **Implementación de AWS CDK ** junto con la acción **Arranque de AWS CDK **. El flujo de trabajo consta de los siguientes componentes que se ejecutarán en orden: + Un **desencadenador**: este desencadenador inicia la ejecución automática del flujo de trabajo cuando se introduce un cambio en el repositorio de código fuente. Este repositorio contiene tu AWS CDK aplicación. Para obtener más información acerca de los desencadenadores, consulte [Inicio de un flujo de trabajo y ejecución automática mediante desencadenadores](workflows-add-trigger.md). + Una acción de **AWS CDK arranque** (`CDKBootstrap`): al activarse, la acción despliega la pila de `CDKToolkit` arranque en ella. AWS Si la pila de `CDKToolkit` ya existe en el entorno, se actualizará si es necesario; de lo contrario, no ocurrirá nada y la acción se marcará como correcta. + Una acción de **AWS CDK despliegue** (`AWS CDK Deploy`): al finalizar la acción de **AWS CDK arranque**, la acción de **AWS CDK despliegue** sintetiza el código de la AWS CDK aplicación en una CloudFormation plantilla y despliega la pila definida en la plantilla. AWS **nota** El siguiente ejemplo de flujo de trabajo tiene fines ilustrativos y no funcionará sin una configuración adicional. **nota** En el código de YAML que se muestra a continuación, puede omitir las secciones `Connections:` si lo desea. Si omite estas secciones, debe asegurarse de que el rol especificado en el campo **Rol de IAM predeterminado** del entorno incluya los permisos y las políticas de confianza requeridos por las acciones **Arranque de AWS CDK ** e **Implementación de AWS CDK **. Para obtener más información sobre cómo configurar un entorno con un rol de IAM predeterminado, consulte [Creación de un entorno](deploy-environments-creating-environment.md). Para obtener más información sobre los permisos y las políticas de confianza que requieren las acciones **Arranque de AWS CDK ** e **Implementación de AWS CDK **, consulte la descripción de la propiedad `Role`en los campos [Acción 'Arranque de AWS CDK ' en YAML](cdk-boot-action-ref.md) y [YAML de la acción 'Implementación de AWS CDK '](cdk-dep-action-ref.md). ``` Name: codecatalyst-cdk-deploy-workflow SchemaVersion: 1.0 Triggers: - Type: PUSH Branches: - main Actions: CDKBootstrap: Identifier: aws/cdk-bootstrap@v2 Inputs: Sources: - WorkflowSource Environment: Name: codecatalyst-cdk-deploy-environment Connections: - Name: codecatalyst-account-connection Role: codecatalyst-cdk-bootstrap-role Configuration: Region: us-west-2 CDKDeploy: Identifier: aws/cdk-deploy@v2 DependsOn: - CDKBootstrap Environment: Name: codecatalyst-cdk-deploy-environment Connections: - Name: codecatalyst-account-connection Role: codecatalyst-cdk-deploy-role Inputs: Sources: - WorkflowSource Configuration: StackName: my-app-stack Region: us-west-2 ``` # Añadir la acción «AWS CDK desplegar» Siga estas instrucciones para añadir la acción **Implementación de AWS CDK ** a su flujo de trabajo. **Antes de empezar** Para poder añadir la acción **Implementación de AWS CDK ** a su flujo de trabajo, realice las siguientes tareas: 1. **Tenga una AWS CDK aplicación lista**. Puedes escribir tu AWS CDK aplicación usando la AWS CDK v1 o la v2, en cualquier lenguaje de programación compatible con AWS CDK. Asegúrese de que los archivos de la aplicación de AWS CDK estén disponibles en: + Un [repositorio CodeCatalyst de código fuente](source.md), o + Un [artefacto CodeCatalyst de salida](workflows-working-artifacts.md) generado por otra acción del flujo de trabajo 1. **Inicie su entorno. AWS ** Para arrancar, puede: + Usar uno de los métodos descritos en [How to bootstrap](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-howto) en la *Guía para desarrolladores de AWS Cloud Development Kit (AWS CDK) *. + Usar la acción **Arranque de AWS CDK **. Puede añadir esta acción al mismo flujo de trabajo que la acción **Implementación de AWS CDK ** o a uno diferente. Solo asegúrese de que la acción de arranque se ejecute al menos una vez antes de ejecutar la acción **Implementación de AWS CDK ** para disponer de los recursos necesarios. Para obtener más información sobre la acción de **AWS CDK arranque**, consulte. [Cómo iniciar una AWS CDK aplicación con un flujo de trabajo](cdk-boot-action.md) 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) *. ------ #### [ Visual ] **Para añadir la acción de «AWS CDK desplegar» 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 **Implementación 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 **Implementación de AWS CDK **. Aparecerá el cuadro de diálogo de detalles de la acción. En este cuadro de diálogo: + (Opcional) Seleccione **Descargar** 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** y **Configuración**, complete los campos según sus necesidades. Para obtener una descripción de cada uno de los campos, consulte la [YAML de la acción 'Implementación de AWS CDK '](cdk-dep-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 **Implementación 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 de «AWS CDK desplegar» mediante el editor YAML** 1. [Abre 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 **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 **Implementación 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 **Implementación de AWS CDK **. Aparecerá el cuadro de diálogo de detalles de la acción. En este cuadro de diálogo: + (Opcional) Seleccione **Descargar** 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. 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 [YAML de la acción 'Implementación de AWS CDK '](cdk-dep-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 **Implementación 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 'Implementación de AWS CDK ' La acción **Implementación 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 | | --- | --- | | stack-id | El nombre de recurso de Amazon (ARN) de la pila de AWS CDK aplicaciones en la que se implementó durante la ejecución del flujo de trabajo. Ejemplo: `arn:aws:cloudformation:us-west-2:111122223333:stack/codecatalyst-cdk-app-stack/6aad4380-100a-11ec-a10a-03b8a84d40df` | | 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ó durante la ejecución del flujo de trabajo. Ejemplo: `us-west-2` | | SKIP-DEPLOYMENT | Un valor de `true` indica que se omitió el despliegue de AWS CDK la pila de aplicaciones 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`. | | *CloudFormation variables* | Además de generar las variables enumeradas anteriormente, la acción de **AWS CDK despliegue** también expone las variables de *CloudFormation*salida como variables de *flujo* de trabajo para su uso en acciones de flujo de trabajo posteriores. De forma predeterminada, la acción solo expone las cuatro primeras CloudFormation variables (o menos) que encuentre. Para determinar cuáles se exponen, ejecute la acción **Implementación de AWS CDK ** una vez y, a continuación, consulte la pestaña **Variables** de la página de detalles de la ejecución. Si las variables que aparecen en la pestaña **Variables** no son las que desea, puede configurar otras variables mediante la propiedad `CfnOutputVariables` de YAML. Para obtener más información, consulte la descripción de la operación [CfnOutputVariables](cdk-dep-action-ref.md#cdk.dep.cfn.out) en la [YAML de la acción 'Implementación de AWS CDK '](cdk-dep-action-ref.md). | # YAML de la acción 'Implementación de AWS CDK ' La siguiente es la definición en YAML de la acción **Implementación de AWS CDK **. Para obtener información sobre cómo utilizar esta acción, consulte [Implementación de una AWS CDK aplicación con un flujo de trabajo](cdk-dep-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. CDKDeploy\$1nn: Identifier: aws/cdk-deploy@v2 DependsOn: - CDKBootstrap 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_artifact Files: - "cdk.out/**/*" Environment: Name: environment-name Connections: - Name: account-connection-name Role: iam-role-name Configuration: StackName: my-cdk-stack Region: us-west-2 Tags: '{"key1": "value1", "key2": "value2"}' Context: '{"key1": "value1", "key2": "value2"}' CdkCliVersion: version CdkRootPath: directory-containing-cdk.json-file CfnOutputVariables: '["CnfOutputKey1","CfnOutputKey2","CfnOutputKey3"]' CloudAssemblyRootPath: path-to-cdk.out ``` ## CDKDeploy (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: `CDKDeploy_nn`. Interfaz de usuario correspondiente: pestaña Configuración/**Nombre de la acción** ## Identifier (*CDKDeploy*/**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-deploy@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-deploy@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-deploy@v2`. Interfaz de usuario correspondiente: diagrama de flujo de trabajo/CDKDeploy\$1nn/etiqueta **aws/cdk-deploy@v2** ## DependsOn (*CDKDeploy*/**DependsOn**) (Opcional) Especifique la acción, el grupo de acciones o la puerta que debe ejecutarse correctamente para que la acción **Implementación de AWS CDK ** se ejecute. Se recomienda especificar la acción de **Arranque de AWS CDK ** en la propiedad de `DependsOn`, de la siguiente manera: ``` CDKDeploy: Identifier: aws/cdk-deploy@v2 DependsOn: - CDKBootstrap ``` **nota** El [arranque es un requisito previo obligatorio para implementar una aplicación](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html). AWS CDK Si no incluye la acción **Arranque de AWS CDK ** en su flujo de trabajo, debe buscar otra forma de implementar la pila de arranque de AWS CDK antes de ejecutar la acción **Implementación de AWS CDK **. Para obtener más información, consulta [Añadir la acción «AWS CDK desplegar»](cdk-dep-action-add.md) en [Implementación de una AWS CDK aplicación con un flujo de trabajo](cdk-dep-action.md). 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 (*CDKDeploy*/**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 (*CDKDeploy*/Compute/**Type**) (Obligatorio si se incluye [Compute](#cdk.dep.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 (*CDKDeploy*/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 (*CDKDeploy*/**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 (*CDKDeploy*/**Inputs**) (Opcional) La sección `Inputs` define los datos que necesita la acción `CDKDeploy` durante la ejecución de un flujo de trabajo. **nota** Solo se permite una entrada (ya sea un código fuente o un artefacto) para cada acción Implementación de AWS CDK . Interfaz de usuario correspondiente: pestaña **Entradas** ## Sources (*CDKDeploy*/Inputs/**Sources**) (Obligatorio si la AWS CDK aplicación que quieres implementar está almacenada en un repositorio de origen) Si AWS CDK la aplicación está almacenada en un repositorio de origen, especifique la etiqueta de ese repositorio de origen. La acción **Implementación de AWS CDK ** sintetiza la aplicación en este repositorio antes de iniciar el proceso de implementación. Actualmente, la única etiqueta 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 (*CDKDeploy*/Inputs/**Artifacts**) (Obligatorio si la AWS CDK aplicación que quieres implementar 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 despliegue** sintetiza la aplicación del artefacto especificado en una CloudFormation plantilla antes de iniciar el proceso de despliegue. 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, consulte [Cómo compartir artefactos y archivos entre acciones](workflows-working-artifacts.md). Interfaz de usuario correspondiente: pestaña Entradas/**Artefactos (opcional)** ## Outputs (*CDKDeploy*/**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 (*CDKDeploy*/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 (*CDKDeploy*/Outputs/Artifacts/**Name**) (Obligatorio si se incluye [Artifacts - output](#cdk.dep.outputs.artifacts)) Especifica el nombre del artefacto que contendrá la CloudFormation plantilla sintetizada por la acción de **AWS CDK despliegue** en tiempo de ejecución. El valor predeterminado es `cdk_artifact`. 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 tab/Artifacts/Add artefacto/crea el nombre del artefacto** ## Files (*CDKDeploy*/Outputs/Artifacts/**Files**) (Obligatorio si se incluye [Artifacts - output](#cdk.dep.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 (*CDKDeploy*/**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 (*CDKDeploy*/Environment/**Name**) (Obligatorio si se incluye [Environment](#cdk.dep.environment)) Especifique el nombre del entorno existente que desea asociar a la acción. Interfaz de usuario correspondiente: pestaña Configuración/**Entorno** ## Connections (*CDKDeploy*/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 (*CDKDeploy*/Environment/Connections/**Name**) (Obligatorio si se incluye [Connections](#cdk.dep.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 (*CDKDeploy*/Environment/Connections/**Role**) (Obligatorio si se incluye [Connections](#cdk.dep.environment.connections)) Especifique el nombre de la conexión de cuenta. Especifique el nombre de la función de IAM que la acción de **AWS CDK despliegue** utiliza para acceder a la pila de aplicaciones AWS e implementarla. AWS CDK 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 siguientes políticas. + La siguiente política de permisos: **aviso** Limite los permisos a los que se muestran en la siguiente política. El uso de un rol con permisos más amplios puede suponer un riesgo de seguridad. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "cloudformation:DescribeStackEvents", "cloudformation:DescribeChangeSet", "cloudformation:DescribeStacks", "cloudformation:ListStackResources" ], "Resource": "*" }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": "sts:AssumeRole", "Resource": "arn:aws:iam::111122223333:role/cdk-*" } ] } ``` ------ + La siguiente política de confianza personalizada: **nota** 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 (*CDKDeploy*/**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** ## StackName (*CDKDeploy*/Configuration/**StackName**) (Obligatorio) El nombre de la pila de AWS CDK aplicaciones, tal como aparece en el archivo de punto de entrada del directorio de la aplicación. AWS CDK `bin` En el siguiente ejemplo, se muestra el contenido de un archivo de TypeScript punto de entrada, con el nombre de la pila resaltado. *red italics* Si el archivo de puntos de entrada está en un lenguaje diferente, tendrá un aspecto similar. ``` import * as cdk from 'aws-cdk-lib'; import { CdkWorksopTypescriptStack } from '../lib/cdk_workshop_typescript-stack'; const app = new cdk.App(); new CdkWorkshopTypescriptStack(app, 'CdkWorkshopTypescriptStack'); ``` Solo puede especificar una sola pila. **sugerencia** Si tiene varias pilas, puede crear una pila principal con pilas anidadas. A continuación, puede especificar la pila principal en esta acción para implementar todas las pilas. Interfaz de usuario correspondiente: pestaña Configuración/**Nombre de la pila** ## Region (*CDKDeploy*/Configuration/**Region**) (Opcional) Especifique Región de AWS en qué lugar se desplegará la pila de AWS CDK aplicaciones. 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). Si no especifica una región, la acción de **AWS CDK despliegue** se despliega en la región especificada en el AWS CDK código. Para obtener más información, consulte [Environments](https://docs.aws.amazon.com/cdk/v2/guide/environments.html) en la *Guía para desarrolladores de AWS Cloud Development Kit (AWS CDK) *. Interfaz de usuario correspondiente: pestaña Configuración/**Región** ## Tags (*CDKDeploy*/Configuration/**Tags**) (Opcional) Especifique las etiquetas que desee aplicar a AWS los recursos de la pila de AWS CDK aplicaciones. Las etiquetas se aplican a la propia pila, así como a los distintos recursos de la pila. Para obtener más información acerca del etiquetado, consulte [Tagging](https://docs.aws.amazon.com/cdk/v2/guide/tagging.html) en la *Guía para desarrolladores de AWS Cloud Development Kit (AWS CDK) *. **Interfaz de usuario correspondiente: Configuración tab/Advanced : opcional/ Etiquetas** ## Context (*CDKDeploy*/Configuration/**Context**) (Opcional) Especifique los contextos, en forma de pares clave-valor, para asociarlos a la pila de aplicaciones. AWS CDK Para obtener más información sobre los contextos, consulte [Runtime contexts](https://docs.aws.amazon.com/cdk/v2/guide/context.html) en la *Guía para desarrolladores de AWS Cloud Development Kit (AWS CDK) *. **Interfaz de usuario correspondiente: Configuración tab/Advanced : opcional/contexto** ## CdkCliVersion (*CDKDeploy*/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** ## CdkRootPath (*CDKDeploy*/Configuration/**CdkRootPath**) (Opcional) La ruta al directorio que contiene el `cdk.json` archivo del AWS CDK proyecto. La acción **Implementación de AWS CDK ** se ejecuta desde esta carpeta y cualquier resultado creado por la acción se añadirá a este directorio. Si no se especifica, la acción de **AWS CDK despliegue** asume que el `cdk.json` archivo está en la raíz del AWS CDK proyecto. Interfaz de usuario correspondiente: pestaña Configuración/**Directorio donde reside el archivo cdk.json** ## CfnOutputVariables (*CDKDeploy*/Configuration/**CfnOutputVariables**) (Opcional) Especifique qué `CfnOutput` componentes del código de AWS CDK la aplicación desea exponer como variables de salida del flujo de trabajo. A continuación, puede hacer referencia a las variables de salida del flujo de trabajo en acciones posteriores del flujo de trabajo. Para obtener más información sobre las variables en CodeCatalyst, consulte[Uso de variables en flujos de trabajo](workflows-working-with-variables.md). Por ejemplo, si el código de AWS CDK la aplicación tiene este aspecto: ``` import { Duration, Stack, StackProps, CfnOutput, RemovalPolicy} from 'aws-cdk-lib'; import * as dynamodb from 'aws-cdk-lib/aws-dynamodb'; import * as s3 from 'aws-cdk-lib/aws-s3'; import { Construct } from 'constructs'; import * as cdk from 'aws-cdk-lib'; export class HelloCdkStack extends Stack { constructor(scope: Construct, id: string, props?: StackProps) { super(scope, id, props); const bucket = new s3.Bucket(this, 'amzn-s3-demo-bucket', { removalPolicy: RemovalPolicy.DESTROY, }); new CfnOutput(this, 'bucketName', { value: bucket.bucketName, description: 'The name of the s3 bucket', exportName: 'amzn-s3-demo-bucket', }); const table = new dynamodb.Table(this, 'todos-table', { partitionKey: {name: 'todoId', type: dynamodb.AttributeType.NUMBER}, billingMode: dynamodb.BillingMode.PAY_PER_REQUEST, removalPolicy: RemovalPolicy.DESTROY, }) new CfnOutput(this, 'tableName', { value: table.tableName, description: 'The name of the dynamodb table', exportName: 'myDynamoDbTable', }); ... } } ``` ...y la propiedad `CfnOutputVariables` tiene este aspecto: ``` Configuration: ... CfnOutputVariables: '["bucketName","tableName"]' ``` ...entonces la acción genera las siguientes variables de salida del flujo de trabajo: | Clave | Valor | | --- | --- | | bucketName | `bucket.bucketName` | | tableName | `table.tableName` | A continuación, puede hacer referencia a las variables `bucketName` y `tableName` en acciones posteriores. Para aprender a hacer referencia a las variables de salida del flujo de trabajo en acciones posteriores, consulte [Referencia a una variable predefinida](workflows-working-with-variables-reference-output-vars.md). Si no especifica ningún `CfnOutput` componente fijo en la `CfnOutputVariables` propiedad, la acción expone las cuatro primeras variables de salida (o menos) que encuentre como variables de CloudFormation salida del flujo de trabajo. Para obtener más información, consulte [Variables de 'Implementación de AWS CDK '](cdk-dep-action-variables.md). **sugerencia** Para obtener una lista de todas las variables de CloudFormation salida que produce la acción, ejecuta el flujo de trabajo que contiene la acción de **AWS CDK despliegue** una vez y, a continuación, consulta la pestaña **Registros** de la acción. Los registros contienen una lista de todas las variables CloudFormation de salida asociadas a tu AWS CDK aplicación. Una vez que sepas cuáles son todas las CloudFormation variables, puedes especificar cuáles quieres convertir en variables de salida del flujo de trabajo mediante la `CfnOutputVariables` propiedad. Para obtener más información sobre las variables de CloudFormation salida, consulta la documentación de la `CfnOutput` construcción, disponible en la [clase CfnOutput (construcción)](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnOutput.html) de la *referencia de la AWS Cloud Development Kit (AWS CDK) API*. Interfaz de usuario correspondiente: pestaña de configuración/variables **CloudFormation de salida** ## CloudAssemblyRootPath (*CDKDeploy*/Configuration/**CloudAssemblyRootPath**) (Opcional) Si ya sintetizó la pila de su AWS CDK aplicación en un ensamblaje en la nube (mediante la `cdk synth` operación), especifique la ruta raíz del directorio del ensamblaje en la nube (`cdk.out`). La CloudFormation plantilla ubicada en el directorio de ensamblaje de nube especificado se implementará mediante la acción de **AWS CDK implementación** Cuenta de AWS mediante el `cdk deploy --app` comando. Cuando la opción `--app` está presente, la operación `cdk synth` no se produce. Si no especifica un directorio de ensamblado en la nube, la acción **Implementación de AWS CDK ** ejecutará el comando `cdk deploy` sin la opción `--app`. Sin `--app` esta opción, la `cdk deploy` operación sintetizará (`cdk synth`) e implementará tu AWS CDK aplicación en tu Cuenta de AWS. **¿Por qué especificaría un ensamblaje de nube sintetizado y existente cuando la acción de «AWS CDK despliegue» puede realizar la síntesis en tiempo de ejecución?** Es posible que desee especificar un ensamblado en la nube sintetizado existente para: + **Asegúrese de implementar exactamente el mismo conjunto de recursos cada vez que se ejecute la acción de «AWS CDK despliegue»** Si no especifica un ensamblado en la nube, es posible que la acción **Implementación de AWS CDK ** sintetice e implemente archivos diferentes en función de cuándo se ejecute. Por ejemplo, la acción **Implementación de AWS CDK ** podría sintetizar un ensamblado en la nube con un conjunto de dependencias durante una fase de prueba y otro conjunto de dependencias durante una fase de producción (si esas dependencias cambiaran de una fase a otra). Para garantizar una paridad exacta entre lo que se ha probado y lo que se ha implementado, se recomienda sintetizar una vez y, después, usar el campo **Ruta al directorio de ensamblado en la nube** (editor visual) o la propiedad `CloudAssemblyRootPath` (editor de YAML) para especificar el ensamblado de nube ya sintetizado. + **Usar herramientas y administradores de paquetes no estándares con la aplicación de AWS CDK ** Durante una operación `synth`, la acción **Implementación de AWS CDK ** intenta ejecutar la aplicación con herramientas estándar, como npm o pip. Si la acción no puede ejecutar correctamente la aplicación con esas herramientas, la síntesis no se producirá y la acción fallará. Para solucionar este problema, puedes especificar los comandos exactos necesarios para ejecutar la aplicación correctamente en el `cdk.json` archivo de la AWS CDK aplicación y, a continuación, sintetizarla mediante un método que no implique la acción de **AWS CDK implementación**. Una vez generado el ensamblado en la nube, puede especificarlo en el campo **Ruta al directorio de ensamblado en la nube** (editor visual) o en la propiedad `CloudAssemblyRootPath` (editor de YAML) de la acción **Implementación de AWS CDK **. Para obtener información sobre cómo configurar el `cdk.json` archivo para que incluya comandos para instalar y ejecutar la AWS CDK aplicación, consulte [Especificar el comando de la aplicación](https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli-app-command). Para obtener información sobre los comandos `cdk deploy` y `cdk synth`, así como sobre la opción `--app`, consulte [Deploying stacks](https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli-deploy), [Synthesizing stacks](https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli-synth) y [Skipping synthesis](https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli-deploy-nosynth) en la *Guía para desarrolladores de AWS Cloud Development Kit (AWS CDK) *. Para obtener información acerca de los ensamblados en la nube, consulte [Cloud Assembly](https://docs.aws.amazon.com/cdk/api/v2/docs/cloud-assembly-schema-readme.html) en la *Referencia de la API de AWS Cloud Development Kit (AWS CDK) *. Interfaz de usuario correspondiente: pestaña Configuración/**Ruta al directorio de ensamblado en la nube**