Usar vários repositórios

Última atualização: 5 de outubro de 2024
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Administrador
  • Desenvolvedor

Saiba como gerenciar vários repositórios Git ao trabalhar com o Cloud Manager.

Sincronizar repositórios Git privados

Em vez de trabalhar diretamente com o repositório Git da Cloud Manager, os clientes podem trabalhar com seu próprio repositório Git privado ou com vários deles. Nesses casos, configure um processo de sincronização automatizada para garantir que o repositório Git no Cloud Manager esteja sempre atualizado.

Dependendo de onde o repositório Git do cliente estiver hospedado, uma ação do GitHub ou uma solução de integração contínua, como Jenkins, pode ser usada para configurar a automação. Com uma automação em vigor, cada push para um repositório Git de propriedade do cliente pode ser encaminhado automaticamente para o repositório Git da Cloud Manager.

Embora essa automação para um único repositório Git de propriedade do cliente seja direta, configurá-la para vários repositórios requer uma configuração inicial. O conteúdo de vários repositórios Git deve ser mapeado para diretórios diferentes dentro do único repositório Git do Cloud Manager. O repositório Git da Cloud Manager deve ser provisionado com um Maven raiz pom.xml, listando os diferentes subprojetos na seção de módulos.

Este é um exemplo de arquivo pom.xml para dois repositórios Git de propriedade do cliente.

  • O primeiro projeto será colocado no diretório chamado project-a.
  • O segundo projeto será colocado no diretório chamado project-b.
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://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>

Essa raiz pom.xml será enviada a uma ramificação no repositório Git do Cloud Manager. Em seguida, os dois projetos devem ser configurados para encaminhar as alterações automaticamente para o repositório Git da Cloud Manager.

Uma solução possível seria a descrita a seguir.

  1. Acione uma ação do GitHub enviando para uma ramificação no projeto A.
  2. A ação verifica o projeto A e o repositório Git do Cloud Manager. Em seguida, ele copia todo o conteúdo do projeto A para o diretório project-a no repositório Git da Cloud Manager.
  3. Em seguida, a ação confirma - envia a alteração.

Por exemplo, uma alteração na ramificação principal do projeto A é automaticamente enviada para a ramificação principal no repositório Git do Cloud Manager. Pode haver um mapeamento entre ramificações, como quando um push para uma ramificação chamada dev no projeto A é enviado para uma ramificação chamada development no repositório Git do Cloud Manager. Etapas semelhantes são necessárias para o projeto B.

Dependendo da estratégia de ramificação e dos fluxos de trabalho, a sincronização pode ser configurada para ramificações diferentes. Se o repositório Git usado não fornecer um conceito semelhante às ações do GitHub, também é possível uma integração por meio do Jenkins (ou semelhante). Nesse caso, um webhook aciona uma tarefa do Jenkins, que faz o trabalho.

Siga estas etapas para adicionar um novo, uma terceira fonte ou um repositório.

  1. Adicione uma ação do GitHub ao novo repositório, o que envia as alterações desse repositório para o repositório Git da Cloud Manager.
  2. Execute essa ação pelo menos uma vez para garantir que o código do projeto esteja no repositório Git do Cloud Manager.
  3. No repositório Git do Cloud Manager, adicione uma referência ao novo diretório na raiz Maven pom.xml.

Exemplo de ação do GitHub

Este é um exemplo de ação do GitHub acionada por um push para a ramificação principal. Em seguida, insira um subdiretório do repositório Git da Cloud Manager. As ações do GitHub devem ser fornecidas com dois segredos, MAIN_USER e MAIN_PASSWORD, para poderem se conectar e enviar para o repositório Git da Cloud Manager.

name: SYNC
env:
  # Username/email used to commit to Cloud Manager's Git repository
  USER_NAME: <NAME>
  USER_EMAIL: <EMAIL>
  # Directory within the Cloud Manager Git repository
  PROJECT_DIR: project-a
  # Cloud Manager's Git repository
  MAIN_REPOSITORY: https://$MAIN_USER:$MAIN_PASSWORD@git.cloudmanager.adobe.com/<PATH>
  # The branch in Cloud Manager's Git repository to push to
  MAIN_BRANCH : <BRANCH_NAME>

# Only run on a push to this branch
on:
  push:
     branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      # Checkout this project into a sub folder
      - uses: actions/checkout@v2
        with:
          path: sub
      # Cleanup sub project
      - name: Clean project
        run: |
          git -C sub log --format="%an : %s" -n 1 > commit.txt
          rm -rf sub/.git
          rm -rf sub/.github
      # Set global git configuration
      - name: Set git config
        run: |
          git config --global credential.helper cache
          git config --global user.email ${USER_EMAIL}
          git config --global user.name ${USER_NAME}
      # Checkout the main project
      - name: Checkout main project
        run:
          git clone -b ${MAIN_BRANCH} ${MAIN_REPOSITORY} ${MAIN_BRANCH}
      # Move sub project
      - name: Move project to main project
        run: |
          rm -rf ${MAIN_BRANCH}/${PROJECT_DIR}
          mv sub ${MAIN_BRANCH}/${PROJECT_DIR}
      - name: Commit Changes
        run: |
          git -C ${MAIN_BRANCH} add -f ${PROJECT_DIR}
          git -C ${MAIN_BRANCH} commit -F ../commit.txt
          git -C ${MAIN_BRANCH} push

O uso de uma ação do GitHub é flexível. É possível executar qualquer mapeamento entre ramificações de repositórios Git, bem como qualquer mapeamento de projetos Git separados no layout de diretório do projeto principal.

NOTE
O exemplo de script usa git add para atualizar o repositório. O script pressupõe que as remoções estejam incluídas. Dependendo da configuração padrão do Git, ele deve ser substituído por git add --all.