Configurar o acesso do Amplify aos repositórios do GitHub - AWS Amplify Hospedagem
Instalando e autorizando o aplicativo Amplify GitHub para uma nova implantaçãoMigrar um aplicativo OAuth existente para o aplicativo Amplify GitHubConfigurar o aplicativo Amplify GitHub para implantações de AWS CloudFormation, CLI e SDKConfigurar visualizações na web com o aplicativo Amplify GitHub

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

Configurar o acesso do Amplify aos repositórios do GitHub

O Amplify agora usa o atributo Aplicativos GitHub para autorizar o acesso somente de leitura do Amplify aos repositórios do GitHub. Com o aplicativo Amplify GitHub, as permissões são mais refinadas, permitindo que você conceda ao Amplify acesso somente aos repositórios que você especificar. Para saber mais sobre os aplicativos do GitHub, consulte Sobre os aplicativos do GitHub no site do GitHub.

Quando você conecta um novo aplicativo armazenado em um repositório do GitHub, por padrão, o Amplify usa o aplicativo GitHub para acessar o repositório. No entanto, os aplicativos existentes do Amplify que você conectou anteriormente a partir dos repositórios do GitHub usam o OAuth para acesso. O CI/CD continuará funcionando para esses aplicativos, mas é altamente recomendável que você os migre para usar o novo aplicativo Amplify GitHub.

Ao implantar um novo aplicativo ou migrar um aplicativo existente usando o console do Amplify, você é automaticamente direcionado para o local de instalação do aplicativo Amplify GitHub. Para acessar manualmente a página inicial de instalação do aplicativo, abra um navegador da Web e navegue até o aplicativo por região. Use o formato https://github.com/apps/aws-amplify-REGION, substituindo REGION pela região em que você implantará seu aplicativo Amplify. Por exemplo, para instalar o aplicativo Amplify GitHub na região Oeste dos EUA (Oregon), acesse https://github.com/apps/aws-amplify-us-west-2.

Instalando e autorizando o aplicativo Amplify GitHub para uma nova implantação

Ao implantar um novo aplicativo no Amplify a partir do código existente em um repositório do GitHub, use as instruções a seguir para instalar e autorizar o aplicativo GitHub.

Para instalar e autorizar o aplicativo Amplify GitHub

  1. Faça login no AWS Management Console e abra o console do Amplify.

  2. Na página Todos os aplicativos, escolha Novo aplicativo e, em seguida, Hospedar aplicativo web.

  3. Na página Conceitos básicos do Amplify Hosting, escolha GitHub e, em seguida, escolha Continuar.

  4. Se for a primeira vez que você conecta um repositório do GitHub, uma nova página é aberta no seu navegador em GitHub.com, solicitando permissão para autorizar na sua conta do GitHub AWS Amplify. Escolha Authorize.

  5. Em seguida, você deve instalar o aplicativo Amplify GitHub na sua conta do GitHub. Uma página é aberta no GitHub.com solicitando permissão para instalar e autorizar na AWS Amplify sua conta do GitHub.

  6. Selecione a conta do GitHub em que deseja instalar o aplicativo Amplify GitHub.

  7. Faça um dos seguintes 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 que você está migrando nos repositórios selecionados.

  8. Escolha Instalar e autorizar.

  9. Você é redirecionado para a página Adicionar ramificação do repositório do seu aplicativo no console do Amplify.

  10. Na lista Repositórios atualizados recentemente, selecione o nome do repositório a ser conectado.

  11. Na lista Ramificação, selecione o nome da ramificação do repositório a ser conectada.

  12. Escolha Próximo.

  13. Na página Definir configurações de segurança, selecione Próximo.

  14. Na página Revisar, escolha Salvar e implantar.

Migrar um aplicativo OAuth existente para o aplicativo Amplify GitHub

Os aplicativos existentes do Amplify que você conectou anteriormente dos repositórios do GitHub usam o OAuth para acesso ao repositório. É altamente recomendável a migração desses aplicativos para usar o Amplify GitHub App.

Use as instruções a seguir para migrar um aplicativo e excluir o webhook OAuth correspondente na sua conta do GitHub. Observe que o procedimento de migração varia dependendo se o aplicativo Amplify GitHub já está instalado. Depois de migrar seu primeiro aplicativo e instalar e autorizar o aplicativo GitHub, você só precisa atualizar as permissões do repositório para migrações de aplicativos subsequentes.

