Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
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-
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 spaceName
CodeCatalystWorkflowDevelopmentRole-
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. spaceName
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
Puoi usare il CodeCatalystWorkflowDevelopmentRole-
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 spaceName
CodeCatalystWorkflowDevelopmentRole-
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. spaceName
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:
[
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.capability-name
]
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
tags
(DeployCloudFormationStack
/Configuration/tags)
(Facoltativo)
Specificate i tag da allegare allo stack. CloudFormation I tag sono coppie chiave-valore arbitrarie che è possibile utilizzare per identificare lo stack per scopi quali l'allocazione dei costi. Per ulteriori informazioni su cosa sono i tag e su come possono essere utilizzati, consulta Tagging your resources nella Amazon EC2 User Guide. Per ulteriori informazioni sull'aggiunta di tag CloudFormation, consulta Impostazione delle opzioni AWS CloudFormation dello stack nella Guida per l'AWS CloudFormation utente.
Una chiave può contenere caratteri alfanumerici o spazi e può contenere fino a 127 caratteri. Un valore può contenere caratteri alfanumerici o spazi e può contenere fino a 255 caratteri.
È possibile aggiungere fino a 50 tag univoci per ogni stack.
Interfaccia utente corrispondente: Configuration Tab/Advanced/ Tags