DocumentaçãoCommerceFerramentas

Configurar a integração do GitHub para Patching Automation

Última atualização: 27 de agosto de 2026

Criado para:

  • Experienced
  • Admin
  • Developer

Se o projeto da Adobe Commerce Cloud estiver conectado a um repositório GitHub, instale o Aplicativo GitHub Patching Automation antes de usar o serviço para aplicar ou reverter patches. O aplicativo concede ao serviço o acesso necessário para fazer alterações no repositório em seu nome.

Pré-requisitos

  • Uma assinatura ativa da Adobe Commerce Cloud
  • Uma integração com o GitHub já foi configurada para o seu projeto da Adobe Commerce Cloud, com a opção fetch-branches habilitada. O Patching Automation cria e envia ramificações temporárias de ambiente de integração, portanto, as operações de patch não criam o ambiente quando esta opção é desabilitada.
  • Um repositório hospedado em github.com. Não há suporte para integrações GitHub configuradas com um domínio personalizado.
  • Acesso de proprietário ou administrador à organização ou ao repositório do GitHub

Instalar o aplicativo GitHub Patching Automation

Você pode iniciar a instalação a partir de Patching Automation clicando em Install GitHub App na interface do usuário, que o redireciona para a página de instalação, ou navegando diretamente para a página de instalação.

  1. Abra a página de instalação do Aplicativo GitHub de Automação de Patches.
  2. Clique em Install.
  3. Selecione a organização do GitHub que é proprietária do repositório do Adobe Commerce.
  4. Em Repository access, selecione Only select repositories e escolha o repositório para seu projeto do Adobe Commerce.
  5. Clique em Install para confirmar.

Depois de instalado, o serviço detecta automaticamente a conexão GitHub e usa o aplicativo para todas as operações de patch. Nenhuma configuração adicional é necessária.

Verificar e gerenciar o status da conexão

A interface do usuário do Patching Automation mostra o status atual da sua conexão GitHub, com ações disponíveis que dependem desse status:

  • Refresh / Refresh status - Verifica novamente o status da conexão sem fazer alterações.
  • Reinstall - Mostrado se a instalação não é mais válida (por exemplo, se foi suspensa ou se o repositório conectado ao projeto na nuvem foi alterado). Inicia o mesmo fluxo de instalação descrito acima.
  • Unlink GitHub App - Remove a conexão salva de Patching Automation ao Aplicativo GitHub. Isso faz não desinstalar o aplicativo do seu repositório GitHub — para remover totalmente o acesso, consulte a seção Desinstalar abaixo.

Desinstalar o aplicativo GitHub Patching Automation

Se você não quiser mais que o serviço acesse seu repositório:

  1. No GitHub, abra as configurações da conta que é proprietária da instalação:

    • Para um repositório de propriedade da organização: Organization settings > Third-party Access > GitHub Apps.
    • Para um repositório pessoal: Settings > Applications > Installed GitHub Apps.

  2. Localize adobe-commerce-patching-automation e clique em Configure.

  3. Clique em Uninstall e confirme.

WARNING
Se alguma operação de aplicação ou reversão ainda estiver em andamento quando o aplicativo GitHub for desinstalado, essas operações poderão falhar. Após desinstalar o aplicativo, os usuários também não podem iniciar novas operações porque os botões de ação ficam inativos.

Tópicos relacionados

recommendation-more-help
commerce-operations-help-tools