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á.
# Configurando o acesso do Amplify aos repositórios GitHub
O Amplify agora usa o recurso GitHub Apps para autorizar o acesso somente de leitura do Amplify aos repositórios. GitHub Com o GitHub aplicativo Amplify, 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 GitHub aplicativos, consulte [Sobre GitHub aplicativos](https://docs.github.com/en/developers/apps/getting-started-with-apps/about-apps#about-github-apps) no GitHub site.
Quando você conecta um novo aplicativo armazenado em um GitHub repositório, por padrão, o Amplify usa GitHub o aplicativo para acessar o repositório. No entanto, os aplicativos existentes do Amplify que você conectou anteriormente a partir de GitHub repositórios usam para OAuth acesso. CI/CD continuarão funcionando para esses aplicativos, mas é altamente recomendável que você os migre para usar o novo aplicativo GitHub Amplify.
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 GitHub Amplify. 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}}`, {{REGION}} substituindo-o pela região em que você implantará seu aplicativo Amplify. Por exemplo, para instalar o GitHub aplicativo Amplify na região Oeste dos EUA (Oregon), navegue até -2. https://github.com/apps/ aws-amplify-us-west
**Topics**
+ [Instalando e autorizando o aplicativo GitHub Amplify para uma nova implantação](#setting-up-github-app)
+ [Migração de um OAuth aplicativo existente para o aplicativo Amplify GitHub](#migrating-to-github-app-auth)
+ [Configurando o GitHub aplicativo Amplify para implantações de CloudFormation CLI e SDK](#setting-up-github-app-cloudformation)
+ [Configurando visualizações na web com o aplicativo Amplify GitHub](#setting-up-github-app-pr-previews)
## Instalando e autorizando o aplicativo GitHub Amplify para uma nova implantação
Ao implantar um novo aplicativo no Amplify a partir do código existente em um GitHub repositório, 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 Console de gerenciamento da AWS e abra o console do [Amplify](https://console.aws.amazon.com/amplify/).
1. Na página **Todos os aplicativos**, escolha **Novo aplicativo** e, em seguida, **Hospedar aplicativo web**.
1. **Na página **Começar com o Amplify Hosting**, escolha e, em seguida **GitHub**, escolha Continuar.**
1. Se for a primeira vez que você conecta um GitHub repositório, uma nova página é aberta em seu navegador GitHub em.com, solicitando permissão para autorizar AWS Amplify em sua conta. GitHub Escolha **Authorize**.
1. Em seguida, você deve instalar o GitHub aplicativo Amplify em sua GitHub conta. Uma página é aberta no GitHub.com solicitando permissão para instalar e autorizar AWS Amplify na sua conta. GitHub
1. Selecione a GitHub conta na qual você deseja instalar o aplicativo Amplify GitHub .
1. 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 que você está migrando nos repositórios selecionados.
1. Escolha **Instalar e autorizar**.
1. Você é redirecionado para a página **Adicionar ramificação do repositório** do seu aplicativo no console do Amplify.
1. Na lista **Repositórios atualizados recentemente**, selecione o nome do repositório a ser conectado.
1. Na lista **Ramificação**, selecione o nome da ramificação do repositório a ser conectada.
1. Escolha **Próximo**.
1. Na página **Definir configurações de segurança**, escolha **Próximo**.
1. Na página **Revisar**, escolha **Salvar e implantar**.
## Migração de um OAuth aplicativo existente para o aplicativo Amplify GitHub
Os aplicativos existentes do Amplify que você conectou anteriormente a partir de GitHub repositórios usam OAuth para acesso ao repositório. É altamente recomendável que você migre esses aplicativos para usar o aplicativo GitHub Amplify.
Use as instruções a seguir para migrar um aplicativo e excluir o OAuth webhook correspondente em sua GitHub conta. Observe que o procedimento de migração varia dependendo se o aplicativo GitHub Amplify já está instalado. Depois de migrar seu primeiro aplicativo, instalar e autorizar o GitHub aplicativo, você só precisa atualizar as permissões do repositório para migrações subsequentes do aplicativo.
**Para migrar um aplicativo OAuth para o GitHub aplicativo**
1. Faça login no Console de gerenciamento da AWS e abra o console do [Amplify](https://console.aws.amazon.com/amplify/).
1. Escolha o aplicativo que você deseja migrar.
1. Na página de informações do aplicativo, localize a mensagem azul **Migrar para nosso GitHub aplicativo** e escolha **Iniciar migração**.
1. Na página **Instalar e autorizar GitHub aplicativo**, escolha **Configurar GitHub aplicativo**.
1. Uma nova página é aberta em seu navegador GitHub em.com, solicitando permissão para autorizar AWS Amplify em sua GitHub conta. Escolha **Authorize**.
1. Selecione a GitHub conta na qual você deseja instalar o aplicativo Amplify GitHub .
1. 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 que você está migrando nos repositórios selecionados.
1. Escolha **Instalar e autorizar**.
1. Você é redirecionado para a página **Instalar e autorizar o GitHub aplicativo** para seu aplicativo no console do Amplify. Se a GitHub autorização for bem-sucedida, você verá uma mensagem de sucesso. Escolha **Próximo**.
1. Na página **Instalação completa**, escolha **Instalação completa**. Essa etapa exclui seu webhook existente, cria um novo e conclui a migração.
## Configurando o GitHub aplicativo Amplify para implantações de CloudFormation CLI e SDK
Os aplicativos existentes do Amplify que você conectou anteriormente a partir de GitHub repositórios usam OAuth para acesso ao repositório. Isso pode incluir aplicativos que você implantou usando a Interface de Linha de Comando (CLI) CloudFormation do Amplify ou o. SDKs É altamente recomendável que você migre esses aplicativos para usar o novo aplicativo GitHub Amplify. A migração deve ser realizada no console do Amplify no Console de gerenciamento da AWS. Para instruções, consulte [Migração de um OAuth aplicativo existente para o aplicativo Amplify GitHub](#migrating-to-github-app-auth).
Você pode usar CloudFormation a CLI do Amplify e a para SDKs implantar um novo aplicativo Amplify que usa o aplicativo para acesso ao repositório. GitHub Esse processo requer que você primeiro instale o GitHub aplicativo Amplify em sua GitHub conta. Em seguida, você precisará gerar um token de acesso pessoal em sua GitHub conta. Por fim, implante o aplicativo e especifique o token de acesso pessoal.
**Instale o GitHub aplicativo Amplify em sua conta**
1. Abra um navegador da web e navegue até o local de instalação do GitHub aplicativo Amplify na AWS região em que você implantará seu aplicativo.
Use o formato`https://github.com/apps/aws-amplify-{{REGION}}/installations/new`, {{REGION}} substituindo-o por sua própria entrada. Por exemplo, se você estiver instalando seu aplicativo na região Oeste dos EUA (Oregon), especifique`https://github.com/apps/aws-amplify-us-west-2/installations/new`.
1. Selecione a GitHub conta na qual você deseja instalar o aplicativo Amplify GitHub .
1. 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 que você está migrando nos repositórios selecionados.
1. Escolha **Instalar**.
**Gere um token de acesso pessoal em sua GitHub conta**
1. Faça login na sua GitHub conta.
1. No canto superior direito, localize sua foto do perfil e escolha **Configurações** no menu.
1. No menu de navegação à esquerda, escolha **Configurações do desenvolvedor**.
1. Na página **GitHub Aplicativos**, no menu de navegação à esquerda, escolha **Tokens de acesso pessoal**.
1. Na página **Tokens de acesso pessoal**, escolha **Gerar novo token**.
1. Na página **Novo token de acesso pessoal**, em **Nota**, insira um nome descritivo para o token.
1. Na seção **Selecionar escopos**, selecione **admin:repo\_hook**.
1. Escolha **Gerar token**.
1. Copie e salve o token de acesso pessoal. Você precisará fornecê-lo ao implantar um aplicativo Amplify com a CLI ou o. CloudFormation SDKs
Depois que o GitHub aplicativo Amplify for instalado em sua GitHub conta e você tiver gerado um token de acesso pessoal, você poderá implantar um novo aplicativo com a CLI do Amplify ou a. CloudFormation SDKs Use o campo `accessToken` para especificar o token de acesso pessoal criado no procedimento anterior. Para obter mais informações, consulte [CreateApp](https://docs.aws.amazon.com/amplify/latest/APIReference/API_CreateApp.html#API_CreateApp_RequestSyntax)a *referência da API Amplify* e [AWS::Amplify::App](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-app.html)o Guia do *AWS CloudFormation usuário*.
O comando CLI a seguir implanta um novo aplicativo Amplify que usa o aplicativo para acesso ao GitHub 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}}
```
## Configurando visualizações na web com o aplicativo Amplify GitHub
Uma visualização prévia na web implanta cada pull request (PR) feita em seu GitHub repositório em uma URL de visualização exclusiva. As visualizações prévias agora usam o aplicativo GitHub Amplify para GitHub acessar seu repositório. Para obter instruções sobre como instalar e autorizar o GitHub aplicativo para visualizações na web, consulte. [Habilitação de pré-visualizações na Web para solicitações de pull](pr-previews.md#enable-web-previews)