Criar uma pilha com base no código-fonte do repositório com a sincronização do Git

Este tópico explica como criar uma pilha que sincroniza um repositório Git com a sincronização do Git do AWS CloudFormation.

Importante

Antes de continuar, preencha todos os pré-requisitos na seção anterior.

Criar uma pilha com base no código-fonte do repositório

1. Faça login no AWS Management Console e abra o console AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

2. Na barra de navegação na parte superior da tela, escolha a Região da AWS na qual a pilha deve ser criada.

3. Na página Pilhas, escolha Criar pilha e selecione Com novos recursos (padrão).

4. Na página Create a stack (Criar uma pilha), faça o seguinte:

   1. Em Pré-requisito: preparar modelo, mantenha a opção Escolher um modelo existente selecionada.

   2. Em Especificar modelo, escolha Sincronizar a partir do Git e Próximo.

5. Na página Fornecer um nome de pilha, insira um nome para a pilha. Os nomes para as pilhas podem incluir letras (A-Z e a-z), números (0 a 9) e travessões (-).

6. Em Arquivo de implantação da pilha:

   • Se você não criou um arquivo de implantação da pilha e o adicionou ao repositório, escolha Criar o arquivo usando os parâmetros a seguir e colocá-lo em meu repositório.

   • Se você criou um arquivo de implantação da pilha e o adicionou ao repositório, escolha Estou fornecendo meu próprio arquivo em meu repositório.

   Para ter mais informações, consulte Arquivo de implantação da pilha.

7. Em Repositório de definição de modelo, selecione Escolher um repositório Git vinculado para escolher um repositório Git que já esteja vinculado ao CloudFormation ou Vincular um repositório Git para vincular um novo. Se você escolher Vincular um repositório Git, faça o seguinte:

   1. Em Selecionar provedor de repositório, escolha uma destas opções:

      • GitHub

      • GitHub Enterprise Server

      • GitLab

      • Bitbucket

      • GitLab autogerenciado

   2. Em Conexão, escolha uma conexão na lista. Se nenhuma opção aparecer na lista Conexão, selecione adicione uma nova conexão para acessar o console do Connections e crie uma conexão para o repositório.

8. Na lista Repositório, selecione o repositório Git que contém o arquivo de modelo da pilha.

9. Na lista Ramificação, selecione a ramificação que você deseja que o Git Sync monitore.

   nota

   O Git Sync monitora somente a ramificação selecionada em busca de alterações no modelo do CloudFormation e nos arquivos de implantação da pilha. Quaisquer alterações que você gostaria de aplicar à sua pilha devem ser confirmadas para esta ramificação.

10. Para o Caminho do arquivo de implantação, especifique o caminho completo, incluindo o nome do arquivo de implantação da pilha na raiz da ramificação do repositório.

    Se o CloudFormation estiver gerando o arquivo para você, é neste local que o arquivo será confirmado em seu repositório. Se você estiver fornecendo o arquivo, este será o local do arquivo em seu repositório.

11. Adicione um Perfil do IAM. O perfil do IAM inclui as permissões necessárias para que o CloudFormation sincronize a pilha pelo seu repositório Git. É possível escolher Novo perfil do IAM para gerar um novo perfil ou escolher Perfil do IAM existente para selecionar um perfil existente em sua conta do CloudFormation. Se você optar por gerar um novo perfil, as permissões necessárias serão incluídas no perfil.

12. Para o Caminho do arquivo de modelo, especifique o caminho completo da raiz do seu repositório para o arquivo de modelo de pilha.

13. Adicione parâmetros à pilha que você gostaria de definir usando o arquivo de implantação da pilha. Os parâmetros correspondem a pares chave/valor.

    Por exemplo, para adicionar o parâmetro Port ao arquivo de implantação da pilha:

    1. Selecione Add parameter (Adicionar parâmetro).

    2. Em Chave, digite port.

    3. Em Valor, insira 8080.

    4. Repita as etapas anteriores para todos os parâmetros da pilha que você deseja disponibilizar no arquivo de implantação da pilha.

14. (Opcional) Adicione tags. As etiquetas correspondem a pares chave/valor que você pode usar para identificar e categorizar os recursos na pilha. Para adicionar as etiquetas à implantação da pilha, siga o mesmo processo usado para adicionar os parâmetros.

15. Escolha Próximo a fim de prosseguir para Configurar opções da pilha. Para obter informações sobre como configurar as opções da pilha, consulte Configurar opções da pilha.

    Ao concluir a configuração, escolha Próximo a fim de prosseguir para a etapa de análise e de implantação.

16. Analise as configurações da pilha e confirme o seguinte:

    • O modelo da pilha está configurado corretamente e definido como Sincronizar pelo Git.

    • O arquivo de implantação está configurado corretamente.

    • O repositório de definição de modelo está configurado corretamente e, em particular, o Repositório e o Nome da ramificação estão selecionados adequadamente.

    • A pré-visualização do arquivo de implantação está correta e contém os parâmetros e os valores esperados.

17. Escolha Enviar para criar a pilha.

    Importante

    Uma solicitação pull é criada automaticamente em seu repositório Git quando você escolhe Enviar. Você deve mesclar essa solicitação pull em seu repositório Git para concluir o processo. Ao mesclar a solicitação pull, a pilha é criada e o Git Sync começa a monitorar o modelo do CloudFormation e o arquivo de implantação da pilha em busca de alterações para atualizar a pilha.

Depois que a pilha é configurada para sincronizar com o código-fonte do repositório, o CloudFormation monitora as alterações no repositório Git.

Para atualizar a pilha, realize alterações diretamente no arquivo de implantação da pilha. Em seguida, confirme as alterações para o repositório e para a ramificação que você configurou para a pilha no Git Sync.

No console do CloudFormation, é possível selecionar a pilha e escolher a guia Sincronização do Git para visualizar informações sobre o status da pilha e sobre os eventos de sincronização. Para ter mais informações, consulte Painel de status do Git Sync.