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

Ao configurar o Cloud Manager para integrar com sua Nuvem privada do GitHub (repositórios hospedados em github.com), 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 do Adobe.

NOTE
Você também pode adicionar os seguintes tipos de repositório com webhooks:
  • Repositórios do GitHub Enterprise Server (versão auto-hospedada do GitHub)
  • Repositórios do GitLab (versões gitlab.com e auto-hospedadas do GitLab)
  • Repositórios Bitbucket (o bitbucket.org e o Servidor de Bitbucket, a versão auto-hospedada do BitBucket)
Consulte Adicionar repositórios externos na Cloud Manager - Beta limitado.

Configuração configuration

A configuração de um repositório privado na nuvem do GitHub na Cloud Manager consiste em duas etapas:

Adicionar um repositório privado da GitHub Cloud 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 do 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 pela 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 privados da GitHub Cloud 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 na nuvem do GitHub 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.

Associar repositórios privados da GitHub Cloud a pipelines pipelines

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

Notas de uso usage-notes

  • 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 da Adobe for removido da organização GitHub, ele removerá o recurso de validação de solicitações de pull para todos os repositórios.
  • Os pipelines usando repositórios privados da nuvem do GitHub e o acionador de build "na confirmação" 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