Este é o Guia do desenvolvedor do AWS CDK v2. O CDK v1 antigo entrou em manutenção em 1º de junho de 2022 e encerrou o suporte em 1º de junho de 2023.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Salvar e recuperar valores de variáveis de contexto

É possível especificar variáveis de contexto com o kit de desenvolvimento em nuvem da AWS (CDK da AWS) ou no arquivo cdk.json. Em seguida, use o método TryGetContext para recuperar valores.

Especificar variáveis de contexto

É possível especificar uma variável de contexto como parte de um comando CLI do AWS CDK, ou no cdk.json.

Para criar uma variável de contexto de linha de comando, use a opção --context (-c), conforme mostrado no exemplo a seguir.

cdk synth -c bucket_name=mygroovybucket

Para especificar a mesma variável de contexto e valor no arquivo cdk.json, use o código a seguir.

{
  "context": {
    "bucket_name": "myotherbucket"
  }
}

Se você especificar uma variável de contexto usando a CLI do AWS CDK e o arquivo cdk.json, o valor da CLI do AWS CDK terá precedência.

Recuperar os valores das variáveis de contexto

Para obter o valor de uma variável de contexto em sua aplicação, use o método TryGetContext no contexto de um constructo. (Ou seja, quando this, ou self em Python, é uma instância de algum constructo.)

Neste exemplo, recuperamos o valor da variável de contexto bucket_name. Se o valor solicitado não estiver definido, TryGetContext retornará undefined (None em Python; null em Java e C#; nil em Go) em vez de gerar uma exceção.

Fora do contexto de um constructo, você pode acessar a variável de contexto do objeto da aplicação dessa forma.

Para obter mais detalhes sobre como trabalhar com variáveis de contexto, consulte Variáveis de contexto e o AWS CDK.