Definición de YAML de la acción «Implementar AWS CloudFormation pila»

La siguiente es la definición en YAML de la acción Deploy AWS CloudFormation stack. Para obtener información sobre cómo utilizar esta acción, consulteImplementación de una AWS CloudFormation pila 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.    
  DeployCloudFormationStack:  
    Identifier: aws/cfn-deploy@v1
    DependsOn:
      - build-action
    Compute:  
      Type: EC2 | Lambda
      Fleet: fleet-name
    Timeout: timeout-minutes
    Environment:
      Name: environment-name
      Connections:
        - Name: account-connection-name
          Role: DeployRole
    Inputs:
      Sources:
        - source-name-1
      Artifacts:
        - CloudFormation-artifact
    Configuration:
      name: stack-name
      region: us-west-2
      template: template-path
      role-arn: arn:aws:iam::123456789012:role/StackRole        
      capabilities: CAPABILITY_IAM,CAPABILITY_NAMED_IAM,CAPABILITY_AUTO_EXPAND
      parameter-overrides: KeyOne=ValueOne,KeyTwo=ValueTwo | path-to-JSON-file
      no-execute-changeset: 1|0
      fail-on-empty-changeset: 1|0
      disable-rollback: 1|0
      termination-protection: 1|0
      timeout-in-minutes: minutes
      notification-arns: arn:aws:sns:us-east-1:123456789012:MyTopic,arn:aws:sns:us-east-1:123456789012:MyOtherTopic
      monitor-alarm-arns: arn:aws:cloudwatch::123456789012:alarm/MyAlarm,arn:aws:cloudwatch::123456789012:alarm/MyOtherAlarm
      monitor-timeout-in-minutes: minutes       
      tags: '[{"Key":"MyKey1","Value":"MyValue1"},{"Key":"MyKey2","Value":"MyValue2"}]'

DeployCloudFormationStack

(Obligatorio)

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

Predeterminado: DeployCloudFormationStack_nn.

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

Identifier

