Use links de criação rápida para criar pilhas do CloudFormation - AWS CloudFormation
Formato do URLExemploCriando uma pilha usando um link de criação rápida

Use links de criação rápida para criar pilhas do CloudFormation

Os links de criação rápida fornecem um método simplificado para iniciar pilhas do CloudFormation diretamente de URLs no console do CloudFormation. Ao especificar o modelo de URL, o nome da pilha e parâmetros do modelo como parâmetros de consulta de URL, é possível preencher previamente uma única página de Criar pilha para acelerar a criação de uma pilha. Isso simplifica o processo de criação de pilhas, reduzindo tanto o número de páginas do assistente quanto a quantidade de entrada do usuário necessária. Isso também otimiza a reutilização de modelos, pois você pode criar vários URLs que especificam valores diferentes para o mesmo modelo.

O link de criação rápida segue este formato de URL:

https://region-code.console.aws.amazon.com/cloudformation/home?region=region-code#/stacks/create/review
   ?templateURL=TemplateURL
   &stackName=StackName
   &param_parameterName=parameterValue

O CloudFormation é compatível com os seguintes parâmetros de consulta de URL:

URL do modelo

Obrigatório. O parâmetro templateURL especifica o URL do modelo de pilha localizado em um bucket do Amazon S3. Para evitar problemas de acesso com um URL do S3 pré-assinado, certifique-se de codificar o URL.

Formatos de URL do S3 válidos:

  • https://s3.region-code.amazonaws.com/bucket-name/template-name

  • https://bucket-name.s3.region-code.amazonaws.com/template-name

  • https://s3-region-code.amazonaws.com/bucket-name/template-name (formato legado)

Nome da pilha

Opcional. Use o parâmetro stackName para especificar o nome da pilha do CloudFormation a ser criada. Um nome de pilha pode conter apenas caracteres alfanuméricos (sensíveis a maiúsculas e minúsculas) e hifens. Ele deve começar com um caractere alfabético e não pode ter mais de 128 caracteres.

Parâmetros do modelo

Opcional. Para parâmetros no modelo de pilha que não são do tipo de parâmetro NoEcho, use o formato param_parameterName na string de consulta do URL. O parâmetro de URL deve incluir o prefixo param_ e o segmento do nome do parâmetro deve corresponder exatamente ao nome do parâmetro no modelo. Por exemplo: param_DBName.

O CloudFormation ignora os parâmetros que não existem no modelo e quaisquer parâmetros definidos com a propriedade NoEcho definida como tipos true (geralmente, nomes de usuário e senhas). Os parâmetros de URL substituem os valores padrão que são especificados no modelo. Inclua quantos parâmetros forem necessários.

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 a prática recomendada Não incorporar credenciais nos seus modelos.

Todos os nomes de parâmetro de consulta diferenciam maiúsculas de minúsculas. Os usuários podem substituir esses valores no console antes de criar a pilha.

O exemplo a seguir é baseado no modelo de exemplo da Instância básica única do WordPress. A string de consulta inclui o parâmetro templateURL obrigatório e os parâmetros stackName, DBName, InstanceType e KeyName.

O URL a seguir tem quebras de linha adicionadas para oferecer clareza.

https://us-east-2.console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/create/review
   ?templateURL=https://s3.us-east-2.amazonaws.com/cloudformation-templates-us-east-2/WordPress_Single_Instance.template
   &stackName=MyWPBlog
   &param_DBName=mywpblog
   &param_InstanceType=t2.medium

O URL a seguir inclui os mesmos parâmetros do exemplo anterior, mas as quebras de linha foram removidas. Este é o formato real do URL.

https://us-east-2.console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/create/review?templateURL=https://s3.us-east-2.amazonaws.com/cloudformation-templates-us-east-2/WordPress_Single_Instance.template&stackName=MyWPBlog&param_DBName=mywpblog&param_InstanceType=t2.medium

Ao abrir um link de criação rápida, você é direcionado para o console do CloudFormation. O console abre diretamente na página Criar pilha rapidamente, com os valores fornecidos usados automaticamente para os parâmetros.

Para criar uma pilha usando um link de criação rápida (console)

  1. Na página Criar pilha rapidamente, em Modelo, URL do modelo, confirme se o URL do modelo está correto.

  2. Expanda a seção Visualizar modelo para verificar o modelo.

  3. Em Nome da pilha, verifique o nome da pilha pré-preenchido.

  4. Revise a seção Parâmetros. Verifique se os valores dos parâmetros pré-preenchidos estão corretos. Preencha todos os parâmetros obrigatórios que não foram especificados no URL. Modifique quaisquer valores pré-preenchidos, se necessário.

  5. Agora, é possível definir as seguintes configurações:

    • Tags — Organize recursos com pares de chave-valor.

    • Permissões: escolha o perfil de serviço do IAM para operações de pilha.

    • Opções de falha na pilha — Escolha reverter (padrão) ou preservar recursos.

    • Política de pilha — Controle as permissões de atualização de recursos.

    • Configuração de reversão — Configure a reversão baseada em alarme do CloudWatch.

    • Opções de notificação — Configure notificações do Amazon SNS para eventos de pilha.

    • Opções de criação de pilha — Defina o tempo máximo de criação da pilha e ative a proteção contra encerramento para evitar exclusões acidentais.

    Para obter mais informações, consulte Configurar opções da pilha.

  6. Para Capacidades, preencha todas as confirmações necessárias. Se o seu modelo contém recursos do IAM, selecione I acknowledge that this template may create IAM resources (Eu reconheço que este modelo pode criar recursos do IAM) para especificar que você deseja usar recursos do IAM no modelo. Para obter mais informações, consulte Confirmar recursos do IAM em modelos do CloudFormation.

  7. (Opcional) É possível criar um conjunto de alterações para visualizar a configuração da pilha do antes de criá-la. Escolha Criar conjunto de alterações e siga as instruções. Para obter mais informações, consulte Visualizar a configuração da sua pilha.

  8. Quando estiver pronto, escolha Criar pilha para iniciar a pilha e, em seguida, monitore o progresso da criação da pilha na guia Eventos. Para obter mais informações, consulte Monitorar o progresso da pilha.