모노레포 패키지 관리 워크플로우

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

하나의 프로젝트 또는 Git 저장소는 여러 개의 서로 다른 하위 프로젝트나 하위 모듈을 포함할 수 있으며, 이들은 모두 개별적으로 패키징되고 게시됩니다.

상위 프로젝트에 서로 다른 패키지 게시하기

하나의 프로젝트에 게시할 수 있는 패키지의 수와 이름에 제한은 없습니다.
각 패키지에 대해 서로 다른 구성 파일을 설정하여 이를 달성할 수 있습니다.
각 패키지 관리자에는 고유한 파일과 게시를 위한 지침이 있으므로, 선택한 패키지 관리자의 문서를 참조하세요.

여기서의 예제는 NPM을 사용합니다.
이 예제에서 MyProject는 상위 프로젝트입니다. components 디렉토리 내에 하위 프로젝트 Foo를 포함하고 있습니다:

MyProject/
  |- src/
  |   |- components/
  |       |- Foo/
  |- package.json

목표는 MyProject와 Foo에 대한 패키지를 게시하는 것입니다.
GitLab NPM 레지스트리 문서의 지침을 따르면,
package.json 파일의 publishConfig 섹션을 수정하여 MyProject를 게시할 수 있으며,
다음 중 하나를 수행합니다:

  • npm config set와 같은 CLI 명령어로 로컬 NPM 구성을 수정합니다.
  • 이러한 구성 설정을 지정하는 .npmrc 파일을 프로젝트의 루트에 저장합니다.

지침을 따르시면 루트 디렉토리에서 npm publish를 실행하여 MyProject를 게시할 수 있습니다.

Foo를 게시하는 것은 거의 동일합니다. Foo 디렉토리 내에서 같은 단계를 따르세요.
Foo는 자신의 package.json 파일이 필요하며, npm init를 사용하여 수동으로 추가할 수 있습니다.
Foo도 자체 구성 설정이 필요합니다. 같은 장소에 게시하고 있으므로, 상위 프로젝트에 대해 npm config set으로 레지스트리를 설정했다면 추가 설정은 필요하지 않습니다.
.npmrc 파일을 사용했다면, Foo 디렉토리에 추가 .npmrc 파일이 필요합니다.
.npmrc 파일을 .gitignore 파일에 추가하거나 접근 토큰이 노출되지 않도록 환경 변수를 사용할 수 있습니다.
이 .npmrc 파일은 MyProject에서 사용한 것과 동일할 수 있습니다. 이제 Foo 디렉토리에서 npm publish를 실행하여 MyProject와 별도로 Foo를 게시할 수 있습니다.

Conan 패키지의 경우 유사한 프로세스를 따를 수 있습니다.
다만, .npmrc와 package.json 대신 프로젝트 내 여러 위치에 conanfile.py가 있습니다.

다른 프로젝트에 게시하기

패키지는 GitLab의 프로젝트에 연결되어 있지만, 그 프로젝트의 코드와 반드시 연결될 필요는 없습니다.
NPM 또는 Maven을 구성할 때, 패키지를 업로드할 레지스트리 URL을 설정하기 위해 오직 Project ID만 사용합니다.
접근할 수 있는 프로젝트로 이 값을 설정하고 패키지 유형에 따라 다른 구성을 업데이트하면,
당신의 패키지는 해당 프로젝트에 게시됩니다.
즉, 동일한 장소에 코드가 존재하지 않더라도 여러 패키지를 하나의 프로젝트에 게시할 수 있습니다.
자세한 내용은 프로젝트 레지스트리 워크플로우 문서를 참조하세요.