View a markdown version of this page

Atualizar uma ação de origem GitHub (via aplicativo OAuth) para uma ação de origem GitHub (via GitHub aplicativo) - AWS CodePipeline
Etapa 1: substituir sua ação (via aplicativo OAuth) GitHubEtapa 2: criar uma conexão com GitHubEtapa 3: Salve sua ação GitHub de origem

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

Atualizar uma ação de origem GitHub (via aplicativo OAuth) para uma ação de origem GitHub (via GitHub aplicativo)

Em AWS CodePipeline, há duas versões compatíveis da ação de GitHub origem:

nota

As conexões não estão disponíveis nas regiões Ásia-Pacífico (Hong Kong), Ásia-Pacífico (Hyderabad), Ásia-Pacífico (Jacarta), Ásia-Pacífico (Melbourne), Ásia-Pacífico (Osaka), África (Cidade do Cabo), Oriente Médio (Bahrein), Oriente Médio (Emirados Árabes Unidos), Europa (Espanha), Europa (Zurique), Israel (Tel Aviv) ou (). AWS GovCloud US-West Para fazer referência a outras ações disponíveis, consulte Integrações de produtos e serviços com CodePipeline. Para considerações sobre essa ação na região Europa (Milão), consulte a nota em CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server e ações GitLab autogerenciadas GitLab.com.

Há algumas vantagens importantes em usar a ação GitHub (via GitHub aplicativo) em vez da ação GitHub (via aplicativo OAuth):

  • Com conexões, CodePipeline não são mais necessários aplicativos OAuth ou tokens de acesso pessoal para acessar seu repositório. Ao criar uma conexão, você instala um GitHub aplicativo que gerencia a autenticação no seu GitHub repositório e permite permissões no nível da organização. É necessário autorizar tokens do OAuth como usuário para acessar o repositório. Para obter mais informações sobre OAuth-based GitHub acesso em contraste com App-based GitHub acesso, consultehttps://docs.github.com/en/developers/apps/differences-between-github-apps-and-oauth-apps.

  • Quando você gerencia GitHub (via GitHub aplicativo) ações na CLI ou CloudFormation, não precisa mais armazenar seu token de acesso pessoal como um segredo no Secrets Manager. Você não precisa mais referenciar dinamicamente o segredo armazenado em sua configuração de CodePipeline ação. Em vez disso, você adiciona o ARN da conexão à configuração de ação. Para obter um exemplo de configuração de ação, consulte CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server e ações GitLab autogerenciadas GitLab.com.

  • Ao criar um recurso de conexão para usar com sua ação GitHub (via GitHub aplicativo) CodePipeline, você pode usar o mesmo recurso de conexão para associar outros serviços compatíveis, como o CodeGuru Reviewer, ao seu repositório.

  • No Github (via GitHub aplicativo), você pode clonar repositórios para acessar os metadados do git em CodeBuild ações subsequentes, enquanto no Github (via aplicativo OAuth) você só pode baixar a fonte.

  • Um administrador instala a aplicação nos repositórios da organização. Não é mais necessário rastrear tokens do OAuth que dependam da pessoa que criou o token.

Todas as aplicações instaladas em uma organização têm acesso ao mesmo conjunto de repositórios. Para alterar quem pode acessar cada repositório, modifique a política do IAM para cada conexão. Para ver um exemplo, consulte Exemplo: uma política de restrição de acesso para usar conexões com um repositório especificado.

Você pode usar as etapas deste tópico para excluir sua ação de origem GitHub (via aplicativo OAuth) e adicionar uma ação de origem GitHub (via GitHub aplicativo) do CodePipeline console.

Etapa 1: substituir sua ação (via aplicativo OAuth) GitHub

Use a página de edição do pipeline para substituir sua ação (via aplicativo OAuth) por uma GitHub ação GitHub (via GitHub aplicativo).

Para substituir sua ação (via aplicativo OAuth) GitHub

  1. Faça login no CodePipeline console.

  2. Selecione o pipeline e escolha Editar. Selecione Editar estágio no estágio de origem. É exibida uma mensagem recomendando que você atualize a ação.

  3. Em Provedor de ações, escolha GitHub (via GitHub aplicativo).

  4. Execute um destes procedimentos:

    • Em Conexão, se você ainda não tiver criado uma conexão com seu provedor, escolha Conectar GitHub a. Prossiga para a Etapa 2: Crie uma conexão com GitHub.

    • Em Conexão, se você já tiver criado uma conexão com seu provedor, escolha a conexão. Vá para a Etapa 3: Salvar a ação de origem para sua conexão.

Etapa 2: criar uma conexão com GitHub

Depois de escolher criar a conexão, a GitHub página Connect to é exibida.

Para criar uma conexão com GitHub

  1. Nas configurações de GitHub conexão, o nome da conexão é mostrado em Nome da conexão.

    Em GitHub Aplicativos, escolha uma instalação de aplicativo ou escolha Instalar um novo aplicativo para criar um.

    nota

    Você instala uma aplicação para todas as suas conexões com um provedor específico. Se você já instalou o GitHub aplicativo, escolha-o e pule esta etapa.

  2. Se a página de autorização for GitHub exibida, faça login com suas credenciais e escolha continuar.

  3. Na página de instalação do aplicativo, uma mensagem mostra que o AWS CodeStar aplicativo está tentando se conectar à sua GitHub conta.

    nota

    Você só instala o aplicativo uma vez para cada GitHub conta. Se você instalou a aplicação anteriormente, poderá escolher Configure (Configurar) para prosseguir para uma página de modificação para a instalação da aplicação ou usar o botão Back (Voltar) para retornar ao console.

  4. Na página Instalar AWS CodeStar, escolha Instalar.

  5. Na GitHub página Connect to, a ID de conexão da sua nova instalação é exibida. Selecione Conectar.

Etapa 3: Salve sua ação GitHub de origem

Conclua as atualizações na página Editar ação para salvar a nova ação de origem.

Para salvar sua ação GitHub de origem

  1. Em Nome do repositório, escolha o nome do repositório de terceiros. Em Ramificação, insira a ramificação onde deseja que o pipeline detecte alterações de origem.

    nota

    No Repositório, digite owner-name/repository-name conforme mostrado neste exemplo: 

    my-account/my-repository

  2. Em Formato de artefato de saída, escolha o formato dos seus artefatos.

    • Para armazenar artefatos de saída da GitHub ação usando o método padrão, escolha CodePipeline default. A ação acessa os arquivos do GitHub repositório e armazena os artefatos em um arquivo ZIP no repositório de artefatos do pipeline.

    • Para armazenar um arquivo JSON que contém uma referência de URL ao repositório para que as ações downstream possam executar comandos Git diretamente, escolha Full clone (Clone completo). Esta opção só pode ser usada por ações downstream do CodeBuild .

      Se você escolher essa opção, precisará atualizar as permissões para sua função de serviço CodeBuild do projeto, conforme mostrado emAdicione CodeBuild GitClone permissões para conexões com Bitbucket GitHub, GitHub Enterprise Server ou .com GitLab. Para um tutorial que mostra como usar a opção Clone completo, consulte Tutorial: use o clone completo com uma fonte de GitHub pipeline.

  3. Em Artefatos de saída, é necessário manter o nome do artefato de saída para essa ação, como SourceArtifact. Escolha Concluído para fechar a página Editar ação.

  4. Escolha Concluído para fechar a página de edição do estágio. Escolha Salvar para fechar a página de edição do pipeline.