Migrer du contenu local ou non versionné vers AWS CodeCommit

Pour créer et configurer un utilisateur IAM pour accéder CodeCommit

1. Créez un compte Amazon Web Services en accédant à http://aws.amazon.com et en choisissant S'inscrire.

2. Créez un utilisateur IAM ou utilisez-en un existant dans votre compte Amazon Web Services. Assurez-vous de disposer d'un ID de clé d'accès et d'une clé d'accès secrète associés à cet utilisateur IAM. Pour plus d'informations, consultez Création d'un utilisateur IAM dans votre compte Amazon Web Services.

   Note

   CodeCommit nécessite AWS Key Management Service. Si vous utilisez un utilisateur IAM existant, assurez-vous qu'aucune politique ne lui interdit expressément les AWS KMS actions requises par CodeCommit. Pour plus d’informations, consultez AWS KMS et chiffrement.

3. Connectez-vous au Console de gestion AWS et ouvrez la console IAM à https://console.aws.amazon.com/iam/ l'adresse.

4. Dans la console IAM, dans le volet de navigation, choisissez Utilisateurs, puis choisissez l'utilisateur IAM que vous souhaitez configurer pour CodeCommit l'accès.

5. Sous l'onglet Autorisations, choisissez Ajouter des autorisations.

6. Pour Accorder des autorisations, choisissez Attacher directement les stratégies existantes.

7. Dans la liste des politiques, sélectionnez AWSCodeCommitPowerUser ou une autre politique gérée pour CodeCommit l'accès. Pour plus d’informations, consultez AWS politiques gérées pour CodeCommit.

   Après avoir sélectionné la politique que vous souhaitez joindre, choisissez Next : Review pour consulter la liste des politiques à associer à l'utilisateur IAM. Si la liste est correcte, choisissez Add permissions.

   Pour plus d'informations sur les politiques CodeCommit gérées et le partage de l'accès aux référentiels avec d'autres groupes et utilisateurs, consultez Partager un référentiel etAuthentification et contrôle d'accès pour AWS CodeCommit.

Pour installer et configurer AWS CLI

1. Sur votre ordinateur local, téléchargez et installez le AWS CLI. Il s'agit d'une condition préalable à l'interaction CodeCommit depuis la ligne de commande. Nous vous recommandons d'installer AWS CLI la version 2. Il s'agit de la version majeure la plus récente de AWS CLI et prend en charge toutes les dernières fonctionnalités. C'est la seule version du AWS CLI qui prend en charge l'utilisation d'un compte root, d'un accès fédéré ou d'informations d'identification temporaires avecgit-remote-codecommit.

   Pour plus d'informations, consultez la section Configuration à l'aide de l'interface de ligne de AWS commande.

   Note

   CodeCommit fonctionne uniquement avec AWS CLI les versions 1.7.38 et ultérieures. Il est recommandé d'installer ou de mettre AWS CLI à niveau la dernière version disponible. Pour déterminer la version AWS CLI que vous avez installée, exécutez la aws --version commande.

   Pour mettre à niveau une ancienne version AWS CLI vers la dernière version, voir Installation du AWS Command Line Interface.

2. Exécutez cette commande pour vérifier que les CodeCommit commandes du AWS CLI sont installées.

   aws codecommit help

   Cette commande renvoie une liste de CodeCommit commandes.

