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á.
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 aplicações com ambientes de backend provisionados usando a CLI do Amplify ou o Amplify Studio, cada solicitação pull (somente repositórios Git privados) cria um backend temporário que é excluído quando a PR é fechada.
Quando as pré-visualizações na Web são ativadas para sua aplicação, cada PR conta para a cota do Amplify de 50 ramificações por aplicação. Para evitar exceder essa cota, certifique-se de fechar suas PRs. Para obter mais informações sobre cotas, consulte Service quotas do Amplify Hosting.
nota
Atualmente, a variável de ambiente AWS_PULL_REQUEST_ID
não está disponível para o uso de AWS CodeCommit como seu provedor de repositório.
Ativar visualizações na web
Para aplicativos armazenados em um repositório do GitHub, as visualizações prévias usam o aplicativo Amplify GitHub para acessar o repositório. Se você estiver habilitando visualizações na web em um aplicativo Amplify existente que você implantou anteriormente a partir de um repositório do GitHub usando o 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 backends 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
-
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.
-
Somente para repositórios do GitHub, faça o seguinte para instalar e autorizar o aplicativo Amplify GitHub na sua conta:
-
Na janela Instalar aplicativo GitHub para habilitar visualizações, escolha Instalar aplicativo GitHub.
-
Selecione a conta do GitHub na qual você deseja configurar o aplicativo Amplify GitHub.
-
Uma página é aberta em GitHub.com para configurar as permissões do repositório para sua conta.
-
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.
-
-
Escolha Salvar
-
-
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 Pré-visualizações, selecione uma ramificação na lista e escolha Editar configurações.
-
Na página Gerenciar configurações de pré-visualização, ative Pré-visualizações de solicitações pull. Depois, selecione Confirm (Confirmar).
-
Para aplicativos full-stack, realize uma das seguintes ações:
-
Escolha Criar um novo ambiente de backend 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.
-
-
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 backend temporário vinculado à solicitação pull é excluído. Somente para repositórios do GitHub, é possível acessar uma prévia do seu URL diretamente da solicitação pull na sua conta do GitHub.
Acesso à pré-visualização na web com subdomínios
As pré-visualizações na Web para solicitações pull podem ser acessadas com subdomínios para uma aplicação do Amplify conectada 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 Configuração de subdomínios automáticos para um domínio personalizado do Amazon Route 53.