Création d'un AWS CodeCommit référentiel - AWS CodeCommit

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 AWS CodeCommit référentiel

Utilisez la AWS CodeCommit console ou le AWS Command Line Interface (AWS CLI) pour créer un CodeCommit dépôt vide. Pour ajouter des balises à un référentiel après l'avoir créé, consultez Ajout d’une balise à un référentiel.

Ces instructions supposent que vous avez déjà réalisé les étapes de Configuration .

Note

En fonction de votre utilisation, la création ou l'accès à un référentiel peuvent vous être facturés. Pour plus d'informations, consultez la section Tarification sur la page d'informations CodeCommit du produit.

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

Pour créer un CodeCommit référentiel

  1. Ouvrez la CodeCommit console à l'adresse https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Dans le sélecteur de région, choisissez l' Région AWS endroit où vous souhaitez créer le référentiel. Pour plus d’informations, consultez Régions et points de terminaison de connexion Git.

  3. Dans la page Référentiels, choisissez Créer un référentiel.

  4. Sur la page Créer un référentiel, dans Nom de référentiel, saisissez un nom pour le référentiel.

    Note

    Les noms de référentiel sont sensibles à la casse. Le nom doit être unique dans le nom Région AWS de votre compte Amazon Web Services.

  5. (Facultatif) Dans la zone Description, saisissez une description pour le référentiel. Cela peut aider d'autres utilisateurs et vous-même à identifier la fonction du référentiel.

    Note

    Le champ de description affiche Markdown dans la console et accepte tous les caractères HTML et les caractères Unicode valides. Si vous êtes un développeur d'applications qui utilise les BatchGetRepositories API GetRepository or et que vous envisagez d'afficher le champ de description du référentiel dans un navigateur Web, consultez la référence des CodeCommit API.

  6. (Facultatif) Choisissez Ajouter une balise pour ajouter une ou plusieurs balises de référentiel (étiquette d'attribut personnalisée qui vous aide à organiser et à gérer vos AWS ressources) à votre référentiel. Pour plus d’informations, consultez Marquage des référentiels dans AWS CodeCommit.

  7. (Facultatif) Développez la configuration supplémentaire pour indiquer si vous souhaitez utiliser la clé par défaut Clé gérée par AWS ou la clé gérée par le client pour chiffrer et déchiffrer les données de ce référentiel. Si vous choisissez d'utiliser votre propre clé gérée par le client, vous devez vous assurer qu'elle est disponible Région AWS là où vous créez le référentiel et que la clé est active. Pour plus d’informations, consultez AWS Key Management Serviceet chiffrement pour les AWS CodeCommit référentiels.

  8. (Facultatif) Sélectionnez Activer Amazon CodeGuru Reviewer pour Java et Python si ce référentiel contient du code Java ou Python et que vous souhaitez que CodeGuru Reviewer l'analyse. CodeGuru Reviewer utilise plusieurs modèles d'apprentissage automatique pour détecter les défauts du code et suggérer des améliorations et des corrections dans les pull requests. Pour plus d'informations, consultez le guide de l'utilisateur Amazon CodeGuru Reviewer.

  9. Choisissez Créer.

Après avoir créé un dépôt, vous pouvez vous y connecter et commencer à ajouter du code via la CodeCommit console ou un client Git local, ou en intégrant votre CodeCommit dépôt à votre IDE favori. Pour plus d’informations, consultez Configuration pour AWS CodeCommit. Vous pouvez également ajouter votre référentiel à un pipeline de diffusion en continu. Pour plus d'informations, consultez Didacticiel : Créer un pipeline simple.

Pour obtenir des informations sur le nouveau CodeCommit référentiel, telles que les URL à utiliser lors du clonage du référentiel, choisissez le nom du référentiel dans la liste ou choisissez simplement le protocole de connexion que vous souhaitez utiliser à côté du nom du référentiel.

Pour partager ce référentiel avec d'autres utilisateurs, vous devez envoyer le lien HTTPS ou SSH à utiliser pour cloner le référentiel. Veillez à ce que ces utilisateurs disposent des autorisations nécessaires pour accéder au référentiel. Pour plus d’informations, consultez Partage d'un référentiel et Authentification et contrôle d'accès pour AWS CodeCommit.

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

Vous pouvez utiliser le AWS CLI pour créer un CodeCommit référentiel. Contrairement à la console, vous pouvez ajouter des balises à un référentiel si vous créez celui-ci à l'aide de l’ AWS CLI.

  1. Assurez-vous que vous avez configuré le AWS CLI avec l' Région AWS endroit où se trouve le référentiel. Pour vérifier la région, exécutez la commande suivante à partir de la ligne de commande ou sur le terminal et vérifiez les informations relatives au nom de la région par défaut.

    aws configure

    Le nom de région par défaut doit correspondre Région AWS à celui du référentiel dans CodeCommit. Pour plus d’informations, consultez Régions et points de terminaison de connexion Git.

  2. Exécutez la commande create-repository en indiquant :

    • Nom qui identifie de manière unique le CodeCommit référentiel (avec l'--repository-nameoption).

      Note

      Ce nom doit être unique sur un compte Amazon Web Services.

    • Un commentaire facultatif sur le CodeCommit dépôt (avec l'--repository-descriptionoption).

    • Une ou plusieurs paires clé-valeur facultatives à utiliser comme balises pour le CodeCommit référentiel (avec l'--tagsoption).

    • Une clé optionnelle gérée par le client à utiliser lors du chiffrement et du déchiffrement de ce référentiel. Tous les référentiels sont chiffrés en transit et au repos à l'aide d'une clé d'entrée. AWS KMS Si aucune clé n'est spécifiée, la clé AWS gérée par défaut aws/codecommit est utilisée.

    Par exemple, pour créer un CodeCommit référentiel nommé MyDemoRepo avec la description "My demonstration repository" et une balise avec une clé nommée Team avec la valeur Saanvi, utilisez cette commande.

    aws codecommit create-repository --repository-name MyDemoRepo --repository-description "My demonstration repository" --tags Team=Saanvi
    Note

    Le champ de description affiche Markdown dans la console et accepte tous les caractères HTML et les caractères Unicode valides. Si vous êtes un développeur d'applications qui utilise les BatchGetRepositories API GetRepository or et que vous envisagez d'afficher le champ de description du référentiel dans un navigateur Web, consultez la référence des CodeCommit API.

  3. Si elle aboutit, cette commande renvoie un objet repositoryMetadata avec les informations suivantes :

    • La description (repositoryDescription).

    • L'ID unique généré par le système (repositoryId).

    • Le nom (repositoryName).

    • L'ID du compte Amazon Web Services associé au CodeCommit référentiel (accountId).

    Voici un exemple de sortie basé sur l'exemple de commande précédent.

    { "repositoryMetadata": { "repositoryName": "MyDemoRepo", "cloneUrlSsh": "ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo", "lastModifiedDate": 1446071622.494, "repositoryDescription": "My demonstration repository", "cloneUrlHttp": "https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo", "defaultBranch": main, "kmsKeyId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "creationDate": 1446071622.494, "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", "Arn": "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo", "accountId": "111111111111" } }
    Note

    Les balises qui ont été ajoutées lorsque le référentiel a été créé ne sont pas renvoyées dans la sortie. Pour afficher une liste des balises associées à un référentiel, exécutez la commande list-tags-for-resource.

  4. Notez le nom et l'ID du CodeCommit dépôt. Vous en avez besoin pour surveiller et modifier les informations relatives au CodeCommit référentiel, en particulier si vous en utilisez AWS CLI.

    Si vous oubliez le nom ou l'ID du , suivez les instructions de Afficher les détails du CodeCommit référentiel (AWS CLI).

Après avoir créé un référentiel, vous pouvez vous connecter à celui-ci et commencer à ajouter du code. Pour plus d’informations, consultez Connexion à un référentiel. Vous pouvez également ajouter votre référentiel à un pipeline de diffusion en continu. Pour plus d'informations, consultez Didacticiel : Créer un pipeline simple.