Fluxos de trabalho de equipe com aplicações Amplify Gen 1 full-stack

A implantação de uma ramificação de atributos consiste em um ambiente de frontend e um ambiente de backend opcional. O frontend é construído e implantado em uma rede global de entrega de conteúdo (CDN), enquanto o backend é implantado pelo Amplify Studio ou pela CLI do Amplify para AWS. Para saber como configurar esse cenário de implantação, consulte Compilação de um backend para uma aplicação.

O Amplify Hosting implanta continuamente atributos de backend como APIs do GraphQL e funções do Lambda com sua implantação de ramificação de atributo. É possível usar os seguintes modelos de ramificação para implantar seu backend e frontend com Amplify Hosting.

Fluxo de trabalho de ramificação de atributo

• Crie os ambientes de backend prod, test e dev com a Amplify CLI.

• Mapeie o backend do produto para a ramificação principal.

• Mapeie o backend de teste para a ramificação de desenvolvimento.

• Os membros da equipe podem usar o ambiente de backend de desenvolvimento para testar ramificações de atributos individuais.

1. Instale a Amplify CLI para inicializar um novo projeto do Amplify.

   npm install -g @aws-amplify/cli

2. Inicialize um ambiente de backend prod para o seu projeto. Se você não tiver um projeto, crie um usando ferramentas bootstrap como create-react-app ou Gatsby.

   create-react-app next-unicorn
   cd next-unicorn
   amplify init
    ? Do you want to use an existing environment? (Y/n): n
    ? Enter a name for the environment: prod
   ...
   amplify push

3. Adicione os ambientes de backend test e dev.

   amplify env add
    ? Do you want to use an existing environment? (Y/n): n
    ? Enter a name for the environment: test
   ...
   amplify push
   
   amplify env add
    ? Do you want to use an existing environment? (Y/n): n
    ? Enter a name for the environment: dev
   ...
   amplify push

4. Envie o código para um repositório Git de sua escolha (neste exemplo, vamos supor que você enviou para o principal).

   git commit -am 'Added dev, test, and prod environments'
   git push origin main

5. Visite Amplify no AWS Management Console para ver seu ambiente de backend atual. Navegue um nível acima no rastro de navegação para ver uma lista de todos os ambientes de backend criados na guia Ambientes de backend.

   

6. Mude para a guia Ambientes de frontend e conecte seu provedor de repositório e a ramificação principal.

7. Na página de configurações de compilação, selecione um ambiente de backend existente para configurar a implantação contínua com a ramificação principal. Escolha prod na lista e conceda o perfil de serviço para o Amplify. Escolha Salvar e implantar. Depois que a compilação for concluída, haverá uma implantação de ramificação principal disponível em https://master.appid.amplifyapp.com.

   

8. Conecte a ramificação develop no Amplify (presuma que as ramificações develop e principal são as mesmas nesse ponto). Escolha o ambiente de backend test.

   

9. O Amplify agora está configurado. É possível começar a trabalhar em novos atributos em um atributo de atributo. Adicione a funcionalidade de backend usando o ambiente de backend dev na sua estação de trabalho local.

   git checkout -b newinternet
   amplify env checkout dev
   amplify add api
   ...
   amplify push

10. Quando terminar de trabalhar no atributo, confirme seu código, crie uma solicitação pull para revisar internamente.

    git commit -am 'Decentralized internet v0.1'
    git push origin newinternet

11. Para visualizar como serão as alterações, acesse o console do Amplify e conecte a ramificação de atributo. Observação: se você tiver a AWS CLI instalada no sistema (não a Amplify CLI), poderá conectar uma ramificação diretamente de seu terminal. Para encontrar o ID do aplicativo, vá até Configurações do aplicativo > Geral > ARN do aplicativo: arn:aws:amplify:<region>:<region>:apps/<appid>

    aws amplify create-branch --app-id <appid> --branch-name <branchname>
    aws amplify start-job --app-id <appid> --branch-name <branchname> --job-type RELEASE

12. Seu atributo estará acessível em https://newinternet.appid.amplifyapp.com para compartilhar com sua equipe. Se tudo estiver aparentemente correto, mescle o PR à ramificação de desenvolvimento.

    git checkout develop
    git merge newinternet
    git push

13. Isso iniciará uma compilação que atualizará o backend e o frontend no Amplify com uma implantação de ramificação em https://dev.appid.amplifyapp.com. É possível compartilhar esse link com partes interessadas, para que possam revisar o novo atributo.

14. Exclua sua ramificação de atributos do Git, Amplify e remova o ambiente de backend da nuvem (você sempre pode criar executando ‘amplify env checkout prod’ e executando ‘amplify env add’).

    git push origin --delete newinternet
    aws amplify delete-branch --app-id <appid> --branch-name <branchname>
    amplify env remove dev

Fluxo de trabalho do GitFlow

O GitFlow usa duas ramificações para registrar o histórico do projeto. A ramificação principal rastreia somente o código de lançamento e a ramificação develop é usada como uma ramificação de integração para novos atributos. O GitFlow simplifica o desenvolvimento paralelo isolando o novo desenvolvimento do trabalho concluído. O novo desenvolvimento (como atributos e correções de erros não emergenciais) é feito em ramificações de atributo. Quando o desenvolvedor estiver satisfeito com o código e entender que ele está pronto para o lançamento, a ramificação de atributo será mesclada com a ramificação de desenvolvimento de integração. As únicas confirmações para a ramificação principal são as mesclagens de ramificações release e ramificações hotfix (para corrigir erros emergenciais).

O diagrama a seguir mostra uma configuração recomendada com GitFlow. É possível seguir o mesmo processo descrito na seção de fluxo de trabalho de ramificação de atributo acima.

Sandbox de desenvolvedor

• Cada desenvolvedor em uma equipe cria um ambiente de sandbox na nuvem, separado do computador local. Isso permite que os desenvolvedores trabalhem em isolamento uns dos outros sem substituir as alterações de outros membros da equipe.

• Cada ramificação no Amplify tem seu próprio backend. Isso garante que o Amplify use o repositório do Git como uma fonte única da verdade a partir da qual implantar alterações, em vez de depender que os desenvolvedores da equipe enviem manualmente o backend ou frontend para a produção a partir do computador local deles.

1. Instale a Amplify CLI para inicializar um novo projeto do Amplify.

   npm install -g @aws-amplify/cli

2. Inicialize um ambiente de backend mary para o seu projeto. Se você não tiver um projeto, crie um usando ferramentas bootstrap como create-react-app ou Gatsby.

   cd next-unicorn
   amplify init
    ? Do you want to use an existing environment? (Y/n): n
    ? Enter a name for the environment: mary
   ...
   amplify push

3. Envie o código para um repositório Git de sua escolha (neste exemplo, vamos supor que você enviou para o principal).

   git commit -am 'Added mary sandbox'
   git push origin main

4. Conecte seu repo > principal ao Amplify.

5. O console do Amplify detecta ambientes de backend criados pela Amplify CLI. Escolha Criar novo ambiente no menu suspenso e conceda a perfil de serviço para o console do Amplify. Escolha Salvar e implantar. Depois que a compilação for concluída, haverá uma implantação de ramificação principal disponível em https://master.appid.amplifyapp.com com um novo ambiente de backend que é vinculado à ramificação.

6. Conecte a ramificação desenvolver no Amplify (presuma que as ramificações desenvolver e principal são as mesmas nesse ponto) e escolha Criar