Azione 'Implementa AWS CloudFormation stack' YAML

Di seguito è riportata la YAML definizione dell'azione Deploy AWS CloudFormation stack. Per informazioni su come utilizzare questa azione, consulta. Implementazione di uno stack AWS CloudFormation

Questa definizione di azione esiste come sezione all'interno di un file di definizione del flusso di lavoro più ampio. Per ulteriori informazioni su questo file, consulta YAMLDefinizione del workflow.

Nota

La maggior parte delle YAML proprietà che seguono hanno elementi dell'interfaccia utente corrispondenti nell'editor visivo. Per cercare un elemento dell'interfaccia utente, usa Ctrl+F. L'elemento verrà elencato con la proprietà associata. YAML


# The workflow definition starts here.
# See Proprietà di primo livello 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

(Obbligatorio)

Specificate il nome dell'azione. Tutti i nomi delle azioni devono essere univoci all'interno del flusso di lavoro. I nomi delle azioni sono limitati a caratteri alfanumerici (a-z, A-Z, 0-9), trattini (-) e caratteri di sottolineatura (_). Gli spazi non sono consentiti. Non è possibile utilizzare le virgolette per abilitare caratteri e spazi speciali nei nomi delle azioni.

Default: DeployCloudFormationStack_nn.

Interfaccia utente corrispondente: scheda di configurazione/nome visualizzato dell'azione

Identifier

(DeployCloudFormationStack/Identifier)

(Obbligatorio)

Identifica l'azione. Non modificate questa proprietà a meno che non vogliate cambiare la versione. Per ulteriori informazioni, consulta Specificare la versione dell'azione da utilizzare.

Default: aws/cfn-deploy@v1.

Interfaccia utente corrispondente: Workflow diagram/ DeployCloudFormationStack _nn/ aws/cfn-deploy @v1 label

DependsOn

(DeployCloudFormationStack/DependsOn)

(Facoltativo)

Specificate un'azione, un gruppo di azioni o un gate che deve essere eseguito correttamente affinché questa azione venga eseguita.

Per ulteriori informazioni sulla funzionalità «dipende da», vedere. Azioni di sequenziamento

Interfaccia utente corrispondente: scheda Ingressi/Dipende da - opzionale

Compute

(DeployCloudFormationStack/Compute)

(Facoltativo)

Il motore di calcolo utilizzato per eseguire le azioni del flusso di lavoro. È possibile specificare l'elaborazione a livello di flusso di lavoro o a livello di azione, ma non entrambi. Se specificata a livello di flusso di lavoro, la configurazione di calcolo si applica a tutte le azioni definite nel flusso di lavoro. A livello di flusso di lavoro, puoi anche eseguire più azioni sulla stessa istanza. Per ulteriori informazioni, consulta Condivisione dell'elaborazione tra le azioni.

Interfaccia utente corrispondente: nessuna

Type

(DeployCloudFormationStack/Compute/Type)

(Obbligatorio se Compute incluso)

Il tipo di motore di calcolo. È possibile utilizzare uno dei seguenti valori:

EC2(editor visivo) o EC2 (YAMLeditor)

Ottimizzato per la flessibilità durante le sessioni di azione.
Lambda (editor visivo) o Lambda (YAMLeditor)

Velocità di avvio dell'azione ottimizzate.

Per ulteriori informazioni sui tipi di calcolo, consulta Tipi di calcolo.

Interfaccia utente corrispondente: scheda di configurazione/Avanzata - opzionale/tipo di calcolo

Fleet

(DeployCloudFormationStack/Compute/Fleet)

(Facoltativo)

Specificate la macchina o il parco macchine che eseguiranno il flusso di lavoro o le azioni del flusso di lavoro. Con le flotte on-demand, all'avvio di un'azione, il flusso di lavoro fornisce le risorse necessarie e le macchine vengono distrutte al termine dell'azione. Esempi di flotte on-demand:,. Linux.x86-64.Large Linux.x86-64.XLarge Per ulteriori informazioni sulle flotte on-demand, vedere. Proprietà del parco veicoli su richiesta

Con le flotte assegnate, puoi configurare una serie di macchine dedicate per eseguire le azioni del flusso di lavoro. Queste macchine rimangono inattive, pronte a elaborare immediatamente le azioni. Per ulteriori informazioni sulle flotte rifornite, vedere. Proprietà del parco veicoli assegnate

