InfoGrab DocsInfoGrab Docs

패키지 레지스트리의 Cargo 크레이트

요약

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 프로젝트의 패키지 레지스트리에 Cargo 크레이트(Rust 패키지)를 게시할 수 있습니다. 이 기능의 개발에 대한 자세한 내용은 이슈 33060을 참조합니다. Cargo 레지스트리는 프로젝트에서만 사용할 수 있습니다.

히스토리
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조합니다. 이 기능은 테스트용으로 사용할 수 있으며 프로덕션 용도로는 준비되지 않았습니다.

프로젝트의 패키지 레지스트리에 Cargo 크레이트(Rust 패키지)를 게시할 수 있습니다. 그런 다음 Cargo로 크레이트를 설치할 수 있습니다.

이 기능의 개발에 대한 자세한 내용은 이슈 33060을 참조합니다.

Cargo 레지스트리는 프로젝트에서만 사용할 수 있습니다. 그룹 레지스트리나 인스턴스 레지스트리는 없습니다. GitLab은 스파스 인덱스 프로토콜만 지원합니다.

Cargo 레지스트리 활성화#

GitLab Self-Managed에서는 크레이트를 게시하거나 설치하기 전에 Cargo 레지스트리를 활성화해야 합니다. 활성화하기 전까지는 프로젝트의 Cargo 레지스트리에 대한 요청이 404 Not Found를 반환합니다.

사전 요구 사항:

  • 관리자 액세스 권한이 있어야 합니다.

프로젝트에서 Cargo 레지스트리를 활성화하려면 다음과 같이 합니다.

  • Rails 콘솔에서 다음을 실행합니다.

    Feature.enable(:package_registry_cargo_support, Project.find(<project_id>))
    

    <project_id>를 프로젝트 ID로 바꿉니다.

인스턴스의 모든 프로젝트에서 Cargo 레지스트리를 활성화하려면 다음을 실행합니다.

Feature.enable(:package_registry_cargo_support)

패키지 레지스트리에 인증#

패키지 레지스트리와 상호 작용하려면 먼저 인증해야 합니다.

  1. 프로젝트에서 .cargo/config.toml 파일을 만들거나 편집합니다.

  2. 레지스트리를 추가합니다.

    [registries.gitlab]
    index = "sparse+https://<gitlab.example.com>/api/v4/projects/<project_id>/packages/cargo/"
    credential-provider = "cargo:token"
    

    다음 값을 바꿉니다.

    • <gitlab.example.com>: GitLab 인스턴스의 호스트 이름입니다. GitLab.com에서는 gitlab.com을 사용합니다.
    • <project_id>: 프로젝트 ID입니다.

    index URL 끝의 슬래시는 필수입니다.

    [registries.gitlab]의 gitlab 키는 레지스트리 이름입니다. 로컬 별칭이므로 원하는 이름을 정할 수 있습니다. 이 페이지의 --registry gitlab 명령은 이 이름을 사용합니다.

  3. 환경 변수에 토큰을 설정합니다.

    export CARGO_REGISTRIES_GITLAB_TOKEN="Bearer <token>"
    

    변수 이름은 CARGO_REGISTRIES__TOKEN입니다. 은 레지스트리 이름을 대문자로 바꾸고 -를 _로 바꾼 값입니다. 예를 들어 레지스트리 이름이 my-registry이면 CARGO_REGISTRIES_MY_REGISTRY_TOKEN을 사용합니다.

구성 파일에 토큰을 저장하지 않습니다.

토큰 설치용 스코프 게시용 스코프
개인 액세스 토큰 api api
프로젝트 액세스 토큰 api api
세분화된 개인 액세스 토큰 Package: Read Package: Read 및 Package: Create
배포 토큰 read_package_registry read_package_registry 및 write_package_registry
CI/CD job 토큰 스코프 필요 없음 스코프 필요 없음

CI/CD job 토큰을 사용하려면 GitLab CI/CD로 게시를 참조합니다.

공개 프로젝트의 크레이트는 토큰 없이 누구나 설치할 수 있습니다. 비공개 및 내부 프로젝트에는 토큰이 필요합니다.

크레이트 게시#

사전 요구 사항:

크레이트를 게시하려면 다음과 같이 합니다.

  1. 다음 명령을 실행합니다.

    cargo publish --registry gitlab
    

    GitLab은 백그라운드에서 크레이트를 처리합니다. 처리가 끝나면 크레이트가 레지스트리 인덱스와 Deploy > Package registry 페이지에 나타납니다.

  2. 선택 사항. 크레이트가 실수로 crates.io에 게시되지 않도록 하려면 Cargo.toml 파일의 [package] 섹션에 publish 키를 추가합니다.

    [package]
    name = "my-crate"
    version = "0.1.0"
    publish = ["gitlab"]
    

GitLab CI/CD로 게시#

CI/CD job 토큰으로 CI/CD job에서 크레이트를 게시할 수 있습니다. 토큰이나 구성 파일을 만들 필요가 없습니다.

.gitlab-ci.yml 파일에 다음을 추가합니다.

