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

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에는 직접 npm init을 사용하여 수동으로 추가할 수 있는 자체 package.json 파일이 필요합니다. Foo에는 자체 구성 설정도 필요합니다. 동일한 위치로 발행하기 때문에, 부모 프로젝트의 레지스트리를 설정하기 위해 npm config set을 사용했다면, 추가적인 설정이 필요 없습니다. .npmrc 파일을 사용했다면, Foo 디렉터리에 추가적인 .npmrc 파일이 필요합니다. .npmrc 파일을 .gitignore 파일에 추가하거나 엑세스 토큰 대신 환경 변수를 사용하여 토큰이 노출되지 않도록 합니다. MyProject에서 사용한 .npmrc 파일과 동일한 .npmrc 파일을 추가할 수 있습니다. 이제 Foo 디렉터리에서 npm publish를 실행하여 MyProject와 별도로 Foo를 발행할 수 있습니다.

Conan 패키지의 경우 비슷한 프로세스를 따를 수 있습니다. 그러나 .npmrc 및 package.json 대신에 프로젝트 내 여러 위치에 conanfile.py가 있습니다.

다른 프로젝트로 발행

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