Adicionar um repositório GitHub privado no Cloud Manager private-repositories

Ao configurar o Cloud Manager para integrar com seus repositórios GitHub privados, você pode validar seu código diretamente no GitHub usando o Cloud Manager. Essa configuração remove o requisito de sincronizar o código regularmente com o repositório 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 de um repositório GitHub privado no Cloud Manager consiste em duas etapas:

Adicionar um repositório GitHub privado a um programa add-repo

  1. Faça logon no Cloud Manager, em my.cloudmanager.adobe.com, e selecione a organização apropriada.

  2. No console Meus programas, selecione o programa ao qual deseja vincular um repositório Git privado.

  3. No menu lateral, em Serviços, selecione Ícone de pasta Repositórios.

    A página Repositórios

  4. Próximo ao canto superior direito da página Repositórios, clique em Adicionar Repositório.

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

    Adicionar repositório próprio

  6. Em cada campo respectivo, forneça os seguintes detalhes sobre o repositório:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Texto Descrição
    Nome do repositório Um nome expressivo para o novo repositório.
    URL do repositório A URL do repositório privado, que deve terminar em .git.
    Por exemplo, https://github.com/org-name/repo-name.git (o caminho da URL é apenas para fins ilustrativos).
    Descrição (opcional) Uma descrição detalhada do repositório.
  7. Selecione Salvar.
    Agora você pode validar a propriedade do repositório privado.

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

Validar a propriedade de um repositório GitHub 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.

Para validar a propriedade de um repositório GitHub privado:

  1. Depois de adicionar seu próprio repositório, siga as etapas restantes na caixa de diálogo Validação da Propriedade do Repositório Privado.

    Validação de propriedade de repositório privado

    table 0-row-2 1-row-2 2-row-2
    Descrição
    Etapa 1: aplicativo GitHub O Cloud Manager usa um aplicativo GitHub para interagir com seu repositório privado de forma segura.
    · Um proprietário 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.
    · Para obter detalhes sobre como instalar e conceder acesso, consulte a documentação do GitHub.
    Etapa 2: Arquivo Secreto Para melhorar a segurança, você deve criar um arquivo secreto na ramificação padrão do seu repositório.
    · Clique em Gerar e em Confirmar. O Cloud Manager gera o conteúdo do arquivo particular no campo de texto Conteúdo do arquivo secreto.
    · Clique em Ícone Copiar para copiar 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 caixa de diálogo, gere novamente o segredo.
  2. Crie um novo arquivo na ramificação padrão do repositório GitHub chamada:

    .well-known/adobe/cloud-manager-challenge

  3. Cole o conteúdo do arquivo secreto no novo arquivo que acabou de criar e salve.

    Depois que o aplicativo estiver instalado e o arquivo secreto existir no repositório, continue a etapa.

  4. Na caixa de diálogo Validação de Propriedade de Repositório Privado, clique em Validar.

O aplicativo pode ser instalado e um arquivo secreto pode ser criado 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 na tabela na página Repositórios identifica repositórios fornecidos por Adobe (Adobe) e seus próprios repositórios privados (GitHub).

Se precisar retornar ao repositório mais tarde para concluir a validação, na página Repositórios, clique em Mais ícone na linha que representa o repositório GitHub que você acabou de adicionar. Na lista suspensa, selecione Validação de Propriedade.

Usar repositórios GitHub privados com o Cloud Manager using

Depois que o repositório GitHub for validado no Cloud Manager, a integração será concluída. Você pode usar o repositório com o Cloud Manager.

Para usar repositórios privados com o Cloud Manager:

  1. Ao criar uma solicitação de pull, começa uma verificação do GitHub automaticamente.

    Verificações do GitHub

  2. Para cada solicitação de pull, é criado um pipeline de qualidade de código de pilha completa 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 a verificação de qualidade do código seja concluída. Os resultados de qualidade do código são então propagados para a verificação do GitHub.

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

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

TIP
Consulte Anotações de verificação do GitHub para obter detalhes sobre as informações fornecidas por meio do 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 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.

Limitações limitations

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

  • 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.
  • Se o aplicativo GitHub do Adobe for removido da organização GitHub, o recurso de validação de solicitações de pull será removido de todos os repositórios.
  • 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.
  • 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 GitHub for validado no Cloud Manager, o Cloud Manager sempre tentará validar as solicitações de pull criadas para esse repositório.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab