CodeArtifact で貨物を設定して使用する - CodeArtifact
CodeArtifact で貨物を設定する貨物箱のインストール貨物箱の発行

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CodeArtifact で貨物を設定して使用する

Cargo を使用して、CodeArtifact リポジトリからクレートを発行およびダウンロードしたり、Rust コミュニティのクレートレジストリである crates.io://www.http://www.com からクレートを取得したりできます。このトピックでは、CodeArtifact リポジトリで認証して使用するように Cargo を設定する方法について説明します。

CodeArtifact で貨物を設定する

Cargo を使用して AWS CodeArtifact からクレートをインストールして公開するには、まず CodeArtifact リポジトリ情報を使用してクレートを設定する必要があります。CodeArtifact リポジトリのエンドポイント情報と認証情報を使用して Cargo を設定するには、次のいずれかの手順を実行します。

コンソールの手順を使用して貨物を設定する

コンソールの設定手順を使用して、Cargo を CodeArtifact リポジトリに接続できます。コンソールの手順では、CodeArtifact リポジトリ用にカスタマイズされた貨物設定を提供します。このカスタム設定を使用して、CodeArtifact 情報を検索して入力することなく、Cargo をセットアップできます。

  1. https://console.aws.amazon.com/codesuite/codeartifact/home「https://www.com で AWS CodeArtifact コンソールを開きます。

  2. ナビゲーションペインで、リポジトリを選択し、Cargo に接続するリポジトリを選択します。

  3. 接続手順の表示 を選択します。

  4. オペレーティングシステムを選択します。

  5. 貨物を選択します。

  6. 生成された手順に従って、Cargo を CodeArtifact リポジトリに接続します。

貨物を手動で設定する

コンソールの設定手順を使用できない場合、または使用しない場合は、次の手順を使用して、Cargo を CodeArtifact リポジトリに手動で接続できます。

macOS and Linux

CodeArtifact で Cargo を設定するには、CodeArtifact リポジトリを Cargo 設定のレジストリとして定義し、認証情報を指定する必要があります。

  • my_registry をレジストリ名に置き換えます。

  • my_domain を CodeArtifact ドメイン名に置き換えます。

  • 111122223333 「」をドメイン所有者の AWS アカウント ID に置き換えます。所有しているドメインのリポジトリにアクセスする場合、--domain-ownerを含める必要はありません。詳細については、「クロスアカウントドメイン」を参照してください。

  • my_repo を CodeArtifact リポジトリ名で置き換えます。

設定をコピーして、Cargo パッケージをリポジトリに公開してダウンロードし、システムレベルの設定または.cargo/config.tomlプロジェクトレベルの設定用に ~/.cargo/config.toml ファイルで保存します。

[registries.my_registry]
index = "sparse+https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/cargo/my_repo/"
credential-provider = "cargo:token-from-stdout aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --region us-west-2 --query authorizationToken --output text"

[registry]
default = "my_registry"

[source.crates-io]
replace-with = "my_registry"
Windows: Download packages only

CodeArtifact で Cargo を設定するには、CodeArtifact リポジトリを Cargo 設定のレジストリとして定義し、認証情報を指定する必要があります。

  • my_registry をレジストリ名に置き換えます。

  • my_domain を CodeArtifact ドメイン名に置き換えます。

  • 111122223333 「」をドメイン所有者の AWS アカウント ID に置き換えます。所有しているドメインのリポジトリにアクセスする場合、--domain-ownerを含める必要はありません。詳細については、「クロスアカウントドメイン」を参照してください。

  • my_repo を CodeArtifact リポジトリ名で置き換えます。

設定をコピーして、リポジトリからのみ Cargo パッケージをダウンロードし、システムレベルの設定または.cargo\config.tomlプロジェクトレベルの設定のために %USERPROFILE%\.cargo\config.toml ファイルに保存してください。

[registries.my_registry]
index = "sparse+https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/cargo/my_repo/"
credential-provider = "cargo:token-from-stdout aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --region us-west-2 --query authorizationToken --output text"

[registry]
default = "my_registry"

[source.crates-io]
replace-with = "my_registry"
Windows: Publish and download packages

  1. CodeArtifact で Cargo を設定するには、CodeArtifact リポジトリを Cargo 設定のレジストリとして定義し、認証情報を指定する必要があります。

    • my_registry をレジストリ名に置き換えます。

    • my_domain を CodeArtifact ドメイン名に置き換えます。

    • 111122223333 「」をドメイン所有者の AWS アカウント ID に置き換えます。所有しているドメインのリポジトリにアクセスする場合、--domain-ownerを含める必要はありません。詳細については、「クロスアカウントドメイン」を参照してください。

    • my_repo を CodeArtifact リポジトリ名で置き換えます。

    設定をコピーして、Cargo パッケージを公開してリポジトリにダウンロードし、システムレベルの設定または.cargo\config.tomlプロジェクトレベルの設定用に %USERPROFILE%\.cargo\config.toml ファイルに保存します。

    ファイルに保存されている認証情報cargo:tokenを使用する認証情報プロバイダー を使用することをお勧めします~/.cargo/credentials.toml。Cargo クライアントcargo publishが 中に認可トークンを適切にトリミングしないcargo:token-from-stdoutため、 を使用すると、 中にエラーが発生する可能性がありますcargo publish。

    [registries.my_registry]
