パッケージレジストリのCargoクレート
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
- ステータス: 実験的機能
この機能の利用可否は、機能フラグによって制御されます。詳細については、履歴を参照してください。この機能はテストには利用できますが、本番環境での使用には適していません。
Cargoクレート(Rustパッケージ)をプロジェクトのパッケージレジストリに公開できます。その後、Cargoを使用してインストールできます。
この機能の開発の詳細については、issue 33060を参照してください。
Cargoレジストリはプロジェクトでのみ利用できます。グループレジストリやインスタンスレジストリはありません。GitLabはスパースインデックスプロトコルのみをサポートしています。
パッケージレジストリに対して認証する
パッケージレジストリを操作する前に、認証する必要があります。
プロジェクトで、
.cargo/config.tomlファイルを作成または編集します。レジストリを追加します:
[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。
indexURLの末尾のスラッシュは必須です。[registries.gitlab]内のgitlabキーはレジストリ名です。これはローカルエイリアスであり、任意の名前を選択できます。このページの--registry gitlabコマンドはこの名前を使用します。環境変数にトークンを設定します:
export CARGO_REGISTRIES_GITLAB_TOKEN="Bearer <token>"変数名は
CARGO_REGISTRIES_<NAME>_TOKENです。<NAME>は大文字のレジストリ名で、-は_に置き換えられます。たとえば、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ジョブトークン | 該当なし | 該当なし |
パブリックプロジェクトからのクレートのインストールは、トークンなしで誰でも行えます。プライベートプロジェクトおよび内部プロジェクトにはトークンが必要です。
クレートを公開する
前提条件:
- パッケージレジストリに認証する必要があります。
- デベロッパーロール以上が必要です。
- クレートは10MB以下である必要があります。
クレートを公開するには:
次のコマンドを実行します:
cargo publish --registry gitlabGitLabはバックグラウンドでクレートを処理します。処理が完了すると、クレートはレジストリインデックスとデプロイ > パッケージレジストリページに表示されます。
オプション。クレートが誤ってcrates.ioに公開されるのを防ぐには、
Cargo.tomlファイルの[package]セクションにpublishキーを追加します:[package] name = "my-crate" version = "0.1.0" publish = ["gitlab"]
GitLab CI/CDを使用して公開する
CI/CDジョブトークンを使用して、CI/CDジョブからクレートを公開できます。トークンや設定ファイルを作成する必要はありません。
.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 gitlabcrates.ioのクレートは、プロジェクトのレジストリのクレートと並行して引き続き動作します。
クレートを削除する
前提条件:
- メンテナーまたはオーナーのロールを持っている必要があります。
パッケージを削除する前に、関連するセキュリティリスクを理解していることを確認してください。
パッケージを削除するには、次のいずれかの方法があります:
サポートされていないCargoコマンド
GitLabは次のコマンドをサポートしていません:
cargo yankcargo searchcargo owner
バージョンを削除するには、パッケージを削除します。