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à.

CloudFormation StackSets riferimento all'azione di distribuzione

CodePipeline offre la possibilità di eseguire CloudFormation StackSets operazioni come parte del CI/CD processo. Utilizza uno stack set per creare stack negli AWS account tra AWS le regioni utilizzando un unico CloudFormation modello. Tutte le risorse incluse in ogni stack sono definite dal CloudFormation modello del set di stack. Quando si crea lo stack set, si specifica il modello da utilizzare, nonché tutti i parametri e le funzionalità richiesti dal modello.

Per ulteriori informazioni sui concetti per CloudFormation StackSets, consulta StackSets i concetti nella Guida per l'AWS CloudFormation utente.

È possibile integrare la pipeline CloudFormation StackSets tramite due tipi di azioni distinti che si utilizzano insieme:

Puoi utilizzare queste azioni per implementarle AWS sugli account di destinazione o sugli ID delle unità organizzative AWS delle organizzazioni di destinazione.

In che modo CloudFormation StackSets le azioni funzionano

Un'CloudFormationStackSetazione crea o aggiorna le risorse a seconda che venga eseguita per la prima volta.

L'CloudFormationStackSetazione crea o aggiorna lo stack set e distribuisce tali modifiche alle istanze specificate.

L'CloudFormationStackInstancesazione crea nuove istanze di stack o aggiorna le istanze di stack obsolete. Un'istanza diventa obsoleta quando uno stack set viene aggiornato, ma non tutte le istanze al suo interno vengono aggiornate.

Come parte di un aggiornamento, le CloudFormationStackInstances azioni CloudFormationStackSet and possono specificare nuovi obiettivi di distribuzione, creando nuove istanze di stack.

Come parte di un aggiornamento, le CloudFormationStackInstances azioni CloudFormationStackSet and non eliminano set di stack, istanze o risorse. Quando l'azione aggiorna uno stack ma non specifica tutte le istanze da aggiornare, le istanze che non sono state specificate per l'aggiornamento vengono rimosse dall'aggiornamento e impostate sullo stato di. OUTDATED

Durante una distribuzione, le istanze dello stack possono anche indicare OUTDATED se la distribuzione nelle istanze non è riuscita.

Come strutturare le azioni in una pipeline StackSets

Come best practice, dovresti costruire la pipeline in modo che lo stack set venga creato e inizialmente distribuito in un sottoinsieme o in una singola istanza. Dopo aver testato la distribuzione e visualizzato lo stack set generato, aggiungi l'CloudFormationStackInstancesazione in modo che le istanze rimanenti vengano create e aggiornate.

Usa la console o la CLI per creare la struttura della pipeline consigliata come segue:

Quando avvii un aggiornamento dello stack in cui hai rimosso i target di distribuzione dalla configurazione dell'azione, le istanze dello stack non designate per l'aggiornamento vengono rimosse dalla distribuzione e passano allo stato OBSOLETO. Ad esempio, per l'aggiornamento delle istanze dello stack per l'account Account-A in cui la us-east-2 regione viene rimossa dalla configurazione dell'azione, vengono create le istanze dello stack rimanenti e l'istanza rimossa viene impostata su OUTDATED come segue:

Per ulteriori informazioni sulle best practice per l'implementazione di stack set, consulta Best practice for StackSets nella Guida per l'AWS CloudFormation utente.

L'operazione CloudFormationStackSet

Questa azione crea o aggiorna uno stack set a partire dal modello archiviato nella posizione di origine della pipeline.

Dopo aver definito uno stack set, è possibile creare, aggiornare o eliminare gli stack negli account e nelle regioni di destinazione specificati nei parametri di configurazione. Durante la creazione, l'aggiornamento e l'eliminazione degli stack, è possibile specificare altre preferenze, come l'ordine delle regioni in cui le operazioni devono essere eseguite, la percentuale di tolleranza agli errori oltre la quale le operazioni sullo stack si interrompono e il numero di account in cui le operazioni vengono eseguite contemporaneamente sugli stack.

