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.
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 selecionado.
- Em seguida, valide a propriedade do repositório GitHub privado.
Adicionar um repositório GitHub privado a um programa add-repo
-
Faça logon no Cloud Manager, em my.cloudmanager.adobe.com, e selecione a organização apropriada.
-
No console Meus programas, selecione o programa ao qual deseja vincular um repositório Git privado.
-
No menu lateral, em Serviços, selecione Repositórios.
-
Próximo ao canto superior direito da página Repositórios, clique em Adicionar Repositório.
-
Na caixa de diálogo Adicionar repositório, selecione Repositório privado como o tipo de repositório.
-
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. -
Selecione Salvar.
Agora você pode validar a propriedade do repositório privado.
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:
-
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.
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 emhttps://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 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. -
Crie um novo arquivo na ramificação padrão do repositório GitHub chamada:
.well-known/adobe/cloud-manager-challenge
-
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.
-
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.
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 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:
-
Ao criar uma solicitação de pull, começa uma verificação do GitHub automaticamente.
-
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.
-
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.
Quando a solicitação de pull é mesclada ou fechada, o pipeline de qualidade do código de pilha completa criado é excluído automaticamente.
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.