Mise en route à l'aide de la console

Exécutez les tâches suivantes pour démarrer avec CodeArtifact à l'aide deAWS Management Console. Ce guide utilise lanpmgestionnaire de packages, si vous utilisez un autre gestionnaire de packages, vous devrez modifier certaines des étapes suivantes.

1. Connectez-vous à la consoleAWS Management ConsoleetAWS CodeArtifact Console àhttps://console.aws.amazon.com/codesuite/codeartifact/start. Pour plus d'informations, consultez Configuration avec AWS CodeArtifact.

2. Choisissez Créer un référentiel.

3. DansNom du référentiel, saisissezmy-repo.

4. (Facultatif) DansDescription du référentiel, entrez une description facultative pour votre référentiel.

5. DansRéférentiels publics en amont, sélectionnezNPMpour créer un référentiel connecté ànpmjsqui se trouve en amont de votremy-reporepository.

   CodeArtifact attribue le nomnpm-storevers ce référentiel pour vous. Tous les packages disponibles dans le référentiel en amontnpm-storesont également disponibles dans son référentiel en aval,my-repo.

6. Choisissez Next (Suivant).

7. DansCompte AWS, choisissezCe compte AWS.

8. DansNom de domaine, saisissezmy-domain.

9. Développez Additional configuration (Configuration supplémentaire).

10. Vous devez utiliser uneAWS KMS key(clé KMS) pour crypter tous les actifs de votre domaine. Vous pouvez utiliser uneClé gérée par AWSou une clé KMS que vous gérez :

    • ChoisissezClé gérée par AWSsi vous voulez qu'utilise défautClé gérée par AWS.

    • ChoisissezClés gérées par le clientsi vous souhaitez utiliser une clé KMS que vous gérez. Pour utiliser une clé KMS que vous gérez, dansARN de clé gérée par défaut, recherchez et choisissez la clé KMS.

    Pour plus d'informations, veuillez consulter la rubriqueClé gérée par AWSetClés gérées par le clientdans leAWS Key Management ServiceManuel du développeur.

11. Choisissez Next (Suivant).

12. DansVérifier et créer, passez en revue quoi CodeArtifact crée pour vous.

    • Flux de Packagemontre commentmy-domain,my-repo, etnpm-storesont liées.

    • Étape 1 : Créer un référentielaffiche des informations surmy-repoetnpm-store.

    • Étape 2 : Sélectionnez le domaineaffiche des informations surmy-domain.

    Lorsque vous êtes prêt, choisissezCréer un référentiel.

13. Dans la pagemon-repopage, choisissezAfficher les instructions de connexion, puisnPM.

14. Utilisation de l'AWS CLIpour exécuter lelogincommande illustrée ci-dessousConfigurez votre client npm en utilisant ceciAWS CLI CodeArtifactcommande.

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

    Votre résultat doit confirmer que votre connexion a bien été réussie.

    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 vous recevez l'erreur suivant s'afficheCould not connect to the endpoint URL, assurez-vous que votreAWS CLIest configuré et que votreNom de la région par défautest défini sur la même région que vous avez créé votre référentiel, voirConfiguration de l'interface de ligne de commande AWS.

    Pour plus d'informations, veuillez consulter la rubriqueConfigurer et utiliser npm avec CodeArtifact

15. Utilisez l'interface de ligne de commande npm pour installer un package npm. Par exemple, pour installer le populaire package npmlodash, utilisez la commande suivante.

    npm install lodash

16. Revenez à la CodeArtifact console Si vos recettesmon-repole référentiel est ouvert, actualisez la page. Sinon, dans le volet de navigation, choisissezRéférentiels, puismon-repo.

    UnderPackages, vous devriez voir la bibliothèque ou le package npm que vous avez installé. Vous pouvez choisir le nom du package pour voir sa version et son état. 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 celui où il est ingéré dans votre dépôt.

17. Pour éviter plusAWSfrais, supprimez les ressources que vous avez utilisées pendant ce tutoriel :

    Note

    Vous ne pouvez pas supprimer un domaine contenant des référentiels, vous devez donc supprimermy-repoetnpm-storeavant de supprimermy-domain.

    1. Dans le volet de navigation, choisissezRéférentiels.

    2. ChoisissezNPM, choisissezSupprimer, puis suivez les étapes pour supprimer le référentiel.

    3. Choisissezmon-repo, choisissezSupprimer, puis suivez les étapes pour supprimer le référentiel.

    4. Dans le volet de navigation, choisissezDomaines.

    5. Choisissezmon-domaine, choisissezSupprimer, puis suivez les étapes pour supprimer le domaine.