使用多个源Git存储库

正在同步客户管理的Git存储库

客户可以使用自己的Git存储库或多个自己的Git存储库，而不是直接使用Cloud Manager的Git存储库。 在这些情况下，应设置自动同步过程，以确保Cloud Manager的Git存储库始终保持为最新。 根据客户的Git存储库的托管位置，可以使用GitHub操作或Jenkins等连续集成解决方案来设置自动化。 实施自动化后，每次向客户拥有的Git存储库推送消息时，都可以自动转发到Cloud Manager的Git存储库。

虽然单个客户拥有的Git存储库可以直接实现此类自动化，但为多个存储库设置此功能需要初始设置。 需要将多个Git存储库中的内容映射到单个Cloud Manager的Git存储库中的不同目录。 需要使用根Maven pom配置Cloud Manager的Git存储库，以便在模块部分中列出不同的子项目

以下是两个客户拥有的Git存储库的示例pom:第一个项目将放入名为project-a的目录中，第二个项目将放入名为project-b的目录中。

<?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>

此类根pom会被推送到Cloud Manager的Git存储库中的分支。 然后，需要设置这两个项目，以自动将更改转发到Cloud Manager的Git存储库。

例如，GitHub操作可以通过将内容推送到项目A中的分支来触发。该操作将签出项目A和Cloud Manager Git存储库，并将项目A中的所有内容复制到Cloud Manager Git存储库中的project-a目录，然后提交推送更改。 例如，项目A中主分支的更改会自动推送到Cloud Manager的git存储库中的主分支。 当然，可能会在分支之间进行映射，如将项目A中名为“dev”的分支推送到Cloud Manager的Git存储库中名为“development”的分支。 项目B需要执行类似步骤。

根据分支策略和工作流，可以为不同分支配置同步。 如果使用的Git存储库没有提供与GitHub操作类似的概念，则也可以通过Jenkins（或类似）进行集成。 在这种情况下，网络挂钩会触发Jenkins作业，该作业负责工作。

请按照以下步骤添加新的（第三个）源或存储库：

1. 向新存储库添加新的GitHub操作，以将更改从该存储库推送到Cloud Manager的Git存储库。
2. 请至少执行一次该操作，以确保项目代码位于Cloud Manager的Git存储库中。
3. 在Cloud Manager Git存储库的根Maven pom中添加对新目录的引用。

GitHub操作示例

这是一个GitHub操作示例，该操作由推送到主分支，然后推送到Cloud Manager的Git存储库的子目录触发。 GitHub操作需要提供两个密钥，即MAIN_USER和MAIN_PASSWORD，才能连接并推送到Cloud Manager的Git存储库。

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} https://${{ secrets.PAT }}@github.com/${MAIN_REPOSITORY}.git main 
      # Move sub project
      - name: Move project to main project
        run: |
          rm -rf main/${PROJECT_DIR} 
          mv sub main/${PROJECT_DIR}
      - name: Commit Changes
        run: |
          git -C main add -f ${PROJECT_DIR}
          git -C main commit -F ../commit.txt
          git -C main push

如上所示，使用GitHub操作非常灵活。 可以执行Git存储库分支之间的任何映射，以及将单独的git项目映射到主项目的目录布局中的任何映射。

示例Jenkins作业

这是一个可在Jenkins作业或类似作业中使用的示例脚本。 它由Git存储库中的更改触发。 Jenkins作业会检出该项目或分支的最新状态，然后触发此脚本。

此脚本随后会检出Cloud Manager的Git存储库，并将项目代码提交到子目录。

Jenkins作业需要提供两个密钥，即MAIN_USER和MAIN_PASSWORD，才能连接并推送到Cloud Manager的Git存储库。

# Username/email used to commit to Cloud Manager's Git repository
export USER_NAME=<NAME>
export USER_EMAIL=<EMAIL>
# Directory within the Cloud Manager Git repository
export PROJECT_DIR=project-a
# Cloud Manager's Git repository
export MAIN_REPOSITORY=https://$MAIN_USER:$MAIN_PASSWORD@git.cloudmanager.adobe.com/<PATH>
# The branch in Cloud Manager's Git repository to push to
export MAIN_BRANCH=<BRANCH_NAME>
 
# clean up and init
rm -rf target
mkdir target
 
# mv project to sub folder
mkdir target/sub
for f in .* *
do
    if [ "$f" != "." -a "$f" != ".." -a "$f" != "target" ]
    then
        mv "$f" target/sub
    fi
done
cd target
 
# capture log and remove git info
cd sub
git log --format="%an : %s" -n 1 > ../commit.txt
rm -rf .git
rm -rf .github
cd ..
 
# checkout main repository
git clone -b $MAIN_BRANCH $MAIN_REPOSITORY main
cd main
 
# configure main repository
git config credential.helper cache
git config user.email $USER_EMAIL
git config user.name $USER_NAME
 
# update project in main
rm -rf $PROJECT_DIR
mv ../sub $PROJECT_DIR
 
# commit changes to main
git add -f $PROJECT_DIR
git commit -F ../commit.txt
git push

如上所示，使用Jenkins作业非常灵活。 可以执行Git存储库分支之间的任何映射，以及将单独的Git项目映射到主项目的目录布局中的任何映射。