Adicionar um repositório GitHub privado no Cloud Manager private-repositories
Ao configurar o Cloud Manager para integrar com seu repositório GitHub privado hospedado em github.com, você pode validar seu código diretamente no GitHub usando o Cloud Manager. Esta página se aplica a qualquer repositório hospedado em github.com, independentemente do plano do GitHub (Gratuito, Pro, Team ou Enterprise Cloud). Essa configuração remove o requisito de sincronizar o código regularmente com o repositório do Adobe.
-
Esta página se aplica a qualquer repositório hospedado em
github.com, independentemente do plano do GitHub (Gratuito, Pro, Team ou Enterprise Cloud). Esses repositórios usam o aplicativo GitHub da Adobe para validar a propriedade. Nenhuma configuração de webhook é necessária, pois o Cloud Manager se integra diretamente pelo aplicativo. -
Se quiser adicionar qualquer um dos seguintes tipos de repositório, consulte Adicionar repositórios externos no Cloud Manager. Esses repositórios usam um PAT (Personal Access Token) e um webhook configurado manualmente para validar a propriedade.
- Repositórios do GitHub Enterprise Server (versão auto-hospedada do GitHub).
- Repositórios GitLab (tanto
gitlab.comquanto a versão auto-hospedada do GitLab). - Repositórios Bitbucket (somente
bitbucket.org, versão em nuvem). A versão auto-hospedada do Bitbucket foi descontinuada em 15 de fevereiro de 2024. - Repositórios DevOps (
dev.azure.com) da Azure.
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
-
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 de ilustração).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
Agora o Cloud Manager está configurado com seu repositório GitHub, mas ainda requer autorização para acessar o repositório. 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 o 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 GitHub deve instalar o aplicativo localizado emhttps://github.com/apps/cloud-manager-for-aeme 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
-
Crie um novo arquivo na ramificação padrão do seu repositório GitHub com o nome
.well-known/adobe/cloud-manager-challenge -
Cole o conteúdo do arquivo secreto no novo arquivo e salve.
Depois que o aplicativo estiver instalado e o arquivo secreto existir no repositório, continue com as etapas.
-
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 é listado com um ícone vermelho, indicando que ainda não foi validado e não está disponível para uso.
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).
Para acessar o repositório posteriormente e concluir a validação, na página Repositórios, clique em
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 GitHub 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.
Associar repositórios GitHub privados a pipelines pipelines
Repositórios privados validados podem ser associados a pipelines de pilha completa e front-end.
Limitações limitations
As limitações a seguir se aplicam ao uso de repositórios privados com o Cloud Manager.
- 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ção de pull para todos os repositórios.
- Os pipelines usando repositórios GitHub privados 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 no 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.
- Se sua organização GitHub impor restrições de IP, abra um caso de suporte para obter a lista de endereços IP que devem ser permitidos.