3. Configurez le AWS CLI avec un profil à l'aide de la configure commande, comme suit :.

   aws configure

   Lorsque vous y êtes invité, spécifiez la clé AWS d'accès et la clé d'accès AWS secrète de l'utilisateur IAM à utiliser avec CodeCommit. Veillez également à spécifier l' Région AWS endroit où se trouve le référentiel, par exempleus-east-2. Lorsque vous êtes invité à saisir le format de sortie par défaut, entrez json. Par exemple, si vous configurez un profil pour un utilisateur IAM :

   AWS Access Key ID [None]: Type your IAM user AWS access key ID here, and then press Enter
   AWS Secret Access Key [None]: Type your IAM user AWS secret access key here, and then press Enter
   Default region name [None]: Type a supported region for CodeCommit here, and then press Enter
   Default output format [None]: Type json here, and then press Enter

   Pour plus d'informations sur la création et la configuration de profils à utiliser avec le AWS CLI, consultez les rubriques suivantes :

   • Profils nommés

   • Utilisation d'un rôle IAM dans AWS CLI

   • Définition de la commande

   • Connexion à AWS CodeCommit référentiels avec informations d'identification rotatives

   Pour vous connecter à un référentiel ou à une ressource dans un autre Région AWS, vous devez le reconfigurer AWS CLI avec le nom de région par défaut. Noms de région par défaut pris en charge pour CodeCommit inclure :

   • us-east-2

   • us-east-1

   • eu-west-1

   • us-west-2

   • ap-northeast-1

   • ap-southeast-1

   • ap-southeast-2

   • ap-southeast-3

   • me-central-1

   • eu-central-1

   • ap-northeast-2

   • sa-east-1

   • us-west-1

   • eu-west-2

   • ap-south-1

   • ap-south-1

   • ca-central-1

   • us-gov-west-1

   • us-gov-east-1

   • eu-north-1

   • ap-east-1

   • me-south-1

   • cn-north-1

   • cn-northwest-1

   • eu-south-1

   • ap-northeast-3

   • af-south-1

   • il-central-1

   Pour plus d'informations sur CodeCommit et Région AWS, consultezRégions et points de terminaison de connexion Git. Pour plus d'informations sur l'IAM, les clés d'accès et les clés secrètes, voir Comment obtenir des informations d'identification ? et Gestion des clés d'accès pour les utilisateurs IAM. Pour plus d'informations sur les profils AWS CLI et, voir Profils nommés.

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 Région AWS pour 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 prévoyez 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 (une étiquette d'attribut personnalisée qui vous permet d'organiser et de gérer vos AWS ressources) à votre référentiel. Pour plus d’informations, consultez Marquer les référentiels dans AWS CodeCommit.

7. (Facultatif) Développez la configuration supplémentaire pour spécifier si vous souhaitez utiliser la clé par défaut Clé gérée par AWS ou votre propre 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 Service et 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 de code et suggérer des améliorations et des corrections dans les pull requests. Pour plus d'informations, consultez le guide de l'utilisateur d'Amazon CodeGuru Reviewer .

9. Cliquez sur Créer.

1. Depuis le terminal ou la ligne de commande sur votre ordinateur local, placez-vous dans le répertoire que vous souhaitez utiliser comme source pour votre référentiel.

2. Exécutez la commande suivante pour configurer Git afin qu'il utilise une branche par défaut nommée main :

   git config --local init.defaultBranch main

   Vous pouvez également exécuter cette commande pour définir le nom de votre branche par défaut main pour tous les référentiels nouvellement créés :

   git config --global init.defaultBranch main

3. Exécutez la commande git init pour initialiser le contrôle de version Git dans le répertoire. Cela crée un sous-répertoire .git à la racine du répertoire qui active le suivi du contrôle de version. Le dossier .git contient également toutes les métadonnées requises pour le référentiel.

   git init

4. Vérifiez l'état du répertoire initialisé en exécutant la commande suivante :

   git status

   Ajoutez les fichiers que vous souhaitez ajouter au contrôle de version. Dans ce didacticiel, vous allez exécuter la commande git add avec le spécificateur . pour ajouter tous les fichiers dans ce répertoire. Pour les autres options, consultez la documentation Git.

   git add .

5. Créez une validation pour les fichiers ajoutés avec un message de validation.

   git commit -m "Initial commit"