Se Fleet viene omesso, l'impostazione predefinita è. Linux.x86-64.Large

Interfaccia utente corrispondente: scheda Configurazione/Avanzata - opzionale/ Compute fleet

Timeout

(DeployCloudFormationStack/Timeout)

(Facoltativo)

Specificate il periodo di tempo, in minuti (YAMLeditor) o in ore e minuti (editor visivo), che l'azione può essere eseguita prima che termini l'azione. CodeCatalyst Il minimo è 5 minuti e il massimo è descritto inQuote per i flussi di lavoro in CodeCatalyst. Il timeout predefinito è lo stesso del timeout massimo.

Interfaccia utente corrispondente: scheda di configurazione/timeout in minuti - opzionale

Environment

(DeployCloudFormationStack/Environment)

(Obbligatorio)

Specificare l' CodeCatalyst ambiente da utilizzare con l'azione. L'azione si collega Account AWS all'Amazon opzionale VPC specificato nell'ambiente scelto. L'azione utilizza il IAM ruolo predefinito specificato nell'ambiente per connettersi a e utilizza il IAM ruolo specificato nella VPCconnessione Amazon per connettersi ad AmazonVPC. Account AWS

Nota

Se il IAM ruolo predefinito non dispone delle autorizzazioni richieste dall'azione, puoi configurare l'azione per utilizzare un ruolo diverso. Per ulteriori informazioni, consulta Cambiare il IAM ruolo di un'azione.

Per ulteriori informazioni sugli ambienti, vedere Implementazione in e Account AWS VPCs eCreazione di un ambiente.

Interfaccia utente corrispondente: scheda di configurazione/ambiente

Name

(DeployCloudFormationStack/Environment/Name)

(Richiesto se Environment incluso)

Specificate il nome di un ambiente esistente che desiderate associare all'azione.

Interfaccia utente corrispondente: scheda di configurazione/ambiente

Connections

(DeployCloudFormationStack/Environment/Connections)

