Fluxos de trabalho de equipe com aplicativos Amplify Gen 1 completos - AWS Amplify Hospedagem
Fluxo de trabalho de ramificação de atributoGitFlow fluxo de trabalhoSandbox de desenvolvedor

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á.

Fluxos de trabalho de equipe com aplicativos Amplify Gen 1 completos

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

O Amplify Hosting implanta continuamente atributos de back-end 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 back-end e front-end com Amplify Hosting.

Fluxo de trabalho de ramificação de atributo

  • Crie os ambientes de back-end prod, test e dev com a Amplify CLI.

  • Mapeie o back-end do produto para a ramificação principal.

  • Mapeie o back-end de teste para a ramificação de desenvolvimento.

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

Um diagrama que mostra como mapear relacionamentos de ambientes de back-end para ramificações de front-end.

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

    npm install -g @aws-amplify/cli

  2. Inicialize um ambiente de back-end prod para o seu projeto. Se você não tiver um projeto, crie um usando ferramentas de 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 back-end 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 back-end atual. Navegue um nível acima no rastro de navegação para ver uma lista de todos os ambientes de back-end criados na guia Ambientes de back-end.

    Uma captura de tela do console do Amplify mostrando todos os ambientes de back-end associados a um aplicativo do Amplify.

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

  7. Na tela de configurações de compilação, escolha um ambiente de back-end existente para configurar a implantação contínua com a ramificação principal. Escolha prod no menu suspenso 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.

    Uma captura de tela da página Definir configurações de compilação do console do Amplify, mostrando onde selecionar um ambiente de back-end para implantar com um ambiente de front-end.

  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 back-end test.

    Uma captura de tela da página Adicionar ramificação do repositório do console Amplify, mostrando onde selecionar um ambiente de back-end para implantar com uma ramificação.

  9. O Amplify agora está configurado. É possível começar a trabalhar em novos atributos em um atributo de atributo. Adicione a funcionalidade de back-end usando o ambiente de back-end 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. Nota: Se você tiver o AWS CLI instalado em seu sistema (não na CLI do Amplify), você pode conectar uma ramificação diretamente do 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 back-end e o front-end 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 back-end 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

GitFlow fluxo de trabalho

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 de desenvolvimento é usada como uma ramificação de integração para novos recursos. GitFlow simplifica o desenvolvimento paralelo ao isolar 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 abaixo 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.

Um diagrama que mostra uma configuração recomendada com GitFlow.

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 back-end. 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 back-end ou front-end para a produção a partir do computador local deles.

Um diagrama que mostra um fluxo de trabalho de sandbox por desenvolvedor.

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

    npm install -g @aws-amplify/cli

  2. Inicialize um ambiente de back-end mary para o seu projeto. Se você não tiver um projeto, crie um usando ferramentas de 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 back-end 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 back-end que é vinculado à ramificação.

  6. Conecte a ramificação de desenvolvimento no Amplify (suponha que a ramificação de desenvolvimento e a ramificação principal sejam iguais neste momento) e escolha Criar