Ação “Deploy AWS CloudFormation stack” YAML

A seguir está a YAML definição da ação Deploy AWS CloudFormation stack. Para saber como usar essa ação, consulteImplantação de uma pilha AWS CloudFormation.

Essa definição de ação existe como uma seção dentro de um arquivo de definição de fluxo de trabalho mais amplo. Para obter mais informações sobre esse arquivo, consulte YAMLDefinição de fluxo de trabalho.

nota

A maioria das YAML propriedades a seguir tem elementos de interface de usuário correspondentes no editor visual. Para pesquisar um elemento de interface do usuário, use Ctrl+F. O elemento será listado com sua YAML propriedade associada.


# The workflow definition starts here.
# See Propriedades de nível 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

(Obrigatório)

Especifique o nome da ação. Todos os nomes das ações devem ser exclusivos no fluxo de trabalho. Os nomes das ações são limitados a caracteres alfanuméricos (a-z, A-Z, 0-9), hífens (-) e sublinhados (_). Não são permitidos espaços. Você não pode usar aspas para ativar caracteres especiais e espaços nos nomes das ações.

Padrão: DeployCloudFormationStack_nn.

UI correspondente: guia de configuração/nome de exibição da ação

Identifier

(DeployCloudFormationStack/Identifier)

(Obrigatório)

Identifica a ação. Não altere essa propriedade, a menos que você queira alterar a versão. Para ter mais informações, consulte Especificando a versão da ação a ser usada.

Padrão: aws/cfn-deploy@v1.

UI correspondente: diagrama de fluxo de trabalho/ DeployCloudFormationStack _nn/aws/cfn-deploy @v1 label

DependsOn

(DeployCloudFormationStack/DependsOn)

(Optional)

Especifique uma ação, grupo de ação ou porta que deve ser executada com êxito para que essa ação seja executada.

Para obter mais informações sobre a funcionalidade “depende de”, consulte. Ações de sequenciamento

UI correspondente: guia Entradas/Depende de - opcional

Compute

(DeployCloudFormationStack/Compute)

(Optional)

O mecanismo de computação usado para executar suas ações de fluxo de trabalho. Você pode especificar a computação no nível do fluxo de trabalho ou no nível da ação, mas não em ambos. Quando especificada no nível do fluxo de trabalho, a configuração computacional se aplica a todas as ações definidas no fluxo de trabalho. No nível do fluxo de trabalho, você também pode executar várias ações na mesma instância. Para ter mais informações, consulte Compartilhamento de computação entre ações.

UI correspondente: nenhuma

Type

(DeployCloudFormationStack/Compute/Type)

(Obrigatório se Compute estiver incluído)

O tipo de mecanismo de computação. Você pode usar um dos seguintes valores:

EC2(editor visual) ou EC2 (YAMLeditor)

Otimizado para flexibilidade durante as corridas de ação.
Lambda (editor visual) ou Lambda (YAMLeditor)

Velocidades otimizadas de inicialização da ação.

Para obter informações sobre tipos de dados, consulte Tipos de computação.

UI correspondente: guia Configuração/Avançado - opcional/Tipo de computação

Fleet

(DeployCloudFormationStack/Compute/Fleet)

(Optional)

Especifique a máquina ou frota que executará seu fluxo de trabalho ou ações de fluxo de trabalho. Com frotas sob demanda, quando uma ação é iniciada, o fluxo de trabalho provisiona os recursos necessários e as máquinas são destruídas quando a ação é concluída. Exemplos de frotas sob demanda:Linux.x86-64.Large,. Linux.x86-64.XLarge Para obter mais informações sobre frotas sob demanda, consulte. Propriedades de frota sob demanda

Com frotas provisionadas, você configura um conjunto de máquinas dedicadas para executar suas ações de fluxo de trabalho. Essas máquinas permanecem ociosas, prontas para processar ações imediatamente. Para obter mais informações sobre frotas provisionadas, consulte. Propriedades da frota provisionada

Se Fleet for omitido, o padrão será. Linux.x86-64.Large

