Pré-visualizações na web para solicitações pull - AWS Amplify Hospedagem
Ativar visualizações na webAcesso à pré-visualização na web com subdomínios

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

Pré-visualizações na web para solicitações pull

As visualizações na Web oferecem às equipes de desenvolvimento e garantia de qualidade (QA) uma maneira de visualizar as alterações das solicitações pull (PRs) antes de mesclar o código a uma ramificação de produção ou integração. As solicitações pull permitem que você informe outras pessoas sobre as alterações que você enviou para uma ramificação em um repositório. Depois que uma solicitação pull é aberta, é possível discutir e revisar as possíveis alterações com os colaboradores e adicionar confirmações de acompanhamento antes que suas alterações sejam mescladas na ramificação base.

Uma visualização prévia da web implanta cada solicitação pull feita em seu repositório em um URL de visualização exclusiva que é completamente diferente do URL que seu site principal usa. Para aplicativos com ambientes de back-end provisionados usando a CLI do Amplify ou o Amplify Studio, cada pull request (somente repositórios Git privados) cria um back-end temporário que é excluído quando o PR é fechado.

Quando as visualizações na web são ativadas para seu aplicativo, cada PR conta para a cota do Amplify de 50 filiais por aplicativo. Para evitar exceder essa cota, certifique-se de fechar seus PRs. Para obter mais informações sobre cotas, consulte Service quotas do Amplify Hosting.

nota

Atualmente, a variável de AWS_PULL_REQUEST_ID ambiente não está disponível quando usada AWS CodeCommit como seu provedor de repositório.

Ativar visualizações na web

Para aplicativos armazenados em um GitHub repositório, as visualizações usam o GitHub aplicativo Amplify para acesso ao repositório. Se você estiver habilitando visualizações na web em um aplicativo Amplify existente que você implantou anteriormente a partir de GitHub um repositório usando OAuth para acesso, primeiro você deve migrar o aplicativo para usar o aplicativo Amplify. GitHub Para obter instruções de migração, consulte Migrar um aplicativo OAuth existente para o aplicativo Amplify GitHub.

Importante

Para fins de segurança, é possível ativar as visualizações da web em todos os aplicativos com repositórios privados, mas não em todos os aplicativos com repositórios públicos. Se seu repositório Git for público, é possível configurar visualizações somente para aplicativos que não exigem um perfil de serviço do IAM.

Por exemplo, aplicativos com back-ends e aplicativos implantados na plataforma de WEB_COMPUTE hospedagem exigem um perfil de serviço do IAM. Portanto, não é possível habilitar visualizações na web para esses tipos de aplicativos se o repositório deles for público.

O Amplify aplica essa restrição para impedir que terceiros enviem código arbitrário que seria executado usando as permissões de perfil do IAM do seu aplicativo.

Para habilitar visualizações na web para solicitações pull

  1. Escolha Hospedagem e, em seguida, Pré-visualizações.

    nota

    As visualizações são visíveis no menu Configurações do aplicativo somente quando um aplicativo é configurado para implantação contínua e conectado a um repositório git. Para obter instruções sobre esse tipo de implantação, consulte Introdução ao código existente.

  2. Somente para GitHub repositórios, faça o seguinte para instalar e autorizar o GitHub aplicativo Amplify em sua conta:

    1. Na janela Instalar GitHub aplicativo para ativar visualizações, escolha Instalar GitHub aplicativo.

    2. Selecione a GitHub conta na qual você deseja configurar o aplicativo Amplify GitHub.

    3. Uma página é aberta em GitHub.com para configurar as permissões do repositório para sua conta.

    4. Execute um destes procedimentos:

      • Para aplicar a instalação a todos os repositórios, escolha Todos os repositórios.

      • Para limitar a instalação aos repositórios específicos que você selecionar, escolha Somente selecionar repositórios. Certifique-se de incluir o repositório do aplicativo para o qual você está habilitando as visualizações da web nos repositórios que você selecionar.

    5. Escolha Salvar

  3. Depois de ativar as visualizações para seu repositório, retorne ao console do Amplify para ativar as visualizações de ramificações específicas. Na página Visualizações prévias, selecione uma ramificação na lista e escolha Editar configurações.

  4. Na página Gerenciar configurações de visualização, ative as visualizações de pull request. Depois, selecione Confirm (Confirmar).

  5. Para aplicativos de pilha completa, realize uma das seguintes ações:

    • Escolha Criar um novo ambiente de back-end para cada solicitação pull. Essa opção permite testar as alterações sem afetar a produção.

    • Escolha Apontar todas as solicitações pull dessa ramificação para um ambiente existente.

  6. Escolha Confirmar.

Na próxima vez que você enviar uma solicitação pull para a filial, o Amplify cria e implanta seu PR em um URL de pré-visualização. Depois que a solicitação pull é fechada, o URL de visualização é excluído e qualquer ambiente de back-end temporário vinculado à solicitação pull é excluído. Somente para GitHub repositórios, você pode acessar uma prévia do seu URL diretamente da pull request em sua GitHub conta.

Acesso à pré-visualização na web com subdomínios

As visualizações na web para pull requests podem ser acessadas com subdomínios para um aplicativo Amplify conectado a um domínio personalizado gerenciado pelo Amazon Route 53. Quando a solicitação pull é fechada, as ramificações e subdomínios associados à solicitação pull são excluídos automaticamente. Esse é o comportamento padrão para visualizações na web depois de configurar implantações de ramificações de atributos baseadas em padrões para seu aplicativo. Para obter instruções de configuração de subdomínios automáticos, consulte Configure subdomínios automáticos para um domínio personalizado do Amazon Route 53.