publish:
  image: rust:1
  variables:
    CARGO_REGISTRIES_GITLAB_INDEX: "sparse+${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/cargo/"
    CARGO_REGISTRIES_GITLAB_TOKEN: "Bearer ${CI_JOB_TOKEN}"
  rules:
    - if: $CI_COMMIT_TAG
  script:
    - cargo publish --registry gitlab

크레이트 이름과 버전#

크레이트 이름은 다음 조건을 충족해야 합니다.

  • 문자로 시작합니다.
  • 64자 이하입니다.
  • 문자, 숫자, 하이픈(-), 밑줄(_)만 포함합니다.

크레이트 이름은 대소문자를 구분하지 않으며 하이픈과 밑줄은 같은 문자로 취급합니다. 예를 들어 my_crate와 My-Crate는 같은 크레이트를 가리킵니다.

버전은 유의적 버전이어야 합니다.

이미 존재하는 버전은 게시할 수 없습니다. Cargo가 요청이 GitLab에 도달하기 전에 중단합니다. 요청이 GitLab에 도달하면 GitLab은 Package already exists 메시지와 함께 400 오류를 반환합니다. 프로젝트의 중복 패키지 설정은 Cargo에 적용되지 않습니다.

패키지 보호 규칙은 Cargo 크레이트에 적용됩니다. 규칙이 크레이트 이름을 보호하면 GitLab은 403 오류를 반환합니다. Cargo는 다음 오류를 출력합니다.

the remote server responded with an error (status 403 Forbidden): Package protected.

크레이트 설치#

사전 요구 사항:

크레이트를 설치하려면 다음 방법 중 하나를 사용합니다.

Cargo.toml 파일의 [dependencies] 섹션에 크레이트를 추가합니다.

[dependencies]
my-crate = { version = "0.1", registry = "gitlab" }

다음을 실행합니다.

cargo add my-crate --registry gitlab

바이너리를 포함한 크레이트를 설치하려면 다음을 실행합니다.

cargo install my-crate --registry gitlab

crates.io의 크레이트는 프로젝트 레지스트리의 크레이트와 함께 계속 사용할 수 있습니다.

크레이트 삭제#

사전 요구 사항:

  • Maintainer 또는 Owner 권한이 있어야 합니다.

패키지를 삭제하기 전에 관련 보안 위험을 충분히 이해했는지 확인합니다.

패키지를 삭제하려면 다음 중 하나를 사용합니다.

지원되지 않는 Cargo 명령#

GitLab은 다음 명령을 지원하지 않습니다.

  • cargo yank
  • cargo search
  • cargo owner

버전을 제거하려면 패키지를 삭제합니다.

관련 주제#

패키지 레지스트리의 Cargo 크레이트

GitLab v19.6
Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 프로젝트의 패키지 레지스트리에 Cargo 크레이트(Rust 패키지)를 게시할 수 있습니다. 이 기능의 개발에 대한 자세한 내용은 이슈 33060을 참조합니다. Cargo 레지스트리는 프로젝트에서만 사용할 수 있습니다.

히스토리
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조합니다. 이 기능은 테스트용으로 사용할 수 있으며 프로덕션 용도로는 준비되지 않았습니다.

프로젝트의 패키지 레지스트리에 Cargo 크레이트(Rust 패키지)를 게시할 수 있습니다. 그런 다음 Cargo로 크레이트를 설치할 수 있습니다.

이 기능의 개발에 대한 자세한 내용은 이슈 33060을 참조합니다.

Cargo 레지스트리는 프로젝트에서만 사용할 수 있습니다. 그룹 레지스트리나 인스턴스 레지스트리는 없습니다. GitLab은 스파스 인덱스 프로토콜만 지원합니다.

Cargo 레지스트리 활성화#

GitLab Self-Managed에서는 크레이트를 게시하거나 설치하기 전에 Cargo 레지스트리를 활성화해야 합니다. 활성화하기 전까지는 프로젝트의 Cargo 레지스트리에 대한 요청이 404 Not Found를 반환합니다.

사전 요구 사항:

  • 관리자 액세스 권한이 있어야 합니다.

프로젝트에서 Cargo 레지스트리를 활성화하려면 다음과 같이 합니다.

  • Rails 콘솔에서 다음을 실행합니다.

    Feature.enable(:package_registry_cargo_support, Project.find(<project_id>))
    

    <project_id>를 프로젝트 ID로 바꿉니다.

인스턴스의 모든 프로젝트에서 Cargo 레지스트리를 활성화하려면 다음을 실행합니다.

Feature.enable(:package_registry_cargo_support)

패키지 레지스트리에 인증#