Un set di stack è una risorsa di livello regionale. Se crei uno stack set in una AWS regione, non puoi accedervi da altre regioni.

Quando questa azione viene utilizzata come azione di aggiornamento dello stack set, gli aggiornamenti allo stack non sono consentiti senza una distribuzione in almeno un'istanza dello stack.

Tipo di operazione

Parametri di configurazione

Input artifact (Artefatti di input)

È necessario includere almeno un elemento di input che contenga il modello per lo stack set in un'azione. CloudFormationStackSet È possibile includere più elementi di input per gli elenchi di obiettivi di distribuzione, account e parametri.

Artefatti di output

Variabili di output

Se si configura questa azione, vengono generate variabili a cui è possibile fare riferimento nella configurazione dell'azione di un'azione a valle nella pipeline. È possibile configurare un'azione con uno spazio dei nomi per rendere tali variabili disponibili per la configurazione delle azioni downstream.

Per ulteriori informazioni, consulta Riferimento alle variabili.

Esempio CloudFormationStackSet configurazione dell'azione

Gli esempi seguenti mostrano la configurazione dell'CloudFormationStackSetazione.

Esempio del modello di autorizzazioni autogestite

L'esempio seguente mostra un'CloudFormationStackSetazione in cui l'obiettivo di distribuzione immesso è un AWS ID account.

YAML

Name: CreateStackSet
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Provider: CloudFormationStackSet
  Version: '1'
RunOrder: 1
Configuration:
  DeploymentTargets: '111111222222'
  FailureTolerancePercentage: '20'
  MaxConcurrentPercentage: '25'
  PermissionModel: SELF_MANAGED
  Regions: us-east-1
  StackSetName: my-stackset
  TemplatePath: 'SourceArtifact::template.json'
OutputArtifacts: []
InputArtifacts:
  - Name: SourceArtifact
Region: us-west-2
Namespace: DeployVariables

JSON

{
    "Name": "CreateStackSet",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Provider": "CloudFormationStackSet",
        "Version": "1"
    },
    "RunOrder": 1,
    "Configuration": {
        "DeploymentTargets": "111111222222",
        "FailureTolerancePercentage": "20",
        "MaxConcurrentPercentage": "25",
        "PermissionModel": "SELF_MANAGED",
        "Regions": "us-east-1",
        "StackSetName": "my-stackset",
        "TemplatePath": "SourceArtifact::template.json"
    },
    "OutputArtifacts": [],
    "InputArtifacts": [
        {
            "Name": "SourceArtifact"
        }
    ],
    "Region": "us-west-2",
    "Namespace": "DeployVariables"
}

Esempio del modello di autorizzazioni gestite dal servizio

L'esempio seguente mostra un'CloudFormationStackSetazione per il modello di autorizzazioni gestite dal servizio in cui l'opzione per la distribuzione automatica nelle organizzazioni è abilitata con la conservazione dello stack. AWS

YAML

Name: Deploy
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Provider: CloudFormationStackSet
  Version: '1'
RunOrder: 1
Configuration:
  Capabilities: 'CAPABILITY_IAM,CAPABILITY_NAMED_IAM'
  OrganizationsAutoDeployment: EnabledWithStackRetention
  PermissionModel: SERVICE_MANAGED
  StackSetName: stacks-orgs
  TemplatePath: 'SourceArtifact::template.json'
OutputArtifacts: []
InputArtifacts:
  - Name: SourceArtifact
Region: eu-central-1
Namespace: DeployVariables

JSON

{
    "Name": "Deploy",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Provider": "CloudFormationStackSet",
        "Version": "1"
    },
    "RunOrder": 1,
    "Configuration": {
        "Capabilities": "CAPABILITY_IAM,CAPABILITY_NAMED_IAM",
        "OrganizationsAutoDeployment": "EnabledWithStackRetention",
        "PermissionModel": "SERVICE_MANAGED",
        "StackSetName": "stacks-orgs",
        "TemplatePath": "SourceArtifact::template.json"
    },
    "OutputArtifacts": [],
    "InputArtifacts": [
        {
            "Name": "SourceArtifact"
        }
    ],
    "Region": "eu-central-1",
    "Namespace": "DeployVariables"
}

