definición de YAML de la acción «AWS CDK implementar» - Amazon CodeCatalyst

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.

definición de YAML de la acción «AWS CDK implementar»

La siguiente es la definición en YAML de la acción de AWS CDK despliegue. Para obtener información sobre cómo utilizar esta acción, consulteImplementación de una AWS Cloud Development Kit (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 Definición de flujo de trabajo YAML.

nota

La mayoría de las propiedades de YAML que aparecen a continuación tienen los elementos de interfaz de usuario correspondientes en el editor visual. Para buscar un elemento de la interfaz de usuario, usa Ctrl+F. El elemento aparecerá en la lista con su propiedad 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_nn: Identifier: aws/cdk-deploy@v1 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 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 se pueden usar comillas para habilitar los caracteres especiales y los espacios en los nombres de las acciones.

Predeterminado: CDKDeploy_nn.

Interfaz de usuario correspondiente: pestaña de 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 Especificar la versión principal, secundaria o de parche de una acción.

Predeterminado: aws/cdk-deploy@v1.

Interfaz de usuario correspondiente: diagrama de flujo de trabajo/ CDKDeploy _nn/ aws/cdk-deploy @v1 label

DependsOn

(CDKDeploy/DependsOn)

(Opcional)

Especifique una acción o un grupo de acciones que debe ejecutarse correctamente para que la acción de despliegue se ejecute.AWS CDK Se recomienda especificar la acción de AWS CDK arranque en la DependsOn propiedad, de la siguiente manera:

CDKDeploy: Identifier: aws/cdk-deploy@v1 DependsOn: - CDKBootstrap
nota

El arranque es un requisito previo obligatorio para implementar una aplicación. AWS CDK Si no incluye la acción de AWS CDK Bootstrap en su flujo de trabajo, debe buscar otra forma de implementar la pila de AWS CDK arranque antes de ejecutar la acción de despliegue.AWS CDK Para obtener más información, consulte Añadir la acción «AWS CDK desplegar» en Implementación de una AWS Cloud Development Kit (AWS CDK) aplicación con un flujo de trabajo.

Para obtener más información sobre la funcionalidad «depende de», consulte. Configurar acciones para que dependan de otras acciones

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

Compute

(CDKDeploy/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 las acciones.

Interfaz de usuario correspondiente: ninguna

Type

(CDKDeploy/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 (editor YAML)

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

  • Lambda (editor visual) o Lambda (editor YAML)

    Velocidades de inicio de acciones optimizadas.

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

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

Fleet

(CDKDeploy/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

(CDKDeploy/Timeout)

(Obligatorio)

Especifica la cantidad de tiempo en minutos (editor YAML) o en horas y minutos (editor visual) que la acción puede ejecutarse antes de que finalice la acción. CodeCatalyst El mínimo es de 5 minutos y el máximo se describe enCuotas para flujos de trabajo. 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

(CDKDeploy/Inputs)

(Opcional)

La Inputs sección define los datos que se CDKDeploy necesitan durante la ejecución de un flujo de trabajo.

nota

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

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 de AWS CDK despliegue sintetiza la aplicación en este repositorio antes de iniciar el proceso de despliegue. Actualmente, la única etiqueta admitida esWorkflowSource.

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 un flujo de trabajo a un repositorio de origen.

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

Artifacts - input

(CDKDeploy/Inputs/Artifacts)

(Obligatorio si la AWS CDK aplicación que quieres implementar 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 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, consulteCompartir datos entre acciones de un flujo de trabajo mediante artefactos.

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

Outputs

(CDKDeploy/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

(CDKDeploy/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 datos entre acciones de un flujo de trabajo mediante artefactos.

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

Name

(CDKDeploy/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 despliegue en tiempo de ejecución. El valor predeterminado es cdk_artifact. 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

(CDKDeploy/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

(CDKDeploy/Environment)

(Obligatorio)

Especifica el entorno que se va a usar con la acción. CodeCatalyst 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 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 Asignación de una función de IAM diferente a una acción.

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

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

Name

(CDKDeploy/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

(CDKDeploy/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 la función de IAM predeterminada especificadas en el entorno de la CodeCatalyst consola. 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

  • La función de IAM predeterminada debe incluir las políticas y los permisos que requiere la acción. Para determinar cuáles son esas políticas y permisos, consulta la descripción de la propiedad del rol en la documentación de definición de YAML 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/¿Qué hay en mi entorno? /menú de tres puntos/ Cambiar rol

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

Name

(CDKDeploy/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/¿Qué hay en mi entorno? /menú de tres puntos/ Cambiar rol

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

Role

(CDKDeploy/Environment/Connections/Role)

Connections(Obligatorio si está incluido)

Especifique el nombre de la conexión de la 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 AWS CDK aplicaciones AWS e implementarla. Asegúrese de haber agregado el rol a su CodeCatalyst espacio 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 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.

    { "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::aws-account:role/cdk-*" } ] }
  • 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. Te recomendamos que solo utilices este rol en los tutoriales y en 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/¿Qué hay en mi entorno? /menú de tres puntos/ Cambiar rol

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

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 de 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 AWS CDK bin aplicación. En el siguiente ejemplo, se muestra el contenido de un archivo de TypeScript punto de entrada, con el nombre de la pila resaltado en cursiva roja. Si el archivo de puntos de entrada está en otro idioma, 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 pila.

sugerencia

Si tiene varias pilas, puede crear una pila principal con pilas anidadas. A continuación, puedes especificar la pila principal en esta acción para desplegar todas las pilas.

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

Region

(CDKDeploy/Configuration/Region)

(Opcional)

Especifique el lugar Región de AWS en el que se desplegará la pila de AWS CDK aplicaciones. Para ver una lista de códigos de regiones, consulte Puntos de conexión regionales.

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 Entornos en la Guía para AWS Cloud Development Kit (AWS CDK) desarrolladores.

Interfaz de usuario correspondiente: pestaña o región de configuració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 recursos individuales de la pila. Para obtener más información sobre el etiquetado, consulte Etiquetado en la Guía para AWS Cloud Development Kit (AWS CDK) desarrolladores.

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada: 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 los contextos de ejecución en la Guía AWS Cloud Development Kit (AWS CDK) para desarrolladores.

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada: opcional/contexto

CdkCliVersion

(CDKDeploy/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 acción de arranque.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.

    Or (Disyunción)

  • latest. Considere la posibilidad de especificar latest para aprovechar las funciones 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 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 CDK CLI compatibles que puede utilizar, consulte AWS CDK Versiones.

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

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 de AWS CDK despliegue 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 se encuentra en la raíz del AWS CDK proyecto.

Interfaz de usuario correspondiente: pestaña de configuración o directorio donde reside el cdk.json

CfnOutputVariables

(CDKDeploy/Configuration/CfnOutputVariables)

(Opcional)

Especifique qué CfnOutput construcciones del código de su AWS CDK 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 de CodeCatalyst, consulteConfiguración y uso de variables en un flujo de trabajo.

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, 'my-bucket', { removalPolicy: RemovalPolicy.DESTROY, }); new CfnOutput(this, 'bucketName', { value: bucket.bucketName, description: 'The name of the s3 bucket', exportName: 'myBucket', }); 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 su CfnOutputVariables propiedad 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 tableName las variables bucketName y en acciones posteriores. Para obtener información sobre cómo hacer referencia a las variables de salida del flujo de trabajo en acciones posteriores, consulteHacer referencia a una variable predefinida.

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 producidas por la acción «AWS CDK desplegar» .

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 AWS CloudFormation salida, consulta la documentación de la CfnOutput construcción, disponible en la clase CfnOutput (construcción) de la referencia de la AWS Cloud Development Kit (AWS CDK) API.

Interfaz de usuario correspondiente: pestaña de configuración/variables AWS 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 AWS CloudFormation plantilla ubicada en el directorio de ensamblaje en la nube especificado se implementará mediante la acción de AWS CDK implementación Cuenta de AWS mediante el cdk deploy --app comando. Cuando la --app opción está presente, la cdk synth operación no se produce.

Si no especifica un directorio de ensamblaje en la nube, la acción de AWS CDK despliegue ejecutará el cdk deploy comando sin la --app opción. 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 ensamblaje de 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 especificas un ensamblaje en la nube, es posible que la acción de AWS CDK despliegue sintetice e implemente diferentes archivos en función de cuándo se ejecute. Por ejemplo, la acción de AWS CDK despliegue podría sintetizar un ensamblaje 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 etapa a otra). Para garantizar una paridad exacta entre lo que se ha probado y lo que se ha desplegado, se recomienda sintetizar una vez y, a continuación, utilizar el campo Ruta del directorio del ensamblaje de nube (editor visual) o la CloudAssemblyRootPath propiedad (editor YAML) para especificar el ensamblaje de nube ya sintetizado.

  • Utilice herramientas y gestores de paquetes no estándares con la aplicación AWS CDK

    Durante una synth operación, la acción de AWS CDK despliegue intenta ejecutar la aplicación con herramientas estándar, como npm o pip. Si la acción no puede ejecutar correctamente tu 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 ensamblaje de nube, puedes especificarlo en el campo Ruta al directorio del ensamblaje en la nube (editor visual) o en la CloudAssemblyRootPath propiedad (editor YAML) de la acción de AWS CDK despliegue.

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.

Para obtener información sobre los cdk synth comandos cdk deploy y, así como sobre la --app opción, consulte Implementar pilas, Sintetizar pilas y omitir la síntesis en la Guía para desarrolladores.AWS Cloud Development Kit (AWS CDK)

Para obtener información sobre Cloud Assembly, consulta Cloud Assembly en la referencia de la API.AWS Cloud Development Kit (AWS CDK)

Interfaz de usuario correspondiente: pestaña de configuración o ruta al directorio de ensamblaje en la nube