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.
# Commencer avec CodeArtifact
Dans ce didacticiel de mise en route, vous CodeArtifact devez créer les éléments suivants :
+ Un domaine appelé`my-domain`.
+ Un dépôt appelé `my-repo` qui est contenu dans`my-domain`.
+ Un dépôt appelé `npm-store` qui est contenu dans`my-domain`. `npm-store`Dispose d'une connexion externe au référentiel public npm. Cette connexion est utilisée pour ingérer un package npm dans le `my-repo` référentiel.
Avant de commencer ce didacticiel, nous vous recommandons de le consulter CodeArtifact [AWS CodeArtifact concepts](codeartifact-concepts.md).
**Note**
Ce didacticiel nécessite que vous créiez des ressources qui peuvent entraîner des frais sur votre compte AWS . Pour en savoir plus, consultez [PricingCodeArtifact ](https://aws.amazon.com/codeartifact/pricing/) (Tarification).
**Topics**
+ [Prérequis](#getting-started-prerequisites)
+ [Mise en route à l'aide de la console](getting-started-console.md)
+ [Commencer à utiliser le AWS CLI](getting-started-cli.md)
## Prérequis
Vous pouvez terminer ce didacticiel en utilisant le AWS Management Console ou le AWS Command Line Interface (AWS CLI). Pour suivre le didacticiel, vous devez d'abord remplir les prérequis suivants :
+ Suivez les étapes de [Configuration avec AWS CodeArtifact](get-set-up-for-codeartifact.md).
+ Installez la CLI npm. Pour plus d'informations, consultez la section [Téléchargement et installation de Node.js et de npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) dans la documentation de npm.
# Mise en route à l'aide de la console
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.
# Commencer à utiliser le AWS CLI
Exécutez les étapes suivantes pour commencer à CodeArtifact utiliser le AWS Command Line Interface (AWS CLI). Pour de plus amples informations, veuillez consulter [Installez ou mettez à niveau, puis configurez le AWS CLI](get-set-up-install-cli.md). Ce guide utilise le gestionnaire de `npm` packages. Si vous utilisez un autre gestionnaire de packages, vous devrez modifier certaines des étapes suivantes.
1. Utilisez le AWS CLI pour exécuter la **create-domain** commande.
```
aws codeartifact create-domain --domain my-domain
```
Les données au format JSON apparaissent dans la sortie avec des informations sur votre nouveau domaine.
```
{
"domain": {
"name": "my-domain",
"owner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
"status": "Active",
"createdTime": "2020-10-07T15:36:35.194000-04:00",
"encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
"repositoryCount": 0,
"assetSizeBytes": 0
}
}
```
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).
1. Utilisez la **create-repository** commande pour créer un référentiel dans votre domaine.
```
aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository my-repo
```
Les données au format JSON apparaissent dans la sortie avec des informations sur votre nouveau dépôt.
```
{
"repository": {
"name": "my-repo",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
"upstreams": [],
"externalConnections": []
}
}
```
1. Utilisez la **create-repository** commande pour créer un dépôt en amont pour votre `my-repo` dépôt.
```
aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository npm-store
```
Les données au format JSON apparaissent dans la sortie avec des informations sur votre nouveau dépôt.
```
{
"repository": {
"name": "npm-store",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
"upstreams": [],
"externalConnections": []
}
}
```
1. Utilisez la **associate-external-connection** commande pour ajouter une connexion externe au référentiel public npm à votre `npm-store` référentiel.
```
aws codeartifact associate-external-connection --domain my-domain --domain-owner 111122223333 --repository npm-store --external-connection "public:npmjs"
```
Les données au format JSON apparaissent dans la sortie avec des informations détaillées sur le référentiel et sa nouvelle connexion externe.
```
{
"repository": {
"name": "npm-store",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
"upstreams": [],
"externalConnections": [
{
"externalConnectionName": "public:npmjs",
"packageFormat": "npm",
"status": "AVAILABLE"
}
]
}
}
```
Pour de plus amples informations, veuillez consulter [Connect un CodeArtifact dépôt à un dépôt public](external-connection.md).
1. Utilisez la **update-repository** commande pour associer le `npm-store` référentiel en tant que référentiel en amont au `my-repo` référentiel.
```
aws codeartifact update-repository --repository my-repo --domain my-domain --domain-owner 111122223333 --upstreams repositoryName=npm-store
```
Les données au format JSON apparaissent dans la sortie avec des informations sur votre dépôt mis à jour, y compris son nouveau référentiel en amont.
```
{
"repository": {
"name": "my-repo",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
"upstreams": [
{
"repositoryName": "npm-store"
}
],
"externalConnections": []
}
}
```
Pour de plus amples informations, veuillez consulter [Ajouter ou supprimer des référentiels en amont ()AWS CLI](repo-upstream-add.md#repo-upstream-add-cli).
1. Utilisez la **login** commande pour configurer votre gestionnaire de packages npm avec votre `my-repo` référentiel.
```
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
```
Pour de plus amples informations, veuillez consulter [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. Utilisez la **list-packages** commande pour afficher le package que vous venez d'installer dans votre `my-repo` dépôt.
**Note**
Il peut y avoir un délai entre la fin de la commande d'`npm install`installation et le moment où le package est visible dans votre dépôt. Pour plus de détails sur la latence typique lors de la récupération de packages depuis des référentiels publics, consultez. [Latence de connexion externe](external-connection-requesting-packages.md#external-connection-latency)
```
aws codeartifact list-packages --domain my-domain --repository my-repo
```
Les données au format JSON apparaissent dans la sortie avec le format et le nom du package que vous avez installé.
```
{
"packages": [
{
"format": "npm",
"package": "lodash"
}
]
}
```
Vous disposez désormais de trois CodeArtifact ressources :
+ Le domaine`my-domain`.
+ Le référentiel `my-repo` contenu dans`my-domain`. Ce référentiel dispose d'un package npm.
+ Le référentiel `npm-store` contenu dans`my-domain`. Ce référentiel dispose d'une connexion externe au référentiel public npm et est associé en tant que référentiel en amont au `my-repo` référentiel.
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. Utilisez la **delete-repository** commande pour supprimer le `npm-store` référentiel.
```
aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository my-repo
```
Les données au format JSON apparaissent dans la sortie avec des informations sur le référentiel supprimé.
```
{
"repository": {
"name": "my-repo",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
"upstreams": [
{
"repositoryName": "npm-store"
}
],
"externalConnections": []
}
}
```
1. Utilisez la **delete-repository** commande pour supprimer le `npm-store` référentiel.
```
aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository npm-store
```
Les données au format JSON apparaissent dans la sortie avec des informations sur le référentiel supprimé.
```
{
"repository": {
"name": "npm-store",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
"upstreams": [],
"externalConnections": [
{
"externalConnectionName": "public:npmjs",
"packageFormat": "npm",
"status": "AVAILABLE"
}
]
}
}
```
1. Utilisez la **delete-domain** commande pour supprimer le `my-domain` référentiel.
```
aws codeartifact delete-domain --domain my-domain --domain-owner 111122223333
```
Les données au format JSON apparaissent dans la sortie avec des informations sur le domaine supprimé.
```
{
"domain": {
"name": "my-domain",
"owner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
"status": "Deleted",
"createdTime": "2020-10-07T15:36:35.194000-04:00",
"encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
"repositoryCount": 0,
"assetSizeBytes": 0
}
}
```