L'azione CloudFormationStackInstances

Questa azione crea nuove istanze e distribuisce set di stack su istanze specificate. Un'istanza di stack è un riferimento a uno stack in un account target all'interno di una Regione. Un'istanza di stack può esistere senza uno stack; ad esempio, se la creazione dello stack non ha esito positivo, l'istanza dello stack mostra il motivo dell'errore di creazione dello stack. Un'istanza di stack è associata a un solo set di stack.

Dopo la creazione iniziale di uno stack set, è possibile aggiungere nuove istanze di stack utilizzandoCloudFormationStackInstances. I valori dei parametri del modello possono essere sovrascritti a livello di istanza di stack durante le operazioni di creazione o aggiornamento delle istanze dello stack set.

Ogni set di stack ha un modello e un set di parametri di modello. Quando si aggiornano il modello o i parametri del modello, li si aggiorna per l'intero set. Quindi tutti gli stati dell'istanza vengono impostati OUTDATED fino a quando le modifiche non vengono distribuite a quell'istanza.

Per sovrascrivere i valori dei parametri su istanze specifiche, ad esempio, se il modello contiene un parametro per stage con un valore diprod, puoi sostituire il valore di quel parametro con o. beta gamma

Tipo di operazione

Parametri di configurazione

Input artifact (Artefatti di input)

CloudFormationStackInstancespuò contenere artefatti che elencano gli obiettivi e i parametri di distribuzione.

Artefatti di output

Variabili di output

Quando è configurata, questa azione produce variabili che possono essere referenziate dalla configurazione dell'azione di un'azione downstream nella pipeline. È possibile configurare un'azione con uno spazio dei nomi per rendere tali variabili disponibili per la configurazione delle azioni downstream.

Per ulteriori informazioni, consulta Riferimento alle variabili.

Esempio di configurazione dell'operazione

Gli esempi seguenti mostrano la configurazione dell'CloudFormationStackInstancesazione.

Esempio del modello di autorizzazioni autogestite

L'esempio seguente mostra un'CloudFormationStackInstancesazione in cui l'obiettivo di distribuzione immesso è un ID. Account AWS 111111222222

YAML

Name: my-instances
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Provider: CloudFormationStackInstances
  Version: '1'
RunOrder: 2
Configuration:
  DeploymentTargets: '111111222222'
  Regions: 'us-east-1,us-east-2,us-west-1,us-west-2'
  StackSetName: my-stackset
OutputArtifacts: []
InputArtifacts:
  - Name: SourceArtifact
Region: us-west-2

JSON

{
    "Name": "my-instances",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Provider": "CloudFormationStackInstances",
        "Version": "1"
    },
    "RunOrder": 2,
    "Configuration": {
        "DeploymentTargets": "111111222222",
        "Regions": "us-east-1,us-east-2,us-west-1,us-west-2",
        "StackSetName": "my-stackset"
    },
    "OutputArtifacts": [],
    "InputArtifacts": [
        {
            "Name": "SourceArtifact"
        }
    ],
    "Region": "us-west-2"
}

Esempio del modello di autorizzazioni gestite dal servizio

L'esempio seguente mostra un'CloudFormationStackInstancesazione per il modello di autorizzazioni gestite dal servizio in cui l'obiettivo di distribuzione è l'ID dell'unità organizzativa dell'organizzazione. AWS ou-1111-1example

YAML

Name: Instances
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Provider: CloudFormationStackInstances
  Version: '1'
RunOrder: 2
Configuration:
  DeploymentTargets: ou-1111-1example
  Regions: us-east-1
  StackSetName: my-stackset
OutputArtifacts: []
InputArtifacts:
  - Name: SourceArtifact