Para migrar um aplicativo do OAuth para o aplicativo GitHub

  1. Faça login no AWS Management Console e abra o console do Amplify.

  2. Escolha o aplicativo que você deseja migrar.

  3. Na página de informações do aplicativo, localize a mensagem azul Migrar para nosso aplicativo GitHub e escolha Iniciar migração.

  4. Na página Instalar e autorizar o aplicativo GitHub, escolha Configurar aplicativo GitHub.

  5. Uma nova página é aberta no seu navegador em GitHub.com, solicitando permissão para autorizar AWS Amplify na sua conta do GitHub. Escolha Authorize.

  6. Selecione a conta do GitHub em que deseja instalar o aplicativo Amplify GitHub.

  7. Faça um dos seguintes 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 que você está migrando nos repositórios selecionados.

  8. Escolha Instalar e autorizar.

  9. Você será redirecionado para a página Instalar e autorizar o aplicativo GitHub do seu aplicativo no console do Amplify. Se a autorização do GitHub for bem-sucedida, você verá uma mensagem de sucesso. Escolha Próximo.

  10. Na página Instalação completa, escolha Instalação completa. Essa etapa exclui seu webhook existente, cria um novo e conclui a migração.

Configurar o aplicativo Amplify GitHub para implantações de AWS CloudFormation, CLI e SDK

Os aplicativos existentes do Amplify que você conectou anteriormente dos repositórios do GitHub usam o OAuth para acesso ao repositório. Isso pode incluir aplicativos que você implantou usando a Command Line Interface (CLI) do Amplify, AWS CloudFormation ou os SDKs. É altamente recomendável a migração desses aplicativos para usar o novo Amplify GitHub App. A migração deve ser realizada no console do Amplify no AWS Management Console. Para obter instruções, consulte Migrar um aplicativo OAuth existente para o aplicativo Amplify GitHub.

É possível usar AWS CloudFormation, Amplify CLI e os SDKs para implantar um novo aplicativo Amplify que usa o aplicativo GitHub para acesso ao repositório. Esse processo exige que você primeiro instale o aplicativo Amplify GitHub na sua conta do GitHub. Em seguida, você precisará gerar um token de acesso pessoal na sua conta do GitHub. Por fim, implante o aplicativo e especifique o token de acesso pessoal.

Instale o aplicativo Amplify GitHub na sua conta

  1. Abra um navegador da web e navegue até o local de instalação do aplicativo Amplify GitHub na região AWS em que você implantará seu aplicativo.

    Use o formato https://github.com/apps/aws-amplify-REGION/installations/new, substituindo REGION por sua própria entrada. Por exemplo, se você estiver instalando seu aplicativo na região Oeste dos EUA (Oregon), especifiquehttps://github.com/apps/aws-amplify-us-west-2/installations/new.

  2. Selecione a conta do GitHub em que deseja instalar o aplicativo Amplify GitHub.

  3. Faça um dos seguintes 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 que você está migrando nos repositórios selecionados.

  4. Escolha Install.

Gere um token de acesso pessoal na sua conta do GitHub

  1. Faça login em sua conta do GitHub.

  2. No canto superior direito, localize sua foto do perfil e escolha Configurações no menu.

  3. No menu de navegação à esquerda, escolha Configurações do desenvolvedor.

  4. Na página do GitHub Apps, no menu de navegação à esquerda, escolha Tokens de acesso pessoal.

  5. Na página Tokens de acesso pessoal, escolha Gerar novo token.

  6. Na página Novo token de acesso pessoal, em Nota, insira um nome descritivo para o token.

  7. Na seção Selecionar escopos, selecione admin:repo_hook.

  8. Escolha Gerar token.

  9. Copie e salve o token de acesso pessoal. Você precisará fornecê-lo ao implantar um aplicativo Amplify com a CLI, AWS CloudFormation ou os SDKs.

Depois que o aplicativo Amplify GitHub for instalado na sua conta do GitHub e você tiver gerado um token de acesso pessoal, você poderá implantar um novo aplicativo com a Amplify CLI ou os SDKs AWS CloudFormation. Use o campo accessToken para especificar o token de acesso pessoal criado no procedimento anterior. Para obter mais informações, consulte CreateApp na referência da API do Amplify e AWS::Amplify::App no ​Guia do usuário do AWS CloudFormation.

O comando CLI a seguir implanta um novo aplicativo Amplify que usa o aplicativo GitHub para acesso ao repositório. Substitua myapp-using-githubapp, https://github.com/Myaccount/react-app e MY_TOKEN por suas próprias informações.

aws amplify create-app --name myapp-using-githubapp --repository https://github.com/Myaccount/react-app --access-token MY_TOKEN

Configurar visualizações na web com o aplicativo Amplify GitHub

Uma prévia na web implanta cada pull request (PR) feita no seu repositório do GitHub em uma URL de visualização exclusiva. As visualizações prévias agora usam o aplicativo Amplify GitHub para acessar seu repositório do GitHub. Para obter instruções sobre como instalar e autorizar o aplicativo GitHub para visualizações na web, consulte Ativar visualizações na web.