(Facoltativo nelle versioni più recenti dell'azione; richiesto nelle versioni precedenti)

Specificare la connessione dell'account da associare all'azione. È possibile specificare al massimo una connessione a un account inEnvironment.

Se non si specifica una connessione all'account:

L'azione utilizza la Account AWS connessione e il IAM ruolo predefinito specificati nell'ambiente della CodeCatalyst console. Per informazioni sull'aggiunta di una connessione all'account e di un IAM ruolo predefinito all'ambiente, consultaCreazione di un ambiente.
Il IAM ruolo predefinito deve includere le politiche e le autorizzazioni richieste dall'azione. Per determinare quali sono tali politiche e autorizzazioni, consulta la descrizione della proprietà Role nella documentazione sulla YAML definizione dell'azione.

Per ulteriori informazioni sulle connessioni degli account, vedereConsentire l'accesso alle AWS risorse con connessione Account AWS. Per informazioni sull'aggiunta di una connessione tramite account a un ambiente, vedereCreazione di un ambiente.

Interfaccia utente corrispondente: una delle seguenti a seconda della versione dell'azione:

(Versioni più recenti) Scheda di configurazione/Ambiente/Cosa c'è in my-environment? /menu a tre punti/ Cambia ruolo
(Versioni precedenti) Scheda di configurazione/'Environment/Account/Role'/connessione all'account AWS

Name

(DeployCloudFormationStack/Environment/Connections/Name)

Connections(Richiesto se incluso)

Specificare il nome della connessione all'account.

Interfaccia utente corrispondente: una delle seguenti a seconda della versione dell'azione:

(Versioni più recenti) Scheda di configurazione/Ambiente/Cosa c'è in my-environment? /menu a tre punti/ Cambia ruolo
(Versioni precedenti) Scheda di configurazione/'Environment/Account/Role'/connessione all'account AWS

Role

(DeployCloudFormationStack/Environment/Connections/Role)

Connections(Richiesto se incluso)

Specificare il nome del IAM ruolo utilizzato dall'azione Deploy AWS CloudFormation stack per accedere AWS e al AWS CloudFormation servizio. Assicurati di aver aggiunto il ruolo al tuo CodeCatalyst spazio e che il ruolo includa le seguenti politiche.

Se non specifichi un IAM ruolo, l'azione utilizza il IAM ruolo predefinito elencato nell'ambiente della CodeCatalyst console. Se utilizzi il ruolo predefinito nell'ambiente, assicurati che abbia le seguenti politiche.

La seguente politica di autorizzazioni:

avvertimento

Limita le autorizzazioni a quelle mostrate nella seguente politica. L'utilizzo di un ruolo con autorizzazioni più ampie potrebbe rappresentare un rischio per la sicurezza.


{
    "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 prima volta che il ruolo viene utilizzato, utilizza il seguente carattere jolly nell'informativa sulla politica delle risorse, quindi definisci la politica inserendo il nome della risorsa dopo che è disponibile.


"Resource": "*"

La seguente politica di fiducia personalizzata:


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

Nota

Puoi usare il CodeCatalystWorkflowDevelopmentRole-spaceName ruolo con questa azione, se lo desideri. Per ulteriori informazioni su questo ruolo, consulta Creazione del CodeCatalystWorkflowDevelopmentRole-spaceNameruolo per il tuo account e il tuo spazio. Tieni presente che il CodeCatalystWorkflowDevelopmentRole-spaceName ruolo dispone di autorizzazioni di accesso complete, il che può rappresentare un rischio per la sicurezza. Ti consigliamo di utilizzare questo ruolo solo in tutorial e scenari in cui la sicurezza è meno preoccupante.

Interfaccia utente corrispondente: una delle seguenti a seconda della versione di azione:

(Versioni più recenti) Scheda di configurazione/Ambiente/Cosa c'è in my-environment? /menu a tre punti/ Cambia ruolo
(Versioni precedenti) Scheda di configurazione/'Environment/Account/Role'/ Ruolo

Inputs

(DeployCloudFormationStack/Inputs)

(Facoltativo)

La Inputs sezione definisce i dati necessari durante l'esecuzione di un flusso di lavoro. DeployCloudFormationStack

Nota

Sono consentiti un massimo di quattro input (una fonte e tre artefatti) per ogni azione dello stack AWS CloudFormation Deploy.

Se è necessario fare riferimento a file che risiedono in input diversi (ad esempio una sorgente e un artefatto), l'input di origine è l'input principale e l'artefatto è l'input secondario. I riferimenti ai file negli input secondari richiedono un prefisso speciale per distinguerli dal primario. Per informazioni dettagliate, vedi Esempio: riferimento a file in più artefatti.

Interfaccia utente corrispondente: scheda Ingressi

Sources

(DeployCloudFormationStack/Inputs/Sources)

(Richiesto se il AWS SAM modello CloudFormation o è archiviato in un repository di origine)

Se il AWS SAM modello CloudFormation o è archiviato in un repository di origine, specifica l'etichetta di tale repository di origine. Attualmente, l'unica etichetta supportata è. WorkflowSource

Se il AWS SAM modello CloudFormation o non è contenuto in un repository di origine, deve risiedere in un artefatto generato da un'altra azione o in un bucket Amazon S3.

Per ulteriori informazioni sulle origini, consulta Connessione degli archivi di origine ai flussi di lavoro.

Interfaccia utente corrispondente: scheda Input/Sources - opzionale

Artifacts - input

(DeployCloudFormationStack/Inputs/Artifacts)

(Richiesto se il AWS SAM modello CloudFormation o è memorizzato in un elemento di output di un'azione precedente)

Se il AWS SAM modello CloudFormation o che desideri distribuire è contenuto in un artefatto generato da un'azione precedente, specifica quell'artefatto qui. Se il CloudFormation modello non è contenuto in un artefatto, deve risiedere nel repository di origine o in un bucket Amazon S3.

Per ulteriori informazioni sugli artefatti, inclusi esempi, consulta. Condivisione di artefatti e file tra azioni

Interfaccia utente corrispondente: scheda di configurazione/artefatti - opzionale

Configuration

(DeployCloudFormationStack/Configuration)

(Obbligatorio)

Una sezione in cui è possibile definire le proprietà di configurazione dell'azione.

Interfaccia utente corrispondente: scheda Configurazione

name

(DeployCloudFormationStack/Configuration/name)

(Obbligatorio)

Specificate un nome per lo CloudFormation stack creato o aggiornato dall'azione Deploy AWS CloudFormation stack.

Interfaccia utente corrispondente: scheda di configurazione/nome dello stack

region

(DeployCloudFormationStack/Configuration/region)

(Obbligatorio)

Specificare Regione AWS in che modo verrà distribuito lo stack. Per un elenco dei codici regionali, consulta Endpoint regionali.

Interfaccia utente corrispondente: scheda di configurazione/regione dello stack

template

(DeployCloudFormationStack/Configuration/template)

(Obbligatorio)

Specificate il nome e il percorso del file CloudFormation o AWS SAM del modello. Il modello può essere in YAML formato JSON o può risiedere in un repository di origine, in un elemento di un'azione precedente o in un bucket Amazon S3. Se il file modello si trova in un repository o in un artefatto di origine, il percorso è relativo all'origine o alla radice dell'artefatto. Se il modello si trova in un bucket Amazon S3, il percorso è il valore dell'oggetto del modello. URL

Esempi:

./MyFolder/MyTemplate.json

MyFolder/MyTemplate.yml

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

Nota

Potrebbe essere necessario aggiungere un prefisso al percorso del file del modello per indicare in quale artefatto o fonte trovarlo. Per ulteriori informazioni, consulta Riferimento ai file del repository di origine e Riferimento ai file in un artefatto.

Interfaccia utente corrispondente: scheda di configurazione/modello

role-arn

(DeployCloudFormationStack/Configuration/role-arn)

(Obbligatorio)

Specificare l'Amazon Resource Name (ARN) del ruolo dello stack. CloudFormation utilizza questo ruolo per accedere e modificare le risorse del tuo stack. Ad esempio: arn:aws:iam::123456789012:role/StackRole.

Assicurati che il ruolo dello stack includa:

Una o più politiche di autorizzazione. Le politiche dipendono dalle risorse presenti nello stack. Ad esempio, se lo stack include una AWS Lambda funzione, devi aggiungere le autorizzazioni che concedono l'accesso a Lambda. Se hai seguito il tutorial descritto inTutorial: Implementazione di un'applicazione serverless, include una procedura intitolata, Per creare un ruolo stack che elenca le autorizzazioni necessarie allo stack role se stai distribuendo un tipico stack di applicazioni serverless.

avvertimento
Limita le autorizzazioni a quelle richieste dal CloudFormation servizio per accedere alle risorse del tuo stack. L'utilizzo di un ruolo con autorizzazioni più ampie potrebbe rappresentare un rischio per la sicurezza.

La seguente politica di fiducia:


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

Facoltativamente, associa questo ruolo alla connessione del tuo account. Per ulteriori informazioni sull'associazione di un IAM ruolo a una connessione all'account, consulta. Aggiungere IAM ruoli alle connessioni degli account Se non associ il ruolo dello stack alla connessione dell'account, il ruolo dello stack non verrà visualizzato nell'elenco a discesa del ruolo Stack nell'editor visivo; tuttavia, il ruolo ARN può ancora essere specificato nel campo utilizzando l'editor. role-arn YAML

Nota

Interfaccia utente corrispondente: scheda di configurazione/ruolo Stack - opzionale

capabilities

(DeployCloudFormationStack/Configuration/capabilities)

(Obbligatorio)

Specificate un elenco di IAM funzionalità necessarie per consentire la creazione AWS CloudFormation di determinati stack. Nella maggior parte dei casi, è possibile lasciare capabilities il valore predefinito diCAPABILITY_IAM,CAPABILITY_NAMED_IAM,CAPABILITY_AUTO_EXPAND.

Se vedi ##[error] requires capabilities: [capability-name] nei log delle azioni AWS CloudFormation dello stack Deploy, consulta Come posso correggere gli errori di funzionalità? IAM per informazioni su come risolvere il problema.

Per ulteriori informazioni sulle IAM funzionalità, consulta la sezione Riconoscimento IAM delle risorse nei AWS CloudFormation modelli nella Guida per l'utente. IAM

Interfaccia utente corrispondente: scheda Configurazione/Avanzate/ Capabilities

parameter-overrides

(DeployCloudFormationStack/Configuration/parameter-overrides)

(Facoltativo)

Specificate i parametri nel vostro AWS SAM modello AWS CloudFormation o che non hanno valori predefiniti o per i quali desiderate specificare valori non predefiniti. Per ulteriori informazioni sui parametri, consultate Parametri nella Guida per l' AWS CloudFormation utente.

La parameter-overrides proprietà accetta:

Un JSON file contenente i parametri e i valori.
Un elenco di parametri e valori separati da virgole.

Per specificare un file JSON

Assicurati che il JSON file utilizzi una delle seguenti sintassi:
```
{
  "Parameters": {
    "Param1": "Value1",
    "Param2": "Value2",
    ...
  }
}
```
Oppure...
```
[
  {
     "ParameterKey": "Param1",
     "ParameterValue": "Value1"
  },
  ...
]
```
(Esistono altre sintassi, ma non sono supportate CodeCatalyst al momento della scrittura.) Per ulteriori informazioni sulla specificazione CloudFormation dei parametri in un JSON file, vedete JSONSintassi supportata nel Command Reference.AWS CLI

Specificate il percorso del JSON file utilizzando uno dei seguenti formati:

Se il JSON file si trova in un elemento di output di un'azione precedente, usa:

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

Vedi l'Esempio 1 per i dettagli.

Se il JSON file si trova nel repository di origine, usa:

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

Vedi l'Esempio 2 per i dettagli.

Esempio 1: il JSON file risiede in un artefatto di output


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

Esempio 2: il JSON file si trova nel repository di origine, in una cartella denominata 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

Per utilizzare un elenco di parametri separati da virgole

Aggiungere coppie nome-valore dei parametri nella parameter-overrides proprietà utilizzando il seguente formato:

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

Ad esempio, supponendo il seguente modello: 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:
...
```
... potresti impostare la parameter-overrides proprietà come segue:
```
##My workflow YAML
...
Actions:
...
  DeployCloudFormationStack:
    Identifier: aws/cfn-deploy@v1
    Configuration:
      parameter-overrides: InstanceType=t3.medium,UseVPC=true   
```
Nota
È possibile specificare il nome di un parametro senza un valore corrispondente undefined da utilizzare come valore. Per esempio:
parameter-overrides: MyParameter=undefined
L'effetto è che durante un aggiornamento dello stack, CloudFormation utilizza il valore del parametro esistente per il nome del parametro specificato.

Interfaccia utente corrispondente:

Scheda di configurazione/Avanzata/ Sostituzioni dei parametri
Scheda di configurazione/Avanzata/Sostituzione dei parametri/ Specificare le sostituzioni utilizzando un file
Scheda di configurazione/Avanzata/Sostituzioni dei parametri/ Specificare le sostituzioni utilizzando un set di valori

no-execute-changeset

(DeployCloudFormationStack/Configuration/no-execute-changeset)

(Facoltativo)

Specificate se desiderate creare il set di modifiche e quindi interromperlo prima CodeCatalyst di eseguirlo. CloudFormation In questo modo è possibile rivedere il set di modifiche nella CloudFormation console. Se ritieni che il set di modifiche abbia un bell'aspetto, disabilita questa opzione e quindi riesegui il flusso di lavoro in modo da CodeCatalyst poter creare ed eseguire il set di modifiche senza interruzioni. L'impostazione predefinita prevede la creazione e l'esecuzione del set di modifiche senza interruzioni. Per ulteriori informazioni, vedete il parametro AWS CloudFormation deploy nel AWS CLI Command Reference. Per ulteriori informazioni sulla visualizzazione dei set di modifiche, vedere Visualizzazione di un set di modifiche nella Guida per l'AWS CloudFormation utente.

Interfaccia utente corrispondente: scheda Configurazione/Avanzata/ Nessun set di modifiche da eseguire

fail-on-empty-changeset

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

(Facoltativo)

Specificate se desiderate fallire CodeCatalyst l'azione Deploy AWS CloudFormation stack se il set di modifiche è vuoto. CloudFormation (Se un set di modifiche è vuoto, significa che non sono state apportate modifiche allo stack durante l'ultima distribuzione.) L'impostazione predefinita prevede il proseguimento dell'azione se il set di modifiche è vuoto e la restituzione di un UPDATE_COMPLETE messaggio anche se lo stack non è stato aggiornato.

Per ulteriori informazioni su questa impostazione, vedete il parametro AWS CloudFormation deploy nel AWS CLI Command Reference. Per ulteriori informazioni sui set di modifiche, vedere Aggiornamento degli stack utilizzando i set di modifiche nella Guida per l'AWS CloudFormation utente.

Interfaccia utente corrispondente: Configuration tab/Advanced/ Fail su changeset vuoto

disable-rollback

(DeployCloudFormationStack/Configuration/disable-rollback)

(Facoltativo)

Specificate se desiderate CodeCatalyst ripristinare la distribuzione dello stack se fallisce. Il rollback riporta lo stack all'ultimo stato stabile conosciuto. L'impostazione predefinita è abilitare i rollback. Per ulteriori informazioni su questa impostazione, vedete il parametro AWS CloudFormation deploy nel AWS CLI Command Reference.

Per ulteriori informazioni su come l'azione Deploy AWS CloudFormation stack gestisce i rollback, consulta. Configurazione dei rollback

Per ulteriori informazioni sul rollback di uno stack, consulta Stack failure options nella Guida per l'utente.AWS CloudFormation

Interfaccia utente corrispondente: scheda Configurazione/Avanzata/ Disabilita il rollback

termination-protection

(DeployCloudFormationStack/Configuration/termination-protection)

(Facoltativo)

Specificate se desiderate che lo stack Deploy aggiunga la protezione dalla terminazione allo AWS CloudFormation stack che sta distribuendo. Se un utente tenta di eliminare uno stack con protezione da cessazione abilitata, l'eliminazione ha esito negativo e lo stack, incluso lo stato, rimane invariato. L'impostazione predefinita è disabilitare la protezione dalla terminazione. Per ulteriori informazioni, consulta Proteggere uno stack dall'eliminazione nella Guida per l'AWS CloudFormation utente.

Interfaccia utente corrispondente: scheda di configurazione/Avanzata/Protezione da terminazione

timeout-in-minutes

(DeployCloudFormationStack/Configuration/timeout-in-minutes)

(Facoltativo)

Specificate la quantità di tempo, in minuti, da dedicare prima di scadere le CloudFormation operazioni di creazione dello stack e impostare lo stato dello stack su. CREATE_FAILED Se non è CloudFormation possibile creare l'intero stack entro il tempo assegnato, non riesce a creare lo stack a causa del timeout e ripristina lo stack.

Per impostazione predefinita, non è previsto alcun timeout per la creazione dello stack. Tuttavia, per la natura del servizio che implementano, alcune singole risorse possono avere un proprio timeout. Ad esempio, se una singola risorsa nello stack produce un timeout, anche la creazione dello stack viene arrestata, anche se il timeout specificato per la creazione dello stack non è ancora stato raggiunto.

Interfaccia utente corrispondente: scheda di configurazione/Avanzata/timeout CloudFormation

notification-arns

(DeployCloudFormationStack/Configuration/notification-arns)

(Facoltativo)

Specificate l'SNSargomento ARN di Amazon CodeCatalyst a cui desiderate inviare messaggi di notifica. Ad esempio, arn:aws:sns:us-east-1:111222333:MyTopic. Quando viene eseguita l'azione Deploy AWS CloudFormation stack, si CodeCatalyst coordina con CloudFormation per inviare una notifica per AWS CloudFormation evento che si verifica durante il processo di creazione o aggiornamento dello stack. (Gli eventi sono visibili nella scheda Eventi della AWS CloudFormation console relativa allo stack.) È possibile specificare fino a cinque argomenti. Per ulteriori informazioni, consulta What is AmazonSNS? .

Interfaccia utente corrispondente: scheda di configurazione/Avanzata/Notifica ARNs

monitor-alarm-arns

(DeployCloudFormationStack/Configuration/monitor-alarm-arns)

(Facoltativo)

Specificare l'Amazon Resource Name (ARN) di un CloudWatch allarme Amazon da utilizzare come trigger di rollback. Ad esempio, arn:aws:cloudwatch::123456789012:alarm/MyAlarm. Puoi avere un massimo di cinque trigger di rollback.

Nota

Se specifichi un CloudWatch allarmeARN, dovrai anche configurare autorizzazioni aggiuntive per abilitare l'azione di accesso. CloudWatch Per ulteriori informazioni, consulta Configurazione dei rollback.

Interfaccia utente corrispondente: scheda di configurazione/Avanzata/Monitor alarm ARNs

monitor-timeout-in-minutes

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

(Facoltativo)

Specificare un periodo di tempo, da 0 a 180 minuti, durante il quale CloudFormation monitorare gli allarmi specificati. Il monitoraggio inizia dopo che tutte le risorse dello stack sono state distribuite. Se l'allarme si verifica entro il periodo di monitoraggio specificato, l'implementazione fallisce e CloudFormation ripristina l'intera operazione dello stack.

Impostazione predefinita: 0. CloudFormation monitora gli allarmi solo mentre le risorse dello stack vengono distribuite, non dopo.

Interfaccia utente corrispondente: scheda Configurazione/Avanzata/Tempo di monitoraggio