View a markdown version of this page

Création d’un référentiel - CodeArtifact
Création d'un référentiel (console)Créez un référentiel (AWS CLI)Création d'un référentiel avec un référentiel en amont

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

Étant donné que tous les packages CodeArtifact sont stockés dans des référentiels CodeArtifact, vous devez en créer un pour 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 référentiel est associé au AWS compte que vous utilisez lors de sa création. Vous pouvez disposer de plusieurs référentiels, qui sont créés et regroupés dans des domaines. Lorsque vous créez un référentiel, il ne contient aucun package. Les dépôts sont polyglottes, ce qui signifie qu'un seul dépôt peut contenir des packages de n'importe quel type 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 dépôts autorisés, vous pouvez supprimer des référentiels pour faire de la place.

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

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

Note

Une fois que vous avez créé un référentiel, vous ne pouvez pas modifier son nom, son AWS compte associé ou son domaine.

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

  1. Ouvrez la AWS CodeArtifact console à l'adresse https://console.aws.amazon.com/codesuite/codeartifact/home.

  2. Dans le volet de navigation, choisissez Référentiels, puis choisissez Créer un référentiel.

  3. Dans Nom du référentiel, entrez un nom pour 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 des référentiels en amont, ajoutez des référentiels intermédiaires qui connectent vos référentiels aux autorités en matière de packages telles que Maven Central ou npmjs.com.

  6. Choisissez Suivant.

  7. Dans le compte AWS, sélectionnez Ce compte AWS si vous êtes connecté au compte propriétaire du domaine. Choisissez un autre compte AWS si le domaine appartient à un autre compte AWS.

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

    S'il n'y a aucun domaine dans le compte, 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é KMS 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. Vous ne pouvez pas utiliser de clé KMS asymétrique 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.

    • Choisissez la clé gérée 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 l'ARN de 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 la 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.

    • Le flux de packages montre comment votre domaine et vos référentiels sont connectés.

    • Étape 1 : Créer un référentiel affiche des informations 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 Créer un référentiel.

Créez 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 référentiel 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 élément en 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.