Da dove è possibile specificare gli ambienti Precedenza dell'ambiente con AWS CDK Quando specificare gli ambienti Come specificare gli ambienti con AWS CDK Considerazioni relative alla configurazione degli ambienti con AWS CDK Esempi

Configurare gli ambienti da utilizzare con AWS CDK

È possibile configurare AWS gli ambienti in diversi modi da utilizzare con AWS Cloud Development Kit (AWS CDK). Il metodo migliore per gestire AWS gli ambienti varia in base alle esigenze specifiche.

Alla fine, ogni CDK stack dell'applicazione deve essere associato a un ambiente per determinare dove verrà distribuito lo stack.

Per un'introduzione agli AWS ambienti, vedere. Ambienti per AWS CDK

Argomenti

Da dove è possibile specificare gli ambienti
Precedenza dell'ambiente con AWS CDK
Quando specificare gli ambienti
Come specificare gli ambienti con AWS CDK
Considerazioni relative alla configurazione degli ambienti con AWS CDK
Esempi

Da dove è possibile specificare gli ambienti

È possibile specificare gli ambienti nelle credenziali e nei file di configurazione oppure utilizzando la env proprietà del costrutto della Stack Construct Library AWS .

Credenziali e file di configurazione

È possibile utilizzare il AWS Command Line Interface comando (AWS CLI) per creare config file credentials e archiviare, organizzare e gestire le informazioni AWS sull'ambiente. Per ulteriori informazioni su questi file, consulta Impostazioni dei file di configurazione e credenziali nella Guida per l'AWS Command Line Interface utente.

I valori memorizzati in questi file sono organizzati per profili. Il modo in cui denominate i profili e le coppie chiave-valore in questi file varieranno in base al metodo di configurazione dell'accesso programmatico. Per ulteriori informazioni sui diversi metodi, consulta. Configurare le credenziali di sicurezza per AWS CDKCLI

In generale, AWS CDK risolve le Account AWS informazioni contenute nel credentials file e le Regione AWS informazioni contenute nel fileconfig.

Una volta configurati config i file credentials e i file, è possibile specificare l'ambiente da utilizzare con AWS CDK CLI e tramite variabili di ambiente.

proprietà env del costrutto Stack

È possibile specificare l'ambiente per ogni stack utilizzando la env proprietà del costrutto. Stack Questa proprietà definisce un account e una regione da utilizzare. È possibile passare valori codificati a questa proprietà o passare variabili di ambiente offerte da. CDK

Per passare le variabili di ambiente, utilizzate le variabili di ambiente AWS_DEFAULT_ACCOUNT andAWS_DEFAULT_REGION. Queste variabili di ambiente possono trasmettere valori dai tuoi credentials e dai tuoi config file. Puoi anche utilizzare la logica all'interno CDK del codice per determinare i valori di queste variabili di ambiente.

Precedenza dell'ambiente con AWS CDK

Se si utilizzano più metodi per specificare gli ambienti, AWS CDK rispetta la seguente precedenza:

Valori codificati specificati con la proprietà del costrutto. env Stack
AWS_DEFAULT_ACCOUNTe variabili di AWS_DEFAULT_REGION ambiente specificate con la env proprietà del costrutto. Stack
Informazioni sull'ambiente associate al profilo provenienti dai tuoi config file credentials e passate a CDK CLI utilizzando l'--profileopzione.
Il default profilo di Your credentials and config Files.

Quando specificare gli ambienti

Quando sviluppate conCDK, iniziate a definire gli CDK stack, che contengono costrutti che rappresentano AWS le risorse. Successivamente, si sintetizza ogni CDK pila in un modello. AWS CloudFormation Quindi distribuisci il CloudFormation modello nel tuo ambiente. Il modo in cui si specificano gli ambienti determina quando le informazioni sull'ambiente vengono applicate e può influire sul CDK comportamento e sui risultati.

Specificate gli ambienti durante la sintesi del modello