UI correspondente: guia Configuração/Avançado - opcional/Frota de computação

Timeout

(DeployCloudFormationStack/Timeout)

(Optional)

Especifique a quantidade de tempo em minutos (YAMLeditor) ou horas e minutos (editor visual) que a ação pode ser executada antes de CodeCatalyst finalizar a ação. O mínimo é de 5 minutos e o máximo está descrito emCotas para fluxos de trabalho em CodeCatalyst. O tempo limite padrão é o mesmo que o tempo limite máximo.

UI correspondente: guia de configuração/Tempo limite em minutos - opcional

Environment

(DeployCloudFormationStack/Environment)

(Obrigatório)

Especifique o CodeCatalyst ambiente a ser usado com a ação. A ação se conecta Conta da AWS à Amazon opcional VPC especificada no ambiente escolhido. A ação usa a IAM função padrão especificada no ambiente para se conectar ao Conta da AWS e usa a IAM função especificada na VPCconexão da Amazon para se conectar à AmazonVPC.

nota

Se a IAM função padrão não tiver as permissões exigidas pela ação, você poderá configurar a ação para usar uma função diferente. Para ter mais informações, consulte Mudando o IAM papel de uma ação.

Para obter mais informações sobre ambientes, consulte Implantação em e Contas da AWS VPCs Criar um ambiente e.

UI correspondente: guia de configuração/ambiente

Name

(DeployCloudFormationStack/Environment/Name)

(Obrigatório se Environment estiver incluído)

Especifique o nome de um ambiente existente que você deseja associar à ação.

UI correspondente: guia de configuração/ambiente

Connections

(DeployCloudFormationStack/Environment/Connections)

(Opcional nas versões mais recentes da ação; obrigatório nas versões mais antigas)

Especifique a conexão da conta a ser associada à ação. Você pode especificar no máximo uma conexão de conta emEnvironment.

Se você não especificar uma conexão de conta:

A ação usa a Conta da AWS conexão e a IAM função padrão especificadas no ambiente no CodeCatalyst console. Para obter informações sobre como adicionar uma conexão de conta e uma IAM função padrão ao ambiente, consulteCriar um ambiente.
A IAM função padrão deve incluir as políticas e permissões exigidas pela ação. Para determinar quais são essas políticas e permissões, consulte a descrição da propriedade Role na documentação de YAML definição da ação.

Para obter mais informações sobre conexões de conta, consultePermitindo acesso a AWS recursos com conexão Contas da AWS. Para obter informações sobre como adicionar uma conexão de conta a um ambiente, consulteCriar um ambiente.

UI correspondente: uma das seguintes, dependendo da versão da ação:

(Versões mais recentes) Guia de configuração/Ambiente/O que está incluído my-environment? /menu de três pontos/ Mudar função
(Versões mais antigas) Guia de configuração/'Ambiente/Conta/Função'/ conexão AWS de conta

Name

(DeployCloudFormationStack/Environment/Connections/Name)

(Obrigatório se Connections estiver incluído)

Especifique o nome da conexão da conta.

UI correspondente: uma das seguintes, dependendo da versão da ação:

(Versões mais recentes) Guia de configuração/Ambiente/O que está incluído my-environment? /menu de três pontos/ Mudar função
(Versões mais antigas) Guia de configuração/'Ambiente/Conta/Função'/ conexão AWS de conta

Role

(DeployCloudFormationStack/Environment/Connections/Role)

(Obrigatório se Connections estiver incluído)

Especifique o nome da IAM função que a ação Deploy AWS CloudFormation stack usa para acessar AWS e o AWS CloudFormation serviço. Certifique-se de ter adicionado a função ao seu CodeCatalyst espaço e de que a função inclua as seguintes políticas.

Se você não especificar uma IAM função, a ação usará a IAM função padrão listada no ambiente no CodeCatalyst console. Se você usar a função padrão no ambiente, verifique se ela tem as seguintes políticas.

A seguinte política de permissões:

Atenção

Limite as permissões às mostradas na política a seguir. Usar uma função com permissões mais amplas pode representar um risco de segurança.


