Repositórios do Cloud Manager

Os repositórios são onde você gerencia seu código usando o Git. Saiba como criar repositórios para seus programas do Cloud Manager.

Acesso a repositórios

Você pode acessar e gerenciar os repositórios Git no autoatendimento do Cloud Manager.

Para acessar seu repositório, use o botão Acessar informações do repositório disponível no Cloud Manager, com maior destaque no cartão de pipeline.

1. Faça logon no Cloud Manager em my.cloudmanager.adobe.com e selecione a organização e o programa apropriados.

2. Navegue até o cartão Pipelines a partir da página Visão geral do programa e você verá a opção Acessar informações do repositório, que permite acessar e gerenciar o repositório Git configurado com este pipeline.

   

3. Se você alternar para a guia do pipeline de Não produção, a opção Acessar informações do repositório também estará disponível lá conforme configurado para o pipeline.

   

4. Clique no botão Acessar informações do repositório para abrir uma caixa de diálogo que apresenta:

   • O URL para o repositório Git
   • Nome de usuário
   • Senha
   • Comando do Git para executar e clonar o repositório localmente

   

Use as informações fornecidas para clonar o repositório localmente, para que você possa iniciar o desenvolvimento local.

Adicionar repositórios

Siga estas etapas para adicionar repositórios no Cloud Manager:

1. Faça logon no Cloud Manager em my.cloudmanager.adobe.com e selecione a organização e o programa apropriados.

2. Na página de Visão geral do programa, clique na guia Repositórios e navegue até a página Repositórios.

3. Clique em Adicionar repositório para iniciar o assistente.

   OBSERVAÇÃO

   Você deve ter as funções de Gerente de implantação ou Proprietário da empresa para adicionar um repositório.

   

4. Insira o nome e a descrição conforme solicitado e clique em Salvar.

   

5. Selecione Salvar.

Seu repositório recém-criado será exibido.

Os repositórios criados no Cloud Manager estão disponíveis para você selecionar quando criar seus pipelines.

Visualizar e editar repositórios

Siga estas etapas para editar e visualizar repositórios no Cloud Manager:

1. Faça logon no Cloud Manager em my.cloudmanager.adobe.com e selecione a organização e o programa apropriados.

2. Na página Visão geral do programa, clique na guia Repositórios e navegue até a página Repositórios. Aqui é possível visualizar os detalhes dos repositórios existentes.

3. Selecione o repositório e clique no botão de reticências na extremidade direita da tabela para Copiar o URL do repositório ou Exibir e atualizar o repositório.

Excluindo Repositórios

Para excluir um repositório, siga as mesmas etapas para exibir e editar repositórios, mas na página Repositórios selecione Excluir no botão de reticências do repositório a ser excluído.

Observe que, quando um repositório é excluído no Cloud Manager, ele é marcado como excluído e não é mais acessível ao usuário, mas é mantido no sistema para fins de recuperação.

Se tentar criar um novo repositório depois de excluir um repositório com o mesmo nome, você receberá a mensagem de erro "Ocorreu um erro ao tentar criar o repositório. Entre em contato com o Suporte CSE ou da Adobe."

Se você receber esta mensagem de erro, entre em contato com o Suporte da Adobe para que o suporte possa ajudar a renomear o repositório excluído ou escolher um nome diferente para seu novo repositório.

Suporte a submódulos Git

Os submódulos Git podem ser usados para mesclar o conteúdo de várias ramificações entre repositórios Git no momento da compilação.

Quando o processo de criação do Cloud Manager é executado, depois que o repositório configurado para o pipeline é clonado e a ramificação configurada é verificada, se a ramificação contiver um arquivo .gitmodules no diretório raiz, o comando é executado.

$ git submodule update --init

Isso verifica cada submódulo no diretório apropriado. Essa técnica é uma alternativa potencial para trabalhar com vários repositórios Git de origem em organizações que estão acostumadas com o uso de submódulos do Git e que não desejam gerenciar um processo de mesclagem externo.

Por exemplo, digamos que existam três repositórios, cada um contendo uma única ramificação chamada main. No repositório “primário”, ou seja, aquele configurado nos pipelines, a ramificação main tem um arquivo pom.xml que declara os projetos contidos nos outros dois repositórios:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>customer.group.id</groupId>
    <artifactId>customer-reactor</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>pom</packaging>

    <modules>
        <module>project-a</module>
        <module>project-b</module>
    </modules>

</project>

Em seguida, você adicionaria submódulos para os outros dois repositórios:

$ git submodule add -b main https://git.cloudmanager.adobe.com/ProgramName/projectA/ project-a
$ git submodule add -b main https://git.cloudmanager.adobe.com/ProgramName/projectB/ project-b

Isso resulta em um arquivo .gitmodules com esta aparência:

[submodule "project-a"]
    path = project-a
    url = https://git.cloudmanager.adobe.com/ProgramName/projectA/
    branch = main
[submodule "project-b"]
    path = project-b
    url = https://git.cloudmanager.adobe.com/ProgramName/projectB/
    branch = main

Mais informações sobre os submódulos do Git podem ser encontradas na seção Manual de referência do Git.

Limitações

Ao usar submódulos do Git, esteja ciente de:

• O URL do Git deve seguir exatamente a sintaxe descrita acima.
• Por motivos de segurança, não incorpore credenciais nesses URLs.
• Somente os submódulos na raiz da ramificação são permitidos.
• As referências de submódulos Git são armazenadas para confirmações do Git específicas.
  • Como resultado, quando alterações no repositório do submódulo são feitas, a confirmação referenciada precisa ser atualizada, por exemplo, usando git submodule update --remote.
• A menos que seja necessário, é altamente recomendável usar submódulos “superficiais”.
  • Para fazer isso, execute git config -f .gitmodules submodule.<submodule path>.shallow true para cada submódulo.