Monorepo 패키지 관리 워크플로우
한 프로젝트 또는 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
파일에 추가하거나 액세스 토큰 대신 환경 변수를 사용하여 토큰이 노출되지 않도록 합니다. 이 .npmrc
파일은 MyProject
에서 사용한 파일과 동일할 수 있습니다. 이제 Foo
디렉터리에서 npm publish
를 실행하여 MyProject
와 별도로 Foo
를 게시할 수 있습니다.
Conan 패키지의 경우 유사한 프로세스를 따를 수 있습니다. 그러나 .npmrc
와 package.json
대신 프로젝트 내에서 여러 위치에 conanfile.py
가 있습니다.
다른 프로젝트로 게시
패키지는 GitLab의 프로젝트와 연관되지만 해당 패키지는 해당 프로젝트의 코드와 연관될 필요가 없습니다. 모든 패키지와 연동하려면 NPM 또는 Maven을 구성할 때 프로젝트 ID
만 사용하여 패키지가 업로드되는 레지스트리 URL을 설정합니다. 액세스할 수 있는 모든 프로젝트에 대한 레지스트리 URL을 설정하고 패키지 유형에 따라 기타 구성을 업데이트하면 패키지를 해당 프로젝트에 발행할 수 있습니다. 이는 코드가 동일한 위치에 없더라도 여러 패키지를 한 프로젝트에 발행할 수 있음을 의미합니다. 자세한 내용은 프로젝트 레지스트리 워크플로우 문서를 참조하십시오.