Adição de repositórios privados no Cloud Manager private-repositories
Saiba como configurar o Cloud Manager para trabalhar com os seus repositórios privados do GitHub.
Visão geral overview
Configurar o Cloud Manager com os seus repositórios privados do GitHub permite validar o código diretamente no GitHub, eliminando a necessidade de sincronização frequente com o repositório da Adobe.
Configuração configuration
A configuração consiste em duas etapas principais:
Adicionar um repositório add-repo
-
Na página Visão geral do programa do Cloud Manager, clique na 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
-
Clique em Salvar.
Validar a propriedade de um 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.
-
Após adicionar seu próprio repositório, a caixa de diálogo Validação de propriedade de repositório privado é exibida.
-
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-aeme conceder acesso ao repositório. Consulte a documentação do GitHub para obter mais detalhes. -
Para melhorar a segurança, crie um arquivo secreto na ramificação padrão do repositório. Clique em Gerar.
-
Confirme a geração do arquivo secreto clicando em Confirmar.
-
De volta à caixa de diálogo Validação de propriedade de repositório privado, o Cloud Manager terá gerado o conteúdo 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, será necessário gerar o segredo novamente.
-
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. -
Após a instalação do aplicativo e a adição do arquivo secreto no repositório, clique em Validar na caixa de diálogo Validação de propriedade de repositório privado.
O aplicativo pode ser instalado e você pode gerar um arquivo secreto 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.
Observe que a coluna Tipo identifica facilmente os repositórios fornecidos pela Adobe (Adobe) e os seus repositórios do GitHub (GitHub).
Para retornar ao repositório mais tarde e concluir a validação, vá para a página Repositórios. Clique no botão de reticências ao lado do repositório GitHub 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.
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 as verificações de qualidade do código sejam concluídas. Os resultados de qualidade do código são entã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.
- 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 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 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 no Cloud Manager. Se o repositório do GitHub for validado no Cloud Manager, o Cloud Manager tentará validar as solicitações de pull criadas para esse repositório.