Quando si specificano informazioni sull'ambiente utilizzando la env proprietà del Stack costrutto, le informazioni sull'ambiente vengono applicate alla sintesi del modello. Esegue cdk synth o cdk deploy produce un modello specifico per l'ambiente CloudFormation .

Se si utilizzano variabili di ambiente all'interno della env proprietà, è necessario utilizzare l'opzione con --profile CDK CLI comandi da passare nel profilo contenente le informazioni sull'ambiente ricavate dalle credenziali e dai file di configurazione. Queste informazioni verranno quindi applicate alla sintesi del modello per produrre un modello specifico per l'ambiente.

Le informazioni sull'ambiente contenute nel CloudFormation modello hanno la precedenza sugli altri metodi. Ad esempio, se si fornisce un ambiente diversocdk deploy --profile profile, il profilo verrà ignorato.

Quando fornisci informazioni sull'ambiente in questo modo, puoi utilizzare codice e logica dipendenti dall'ambiente all'interno dell'app. CDK Ciò significa anche che il modello sintetizzato potrebbe essere diverso, in base alla macchina, all'utente o alla sessione in cui viene sintetizzato. Questo approccio è spesso accettabile o auspicabile durante lo sviluppo, ma non è consigliato per l'uso in produzione.

Specificate gli ambienti durante l'implementazione dello stack

Se non specificate un ambiente utilizzando la env proprietà del Stack costrutto, CDK CLI produrrà un modello indipendente dall'ambiente al momento della sintesi CloudFormation . È quindi possibile specificare l'ambiente in cui eseguire la distribuzione utilizzando. cdk deploy --profile profile

Se non si specifica un profilo durante la distribuzione di un modello indipendente dall'ambiente, CDK CLI tenterà di utilizzare i valori di ambiente del default profilo dell'utente e dei file al momento della distribuzione. credentials config

Se le informazioni sull'ambiente non sono disponibili al momento della distribuzione, AWS CloudFormation tenterà di risolvere le informazioni sull'ambiente durante la distribuzione tramite attributi relativi all'ambiente come stack.accountstack.region, e. stack.availabilityZones

Per gli stack indipendenti dall'ambiente, i costrutti all'interno dello stack non possono utilizzare informazioni sull'ambiente e non è possibile utilizzare una logica che richieda informazioni sull'ambiente. Ad esempio, non è possibile scrivere codice simile if (stack.region ==== 'us-east-1') o utilizzare metodi di costruzione che richiedono informazioni sull'ambiente come. Vpc.fromLookup Per utilizzare queste funzionalità, è necessario specificare un ambiente con la env proprietà.

Per gli stack indipendenti dall'ambiente, qualsiasi costrutto che utilizza zone di disponibilità vedrà due zone di disponibilità, che consentono di distribuire lo stack in qualsiasi regione.

Come specificare gli ambienti con AWS CDK

Specificare ambienti codificati per ogni stack

Utilizzate la env proprietà del Stack costrutto per specificare i valori di AWS ambiente per il vostro stack. Di seguito è riportato un esempio:

TypeScript


const envEU  = { account: '2383838383', region: 'eu-west-1' };
const envUSA = { account: '8373873873', region: 'us-west-2' };

new MyFirstStack(app, 'first-stack-us', { env: envUSA });
new MyFirstStack(app, 'first-stack-eu', { env: envEU });

JavaScript


const envEU  = { account: '2383838383', region: 'eu-west-1' };
const envUSA = { account: '8373873873', region: 'us-west-2' };

new MyFirstStack(app, 'first-stack-us', { env: envUSA });
new MyFirstStack(app, 'first-stack-eu', { env: envEU });

Python


env_EU = cdk.Environment(account="8373873873", region="eu-west-1")
env_USA = cdk.Environment(account="2383838383", region="us-west-2")

MyFirstStack(app, "first-stack-us", env=env_USA)
MyFirstStack(app, "first-stack-eu", env=env_EU)

