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á.
Alwin Abraham, Amazon Web Services
O AWS Amplify ajuda você a implantar e testar rapidamente sites estáticos sem precisar configurar a infraestrutura que normalmente é necessária. Você pode implantar a abordagem desse padrão se sua organização quiser usar o Bitbucket para controle de origem, seja para migrar o código do aplicativo existente ou para criar um novo aplicativo. Ao usar CloudFormation a AWS para configurar automaticamente o Amplify, você fornece visibilidade das configurações que você usa.
Esse padrão descreve como criar um pipeline front-end de integração contínua e implantação contínua (CI/CD) e um ambiente de implantação usando a AWS CloudFormation para integrar um repositório Bitbucket ao AWS Amplify. A abordagem do padrão significa que você pode criar um pipeline de frontend do Amplify para implantações repetíveis.
Pré-requisitos
Uma conta ativa da Amazon Web Services (AWS)
Uma conta ativa do Bitbucket com acesso de administrador
Acesso a um terminal que usa cURL ou o aplicativo Postman
Familiaridade com o Amplify
Familiaridade com a AWS CloudFormation
Familiaridade com arquivos YAML-formatted
Pilha de tecnologia
Amplify
AWS CloudFormation
Bitbucket
AWS Amplify: o Amplify ajuda os desenvolvedores a desenvolverem e implantarem aplicativos móveis e web baseados na nuvem.
AWS CloudFormation — CloudFormation A AWS é um serviço que ajuda você a modelar e configurar seus recursos da AWS para que você possa passar menos tempo gerenciando esses recursos e mais tempo se concentrando em seus aplicativos que são executados na AWS.
Bitbucket: o Bitbucket é uma solução de gerenciamento de repositórios Git projetada para equipes profissionais. Ele oferece um local central para gerenciar repositórios Git, colaborar em seu código-fonte e guiá-lo pelo fluxo de desenvolvimento.
Código
O bitbucket-amplify.yml arquivo (anexado) contém o CloudFormation modelo da AWS para esse padrão.
| Tarefa | Description | Habilidades necessárias |
|---|
| (Opcional) Criar um repositório do Bitbucket. | Faça login na sua conta do Bitbucket e crie um novo repositório. Para obter mais informações, consulte Criar um repositório Git na documentação do Bitbucket. Registre o nome do espaço de trabalho.
Você também pode usar um repositório do Bitbucket já existente. | DevOps engenheiro |
| Abra as configurações do espaço de trabalho. | Abra o espaço de trabalho e escolha a guia Repositório. Escolha o repositório que você deseja usar no Amplify. Escolha o nome do espaço de trabalho que está acima do nome do repositório. Na barra lateral, escolha Configurações.
| DevOps engenheiro |
| Crie um consumidor OAuth. | Na seção Aplicativos e recursos, escolha Consumidores do OAuth e, em seguida, escolha Adicionar consumidor. Insira um nome para o seu consumidor, como por exemplo, Amplify Integration. Insira um URL de retorno de chamada. Embora esse campo seja uma entrada obrigatória, ele não é usado para concluir a integração, portanto, o valor pode ser http://localhost:3000 Marque a caixa Este é um consumidor privado. Selecione as seguintes permissões: Projeto – Read Repositórios – Admin Solicitações pull – Read Webhooks – Read e Write
Deixe as opções padrão para todos os outros campos e escolha Enviar. Registre a chave e o segredo que são gerados.
| DevOps engenheiro |
| Obtenha o token de acesso OAuth. | Abra uma janela de terminal e execute o seguinte comando:
curl -X POST -u "KEY:SECRET" https://bitbucket.org/site/oauth2/access_token -d grant_type=client_credentials
Substitua KEY e SECRET pelos valores de chave e de segredo que você anotou anteriormente. 2. Grave o token de acesso sem usar as aspas. O token só é válido por um tempo limitado e o tempo padrão é de duas horas. Você deve executar o CloudFormation modelo da AWS nesse período. | DevOps engenheiro |
| Tarefa | Description | Habilidades necessárias |
|---|
| Baixe o CloudFormation modelo da AWS. | Faça o download do CloudFormation modelo bitbucket-amplify.yml da AWS (em anexo). Esse modelo cria o CI/CD pipeline no Amplify, além do projeto e da ramificação do Amplify. | |
| Crie e implante o AWS CloudFormation stack. | Faça login no Console de Gerenciamento da AWS na região da AWS em que você deseja implantar e abra o CloudFormation console da AWS. Selecione Criar pilha (com novos recursos) e selecione Fazer upload de um arquivo de modelo. Carregue o arquivo bitbucket-amplify.yml. Escolha Próximo, insira o nome da pilha e, após, insira os seguintes parâmetros: Token de acesso: cole o token de acesso OAuth que você criou anteriormente. URL do repositório: adicione o URL do repositório do projeto Bitbucket. O URL tipicamente é no seguinte formato: https://bitbucket.org/<WORKSPACE_NAME>/<REPO_NAME> Nome da ramificação: deve corresponder ao nome de uma ramificação no seu repositório do Bitbucket. Essa ramificação não precisa existir quando você executa a CloudFormation pilha da AWS, mas é necessária para implantar código no ambiente. Nome do projeto: Esse é o nome a ser associado ao projeto Amplify.
5. Escolha Próximo e, em seguida, Criar pilha. | DevOps engenheiro |
| Tarefa | Description | Habilidades necessárias |
|---|
| Implantar o código na ramificação do seu repositório. | Clone seu repositório Bitbucket executando o seguinte comando: git clone https://bitbucket.org/<WORKSPACE_NAME>/<REPO_NAME> Confira o nome da filial que foi usado ao executar o CloudFormation script da AWS. Para criar e verificar uma nova ramificação, execute o comando git checkout -b <BRANCH_NAME>. Para verificar uma ramificação existente, execute o comando git checkout <BRANCH_NAME> Confirme o código na ramificação e envie-o para a ramificação remota executando os comandos git commit e git push. Em seguida, o Amplify cria e implanta o aplicativo.
Para obter mais informações, consulte Comandos básicos do Git na documentação do Bitbucket. | Desenvolvedor de aplicativos |
Métodos de autenticação (documentação da Atlassian)
Anexos
Para acessar o conteúdo adicional associado a este documento, baixe e descompacte o seguinte arquivo: attachment.zip