Region: eu-central-1

JSON

{
    "Name": "Instances",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Provider": "CloudFormationStackInstances",
        "Version": "1"
    },
    "RunOrder": 2,
    "Configuration": {
        "DeploymentTargets": "ou-1111-1example",
        "Regions": "us-east-1",
        "StackSetName": "my-stackset"
    },
    "OutputArtifacts": [],
    "InputArtifacts": [
        {
            "Name": "SourceArtifact"
        }
    ],
    "Region": "eu-central-1"
}

Autorizzazioni per i ruoli di servizio: azione CloudFormationStackSet

Per CloudFormation StackSets le azioni, sono richieste le seguenti autorizzazioni minime.

Per l'CloudFormationStackSetazione, aggiungi quanto segue alla tua dichiarazione sulla politica:

{
    "Effect": "Allow",
    "Action": [
        "cloudformation:CreateStackSet",
        "cloudformation:UpdateStackSet",
        "cloudformation:CreateStackInstances",
        "cloudformation:DescribeStackSetOperation",
        "cloudformation:DescribeStackSet",
        "cloudformation:ListStackInstances"
    ],
    "Resource": "resource_ARN"
},

Autorizzazioni per i ruoli di servizio: azione CloudFormationStackInstances

Per l'CloudFormationStackInstancesazione, aggiungi quanto segue alla tua dichiarazione politica:

{
    "Effect": "Allow",
    "Action": [
        "cloudformation:CreateStackInstances",
        "cloudformation:DescribeStackSetOperation"
    ],
    "Resource": "resource_ARN"
},

Modelli di autorizzazione per le operazioni di stack set

Poiché CloudFormation StackSets esegue operazioni su più account, è necessario definire le autorizzazioni necessarie in tali account prima di poter creare lo stack set. È possibile definire le autorizzazioni tramite autorizzazioni autogestite o autorizzazioni gestite dal servizio.

Con le autorizzazioni autogestite, si creano i due ruoli IAM richiesti StackSets : un ruolo di amministratore, ad esempio nell'account AWSCloudFormationStackSetAdministrationRole in cui si definisce lo stack set e un ruolo di esecuzione, ad esempio AWSCloudFormationStackSetExecutionRole in ciascuno degli account in cui si distribuiscono le istanze dello stack set. Utilizzando questo modello di autorizzazioni, è StackSets possibile eseguire l'implementazione su qualsiasi AWS account in cui l'utente dispone delle autorizzazioni per creare un ruolo IAM. Per ulteriori informazioni, consulta Concessione di autorizzazioni autogestite nella Guida per l'utente. AWS CloudFormation

Con le autorizzazioni gestite dal servizio, puoi distribuire istanze stack agli account gestiti dalle organizzazioni. AWS Utilizzando questo modello di autorizzazioni, non è necessario creare i ruoli IAM necessari perché StackSets crea i ruoli IAM per conto dell'utente. Con questo modello, puoi anche abilitare le distribuzioni automatiche agli account che verranno aggiunti all'organizzazione in futuro. Vedi Abilita l'accesso affidabile con AWS le organizzazioni nella Guida per l'AWS CloudFormation utente.

Tipi di dati relativi ai parametri del modello

I parametri del modello utilizzati nelle operazioni sugli stack set includono i seguenti tipi di dati. Per ulteriori informazioni, consulta DescribeStackSet.

Ogni set di stack ha un modello e un set di parametri del modello. Quando si aggiornano il modello o i parametri del modello, li si aggiorna per l'intero set. Quindi tutti gli stati dell'istanza vengono impostati su OBSOLETO fino a quando le modifiche non vengono distribuite a quell'istanza.

Per sovrascrivere i valori dei parametri su istanze specifiche, ad esempio, se il modello contiene un parametro per stage con un valore diprod, puoi sovrascrivere il valore di quel parametro impostandolo su or. beta gamma

Consulta anche

Le risorse correlate seguenti possono essere utili durante l'utilizzo di questa operazione.