Java


public class MyApp {

    // Helper method to build an environment
    static Environment makeEnv(String account, String region) {
        return Environment.builder()
                .account(account)
                .region(region)
                .build();
    }

    public static void main(final String argv[]) {
        App app = new App();

        Environment envEU = makeEnv("8373873873", "eu-west-1");
        Environment envUSA = makeEnv("2383838383", "us-west-2");
        
        new MyFirstStack(app, "first-stack-us", StackProps.builder()
                .env(envUSA).build());
        new MyFirstStack(app, "first-stack-eu", StackProps.builder()
                .env(envEU).build());
 
        app.synth();
    }
}

C#


Amazon.CDK.Environment makeEnv(string account, string region)
{
    return new Amazon.CDK.Environment
    {
        Account = account,
        Region = region
    };
}

var envEU = makeEnv(account: "8373873873", region: "eu-west-1");
var envUSA = makeEnv(account: "2383838383", region: "us-west-2");

new MyFirstStack(app, "first-stack-us", new StackProps { Env=envUSA });
new MyFirstStack(app, "first-stack-eu", new StackProps { Env=envEU });

Go


env_EU := awscdk.Environment{
	Account: jsii.String("8373873873"),
	Region:  jsii.String("eu-west-1"),
}

env_USA := awscdk.Environment{
	Account: jsii.String("2383838383"),
	Region:  jsii.String("us-west-2"),
}

MyFirstStack(app, "first-stack-us", &awscdk.StackProps{
	Env: &env_USA,
})

MyFirstStack(app, "first-stack-eu", &awscdk.StackProps{
	Env: &env_EU,
})

Consigliamo questo approccio per gli ambienti di produzione. Specificando esplicitamente l'ambiente in questo modo, è possibile garantire che lo stack venga sempre distribuito nell'ambiente specifico.

Specificate gli ambienti utilizzando le variabili di ambiente

AWS CDK Fornisce due variabili di ambiente che è possibile utilizzare all'interno CDK del codice: CDK_DEFAULT_ACCOUNT eCDK_DEFAULT_REGION. Quando utilizzate queste variabili di ambiente all'interno della env proprietà della vostra istanza stack, potete passare le informazioni sull'ambiente dalle vostre credenziali e dai file di configurazione utilizzando il CDK CLI --profileopzione.

Di seguito è riportato un esempio di come specificare queste variabili di ambiente:

TypeScript

Accedi alle variabili di ambiente tramite l'processoggetto di Node.

Nota

È necessario il DefinitelyTyped modulo da utilizzare process TypeScript. cdk initinstalla questo modulo per te. Tuttavia, dovresti installare questo modulo manualmente se stai lavorando con un progetto creato prima che fosse aggiunto o se non hai configurato il progetto utilizzandocdk init.


npm install @types/node


new MyDevStack(app, 'dev', { 
  env: { 
    account: process.env.CDK_DEFAULT_ACCOUNT, 
    region: process.env.CDK_DEFAULT_REGION 
}});

JavaScript

Accedi alle variabili di ambiente tramite l'processoggetto di Node.


new MyDevStack(app, 'dev', { 
  env: { 
    account: process.env.CDK_DEFAULT_ACCOUNT, 
    region: process.env.CDK_DEFAULT_REGION 
}});

Python

Usa il environ dizionario del os modulo per accedere alle variabili di ambiente.


import os
MyDevStack(app, "dev", env=cdk.Environment(
    account=os.environ["CDK_DEFAULT_ACCOUNT"],
    region=os.environ["CDK_DEFAULT_REGION"]))

Java

Usa System.getenv() per ottenere il valore di una variabile d'ambiente.


public class MyApp {

    // Helper method to build an environment
    static Environment makeEnv(String account, String region) {
        account = (account == null) ? System.getenv("CDK_DEFAULT_ACCOUNT") : account;
        region = (region == null) ? System.getenv("CDK_DEFAULT_REGION") : region;

        return Environment.builder()
                .account(account)
                .region(region)
                .build();
    }

