

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.

# Création d'un référentiel
<a name="create-repo"></a>

Comme tous les packages CodeArtifact sont stockés dans [des référentiels](codeartifact-concepts.md#welcome-concepts-repository) CodeArtifact, vous devez en créer un pour pouvoir les utiliser. Vous pouvez créer un référentiel à l'aide de la CodeArtifact console, du AWS Command Line Interface (AWS CLI) ou CloudFormation. Chaque dépôt est associé au AWS compte que vous utilisez lorsque vous le créez. Vous pouvez avoir plusieurs référentiels, qui sont créés et regroupés en [domaines](codeartifact-concepts.md#welcome-concepts-domain). Lorsque vous créez un dépôt, celui-ci ne contient aucun package. Les référentiels sont polyglottes, ce qui signifie qu'un dépôt unique peut contenir tous les types de packages pris en charge.

Pour plus d'informations sur les limites de CodeArtifact service, telles que le nombre maximum de référentiels autorisés dans un seul domaine, consultez[Quotas dans AWS CodeArtifact](service-limits.md). Si vous atteignez le nombre maximum de référentiels autorisés, vous pouvez [supprimer des référentiels](delete-repo.md) pour faire de la place à d'autres. 

Un référentiel peut être associé à un ou plusieurs CodeArtifact référentiels en tant que référentiels en amont. Cela permet à un client du gestionnaire de packages d'accéder aux packages contenus dans plusieurs référentiels à l'aide d'un seul point de terminaison URL. Pour de plus amples informations, veuillez consulter [Utilisation de référentiels en amont dans CodeArtifact](repos-upstream.md).

Pour plus d'informations sur la gestion des CodeArtifact référentiels avec CloudFormation, consultez[Création de CodeArtifact ressources avec AWS CloudFormation](cloudformation-codeartifact.md). 

**Note**  
Après avoir créé un référentiel, vous ne pouvez pas modifier son nom, le AWS compte associé ou le domaine.

**Topics**
+ [Création d'un référentiel (console)](#create-repo-console)
+ [Création d'un référentiel (AWS CLI)](#create-repo-cli)
+ [Création d'un référentiel avec un référentiel en amont](#creating-a-repository-with-an-upstream)

## Création d'un référentiel (console)
<a name="create-repo-console"></a>

1. Ouvrez la AWS CodeArtifact console sur [https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home).

1.  Dans le volet de navigation, choisissez **Repositories**, puis **Create repository**. 

1.  Dans **Nom du référentiel**, entrez le nom de votre référentiel.

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

1.  (Facultatif) Dans **Publier les référentiels en amont**, ajoutez des référentiels intermédiaires qui connectent vos référentiels aux autorités de package telles que Maven Central ou npmjs.com. 

1.  Choisissez **Suivant**. 

1.  Dans le **compte AWS**, choisissez **Ce compte AWS** si vous êtes connecté au compte propriétaire du domaine. Choisissez un **autre compte AWS** si un autre compte AWS possède le domaine.

1.  Dans **Domaine**, choisissez le domaine dans lequel le référentiel sera créé.

    Si le compte ne contient aucun domaine, vous devez en créer un. Entrez le nom du nouveau domaine dans **Nom de domaine**.

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

    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 : 
**Important**  
CodeArtifact ne prend en charge que les [clés KMS symétriques](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#symmetric-cmks). Vous ne pouvez pas utiliser de [clé KMS asymétrique](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html#asymmetric-cmks) pour chiffrer vos CodeArtifact domaines. Pour savoir si une clés KMS est symétrique ou asymétrique, consultez [Identification de clés KMS symétriques et asymétriques](https://docs.aws.amazon.com/kms/latest/developerguide/find-symm-asymm.html).
   +  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és gérées 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. 
   +  **Package Flow** indique comment votre domaine et vos référentiels sont connectés.
   +  **L'étape 1 : Créer un référentiel** affiche des détails sur le référentiel et les référentiels en amont facultatifs qui seront créés. 
   +  **Étape 2 : Sélectionnez le domaine** pour afficher les détails sur`my_domain`. 

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

## Création d'un référentiel (AWS CLI)
<a name="create-repo-cli"></a>

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 --description "My new repository"
```

Exemple de sortie :

```
{
    "repository": {
        "name": "my_repo",
        "administratorAccount": "123456789012",
        "domainName": "my_domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:region-id:111122223333:repository/my_domain/my_repo",
        "description": "My new repository",
        "upstreams": "[]",
        "externalConnections"" "[]"
    }
}
```

Un nouveau dépôt ne contient aucun package. Chaque dépôt est associé au AWS compte auprès duquel vous êtes authentifié lors de sa création.

### Création d'un référentiel avec des balises
<a name="create-repo-cli-tags"></a>

Pour créer un référentiel avec des balises, ajoutez le `--tags` paramètre à votre `create-domain` commande.

```
aws codeartifact create-repository --domain my_domain --domain-owner 111122223333 --repository my_repo --tags key=k1,value=v1 key=k2,value=v2
```

## Création d'un référentiel avec un référentiel en amont
<a name="creating-a-repository-with-an-upstream"></a>

Vous pouvez spécifier un ou plusieurs référentiels en amont lorsque vous créez un référentiel. 

```
aws codeartifact create-repository --domain my_domain --domain-owner 111122223333 --repository my_repo \
  --upstreams repositoryName=my-upstream-repo --repository-description "My new repository"
```

Exemple de sortie :

```
{
    "repository": {
        "name": "my_repo",
        "administratorAccount": "123456789012",
        "domainName": "my_domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:region-id:111122223333:repository/my_domain/my_repo",
        "description": "My new repository",
        "upstreams": [
            {
                "repositoryName": "my-upstream-repo"
            }
        ],
        "externalConnections"" "[]"
    }
}
```

**Note**  
Pour créer un référentiel avec un référentiel en amont, vous devez être autorisé à effectuer l'`AssociateWithDownstreamRepository`action sur le référentiel en amont.

Pour ajouter un amont à un référentiel après sa création, consultez [Ajouter ou supprimer des référentiels en amont (console)](repo-upstream-add.md#repo-upstream-add-console) et[Ajouter ou supprimer des référentiels en amont ()AWS CLI](repo-upstream-add.md#repo-upstream-add-cli).