(DeployCloudFormationStack/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/cfn-deploy@v1.

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

DependsOn

(DeployCloudFormationStack/DependsOn)

(Opcional)

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

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

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

Compute

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

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

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

(DeployCloudFormationStack/Timeout)

(Opcional)

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 en minutos (opcional)

Environment

(DeployCloudFormationStack/Environment)

(Obligatorio)

Especifique 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 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

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

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

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

(DeployCloudFormationStack/Environment/Connections/Role)

Connections(Obligatorio si está incluido)

Especifique el nombre de la función de IAM que la acción Deploy AWS CloudFormation stack utiliza para acceder al servicio AWS y al AWS CloudFormation servicio. 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 para la seguridad.


{
    "Version": "2012-10-17",
    "Statement": [{
    "Action": [
        "cloudformation:CreateStack",
        "cloudformation:DeleteStack",
        "cloudformation:Describe*",
        "cloudformation:UpdateStack",
        "cloudformation:CreateChangeSet",
        "cloudformation:DeleteChangeSet",
        "cloudformation:ExecuteChangeSet",
        "cloudformation:SetStackPolicy",
        "cloudformation:ValidateTemplate",
        "cloudformation:List*",
        "iam:PassRole"
    ],
    "Resource": "*",
    "Effect": "Allow"
}]
}

nota

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


"Resource": "*"

La siguiente política de confianza personalizada:


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

nota

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

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

(Versiones más recientes) Pestaña de configuración/Entorno/¿Qué hay en mi entorno? /menú de tres puntos/ Cambiar rol
(Versiones anteriores) Pestaña de configuración/'Entorno/cuenta/role'/ Rol

Inputs

(DeployCloudFormationStack/Inputs)

(Opcional)

En Inputs esta sección se definen los datos que se necesitan durante la ejecución de un flujo de trabajo. DeployCloudFormationStack

nota

Se permite un máximo de cuatro entradas (una fuente y tres artefactos) por cada acción de Deploy AWS CloudFormation stack.

Si necesitas hacer referencia a archivos que se encuentran en entradas diferentes (por ejemplo, una fuente y un artefacto), la entrada de origen es la entrada principal y el artefacto es la entrada secundaria. Las referencias a los archivos en las entradas secundarias llevan un prefijo especial para distinguirlas de las principales. Para obtener más detalles, consulte Ejemplo: hacer referencia a archivos en varios artefactos.

Interfaz de usuario correspondiente: pestaña de entradas

Sources

(DeployCloudFormationStack/Inputs/Sources)

(Necesaria si tu AWS SAM plantilla CloudFormation o plantilla está almacenada en un repositorio de fuentes)

Si su AWS SAM plantilla CloudFormation o plantilla está almacenada en un repositorio de origen, especifique la etiqueta de ese repositorio de origen. Actualmente, la única etiqueta admitida esWorkflowSource.

Si su AWS SAM plantilla CloudFormation o su plantilla no se encuentran en un repositorio de origen, deben residir en un artefacto generado por otra acción o en un bucket de Amazon S3.

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

(DeployCloudFormationStack/Inputs/Artifacts)

(Obligatorio si tu AWS SAM plantilla CloudFormation o plantilla está almacenada en un artefacto de salida de una acción anterior)

Si la AWS SAM plantilla CloudFormation o que desea implementar está incluida en un artefacto generado por una acción anterior, especifique ese artefacto aquí. Si la CloudFormation plantilla no está incluida en un artefacto, debe residir en el repositorio de origen o en un bucket de Amazon S3.

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 configuración/Artefactos: opcional

Configuration

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

name

(DeployCloudFormationStack/Configuration/name)

(Obligatorio)

Especifique un nombre para la CloudFormation pila que la acción Implementar AWS CloudFormation pila crea o actualiza.

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

region

(DeployCloudFormationStack/Configuration/region)

(Obligatorio)

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

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

template

(DeployCloudFormationStack/Configuration/template)

(Obligatorio)

Especifique el nombre y la ruta de su archivo CloudFormation o AWS SAM de plantilla. La plantilla puede estar en formato JSON o YAML y puede residir en un repositorio de origen, un artefacto de una acción anterior o un bucket de Amazon S3. Si el archivo de plantilla está en un repositorio o artefacto fuente, la ruta es relativa a la fuente o raíz del artefacto. Si la plantilla está en un bucket de Amazon S3, la ruta es el valor de la URL del objeto de la plantilla.

Ejemplos:

./MyFolder/MyTemplate.json

MyFolder/MyTemplate.yml

https://MyBucket.s3.us-west-2.amazonaws.com/MyTemplate.yml

nota

Es posible que tengas que añadir un prefijo a la ruta del archivo de la plantilla para indicar en qué artefacto o fuente puedes encontrarla. Para obtener más información, consulte Hacer referencia a archivos en un repositorio de fuentes y Hacer referencia a los archivos de un artefacto.

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

role-arn

(DeployCloudFormationStack/Configuration/role-arn)

(Obligatorio)

Especifique el nombre de recurso de Amazon (ARN) de la función de pila. CloudFormation utiliza este rol para acceder a los recursos de la pila y modificarlos. Por ejemplo: arn:aws:iam::123456789012:role/StackRole.

Asegúrese de que la función de pila incluya:

Una o más políticas de permisos. Las políticas dependen de los recursos de los que dispongas. Por ejemplo, si su pila incluye una AWS Lambda función, debe añadir permisos que permitan el acceso a Lambda. Si ha seguido el tutorial que se describe enTutorial: Implemente una aplicación sin servidor mediante AWS CloudFormation, incluye un procedimiento denominado Para crear un rol de pila que enumera los permisos que necesita la función de pila si va a implementar una pila de aplicaciones sin servidor típica.

aviso
Limite los permisos a los que requiere el CloudFormation servicio para acceder a los recursos de su pila. El uso de un rol con permisos más amplios puede suponer un riesgo de seguridad.

La siguiente política de confianza:


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

Si lo desea, asocie este rol a la conexión de su cuenta. Para obtener más información sobre cómo asociar un rol de IAM a una conexión de cuenta, consulte. Añadir funciones de IAM a las conexiones de cuentas Si no asocias el rol de pila a la conexión de la cuenta, el rol de pila no aparecerá en la lista desplegable del rol de pila del editor visual; sin embargo, el ARN del rol aún se puede especificar en el role-arn campo mediante el editor YAML.

nota

Interfaz de usuario correspondiente: pestaña de configuración/función de pila (opcional)

capabilities

(DeployCloudFormationStack/Configuration/capabilities)

(Obligatorio)

Especifique una lista de las capacidades de IAM necesarias para poder AWS CloudFormation crear determinadas pilas. En la mayoría de los casos, puede quedarse capabilities con el valor predeterminado de. CAPABILITY_IAM,CAPABILITY_NAMED_IAM,CAPABILITY_AUTO_EXPAND

Si ves ##[error] requires capabilities: [capability-name] en los registros de tus acciones de Deploy AWS CloudFormation stack, consulta ¿Cómo puedo corregir los errores de las capacidades de IAM? para obtener información sobre cómo solucionar el problema.

Para obtener más información sobre las capacidades de IAM, consulte Reconocimiento de los recursos de IAM en AWS CloudFormation las plantillas de la Guía del usuario de IAM.

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

parameter-overrides

(DeployCloudFormationStack/Configuration/parameter-overrides)

(Opcional)

Especifique los parámetros en su AWS CloudFormation AWS SAM plantilla que no tengan valores predeterminados o para los que desee especificar valores no predeterminados. Para obtener más información sobre los parámetros, consulte Parámetros en la Guía del AWS CloudFormation usuario.

El parameter-overrides establecimiento acepta:

Un archivo JSON que contiene los parámetros y valores.
Una lista de parámetros y valores separados por comas.

Para especificar un archivo JSON

Asegúrese de que el archivo JSON utilice una de las siguientes sintaxis:
```
{
  "Parameters": {
    "Param1": "Value1",
    "Param2": "Value2",
    ...
  }
}
```
O bien…
```
[
  {
     "ParameterKey": "Param1",
     "ParameterValue": "Value1"
  },
  ...
]
```
(Existen otras sintaxis, pero no las admiten CodeCatalyst en el momento de escribir este artículo). Para obtener más información sobre cómo especificar CloudFormation los parámetros en un archivo JSON, consulte la Sintaxis JSON admitida en la Referencia de AWS CLI comandos.

Especifique la ruta al archivo JSON mediante uno de los siguientes formatos:

Si el archivo JSON reside en un artefacto de salida de una acción anterior, utilice:

file:///artifacts/current-action-name/output-artifact-name/path-to-json-file

Consulte el ejemplo 1 para obtener más información.

Si el archivo JSON reside en el repositorio de origen, usa:

file:///sources/WorkflowSource/path-to-json-file

Consulte el ejemplo 2 para obtener más información.

Ejemplo 1: El archivo JSON reside en un artefacto de salida


##My workflow YAML
...
Actions:
  MyBuildAction:
    Identifier: aws/build@v1
    Outputs:
      Artifacts:
        - Name: ParamArtifact
          Files:
            - params.json
    Configuration:
    ...
  MyDeployCFNStackAction:
    Identifier: aws/cfn-deploy@v1
    Configuration:
      parameter-overrides: file:///artifacts/MyDeployCFNStackAction/ParamArtifact/params.json

Ejemplo 2: El archivo JSON reside en el repositorio de origen, en una carpeta llamada my/folder


##My workflow YAML
...
Actions:
  MyDeployCloudFormationStack:
    Identifier: aws/cfn-deploy@v1
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:
      parameter-overrides: file:///sources/WorkflowSource/my/folder/params.json

Para usar una lista de parámetros separados por comas

Añada pares de nombre-valor de los parámetros a la parameter-overrides propiedad con el siguiente formato:

param-1=value-1,param-2=value-2

Por ejemplo, suponiendo la siguiente plantilla: AWS CloudFormation
```
##My CloudFormation template

Description: My AWS CloudFormation template

Parameters:
  InstanceType:
    Description: Defines the Amazon EC2 compute for the production server.
    Type: String
    Default: t2.micro
    AllowedValues:
      - t2.micro
      - t2.small
      - t3.medium
    
Resources:
...
```
... puede establecer la parameter-overrides propiedad de la siguiente manera:
```
##My workflow YAML
...
Actions:
...
  DeployCloudFormationStack:
    Identifier: aws/cfn-deploy@v1
    Configuration:
      parameter-overrides: InstanceType=t3.medium,UseVPC=true   
```
nota
Puede especificar un nombre de parámetro sin el valor correspondiente utilizando undefined como valor. Por ejemplo:
parameter-overrides: MyParameter=undefined
El efecto es que, durante una actualización de la pila, CloudFormation utiliza el valor del parámetro existente para el nombre del parámetro dado.

Interfaz de usuario correspondiente:

Pestaña de configuración/Avanzado/Modificaciones de parámetros
Pestaña de configuración/Avanzado/Modificaciones de parámetros/ Especifique las anulaciones mediante un archivo
Pestaña de configuración/Avanzado/Modificaciones de parámetros/ Especifique las anulaciones mediante un conjunto de valores

no-execute-changeset

(DeployCloudFormationStack/Configuration/no-execute-changeset)

(Opcional)

Especifique si desea crear el conjunto de cambios y, CodeCatalyst a continuación, detenerlo antes de ejecutarlo CloudFormation . Esto le da la oportunidad de revisar el conjunto de cambios en la CloudFormation consola. Si determina que el conjunto de cambios se ve bien, desactive esta opción y, a continuación, vuelva a ejecutar el flujo de trabajo para CodeCatalyst poder crear y ejecutar el conjunto de cambios sin detenerlo. La opción predeterminada es crear y ejecutar el conjunto de cambios sin detenerlo. Para obtener más información, consulte el parámetro de AWS CloudFormation despliegue en la Referencia de AWS CLI comandos. Para obtener más información sobre la visualización de los conjuntos de cambios, consulte Visualización de un conjunto de cambios en la Guía del AWS CloudFormation usuario.

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada/Conjunto de cambios sin ejecutar

fail-on-empty-changeset

(DeployCloudFormationStack/Configuration/fail-on-empty-changeset)

(Opcional)

Especifique si desea que no se ejecute la acción CodeCatalyst Implementar AWS CloudFormation pila si el conjunto de cambios está vacío. CloudFormation (Si un conjunto de cambios está vacío, significa que no se realizaron cambios en la pila durante la última implementación). La opción predeterminada es permitir que la acción continúe si el conjunto de cambios está vacío y devolver un UPDATE_COMPLETE mensaje aunque la pila no se haya actualizado.

Para obtener más información sobre esta configuración, consulte el parámetro de AWS CloudFormation despliegue en la Referencia de AWS CLI comandos. Para obtener más información sobre los conjuntos de cambios, consulte Actualización de pilas mediante conjuntos de cambios en la Guía del AWS CloudFormation usuario.

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada/Error en el conjunto de cambios vacío

disable-rollback

(DeployCloudFormationStack/Configuration/disable-rollback)

(Opcional)

Especifique si desea revertir la implementación de la pila CodeCatalyst en caso de que se produzca un error. La reversión devuelve la pila al último estado estable conocido. La opción predeterminada es habilitar las reversiones. Para obtener más información sobre esta configuración, consulte el parámetro de AWS CloudFormation despliegue en la Referencia de AWS CLI comandos.

Para obtener más información sobre cómo la acción Implementar AWS CloudFormation pila gestiona las reversiones, consulteConfiguración de reversiones.

Para obtener más información sobre cómo revertir una pila, consulte las opciones de error de apilamiento en la Guía del AWS CloudFormation usuario.

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada/Desactivar la reversión

termination-protection

(DeployCloudFormationStack/Configuration/termination-protection)

(Opcional)

Especifique si desea que la pila de implementación añada una protección de terminación a la AWS CloudFormation pila que está desplegando. Si un usuario intenta eliminar una pila con la protección de terminación habilitada, la eliminación fallará y la pila junto con su estado no cambiarán. La opción predeterminada es deshabilitar la protección de terminación. Para obtener más información, consulte Proteger una pila para que no se elimine en la Guía del AWS CloudFormation usuario.

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada/Protección de terminación

timeout-in-minutes

(DeployCloudFormationStack/Configuration/timeout-in-minutes)

(Opcional)

Especifique la cantidad de tiempo, en minutos, que CloudFormation debe transcurrir antes de agotar el tiempo de espera de las operaciones de creación de la pila y establecer el estado de la pila en. CREATE_FAILED Si no CloudFormation puede crear la pila completa en el tiempo asignado, no se podrá crear la pila debido al tiempo de espera y la revierte.

De forma predeterminada, no hay tiempo de espera para la creación de pilas. Sin embargo, puede que determinados recursos individuales tengan sus propios tiempos de espera en función de la naturaleza del servicio que implementan. Por ejemplo, si se agota el tiempo de espera de un recurso individual de la pila, también se agota el tiempo de espera de creación de la pila aunque todavía no se haya agotado el tiempo de espera especificado para la creación de la pila.

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada/Tiempo de espera CloudFormation

notification-arns

(DeployCloudFormationStack/Configuration/notification-arns)

(Opcional)

Especifique el ARN de un tema de Amazon SNS al que CodeCatalyst desee enviar los mensajes de notificación. Por ejemplo, arn:aws:sns:us-east-1:111222333:MyTopic. Cuando se ejecute la acción Implementar una AWS CloudFormation pila, CodeCatalyst coordine con ella CloudFormation para enviar una notificación por cada AWS CloudFormation evento que se produzca durante el proceso de creación o actualización de la pila. (Los eventos están visibles en la pestaña Eventos de la AWS CloudFormation consola para la pila). Puede especificar hasta cinco temas. Para obtener más información, consulte ¿Qué es Amazon SNS?

Interfaz de usuario correspondiente: pestaña de configuración/avanzada/ARN de notificación

monitor-alarm-arns

(DeployCloudFormationStack/Configuration/monitor-alarm-arns)

(Opcional)

Especifique el nombre de recurso de Amazon (ARN) de una CloudWatch alarma de Amazon para utilizarla como activador de reversión. Por ejemplo, arn:aws:cloudwatch::123456789012:alarm/MyAlarm. Puede tener un máximo de cinco activadores de reversión.

nota

Si especificas un CloudWatch ARN de alarma, también tendrás que configurar permisos adicionales para permitir el acceso de la acción. CloudWatch Para obtener más información, consulte Configuración de reversiones.

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada/Monitorear los ARN de alarma

monitor-timeout-in-minutes

(DeployCloudFormationStack/Configuration/monitor-timeout-in-minutes)

(Opcional)

Especifique un período de tiempo, de 0 a 180 minutos, durante el cual se supervisarán las alarmas especificadas. CloudFormation La supervisión comienza después de que se hayan desplegado todos los recursos de la pila. Si la alarma se produce dentro del tiempo de supervisión especificado, la implementación falla y CloudFormation revierte toda la operación de apilamiento.

Predeterminado: 0. CloudFormation solo monitorea las alarmas mientras se despliegan los recursos de la pila, no después.

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada/Tiempo de monitoreo