    public static void main(final String argv[]) {
        App app = new App();

        Environment envEU = makeEnv(null, null);
        Environment envUSA = makeEnv(null, null);
        
        new MyDevStack(app, "first-stack-us", StackProps.builder()
                .env(envUSA).build());
        new MyDevStack(app, "first-stack-eu", StackProps.builder()
                .env(envEU).build());
 
        app.synth();
    }
}

C#

Si usa System.Environment.GetEnvironmentVariable() per ottenere il valore di una variabile di ambiente.


Amazon.CDK.Environment makeEnv(string account=null, string region=null)
{
    return new Amazon.CDK.Environment
    {
        Account = account ?? System.Environment.GetEnvironmentVariable("CDK_DEFAULT_ACCOUNT"),
        Region = region ?? System.Environment.GetEnvironmentVariable("CDK_DEFAULT_REGION")
    };
}

new MyDevStack(app, "dev", new StackProps { Env = makeEnv() });

Go


import "os"

MyDevStack(app, "dev", &awscdk.StackProps{
	Env: &awscdk.Environment{
		Account: jsii.String(os.Getenv("CDK_DEFAULT_ACCOUNT")),
		Region:  jsii.String(os.Getenv("CDK_DEFAULT_REGION")),
    },
})

Specificando gli ambienti utilizzando variabili di ambiente, è possibile sintetizzare lo stesso CDK stack in AWS CloudFormation modelli per ambienti diversi. Ciò significa che puoi distribuire lo stesso CDK stack in AWS ambienti diversi senza dover modificare il codice. CDK Devi solo specificare il profilo da usare durante l'esecuzione. cdk synth

Questo approccio è ideale per gli ambienti di sviluppo quando si implementa lo stesso stack in ambienti diversi. Tuttavia, non consigliamo questo approccio per gli ambienti di produzione poiché lo stesso CDK codice può sintetizzare modelli diversi, a seconda della macchina, dell'utente o della sessione in cui viene sintetizzato.

Specificate gli ambienti dalle vostre credenziali e dai file di configurazione con il CDK CLI

Quando implementate un modello indipendente dall'ambiente, utilizzate l'opzione con qualsiasi --profile CDK CLI comando per specificare il profilo da utilizzare. Di seguito è riportato un esempio che distribuisce uno CDK stack denominato myStack utilizzando il prod profilo definito nei file credentials andconfig:


$ cdk deploy myStack --profile prod

Per ulteriori informazioni sull'--profileopzione, insieme ad altre CDK CLI comandi e opzioni, vedereAWS CDK CLI riferimento al comando.

Considerazioni relative alla configurazione degli ambienti con AWS CDK

I servizi definiti utilizzando costrutti all'interno degli stack devono supportare la regione in cui si esegue la distribuzione. Per un elenco dei servizi supportati Servizi AWS per regione, consulta AWS Servizi per regione.

È necessario disporre di credenziali AWS Identity and Access Management (IAM) valide per eseguire distribuzioni di stack con the AWS CDK negli ambienti specificati.

Esempi

Sintetizza un modello indipendente dall'ambiente da uno stack CloudFormation CDK

In questo esempio, creiamo un modello indipendente dall'ambiente dal nostro stack. CloudFormation CDK Possiamo quindi distribuire questo modello in qualsiasi ambiente.

Quello che segue è il nostro CDK stack di esempio. Questo stack definisce un bucket Amazon S3 e CloudFormation un output dello stack per la regione del bucket. Per questo esempio, non è definito: env

TypeScript


export class CdkAppStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    // Create the S3 bucket
    const bucket = new s3.Bucket(this, 'amzn-s3-demo-bucket', {
      removalPolicy: cdk.RemovalPolicy.DESTROY,
    });
    
    // Create an output for the bucket's Region
    new cdk.CfnOutput(this, 'BucketRegion', {
      value: bucket.env.region,
    });
  }
}

