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.
# Configuration avec AWS CodeArtifact
Si vous êtes déjà inscrit à Amazon Web Services (AWS), vous pouvez commencer à utiliser AWS CodeArtifact dès maintenant. Vous pouvez ouvrir la CodeArtifact console, choisir **Créer un domaine et un référentiel**, puis suivre les étapes de l'assistant de lancement pour créer votre premier domaine et votre premier référentiel.
Si vous n'êtes pas AWS encore inscrit ou si vous avez besoin d'aide pour créer votre premier domaine et votre premier référentiel, effectuez les tâches suivantes pour configurer votre utilisation CodeArtifact :
**Topics**
+ [Inscrivez-vous pour AWS](get-set-up-sign-up-for-aws.md)
+ [Installez ou mettez à niveau, puis configurez le AWS CLI](get-set-up-install-cli.md)
+ [Approvisionner un utilisateur IAM](get-set-up-provision-user.md)
+ [Installez votre gestionnaire de packages ou votre outil de compilation](getting-started-install-package-manager.md)
# Inscrivez-vous pour AWS
Lorsque vous vous inscrivez à Amazon Web Services (AWS), seuls les services et ressources que vous utilisez vous sont facturés, notamment AWS CodeArtifact.
Si vous en avez déjà un Compte AWS, passez à la tâche suivante,[Installez ou mettez à niveau, puis configurez le AWS CLI](get-set-up-install-cli.md). Si vous n'en avez pas Compte AWS, utilisez la procédure suivante pour en créer un.
**Pour créer un Compte AWS**
1. Ouvrez l'[https://portal.aws.amazon.com/billing/inscription.](https://portal.aws.amazon.com/billing/signup)
1. Suivez les instructions en ligne.
Dans le cadre de la procédure d’inscription, vous recevrez un appel téléphonique ou un SMS et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.
Lorsque vous vous inscrivez à un Compte AWS, un *Utilisateur racine d'un compte AWS*est créé. Par défaut, seul l’utilisateur racine a accès à l’ensemble des Services AWS et des ressources de ce compte. La meilleure pratique de sécurité consiste à attribuer un accès administratif à un utilisateur, et à utiliser uniquement l’utilisateur racine pour effectuer les [tâches nécessitant un accès utilisateur racine](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
# Installez ou mettez à niveau, puis configurez le AWS CLI
Pour appeler CodeArtifact des commandes depuis AWS Command Line Interface (AWS CLI) sur une machine de développement locale, vous devez installer le AWS CLI.
Si une ancienne version est AWS CLI installée, vous devez la mettre à niveau pour que les CodeArtifact commandes soient disponibles. CodeArtifact les commandes sont disponibles dans les AWS CLI versions suivantes :
1. **AWS CLI 1 :** 1.18.77 et versions ultérieures
1. **AWS CLI 2 :** 2.0.21 et versions ultérieures
Pour vérifier la version, utilisez la `aws --version` commande.
**Pour installer et configurer le AWS CLI**
1. Installez ou mettez à niveau le AWS CLI en suivant les instructions de [la section Installation du AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html).
1. Configurez le AWS CLI, à l'aide de la commande **configure**, comme suit.
```
aws configure
```
Lorsque vous y êtes invité, spécifiez la clé AWS d'accès et la clé d'accès AWS secrète de l'utilisateur IAM que vous utiliserez avec CodeArtifact. Lorsque vous êtes invité à saisir le Région AWS nom par défaut, spécifiez la région dans laquelle vous allez créer le pipeline, par exemple`us-east-2`. Lorsque vous êtes invité à saisir le format de sortie par défaut, entrez `json`.
**Important**
Lorsque vous configurez le AWS CLI, vous êtes invité à spécifier un Région AWS. Choisissez l'une des régions prises en charge répertoriées dans [Région et points de terminaison](https://docs.aws.amazon.com/general/latest/gr/codeartifact.html) dans le *Références générales AWS*.
Pour plus d'informations, consultez [Configuration AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) et [gestion des clés d'accès pour les utilisateurs IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingCredentials.html).
1. Pour vérifier l'installation ou la mise à niveau, appelez la commande suivante à partir du AWS CLI.
```
aws codeartifact help
```
En cas de succès, cette commande affiche la liste des CodeArtifact commandes disponibles.
Vous pouvez ensuite créer un utilisateur IAM et lui accorder l'accès à CodeArtifact. Pour de plus amples informations, veuillez consulter [Approvisionner un utilisateur IAM](get-set-up-provision-user.md).
# Approvisionner un utilisateur IAM
Suivez ces instructions pour préparer un utilisateur IAM à l'utiliser CodeArtifact.
**Pour approvisionner un utilisateur IAM**
1. Créez un utilisateur IAM ou utilisez-en un qui est associé à votre Compte AWS. Pour plus d'informations, consultez les [sections Création d'un utilisateur IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html#Using_CreateUser_console) et [Présentation des politiques AWS IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html) dans le Guide de l'utilisateur *IAM*.
1. Accordez à l'utilisateur IAM l'accès à. CodeArtifact
+ **Option 1 :** créer une politique IAM personnalisée. Avec une politique IAM personnalisée, vous pouvez fournir les autorisations minimales requises et modifier la durée de vie des jetons d'authentification. Pour plus d’informations et obtenir des exemples de stratégie, consultez [Exemples de politiques basées sur l'identité pour AWS CodeArtifact](security_iam_id-based-policy-examples.md).
+ **Option 2 :** utilisez la politique `AWSCodeArtifactAdminAccess` AWS gérée. L'extrait suivant montre le contenu de cette politique.
**Important**
Cette politique accorde l'accès à tous CodeArtifact APIs. Nous vous recommandons de toujours utiliser les autorisations minimales requises pour accomplir votre tâche. Pour plus d’informations, consultez [Bonnes pratiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) dans le *Guide de l’utilisateur IAM*.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"codeartifact:*"
],
"Effect": "Allow",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "sts:GetServiceBearerToken",
"Resource": "*",
"Condition": {
"StringEquals": {
"sts:AWSServiceName": "codeartifact.amazonaws.com"
}
}
}
]
}
```
------
**Note**
L'`sts:GetServiceBearerToken`autorisation doit être ajoutée à la politique de rôle ou d'utilisateur IAM. Bien qu'elle puisse être ajoutée à une politique de ressources de CodeArtifact domaine ou de référentiel, l'autorisation n'aura aucun effet sur les politiques de ressources.
L'`sts:GetServiceBearerToken`autorisation est requise pour appeler l' CodeArtifact`GetAuthorizationToken`API. Cette API renvoie un jeton qui doit être utilisé lors de l'utilisation d'un gestionnaire de packages tel que `npm` ou `pip` avec CodeArtifact. Pour utiliser un gestionnaire de packages avec un CodeArtifact référentiel, votre utilisateur ou rôle IAM doit l'autoriser, `sts:GetServiceBearerToken` comme indiqué dans l'exemple de politique précédent.
Si vous n'avez pas installé le gestionnaire de packages ou l'outil de génération que vous comptez utiliser CodeArtifact, consultez[Installez votre gestionnaire de packages ou votre outil de compilation](getting-started-install-package-manager.md).
# Installez votre gestionnaire de packages ou votre outil de compilation
Pour publier ou consommer des packages depuis CodeArtifact, vous devez utiliser un gestionnaire de packages. Il existe différents gestionnaires de packages pour chaque type de package. La liste suivante contient certains gestionnaires de packages que vous pouvez utiliser CodeArtifact. Si ce n'est pas déjà fait, installez les gestionnaires de packages pour le type de package que vous souhaitez utiliser.
+ [Pour npm, utilisez la [CLI npm ou pnpm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).](https://pnpm.io/installation)
+ [Pour Maven, utilisez [Apache Maven (`mvn`)](https://maven.apache.org/install.html) ou Gradle.](https://gradle.org/install/)
+ Pour Python, utilisez [pip](https://pip.pypa.io/en/stable/installation/) pour installer des packages et [twine](https://twine.readthedocs.io/en/stable/#installation) pour publier des packages.
+ Pour NuGet, utilisez le [Toolkit for Visual Studio](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/setup.html) dans Visual Studio ou le [nuget](https://learn.microsoft.com/en-us/nuget/reference/nuget-exe-cli-reference) ou le [ CLIsdotnet](https://learn.microsoft.com/en-us/dotnet/core/install/).
+ Pour les packages [génériques](using-generic.md), utilisez le SDK [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)ou pour publier et télécharger le contenu du package.
## Étapes suivantes
Les prochaines étapes dépendront du ou des types de packages que vous utilisez et de l'état de vos CodeArtifact ressources. CodeArtifact
Si vous débutez CodeArtifact pour vous-même, votre équipe ou votre organisation, consultez la documentation suivante pour obtenir des informations générales de démarrage et de l'aide pour créer les ressources dont vous aurez besoin.
+ [Mise en route à l'aide de la console](getting-started-console.md)
+ [Commencer à utiliser le AWS CLI](getting-started-cli.md)
Si vos ressources ont déjà été créées et que vous êtes prêt à configurer votre gestionnaire de packages pour envoyer des packages vers ou installer des packages depuis un CodeArtifact référentiel, consultez la documentation correspondant à votre type de package ou à votre gestionnaire de packages.
+ [Utilisation CodeArtifact avec npm](using-npm.md)
+ [Utilisation CodeArtifact avec Python](using-python.md)
+ [Utilisation CodeArtifact avec Maven](using-maven.md)
+ [Utilisation CodeArtifact avec NuGet](using-nuget.md)
+ [Utilisation CodeArtifact avec des packages génériques](using-generic.md)