{
    "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

Na primeira vez em que a função for usada, use o caractere curinga a seguir na declaração de política de recursos e, em seguida, defina o escopo da política com o nome do recurso depois que ele estiver disponível.


"Resource": "*"

A seguinte política de confiança personalizada:


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

nota

Você pode usar a CodeCatalystWorkflowDevelopmentRole-spaceName função com essa ação, se quiser. Para obter mais informações sobre essa função, consulte Criando a CodeCatalystWorkflowDevelopmentRole-spaceNamefunção para sua conta e espaço. Entenda que a CodeCatalystWorkflowDevelopmentRole-spaceName função tem permissões de acesso completas, o que pode representar um risco de segurança. Recomendamos que você use essa função somente em tutoriais e cenários em que a segurança seja menos preocupante.

UI correspondente: uma das seguintes, dependendo da versão da ação:

(Versões mais recentes) Guia de configuração/Ambiente/O que está incluído my-environment? /menu de três pontos/ Mudar função
(Versões mais antigas) Guia de configuração/'Ambiente/Conta/Função'/ Função

Inputs

(DeployCloudFormationStack/Inputs)

(Optional)

A Inputs seção define os dados DeployCloudFormationStack necessários durante a execução de um fluxo de trabalho.

nota

São permitidas no máximo quatro entradas (uma fonte e três artefatos) por ação de implantação da AWS CloudFormation pilha.

Se você precisar se referir a arquivos que residem em entradas diferentes (digamos, uma fonte e um artefato), a entrada de origem é a entrada primária e o artefato é a entrada secundária. As referências a arquivos em entradas secundárias usam um prefixo especial para diferenciá-las das primárias. Para obter detalhes, consulte Exemplo: referenciando arquivos em vários artefatos.

UI correspondente: guia Entradas

Sources

(DeployCloudFormationStack/Inputs/Sources)

(Obrigatório se o seu AWS SAM modelo CloudFormation ou modelo estiver armazenado em um repositório de origem)

Se seu AWS SAM modelo CloudFormation ou modelo estiver armazenado em um repositório de origem, especifique o rótulo desse repositório de origem. Atualmente, o único rótulo compatível éWorkflowSource.

Se o seu AWS SAM modelo CloudFormation ou modelo não estiver contido em um repositório de origem, ele deverá residir em um artefato gerado por outra ação ou em um bucket do Amazon S3.

Para obter mais informações sobre fontes, consulte Conectando repositórios de origem aos fluxos de trabalho.

UI correspondente: guia Entradas/Fontes - opcional

Artifacts - input

(DeployCloudFormationStack/Inputs/Artifacts)

(Obrigatório se seu AWS SAM modelo CloudFormation ou modelo estiver armazenado em um artefato de saída de uma ação anterior)

Se o AWS SAM modelo CloudFormation ou que você deseja implantar estiver contido em um artefato gerado por uma ação anterior, especifique esse artefato aqui. Se seu CloudFormation modelo não estiver contido em um artefato, ele deverá residir no seu repositório de origem ou em um bucket do Amazon S3.

Para obter mais informações sobre artefatos, incluindo exemplos, consulteCompartilhamento de artefatos e arquivos entre ações.

UI correspondente: guia de configuração/artefatos - opcional

Configuration

(DeployCloudFormationStack/Configuration)

(Obrigatório)

Uma seção na qual você pode definir as propriedades de configuração da ação.

UI correspondente: guia Configuração

name

(DeployCloudFormationStack/Configuration/name)

(Obrigatório)

Especifique um nome para a CloudFormation pilha que a ação Deploy AWS CloudFormation stack cria ou atualiza.

UI correspondente: guia de configuração/nome da pilha

region

(DeployCloudFormationStack/Configuration/region)

(Obrigatório)

Especifique o Região da AWS local no qual a pilha será implantada. Para obter uma lista dos códigos das regiões, consulte Endpoints regionais.

UI correspondente: guia de configuração/região da pilha

template

(DeployCloudFormationStack/Configuration/template)

(Obrigatório)

Especifique o nome e o caminho para seu arquivo CloudFormation ou arquivo AWS SAM de modelo. O modelo pode estar em YAML formato JSON ou residir em um repositório de origem, em um artefato de uma ação anterior ou em um bucket do Amazon S3. Se o arquivo de modelo estiver em um repositório ou artefato de origem, o caminho será relativo à origem ou à raiz do artefato. Se o modelo estiver em um bucket do Amazon S3, o caminho será o valor do objeto URL do modelo.

Exemplos:

./MyFolder/MyTemplate.json

MyFolder/MyTemplate.yml

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

nota

Talvez seja necessário adicionar um prefixo ao caminho do arquivo do modelo para indicar em qual artefato ou fonte encontrá-lo. Para obter mais informações, consulte Fazendo referência aos arquivos do repositório de origem e Fazendo referência a arquivos em um artefato.

UI correspondente: guia de configuração/modelo

role-arn

(DeployCloudFormationStack/Configuration/role-arn)

(Obrigatório)

Especifique o Amazon Resource Name (ARN) da função da pilha. CloudFormation usa essa função para acessar e modificar recursos em sua pilha. Por exemplo: arn:aws:iam::123456789012:role/StackRole.

Certifique-se de que a função da pilha inclua:

Uma ou mais políticas de permissões. As políticas dependem dos recursos que você tem em sua pilha. Por exemplo, se sua pilha inclui uma AWS Lambda função, você precisa adicionar permissões que concedam acesso ao Lambda. Se você seguiu o tutorial descrito emTutorial: implantar um aplicativo sem servidor, ele inclui um procedimento intitulado, Para criar uma função de pilha que lista as permissões que a função de pilha precisa se você estiver implantando uma pilha típica de aplicativos sem servidor.

Atenção
Limite as permissões às exigidas pelo CloudFormation serviço para acessar os recursos em sua pilha. Usar uma função com permissões mais amplas pode representar um risco de segurança.

A seguinte política de confiança:


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

Opcionalmente, associe essa função à conexão da sua conta. Para saber mais sobre como associar uma IAM função a uma conexão de conta, consulteAdicionar IAM funções às conexões da conta. Se você não associar a função da pilha à conexão da conta, a função da pilha não aparecerá na lista suspensa da função da pilha no editor visual; no entanto, a função ainda ARN poderá ser especificada no campo usando o role-arn editor. YAML

nota

UI correspondente: guia de configuração/função de pilha - opcional

capabilities

(DeployCloudFormationStack/Configuration/capabilities)

(Obrigatório)

Especifique uma lista de IAM recursos necessários para permitir AWS CloudFormation a criação de determinadas pilhas. Na maioria dos casos, você pode sair capabilities com o valor padrão deCAPABILITY_IAM,CAPABILITY_NAMED_IAM,CAPABILITY_AUTO_EXPAND.

Se você ver os ##[error] requires capabilities: [capability-name] registros da ação do Deploy AWS CloudFormation stack, consulte Como faço para corrigir erros IAM de recursos? para obter informações sobre como corrigir o problema.

Para obter mais informações sobre IAM recursos, consulte Confirmação de IAM recursos em AWS CloudFormation modelos no Guia do IAM usuário.

UI correspondente: guia Configuração/Avançada/Capacidades

parameter-overrides

(DeployCloudFormationStack/Configuration/parameter-overrides)

(Optional)

Especifique parâmetros no seu AWS CloudFormation ou no AWS SAM modelo que não tenham valores padrão ou para os quais você deseja especificar valores não padrão. Para obter mais informações sobre parâmetros, consulte Parâmetros no Guia AWS CloudFormation do usuário.

A parameter-overrides propriedade aceita:

Um JSON arquivo contendo os parâmetros e valores.
Uma lista separada por vírgulas de parâmetros e valores.

Para especificar um JSON arquivo

Verifique se o JSON arquivo usa uma das seguintes sintaxes:
```
{
  "Parameters": {
    "Param1": "Value1",
    "Param2": "Value2",
    ...
  }
}
```
Ou...
```
[
  {
     "ParameterKey": "Param1",
     "ParameterValue": "Value1"
  },
  ...
]
```
(Existem outras sintaxes, mas elas não são suportadas CodeCatalyst no momento em que este artigo foi escrito.) Para obter mais informações sobre a especificação de CloudFormation parâmetros em um JSON arquivo, consulte JSONSintaxe suportada na Referência de AWS CLI Comandos.

Especifique o caminho para o JSON arquivo usando um dos seguintes formatos:

Se seu JSON arquivo residir em um artefato de saída de uma ação anterior, use:

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

Consulte o Exemplo 1 para obter detalhes.

Se seu JSON arquivo residir no seu repositório de origem, use:

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

Consulte o Exemplo 2 para obter detalhes.

Exemplo 1 — O JSON arquivo reside em um artefato de saída


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

Exemplo 2 — O JSON arquivo reside no seu repositório de origem, em uma pasta chamada 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 uma lista de parâmetros separada por vírgula

Adicione pares nome-valor do parâmetro na parameter-overrides propriedade usando o seguinte formato:

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

Por exemplo, assumindo o seguinte AWS CloudFormation modelo:
```
##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:
...
```
... você pode definir a parameter-overrides propriedade da seguinte forma:
```
##My workflow YAML
...
Actions:
...
  DeployCloudFormationStack:
    Identifier: aws/cfn-deploy@v1
    Configuration:
      parameter-overrides: InstanceType=t3.medium,UseVPC=true   
```
nota
Você pode especificar um nome de parâmetro sem um valor correspondente usando undefined como valor. Por exemplo: .
parameter-overrides: MyParameter=undefined
O efeito é que, durante uma atualização da pilha, CloudFormation usa o valor do parâmetro existente para o nome do parâmetro fornecido.

UI correspondente:

Guia de configuração/Avançada/Substituições de parâmetros
Guia de configuração/Avançado/Substituições de parâmetros/Especificar substituições usando um arquivo
Guia de configuração/Avançado/Substituições de parâmetros/Especificar substituições usando um conjunto de valores

no-execute-changeset

(DeployCloudFormationStack/Configuration/no-execute-changeset)

(Optional)

Especifique se você CodeCatalyst deseja criar o conjunto de CloudFormation alterações e depois parar antes de executá-lo. Isso lhe dá a oportunidade de revisar o conjunto de alterações no CloudFormation console. Se você determinar que o conjunto de alterações parece bom, desative essa opção e execute novamente o fluxo de trabalho para que ele CodeCatalyst possa criar e executar o conjunto de alterações sem parar. O padrão é criar e executar o conjunto de alterações sem parar. Para obter mais informações, consulte o parâmetro AWS CloudFormation deploy na Referência de AWS CLI Comandos. Para obter mais informações sobre a visualização de conjuntos de alterações, consulte Visualização de um conjunto de alterações no Guia AWS CloudFormation do usuário.

UI correspondente: guia Configuração/Avançado/Sem conjunto de alterações de execução

fail-on-empty-changeset

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

(Optional)

Especifique se você deseja CodeCatalyst falhar na ação Deploy AWS CloudFormation stack se o conjunto de CloudFormation alterações estiver vazio. (Se um conjunto de alterações estiver vazio, significa que não foram feitas alterações na pilha durante a implantação mais recente.) O padrão é permitir que a ação continue se o conjunto de alterações estiver vazio e retornar uma UPDATE_COMPLETE mensagem mesmo que a pilha não tenha sido atualizada.

Para obter mais informações sobre essa configuração, consulte o parâmetro AWS CloudFormation deploy na Referência de AWS CLI Comandos. Para obter mais informações sobre conjuntos de alterações, consulte Atualização de pilhas usando conjuntos de alterações no Guia do AWS CloudFormation usuário.

UI correspondente: guia Configuração/Avançado/Falha no conjunto de alterações vazio

disable-rollback

(DeployCloudFormationStack/Configuration/disable-rollback)

(Optional)

Especifique se você CodeCatalyst deseja reverter a implantação da pilha se ela falhar. A reversão retorna a pilha ao último estado estável conhecido. O padrão é habilitar reversões. Para obter mais informações sobre essa configuração, consulte o parâmetro AWS CloudFormation deploy na Referência de AWS CLI Comandos.

Para obter mais informações sobre como a ação Deploy AWS CloudFormation stack lida com reversões, consulte. Configurando reversões

Para obter mais informações sobre como reverter uma pilha, consulte Opções de falha de pilha no Guia do AWS CloudFormation usuário.

UI correspondente: guia Configuração/Avançado/Desativar reversão

termination-protection

(DeployCloudFormationStack/Configuration/termination-protection)

(Optional)

Especifique se você deseja que a AWS CloudFormation pilha Deploy adicione proteção de encerramento à pilha que está implantando. Se um usuário tentar excluir uma pilha com proteção contra encerramento ativada, a exclusão falhará e a pilha, incluindo o status dela, permanecerá inalterada. O padrão é desativar a proteção contra rescisão. Para obter mais informações, consulte Protegendo uma pilha de ser excluída no Guia do AWS CloudFormation usuário.

UI correspondente: guia Configuração/Avançada/Proteção de terminação

timeout-in-minutes

(DeployCloudFormationStack/Configuration/timeout-in-minutes)

(Optional)

Especifique a quantidade de tempo, em minutos, que CloudFormation deve ser alocada antes de expirar as operações de criação da pilha e definir o status da pilha como. CREATE_FAILED Se não CloudFormation conseguir criar a pilha inteira no tempo alocado, ela falha na criação da pilha devido ao tempo limite e reverte a pilha.

Por padrão, não há tempo limite para criação da pilha. No entanto, recursos individuais podem ter seus próprios limites de tempo com base na natureza do serviço que implementam. Por exemplo, se um recurso individual em sua pilha expirar, a criação dela também expirará, ainda que o tempo limite especificado para a criação não tenha sido atingido.

UI correspondente: guia de configuração/avançado/tempo limite CloudFormation

notification-arns

(DeployCloudFormationStack/Configuration/notification-arns)

(Optional)

Especifique o SNS tópico ARN da Amazon para o qual você CodeCatalyst deseja enviar mensagens de notificação. Por exemplo, arn:aws:sns:us-east-1:111222333:MyTopic. Quando a ação Deploy AWS CloudFormation stack é executada, CodeCatalyst CloudFormation coordena-se para enviar uma notificação por AWS CloudFormation evento que ocorre durante o processo de criação ou atualização da pilha. (Os eventos são visíveis na guia Eventos do AWS CloudFormation console para a pilha.) Você pode especificar até cinco tópicos. Para obter mais informações, consulte O que é a AmazonSNS? .

UI correspondente: guia Configuração/Avançado/Notificação ARNs

monitor-alarm-arns

(DeployCloudFormationStack/Configuration/monitor-alarm-arns)

(Optional)

Especifique o Amazon Resource Name (ARN) de um CloudWatch alarme da Amazon para usar como gatilho de reversão. Por exemplo, arn:aws:cloudwatch::123456789012:alarm/MyAlarm. Você pode ter no máximo cinco gatilhos de reversão.

nota

Se você especificar um CloudWatch alarmeARN, também precisará configurar permissões adicionais para permitir o acesso à ação CloudWatch. Para ter mais informações, consulte Configurando reversões.

UI correspondente: guia de configuração/avançado/alarme de monitor ARNs

monitor-timeout-in-minutes

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

(Optional)

Especifique um período de tempo, de 0 a 180 minutos, durante o qual CloudFormation monitora os alarmes especificados. O monitoramento começa após a implantação de todos os recursos da pilha. Se o alarme ocorrer dentro do tempo de monitoramento especificado, a implantação falhará e CloudFormation reverterá toda a operação da pilha.

Padrão: 0. CloudFormation monitora apenas os alarmes enquanto os recursos da pilha estão sendo implantados, não depois.

UI correspondente: guia Configuração/Avançado/Tempo de monitoramento