패키지 레지스트리와 상호 작용하려면 먼저 인증해야 합니다.

  1. 프로젝트에서 .cargo/config.toml 파일을 만들거나 편집합니다.

  2. 레지스트리를 추가합니다.

    [registries.gitlab]
    index = "sparse+https://<gitlab.example.com>/api/v4/projects/<project_id>/packages/cargo/"
    credential-provider = "cargo:token"
    

    다음 값을 바꿉니다.

    • <gitlab.example.com>: GitLab 인스턴스의 호스트 이름입니다. GitLab.com에서는 gitlab.com을 사용합니다.
    • <project_id>: 프로젝트 ID입니다.

    index URL 끝의 슬래시는 필수입니다.

    [registries.gitlab]의 gitlab 키는 레지스트리 이름입니다. 로컬 별칭이므로 원하는 이름을 정할 수 있습니다. 이 페이지의 --registry gitlab 명령은 이 이름을 사용합니다.

  3. 환경 변수에 토큰을 설정합니다.

    export CARGO_REGISTRIES_GITLAB_TOKEN="Bearer <token>"
    

    변수 이름은 CARGO_REGISTRIES__TOKEN입니다. 은 레지스트리 이름을 대문자로 바꾸고 -를 _로 바꾼 값입니다. 예를 들어 레지스트리 이름이 my-registry이면 CARGO_REGISTRIES_MY_REGISTRY_TOKEN을 사용합니다.

구성 파일에 토큰을 저장하지 않습니다.

토큰 설치용 스코프 게시용 스코프
개인 액세스 토큰 api api
프로젝트 액세스 토큰 api api
세분화된 개인 액세스 토큰 Package: Read Package: Read 및 Package: Create
배포 토큰 read_package_registry read_package_registry 및 write_package_registry
CI/CD job 토큰 스코프 필요 없음 스코프 필요 없음

CI/CD job 토큰을 사용하려면 GitLab CI/CD로 게시를 참조합니다.

공개 프로젝트의 크레이트는 토큰 없이 누구나 설치할 수 있습니다. 비공개 및 내부 프로젝트에는 토큰이 필요합니다.

크레이트 게시#

사전 요구 사항:

크레이트를 게시하려면 다음과 같이 합니다.

  1. 다음 명령을 실행합니다.

    cargo publish --registry gitlab
    

    GitLab은 백그라운드에서 크레이트를 처리합니다. 처리가 끝나면 크레이트가 레지스트리 인덱스와 Deploy > Package registry 페이지에 나타납니다.

  2. 선택 사항. 크레이트가 실수로 crates.io에 게시되지 않도록 하려면 Cargo.toml 파일의 [package] 섹션에 publish 키를 추가합니다.

    [package]
    name = "my-crate"
    version = "0.1.0"
    publish = ["gitlab"]
    

GitLab CI/CD로 게시#

CI/CD job 토큰으로 CI/CD job에서 크레이트를 게시할 수 있습니다. 토큰이나 구성 파일을 만들 필요가 없습니다.

.gitlab-ci.yml 파일에 다음을 추가합니다.

publish:
  image: rust:1
  variables:
    CARGO_REGISTRIES_GITLAB_INDEX: "sparse+${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/cargo/"
    CARGO_REGISTRIES_GITLAB_TOKEN: "Bearer ${CI_JOB_TOKEN}"
  rules:
    - if: $CI_COMMIT_TAG
  script:
    - cargo publish --registry gitlab

크레이트 이름과 버전#

크레이트 이름은 다음 조건을 충족해야 합니다.

  • 문자로 시작합니다.
  • 64자 이하입니다.
  • 문자, 숫자, 하이픈(-), 밑줄(_)만 포함합니다.

크레이트 이름은 대소문자를 구분하지 않으며 하이픈과 밑줄은 같은 문자로 취급합니다. 예를 들어 my_crate와 My-Crate는 같은 크레이트를 가리킵니다.

버전은 유의적 버전이어야 합니다.

이미 존재하는 버전은 게시할 수 없습니다. Cargo가 요청이 GitLab에 도달하기 전에 중단합니다. 요청이 GitLab에 도달하면 GitLab은 Package already exists 메시지와 함께 400 오류를 반환합니다. 프로젝트의 중복 패키지 설정은 Cargo에 적용되지 않습니다.

패키지 보호 규칙은 Cargo 크레이트에 적용됩니다. 규칙이 크레이트 이름을 보호하면 GitLab은 403 오류를 반환합니다. Cargo는 다음 오류를 출력합니다.

the remote server responded with an error (status 403 Forbidden): Package protected.

크레이트 설치#

사전 요구 사항:

크레이트를 설치하려면 다음 방법 중 하나를 사용합니다.

Cargo.toml 파일의 [dependencies] 섹션에 크레이트를 추가합니다.

[dependencies]
my-crate = { version = "0.1", registry = "gitlab" }

다음을 실행합니다.

cargo add my-crate --registry gitlab

바이너리를 포함한 크레이트를 설치하려면 다음을 실행합니다.

cargo install my-crate --registry gitlab

crates.io의 크레이트는 프로젝트 레지스트리의 크레이트와 함께 계속 사용할 수 있습니다.

크레이트 삭제#

사전 요구 사항:

  • Maintainer 또는 Owner 권한이 있어야 합니다.

패키지를 삭제하기 전에 관련 보안 위험을 충분히 이해했는지 확인합니다.

패키지를 삭제하려면 다음 중 하나를 사용합니다.

지원되지 않는 Cargo 명령#

GitLab은 다음 명령을 지원하지 않습니다.

  • cargo yank
  • cargo search
  • cargo owner

버전을 제거하려면 패키지를 삭제합니다.

관련 주제#