Criar uma pilha

Para criar uma pilha que você executa o comando aws cloudformation create-stack. Você deve fornecer o nome da pilha, a localização de um modelo válido e quaisquer parâmetros de entrada.

Os parâmetros são separados por um espaço e os nomes de chaves fazem distinção entre maiúsculas e minúsculas. Se você digitar incorretamente um nome de chave de parâmetro ao executar aws cloudformation create-stack, o AWS CloudFormation não criará a pilha e relatará que o modelo não contém esse parâmetro.

nota

Você pode usar seu próprio bucket e gerenciar suas permissões carregando modelos manualmente no Amazon S3 ou no AWS Systems Manager. Em seguida, sempre que você criar ou atualizar uma pilha, especifique o Amazon S3 ou AWS Systems Manager de um arquivo de modelo.

Por padrão, o aws cloudformation describe-stacks retorna valores de parâmetros. Para impedir que valores confidenciais de parâmetros, como senhas, sejam retornados, inclua uma propriedade NoEcho definida como TRUE em seu modelo do AWS CloudFormation.

Importante

O uso do atributo NoEcho não mascara informações armazenadas no seguinte:

• A seção de modelo de Metadata. O CloudFormation não transforma, modifica nem edita nenhuma informação incluída na seção Metadata. Para ter mais informações, consulte Metadados.

• A seção de modelo de Outputs. Para ter mais informações, consulte Outputs.

• O atributo Metadata de uma definição de recurso. Para ter mais informações, consulte Atributo Metadata.

É altamente recomendável não usar esses mecanismos para incluir informações confidenciais, como senhas ou segredos.

Importante

Em vez de incorporar informações confidenciais diretamente em modelos do CloudFormation, recomendamos usar os parâmetros dinâmicos no modelo da pilha para fazer referência a informações confidenciais que são armazenadas e gerenciadas de forma externa ao CloudFormation, como no AWS Systems Manager Parameter Store ou no AWS Secrets Manager.

Para obter mais informações, consulte as práticas recomendadas do Não incorporar credenciais em seus modelos.

O exemplo a seguir cria a pilha myteststack:

PROMPT> aws cloudformation create-stack \
  --stack-name myteststack \
  --template-body file:///home/testuser/mytemplate.json \
  --parameters ParameterKey=Parm1,ParameterValue=test1 ParameterKey=Parm2,ParameterValue=test2

O CloudFormation retorna a seguinte saída:

{
  "StackId" : "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/330b0120-1771-11e4-af37-50ba1b98bea6"
}

O exemplo a seguir cria a pilha do myteststack em um documento do AWS Systems Manager:

PROMPT> aws cloudformation create-stack \
 --stack-name myteststack \
 --template-url "ssm-doc://arn:aws:ssm:us-east-1:123456789012:document/documentName"