

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.

# Mise en route à l'aide de la console
<a name="getting-started-console"></a>

 Exécutez les étapes suivantes pour commencer à CodeArtifact utiliser le AWS Management Console. Ce guide utilise le gestionnaire de `npm` packages. Si vous utilisez un autre gestionnaire de packages, vous devrez modifier certaines des étapes suivantes.

1. Connectez-vous à la AWS CodeArtifact console AWS Management Console et ouvrez-la sur [https://console.aws.amazon.com/codesuite/codeartifact/start](https://console.aws.amazon.com/codesuite/codeartifact/start). Pour de plus amples informations, veuillez consulter [Configuration avec AWS CodeArtifact](get-set-up-for-codeartifact.md).

1.  Choisissez **Créer un référentiel**. 

1.  Dans **Nom du référentiel**, entrez**my-repo**. 

1.  (Facultatif) Dans **Description du référentiel**, entrez une description facultative pour votre référentiel. 

1. Dans **Référentiels publics en amont**, sélectionnez **npm-store** pour créer un référentiel connecté à **npmjs** situé en amont de votre référentiel. `my-repo` 

   CodeArtifact attribue le nom `npm-store` à ce dépôt pour vous. Tous les packages disponibles dans le référentiel en amont `npm-store` sont également disponibles dans son référentiel en aval,`my-repo`. 

1.  Choisissez **Suivant**. 

1.  Dans le **compte AWS**, sélectionnez **Ce compte AWS**.

1.  Dans **Nom de domaine**, entrez**my-domain**. 

1.  Développez **Additional configuration (Configuration supplémentaire)**. 

1.  Vous devez utiliser une AWS KMS key (clé KMS) pour chiffrer tous les actifs de votre domaine. Vous pouvez utiliser une Clé gérée par AWS ou une clé KMS que vous gérez : 
   +  Choisissez la **clé gérée par AWS** si vous souhaitez utiliser la clé par défaut Clé gérée par AWS. 
   +  Choisissez **Clé gérée par le client** si vous souhaitez utiliser une clé KMS que vous gérez. Pour utiliser une clé KMS que vous gérez, dans **ARN de la clé gérée par le client**, recherchez et choisissez la clé KMS. 

    Pour plus d'informations, consultez [Clé gérée par AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)la section « [Clé gérée par le client](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) » dans le *guide du AWS Key Management Service développeur*. 

1.  Choisissez **Suivant**. 

1.  Dans **Réviser et créer**, passez en revue ce qui CodeArtifact est créé pour vous. 
   +  **Le flux de packages** montre comment `my-domain` et `npm-store` sont liés. `my-repo` 
   +  **Étape 1 : Créer un référentiel** affiche des détails sur `my-repo` et`npm-store`. 
   +  **Étape 2 : Sélectionnez le domaine** pour afficher les détails sur`my-domain`. 

    Lorsque vous êtes prêt, choisissez **Create repository**. 

1.  **Sur la page **my-repo**, choisissez **Afficher les instructions de connexion**, puis choisissez npm.** 

1.  Utilisez le AWS CLI pour exécuter la `login` commande indiquée sous **Configurer votre client npm à l'aide de cette AWS CLI CodeArtifact commande**.

   ```
   aws codeartifact login --tool npm --repository my-repo --domain my-domain --domain-owner 111122223333
   ```

   Vous devriez recevoir un message confirmant la réussite de votre connexion.

   ```
   Successfully configured npm to use AWS CodeArtifact repository https://my-domain-111122223333.d.codeartifact.us-east-2.amazonaws.com/npm/my-repo/
   Login expires in 12 hours at 2020-10-08 02:45:33-04:00
   ```

   Si le message d'erreur s'affiche`Could not connect to the endpoint URL`, assurez-vous que votre région AWS CLI est configurée et que le **nom de votre région par défaut** est défini sur la même région que celle dans laquelle vous avez créé votre référentiel. Consultez [Configuration de l'interface de ligne de commande AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html).

   Pour plus d’informations, consultez [Configurer et utiliser npm avec CodeArtifact](npm-auth.md).

1.  Utilisez la CLI npm pour installer un package npm. Par exemple, pour installer le populaire package npm`lodash`, utilisez la commande suivante. 

   ```
   npm install lodash
   ```

1.  Retournez à la CodeArtifact console. Si votre dépôt **my-repo** est ouvert, actualisez la page. Sinon, dans le volet de navigation, choisissez **Repositories**, puis **my-repo**. 

    Sous **Packages**, vous devriez voir la bibliothèque npm, ou le package, que vous avez installé. Vous pouvez choisir le nom du package pour voir sa version et son statut. Vous pouvez choisir sa dernière version pour afficher les détails du package tels que les dépendances, les actifs, etc. 
**Note**  
 Il peut y avoir un délai entre le moment où vous installez le package et le moment où il est ingéré dans votre dépôt. 

1.  Pour éviter d'autres AWS frais, supprimez les ressources que vous avez utilisées au cours de ce didacticiel : 
**Note**  
Vous ne pouvez pas supprimer un domaine qui contient des référentiels. Vous devez donc le supprimer `npm-store` avant `my-repo` de procéder à la suppression`my-domain`.

   1.  Dans le volet de navigation, sélectionnez **Repositories.** 

   1.  Choisissez **npm-store**, choisissez **Supprimer**, puis suivez les étapes pour supprimer le référentiel. 

   1.  Choisissez **my-repo**, choisissez **Delete**, puis suivez les étapes pour supprimer le référentiel. 

   1.  Dans le volet de navigation, sélectionnez **Domains**. 

   1.  Choisissez **mon-domaine**, choisissez **Supprimer**, puis suivez les étapes pour supprimer le domaine. 