Création d'un référentiel

Comme tous les packages CodeArtifact sont stockés dans des référentiels 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 AWS 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. 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, consultezQuotas dans AWS CodeArtifact. Si vous atteignez le nombre maximum de référentiels autorisés, vous pouvez supprimer des référentiels 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 URL point de terminaison. Pour plus d’informations, consultez Utilisation de référentiels en amont dans CodeArtifact.

Pour plus d'informations sur la gestion des CodeArtifact référentiels avec CloudFormation, consultezCréation de CodeArtifact ressources avec AWS CloudFormation.

Note

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

Création d'un référentiel (console)

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

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

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

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

5. (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.

6. Choisissez Suivant.

7. Dans le AWScompte, choisissez Ce AWS compte si vous êtes connecté au compte propriétaire du domaine. Choisissez AWSCompte différent si un autre AWS compte possède le domaine.

8. 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 (KMSclé) pour chiffrer tous les actifs de votre domaine. Vous pouvez utiliser une Clé gérée par AWS ou une KMS clé que vous gérez :

   Important

   CodeArtifact ne prend en charge que les KMSclés symétriques. Vous ne pouvez pas utiliser de KMSclé asymétrique pour chiffrer vos CodeArtifact domaines. Pour savoir si une KMS clé est symétrique ou asymétrique, consultez la section Identification des clés symétriques et asymétriques. KMS

   • Choisissez la clé AWS gérée 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 KMS clé que vous gérez. Pour utiliser une KMS clé que vous gérez, dans Clé gérée par le client ARN, recherchez et choisissez la KMS clé.

   Pour plus d'informations, consultez Clés gérées par AWSla section « clé gérée par le client » dans le guide du AWS Key Management Service développeur.

9. Choisissez Suivant.

10. 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 surmy_domain.

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

Création d'un référentiel (AWS CLI)

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

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

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'AssociateWithDownstreamRepositoryaction 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) etAjouter ou supprimer des référentiels en amont ()AWS CLI.