6. Exécutez la git push commande en spécifiant l'URL et le nom du CodeCommit référentiel de destination et l'--alloption. (Il s'agit de l'URL que vous avez copiée dans Étape 1 : Création d'un CodeCommit référentiel.)

   Par exemple, si vous avez donné un nom à votre référentiel MyFirstRepo et que vous êtes configuré pour utiliser le protocole HTTPS, vous devez exécuter la commande suivante :

   git push https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyFirstRepo --all

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

2. Dans Référentiels, choisissez le nom du référentiel (par exempleMyFirstRepository) dans la liste.

3. Affichez les fichiers dans le référentiel pour les branches, les URL du clone, les paramètres, etc.

Création d'une stratégie gérée par le client pour votre référentiel

1. Connectez-vous au Console de gestion AWS et ouvrez la console IAM à https://console.aws.amazon.com/iam/ l'adresse.

2. Dans la zone de navigation de Dashboard, choisissez Stratégies, puis Créer une stratégie.

3. Sur la page Créer une politique, choisissez Importer une stratégie gérée.

4. Sur la page Importer des politiques gérées, dans Politiques de filtrage, entrezAWSCodeCommitPowerUser. Cliquez sur le bouton à côté du nom de la politique, puis choisissez Importer.

5. Sur la page Créer une politique, choisissez JSON. Remplacez la partie « * » de la Resource ligne réservée aux CodeCommit actions par le nom de ressource Amazon (ARN) du CodeCommit référentiel, comme indiqué ici :

   "Resource": [
    "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo"
    ]

   Astuce

   Pour trouver l'ARN du CodeCommit référentiel, accédez à la CodeCommit console, choisissez le nom du référentiel dans la liste, puis choisissez Paramètres. Pour plus d’informations, consultez Afficher les détails du référentiel.

   Si vous souhaitez que cette stratégie s'applique à plusieurs référentiels, ajoutez chaque référentiel en tant que ressource en spécifiant son ARN. Incluez une virgule entre chaque instruction de ressource, comme illustré ici :

   "Resource": [
    "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo",
    "arn:aws:codecommit:us-east-2:111111111111:MyOtherDemoRepo"
    ]

   Lorsque vous avez terminé les modifications, choisissez Politique de révision.

6. Sur la page Réviser la politique, dans Nom, entrez un nouveau nom pour la stratégie (par exemple,AWSCodeCommitPowerUser-MyDemoRepo). Fournissez éventuellement une description de cette politique.

7. Choisissez Create Policy (Créer une politique).

1. Connectez-vous au Console de gestion AWS et ouvrez la console IAM à https://console.aws.amazon.com/iam/ l'adresse.

2. Dans la zone de navigation de Dashboard, sélectionnez Groupes, puis Créer un groupe.

3. Sur la page Définir un nom de groupe, dans la zone Nom du groupe, saisissez un nom pour le groupe (par exemple, MyDemoRepoGroup), puis sélectionnez Étape suivante. Vous pouvez inclure le nom du référentiel comme partie du nom du groupe.

   Note

   Ce nom doit être unique sur l'ensemble d'un compte Amazon Web Services.

4. Cochez la case à côté de la politique gérée par le client que vous avez créée dans la section précédente (par exemple, AWSCodeCommitPowerUser-MyDemoRepo).

5. Sur la page Vérifier, choisissez Créer un groupe. IAM crée ce groupe avec les politiques spécifiées déjà associées. Le groupe apparaît dans la liste des groupes associés à votre compte Amazon Web Services.

6. Choisissez votre groupe dans la liste.

7. Sur la page récapitulative du groupe, sélectionnez l'onglet Utilisateurs, puis Ajouter des utilisateurs au groupe. Dans la liste qui répertorie tous les utilisateurs associés à votre compte Amazon Web Services, cochez les cases à côté des utilisateurs auxquels vous souhaitez autoriser l'accès au CodeCommit référentiel, puis choisissez Ajouter des utilisateurs.

   Astuce

   Vous pouvez utiliser la zone de recherche pour trouver rapidement des utilisateurs par leur nom.

8. Lorsque vous avez ajouté vos utilisateurs, fermez la console IAM.

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ù le référentiel a été créé. Les référentiels sont spécifiques à un Région AWS. Pour plus d’informations, consultez Régions et points de terminaison de connexion Git.

3. Sur la page Repositories (Référentiels), choisissez le référentiel à partager.

4. Dans Clone URL (URL de clone), choisissez le protocole que vos utilisateurs doivent employer. Cette fonction copie l'URL de clone pour le protocole de connexion.

5. Envoyez à vos utilisateurs l'URL du clone ainsi que toute autre instruction, telle que l'installation de AWS CLI, la configuration d'un profil ou l'installation de Git. Assurez-vous d'inclure les informations de configuration pour le protocole de connexion (par exemple, HTTPS).