JavaScript


class CdkAppStack extends cdk.Stack {
  constructor(scope, id, props) {
    super(scope, id, props);

    // Create the S3 bucket
    const bucket = new s3.Bucket(this, 'amzn-s3-demo-bucket', {
      removalPolicy: cdk.RemovalPolicy.DESTROY,
    });
    
    // Create an output for the bucket's Region
    new cdk.CfnOutput(this, 'BucketRegion', {
      value: bucket.env.region,
    });
  }
}

Python


class CdkAppStack(cdk.Stack):

    def __init__(self, scope: cdk.Construct, id: str, **kwargs) -> None:
        super().__init__(scope, id, **kwargs)

        # Create the S3 bucket
        bucket = s3.Bucket(self, 'amzn-s3-demo-bucket',
            removal_policy=cdk.RemovalPolicy.DESTROY
        )
        
        # Create an output for the bucket's Region
        cdk.CfnOutput(self, 'BucketRegion',
            value=bucket.env.region
        )

Java


public class CdkAppStack extends Stack {

    public CdkAppStack(final Construct scope, final String id, final StackProps props) {
        super(scope, id, props);

        // Create the S3 bucket
        Bucket bucket = Bucket.Builder.create(this, "amzn-s3-demo-bucket")
            .removalPolicy(RemovalPolicy.DESTROY)
            .build();
        
        // Create an output for the bucket's Region
        CfnOutput.Builder.create(this, "BucketRegion")
            .value(this.getRegion())
            .build();
    }
}

C#


namespace MyCdkApp
{
    public class CdkAppStack : Stack
    {
        public CdkAppStack(Construct scope, string id, IStackProps props = null) : base(scope, id, props)
        {
            // Create the S3 bucket
            var bucket = new Bucket(this, "amzn-s3-demo-bucket", new BucketProps
            {
                RemovalPolicy = RemovalPolicy.DESTROY
            });
            
            // Create an output for the bucket's Region
            new CfnOutput(this, "BucketRegion", new CfnOutputProps
            {
                Value = this.Region
            });
        }
    }
}

Go


func NewCdkAppStack(scope constructs.Construct, id string, props *CdkAppStackProps) awscdk.Stack {
	stack := awscdk.NewStack(scope, &id, &props.StackProps)

	// Create the S3 bucket
	bucket := awss3.NewBucket(stack, jsii.String("amzn-s3-demo-bucket"), &awss3.BucketProps{
		RemovalPolicy: awscdk.RemovalPolicy_DESTROY,
	})
	
	// Create an output for the bucket's Region
	awscdk.NewCfnOutput(stack, jsii.String("BucketRegion"), &awscdk.CfnOutputProps{
		Value: stack.Region(),
	})

	return stack
}

Quando corriamocdk synth, il CDK CLI produce un CloudFormation modello con lo pseudo parametro AWS::Region come valore di output per la regione del bucket. Questo parametro verrà risolto al momento della distribuzione:


Outputs:
  BucketRegion:
    Value:
      Ref: AWS::Region

Per distribuire questo stack in un ambiente specificato nel dev profilo delle nostre credenziali e dei nostri file di configurazione, eseguiamo quanto segue:


$ cdk deploy CdkAppStack --profile dev

Se non specifichiamo un profilo, il CDK CLI tenterà di utilizzare le informazioni ambientali del default profilo nelle nostre credenziali e nei file di configurazione.

Usa la logica per determinare le informazioni sull'ambiente durante la sintesi del modello

In questo esempio, configuriamo la env proprietà della nostra stack istanza per utilizzare un'espressione valida. Specifichiamo due variabili di ambiente aggiuntive CDK_DEPLOY_ACCOUNT eCDK_DEPLOY_REGION. Queste variabili di ambiente possono sovrascrivere i valori predefiniti al momento della sintesi, se esistono:

TypeScript


