Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Configurer et utiliser Cargo avec CodeArtifact
Vous pouvez utiliser Cargo pour publier et télécharger des caisses depuis CodeArtifact des référentiels ou pour récupérer des caisses depuis crates.io
Configurez Cargo avec CodeArtifact
Pour utiliser Cargo pour installer et publier des caisses à partir de celles-ci AWS CodeArtifact, vous devez d'abord les configurer avec les informations de votre CodeArtifact référentiel. Suivez les étapes de l'une des procédures suivantes pour configurer Cargo avec les informations et les informations d'identification du point de terminaison de votre CodeArtifact référentiel.
Configurer Cargo à l'aide des instructions de la console
Vous pouvez utiliser les instructions de configuration de la console pour connecter Cargo à votre CodeArtifact référentiel. Les instructions de la console fournissent une configuration Cargo personnalisée pour votre CodeArtifact référentiel. Vous pouvez utiliser cette configuration personnalisée pour configurer Cargo sans avoir à rechercher et à renseigner vos CodeArtifact informations.
-
Ouvrez la AWS CodeArtifact console à l'adresse https://console.aws.amazon.com/codesuite/codeartifact/home
. -
Dans le volet de navigation, choisissez Repositories, puis choisissez un référentiel pour vous connecter à Cargo.
-
Choisissez Afficher les instructions de connexion.
-
Choisissez votre système d'exploitation.
-
Choisissez Cargo.
-
Suivez les instructions générées pour connecter Cargo à votre CodeArtifact dépôt.
Configurer Cargo manuellement
Si vous ne pouvez pas ou ne souhaitez pas utiliser les instructions de configuration de la console, vous pouvez utiliser les instructions suivantes pour connecter Cargo à votre CodeArtifact référentiel manuellement.
La [registries.
section de l'exemple précédent définit un registre contenant my_registry
]my_registry
index
et fournit des credential-provider
informations.
-
index
spécifie l'URL de l'index de votre registre, qui est le point de terminaison du CodeArtifact référentiel qui se termine par un/
. Lesparse+
préfixe est obligatoire pour les registres qui ne sont pas des référentiels Git. -
credential-provider
spécifie le fournisseur d'informations d'identification pour le registre donné. Sicredential-provider
ce n'est pas le cas, les fournisseursregistry.global-credential-providers
inclus seront utilisés. En lecredential-provider
réglant surcargo:token-from-stdout
, le client Cargo récupérera automatiquement le nouveau jeton d'autorisation lors de la publication ou du téléchargement depuis votre CodeArtifact référentiel. Vous n'avez donc pas besoin d'actualiser manuellement le jeton d'autorisation toutes les 12 heures.
La [registry]
section définit le registre par défaut utilisé.
-
default
indique le nom du registre défini dans[registries.
, à utiliser par défaut lors de la publication ou du téléchargement depuis votre CodeArtifact référentiel.my_registry
]
La [source.crates-io]
section définit le registre par défaut utilisé lorsqu'aucun registre n'est spécifié.
-
replace-with = "
remplace le registre public crates.io par votre CodeArtifact dépôt défini dans.my_registry
"[registries.
Cette configuration est recommandée si vous devez demander des packages via une connexion externe telle que crates.io.my_registry
]Pour bénéficier de tous les avantages CodeArtifact, tels que le contrôle de l'origine des packages qui empêche les attaques de confusion de dépendances, il est recommandé d'utiliser le remplacement de source. Avec le remplacement de la source, CodeArtifact transmet toutes les demandes par proxy à la connexion externe et copie le package depuis la connexion externe vers votre référentiel. Sans le remplacement de la source, le client Cargo récupérera directement le package en fonction de la configuration de votre
Cargo.toml
fichier dans votre projet. Si une dépendance n'est pas marquée par unregistry=
, le client Cargo la récupérera directement depuis crates.io sans communiquer avec votre CodeArtifact dépôt.my_registry
Note
Si vous commencez à utiliser le remplacement de source, puis que vous mettez à jour votre fichier de configuration pour ne pas utiliser le remplacement de source, vous risquez de rencontrer des erreurs. Le scénario inverse peut également entraîner des erreurs. Il est donc recommandé d'éviter de modifier la configuration de votre projet.
Installation de caisses de chargement
Utilisez les procédures suivantes pour installer les caisses Cargo depuis un CodeArtifact dépôt ou depuis crates.io.
Installez les caisses Cargo à partir de CodeArtifact
Vous pouvez utiliser la CLI Cargo (cargo
) pour installer rapidement une version spécifique d'une caisse Cargo à partir de votre CodeArtifact référentiel.
Pour installer des caisses Cargo à partir d'un CodeArtifact référentiel avec cargo
Si ce n'est pas le cas, suivez les étapes décrites Configurer et utiliser Cargo avec CodeArtifact pour configurer la
cargo
CLI afin d'utiliser votre CodeArtifact référentiel avec les informations d'identification appropriées.-
Utilisez la commande suivante pour installer les caisses Cargo à partir de CodeArtifact :
cargo add my_cargo_package@
1.0.0
Pour plus d'informations, voir Ajouter une cargaison
dans The Cargo Book.
Publication de caisses Cargo sur CodeArtifact
Utilisez la procédure suivante pour publier des caisses Cargo dans un CodeArtifact référentiel à l'aide de la cargo
CLI.
Si ce n'est pas le cas, suivez les étapes décrites Configurer et utiliser Cargo avec CodeArtifact pour configurer la
cargo
CLI afin d'utiliser votre CodeArtifact référentiel avec les informations d'identification appropriées.-
Utilisez la commande suivante pour publier les caisses Cargo dans un CodeArtifact référentiel :
cargo publish
Pour plus d'informations, consultez la section Cargo Publish
dans The Cargo Book.