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.
Configuração configuration
A configuração consiste em duas etapas principais:
Adicionar repositório add-repo
-
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.
-
Na caixa de diálogo Adicionar repositório, selecione Repositório privado como o tipo de repositório.
-
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
-
Selecione Salvar.
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.
-
Depois de adicionar seu próprio repositório, a caixa de diálogo Validação da Propriedade do Repositório Privado será aberta.
-
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.
- Um(a) proprietário(a) de sua organização do GitHub deve instalar o aplicativo localizado em
-
Para melhorar a segurança, você deve criar um arquivo secreto na ramificação padrão do repositório. Selecione Gerar.
-
Confirme a geração do arquivo secreto tocando ou clicando em Confirmar.
-
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.
-
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. -
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.
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.
-
Ao criar uma solicitação de “pull”, uma verificação do GitHub será iniciada automaticamente.
-
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.
-
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.
Quando a solicitação de “pull” é fechada ou mesclada, o pipeline de qualidade de 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.
- 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.