new MyDevStack(app, 'dev', { 
  env: { 
    account: process.env.CDK_DEPLOY_ACCOUNT || process.env.CDK_DEFAULT_ACCOUNT, 
    region: process.env.CDK_DEPLOY_REGION || process.env.CDK_DEFAULT_REGION 
}});

JavaScript


new MyDevStack(app, 'dev', { 
  env: { 
    account: process.env.CDK_DEPLOY_ACCOUNT || process.env.CDK_DEFAULT_ACCOUNT, 
    region: process.env.CDK_DEPLOY_REGION || process.env.CDK_DEFAULT_REGION 
}});

Python


MyDevStack(app, "dev", env=cdk.Environment(
    account=os.environ.get("CDK_DEPLOY_ACCOUNT", os.environ["CDK_DEFAULT_ACCOUNT"]),
    region=os.environ.get("CDK_DEPLOY_REGION", os.environ["CDK_DEFAULT_REGION"])

Java


public class MyApp {

    // Helper method to build an environment
    static Environment makeEnv(String account, String region) {
        account = (account == null) ? System.getenv("CDK_DEPLOY_ACCOUNT") : account;
        region = (region == null) ? System.getenv("CDK_DEPLOY_REGION") : region;
        account = (account == null) ? System.getenv("CDK_DEFAULT_ACCOUNT") : account;
        region = (region == null) ? System.getenv("CDK_DEFAULT_REGION") : region;

        return Environment.builder()
                .account(account)
                .region(region)
                .build();
    }

    public static void main(final String argv[]) {
        App app = new App();

        Environment envEU = makeEnv(null, null);
        Environment envUSA = makeEnv(null, null);
        
        new MyDevStack(app, "first-stack-us", StackProps.builder()
                .env(envUSA).build());
        new MyDevStack(app, "first-stack-eu", StackProps.builder()
                .env(envEU).build());
 
        app.synth();
    }
}

C#


Amazon.CDK.Environment makeEnv(string account=null, string region=null)
{
    return new Amazon.CDK.Environment
    {
        Account = account ??
            System.Environment.GetEnvironmentVariable("CDK_DEPLOY_ACCOUNT") ??
            System.Environment.GetEnvironmentVariable("CDK_DEFAULT_ACCOUNT"),
        Region = region ?? 
            System.Environment.GetEnvironmentVariable("CDK_DEPLOY_REGION") ??
            System.Environment.GetEnvironmentVariable("CDK_DEFAULT_REGION")
    };
}

new MyDevStack(app, "dev", new StackProps { Env = makeEnv() });

Go


var account, region string
var b bool

if account, b = os.LookupEnv("CDK_DEPLOY_ACCOUNT"); !b || len(account) == 0 {
	account = os.Getenv("CDK_DEFAULT_ACCOUNT")
}
if region, b = os.LookupEnv("CDK_DEPLOY_REGION"); !b || len(region) == 0 {
	region = os.Getenv("CDK_DEFAULT_REGION")
}

MyDevStack(app, "dev", &awscdk.StackProps{
	Env: &awscdk.Environment{
		Account: &account,
		Region:  &region,
	},
})

Con l'ambiente del nostro stack dichiarato in questo modo, possiamo quindi scrivere un breve script o un file batch e impostare le variabili dagli argomenti della riga di comando, quindi chiamare. cdk deploy Di seguito è riportato un esempio. Tutti gli argomenti oltre ai primi due vengono passati cdk deploy a per specificare le opzioni o gli argomenti della riga di comando:

Possiamo quindi scrivere script aggiuntivi che utilizzano cdk-deploy-to lo script per la distribuzione in ambienti specifici. Di seguito è riportato un esempio:

Di seguito è riportato un esempio che utilizza cdk-deploy-to lo script per la distribuzione in più ambienti. Se la prima distribuzione fallisce, il processo si interrompe:

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Esempio: autenticazione con l'aggiornamento automatico del token di IAM Identity Center

Avvia il tuo ambiente