Adobe 저장소에 대한 Git 하위 모듈 지원

마지막 업데이트: 2024년 10월 9일

작성 대상:

  • 관리자
  • 개발자

Git 하위 모듈을 사용하여 빌드 시 Git 저장소에 있는 여러 분기의 콘텐츠를 병합할 수 있습니다.

Cloud Manager의 빌드 프로세스가 실행되면 파이프라인의 저장소를 복제하고 분기를 체크아웃합니다. 분기의 루트 디렉터리에 .gitmodules 파일이 있으면 해당 명령이 실행됩니다.

다음 명령은 각 하위 모듈을 적절한 디렉터리로 체크아웃합니다.

$ git submodule update --init

이 기술은 여러 Source Git 저장소를 사용하여 작업에 설명된 솔루션에 대한 대안을 제공합니다. Git 하위 모듈에 익숙하고 외부 병합 프로세스를 관리하지 않는 것이 좋은 조직에 이상적입니다.

예를 들어 저장소가 3개라고 가정해 보겠습니다. 각 리포지토리에는 이름이 main인 단일 분기가 있습니다. 기본 저장소, 즉 파이프라인에 구성된 저장소에서 main 분기에는 다른 두 저장소에 포함된 프로젝트를 선언하는 pom.xml 파일이 있습니다.

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

그런 다음 다른 두 저장소에 대한 하위 모듈을 추가합니다.

$ 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

결과는 다음과 유사한 .gitmodules 파일입니다.

[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

Git 하위 모듈에 대한 자세한 내용은 Git 참조 설명서를 참조하십시오.

제한 사항 및 권장 사항

Adobe 관리 저장소와 함께 Git 하위 모듈을 사용할 때는 다음 제한 사항에 유의하십시오.

  • Git URL은 이전 섹션에서 설명한 구문과 정확히 일치해야 합니다.

  • 분기의 루트에 있는 하위 모듈만 지원됩니다.

  • 보안상의 이유로 Git URL에 자격 증명을 임베드하지 마십시오.

  • Adobe 달리 필요한 경우가 아니면 다음을 실행하여 약식 하위 모듈을 사용하는 것이 좋습니다.
    각 하위 모듈에 대해 git config -f .gitmodules submodule.<submodule path>.shallow true입니다.

  • Git 하위 모듈 참조는 특정 Git 커밋에 저장됩니다. 따라서 하위 모듈 저장소가 변경되면 참조된 커밋을 업데이트해야 합니다.
    예를 들어 다음을 사용합니다.

    git submodule update --remote

비공개 저장소에 대한 Git 하위 모듈 지원

개인 저장소에서 Git 하위 모듈에 대한 지원은 일반적으로 Adobe 리포지토리에서 사용하는 것과 유사합니다.

그러나 pom.xml 파일을 구성하고 git submodule 명령을 실행한 후에는 Cloud Manager에서 하위 모듈 구성을 인식하도록 집계 저장소의 루트 디렉터리에 .gitmodules 파일을 추가해야 합니다.

.gitmodules 파일

집계기

제한 사항 및 권장 사항

개인 리포지토리에 Git 하위 모듈을 사용할 때는 다음 제한 사항을 염두에 두십시오.

  • 하위 모듈 Git URL은 HTTPS 또는 SSH 형식일 수 있지만 GitHub.com 저장소를 가리켜야 합니다. GitHub 집계 저장소에 Adobe 저장소 하위 모듈을 추가하거나 그 반대로 추가할 수 없습니다.
  • GitHub 하위 모듈은 GitHub 앱 Adobe에서 액세스할 수 있어야 합니다.
  • Adobe 관리 저장소의 Git 하위 모듈 사용 시 제한 사항도 적용됩니다.

Experience Manager