Trabalhe com os seus repositórios do GitHub no Cloud Manager

Última atualização em 2024-02-15
  • Criado para:
  • Admin

Ao configurar o Cloud Manager para trabalhar com os seus repositórios do GitHub, você pode validar o código diretamente no repositório do GitHub por meio do Cloud Manager, eliminando a necessidade de sincronizar consistentemente o código com o repositório da Adobe.

OBSERVAÇÃO

Este recurso só está disponível por meio do programa de adoção antecipada.

OBSERVAÇÃO

Esse recurso é exclusivo do GitHub público. A compatibilidade com o GitHub auto-hospedado não está disponível.

Configuração

A configuração consiste em duas etapas principais:

  1. Adicionar repositório
  2. Validação de propriedade de repositório privado

Adicionar repositório

  1. Na página Visão geral do programa do Cloud Manager, toque ou clique na guia Repositórios para alternar para a página Repositórios e clique em Adicionar repositório.

  2. Na caixa de diálogo Adicionar repositório, selecione Repositório privado como o tipo de repositório.

  3. Forneça os detalhes do repositório

    • Nome do repositório: um nome intuitivo
    • URL do repositório: o URL do repositório, que deve terminar em .git
    • Descrição (opcional): uma descrição mais longa do repositório, conforme necessário

    Adicionar repositório próprio

  4. Toque ou clique em Salvar.

DICA

Para obter detalhes sobre como gerenciar repositórios no Cloud Manager, consulte o documento Repositórios do Cloud Manager.

Validação de propriedade de repositório privado

O Cloud Manager agora reconhece seu repositório GitHub, mas ainda precisa de acesso. Para conceder acesso, é necessário instalar o aplicativo GitHub da Adobe e confirmar que você é proprietário(a) do repositório especificado.

  1. Após adicionar seu próprio repositório, a caixa de diálogo Validação de propriedade de repositório privado será aberta.

    Validação de propriedade de repositório privado

  2. O Cloud Manager usa um aplicativo GitHub para interagir de maneira segura com o repositório.

    • Um(a) proprietário(a) de sua organização do GitHub deve instalar o aplicativo localizado em https://github.com/apps/cloud-manager-for-aem e conceder acesso ao repositório.
    • Consulte a documentação do GitHub para obter detalhes sobre como fazer isso.
  3. Para melhorar a segurança, você deve criar um arquivo secreto na ramificação padrão do repositório. Toque ou clique em Gerar.

  4. Confirme a geração do arquivo secreto tocando ou clicando em Confirmar.

    Confirmar geração de segredo

  5. De volta à janela Validação de propriedade de repositório privado, o Cloud Manager terá gerado o conteúdo do arquivo privado no campo Conteúdo do arquivo secreto. Copie o conteúdo desse campo.

    • O conteúdo do arquivo secreto será mostrado apenas uma vez. Se você não copiar o conteúdo antes de fechar esta janela, precisará gerar o segredo novamente.

    Copiar conteúdo do arquivo secreto

  6. Crie um novo arquivo na ramificação padrão do repositório GitHub chamado .well-known/adobe/cloud-manager-challenge, cole o conteúdo do arquivo secreto nesse arquivo e salve.

  7. Após a instalação do aplicativo e a adição do arquivo secreto no repositório, toque ou clique em Validar na caixa de diálogo Validação de propriedade de repositório privado.

A instalação do aplicativo e criação do arquivo secreto podem ser realizadas em qualquer ordem. No entanto, ambas as etapas devem ser concluídas para que você possa validar.

Até a validação, o repositório será listado com um ícone vermelho, indicando que ainda não foi validado e não pode ser usado.

Repositório não validado

Observe que a coluna Tipo identifica facilmente os repositórios fornecidos pela Adobe (Adobe) e os seus repositórios do GitHub (GitHub).

Se precisar retornar ao repositório em uma data posterior para concluir a validação, na página Repositórios, toque ou clique no botão de reticências na linha que representa o repositório GitHub recém-adicionado e selecione Validação de propriedade no menu suspenso.

Use seus repositórios do GitHub com o Cloud Manager

Após a validação do repositório do GitHub no Cloud Manager, a integração é concluída e é possível usar o repositório com o Cloud Manager.

  1. Ao criar uma solicitação de “pull”, uma verificação do GitHub será iniciada automaticamente.

    Verificações do GitHub

  2. Para cada solicitação de “pull”, um pipeline de qualidade de código de pilha completa será criado automaticamente. Esse pipeline é iniciado a cada atualização de solicitação de “pull”.

  3. A verificação do GitHub permanece em estado de execução até que as verificações de qualidade do código sejam concluídas. Os resultados de qualidade do código serão propagados para a verificação do GitHub.

    Verificações de qualidade do código do GitHub

Quando a solicitação de “pull” é fechada ou mesclada, o pipeline de qualidade de código de pilha completa criado é excluído automaticamente.

Limitações

Lembre-se das seguintes limitações ao usar os seus repositórios do GitHub com o Cloud Manager.

  • Não é possível usar os repositórios do GitHub como a fonte de repositório direta dos pipelines que você gerencia.
    • Essa funcionalidade está planejada.
  • Não é possível pausar a validação da solicitação de “pull” usando a verificação do GitHub no Cloud Manager.
    • Se o repositório do GitHub for validado no Cloud Manager, o Cloud Manager sempre tentará validar as solicitações de “pull” criadas para esse repositório.
      Se o aplicativo GitHub da Adobe for removido de sua organização do GitHub, o recurso de validação de solicitações de “pull” será removido de todos os repositórios.

Nesta página