index = "sparse+https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/cargo/my_repo/"
credential-provider = "cargo:token"

[registry]
default = "my_registry"

[source.crates-io]
replace-with = "my_registry"

  2. Windows でリポジトリに Cargo パッケージを発行するには、CodeArtifact get-authorization-token コマンドと Cargo login コマンドを使用して認可トークンと認証情報を取得する必要があります。

    • my_registry を、 で定義されているレジストリ名に置き換えます[registries.my_registry]。

    • my_domain を CodeArtifact ドメイン名に置き換えます。

    • 111122223333 「」をドメイン所有者の AWS アカウント ID に置き換えます。所有しているドメインのリポジトリにアクセスする場合、--domain-ownerを含める必要はありません。詳細については、「クロスアカウントドメイン」を参照してください。

    aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --region us-west-2 --query authorizationToken --output text | cargo login --registry my_registry
    注記

    認可トークンの有効期限は 12 時間です。トークンの作成後 12 時間が経過した場合は、新しいトークンを作成する必要があります。

前の例の [registries.my_registry]セクションでは、 を使用してレジストリを定義my_registryしindex、 および credential-provider情報を提供します。

  • index は、レジストリのインデックスの URL を指定します。これは、 で終わる CodeArtifact リポジトリエンドポイントです/。sparse+ プレフィックスは、Git リポジトリではないレジストリに必要です。

    注記

    デュアルスタックエンドポイントを使用するには、codeartifact.region.on.awsエンドポイントを使用します。

  • credential-provider は、指定されたレジストリの認証情報プロバイダーを指定します。が設定されcredential-providerていない場合、 のプロバイダーregistry.global-credential-providersが使用されます。credential-provider を に設定することでcargo:token-from-stdout、Cargo クライアントは CodeArtifact リポジトリから発行またはダウンロードするときに新しい認可トークンを自動的に取得するため、12 時間ごとに認可トークンを手動で更新する必要はありません。

このセクションでは、使用するデフォルトのレジストリ[registry]を定義します。

  • default は、CodeArtifact リポジトリを公開またはダウンロードするときにデフォルトで使用する[registries.my_registry]、 で定義されたレジストリの名前を指定します。

[source.crates-io] セクションでは、レジストリが指定されていない場合に使用されるデフォルトのレジストリを定義します。

  • replace-with = "my_registry" は、パブリックレジストリである crates.io://https://https://https://https://https://https://https://https://https://https://https://https://https://https://https://https://CodeArtifact://http [registries.my_registry]s この設定は、crates.io://www.jp などの外部接続からパッケージをリクエストする必要がある場合に推奨されます。

    依存関係の混乱攻撃を防ぐパッケージオリジンコントロールなど、CodeArtifact のすべての利点を得るには、ソース置換を使用することをお勧めします。ソースの置き換えにより、CodeArtifact はすべてのリクエストを外部接続にプロキシし、パッケージを外部接続からリポジトリにコピーします。ソースの置き換えがない場合、Cargo クライアントはプロジェクトの Cargo.toml ファイルの設定に基づいてパッケージを直接取得します。依存関係が でマークされていない場合registry=my_registry、Cargo クライアントは CodeArtifact リポジトリと通信することなく、crates.io://www.com から直接取得します。

    注記

    ソース置換の使用を開始し、ソース置換を使用しないように設定ファイルを更新すると、エラーが発生する可能性があります。逆のシナリオでは、エラーが発生する可能性もあります。したがって、プロジェクトの設定を変更しないことをお勧めします。

貨物箱のインストール

次の手順を使用して、CodeArtifact リポジトリまたは crates.io://https://https://https://https://https://https://https://https://https://https://https://https://https://https://https://https://https://https://https://https

CodeArtifact から貨物クレートをインストールする

貨物 (cargo) CLI を使用して、CodeArtifact リポジトリから特定のバージョンの貨物クレートをすばやくインストールできます。

を使用して CodeArtifact リポジトリから Cargo クレートをインストールするには cargo

  1. まだ設定していない場合は、「」の手順に従ってCodeArtifact で貨物を設定して使用する、適切な認証情報で CodeArtifact リポジトリを使用するように cargo CLI を設定します。

  2. 次のコマンドを使用して、CodeArtifact から Cargo クレートをインストールします。

    cargo add my_cargo_package@1.0.0

    詳細については、「 貨物ブック」の「 貨物追加」を参照してください。

CodeArtifact への貨物クレートの発行

CLI を使用して貨物クレートを CodeArtifact cargo リポジトリに発行するには、次の手順に従います。

  1. まだ設定していない場合は、「」の手順に従ってCodeArtifact で貨物を設定して使用する、適切な認証情報で CodeArtifact リポジトリを使用するように cargo CLI を設定します。

  2. 次のコマンドを使用して、貨物クレートを CodeArtifact リポジトリに発行します。

    cargo publish

    詳細については、「 貨物ブック」の「 貨物公開」を参照してください。