Adição de repositórios privados no Cloud Manager private-repositories

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

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

Configuração configuration

A configuração consiste em duas etapas principais:

Adicionar repositório add-repo

  1. Na Cloud Manager, na página Visão geral do programa, selecione a 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. Selecione Salvar.

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

Validação de propriedade de repositório privado validate-ownership

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. Depois de adicionar seu próprio repositório, a caixa de diálogo Validação da Propriedade do 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 isso é feito.
  3. Para melhorar a segurança, você deve criar um arquivo secreto na ramificação padrão do repositório. Selecione 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, gere novamente o segredo.

    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. Depois que o aplicativo estiver instalado e o arquivo secreto existir no repositório, você poderá selecionar Validar na caixa de diálogo Validação da Propriedade do 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

A coluna Tipo identifica facilmente repositórios fornecidos por Adobe (Adobe) e seus próprios repositórios GitHub (GitHub).

Se precisar retornar ao repositório posteriormente para concluir a validação, na página Repositórios, selecione o 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.

Utilização de repositórios privados com o Cloud Manager using

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.

TIP
Consulte o documento Anotações de verificação do GitHub para obter detalhes sobre as informações fornecidas pelo GitHub quando as verificações de solicitação de pull são executadas.
TIP
Você pode controlar os pipelines criados automaticamente para validar cada solicitação de pull para um repositório privado. Consulte o documento Configuração de verificação do GitHub para repositórios privados para obter mais informações.

Associação de repositórios privados a pipelines pipelines

Repositórios privados validados podem ser associados a pipelines de pilha completa e front-end.

NOTE
Os pipelines de nível da Web e de configuração não são compatíveis com repositórios privados.

Limitações limitations

Certas limitações se aplicam ao uso de repositórios privados com o Cloud Manager.

  • Não é possível pausar a validação da solicitação de pull usando a verificação do GitHub da 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.
  • Os pipelines de nível da Web e de configuração não são compatíveis com repositórios privados.
  • Nenhuma tag do Git será criada e enviada ao usar repositórios privados em pipelines de pilha completa de produção.
  • Os pipelines que usam repositórios privados e o acionador de build ao confirmar não são iniciados automaticamente quando uma nova confirmação é enviada para a ramificação selecionada.
  • A Funcionalidade de reutilização de artefato não se aplica a repositórios privados.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab