Clonage d'un dépôt Git existant dans un dépôt source

Vous pouvez cloner un dépôt Git existant vers un référentiel source vide sur Amazon CodeCatalyst. Il s'agit d'un moyen rapide de démarrer CodeCatalyst avec du code précédemment hébergé dans un autre fournisseur de dépôt Git. Vous pouvez cloner le contenu du référentiel en créant un clone miroir, puis en poussant le miroir vers CodeCatalyst. Sinon, si vous avez un dépôt local du référentiel dont vous souhaitez ajouter le contenu CodeCatalyst, vous pouvez ajouter le référentiel CodeCatalyst source en tant qu'autre répertoire distant au dépôt local, puis le transférer vers le référentiel source vide. Les deux approches sont également valables. L'utilisation d'un clone miroir permet non seulement de cartographier les branches, mais également de cartographier toutes les références. Il s'agit d'un moyen simple et propre de créer une copie de travail du référentiel dans CodeCatalyst. L'ajout d'une télécommande à un dépôt local pointant vers un dépôt CodeCatalyst source vide ajoutera le contenu du référentiel CodeCatalyst, mais vous permettra également d'effectuer des push depuis le dépôt local vers le référentiel CodeCatalyst source et le référentiel distant Git d'origine. Cela peut être utile si vous souhaitez conserver le code dans différents référentiels distants, mais cela peut entraîner des conflits si d'autres développeurs valident le code sur une seule des télécommandes.

Les procédures suivantes utilisent des commandes Git de base pour accomplir cette tâche. Il existe de nombreuses manières d'accomplir des tâches dans Git, notamment le clonage. Pour plus d'informations, consultez la documentation Git.

Important

Vous devez créer un référentiel vide CodeCatalyst avant de pouvoir y cloner du contenu. Vous devez également disposer d'un jeton d'accès personnel. Pour plus d’informations, consultez Pour créer un référentiel source vide et Créez un jeton d'accès personnel.

À utiliser git clone --mirror pour cloner un dépôt Git existant dans CodeCatalyst

1. Dans la CodeCatalyst console, accédez au projet dans lequel vous avez créé un référentiel vide.

2. Sur la page de résumé de votre projet, choisissez le référentiel vide dans la liste, puis choisissez Afficher le référentiel. Dans le volet de navigation, vous pouvez également choisir Code, puis Référentiels sources. Choisissez le nom du référentiel vide dans la liste des référentiels sources du projet.

3. Copiez le HTTPS clone URL du dépôt vide. Vous en aurez besoin pour transférer le clone miroir. Par exemple, si vous avez nommé le référentiel source MyExampleRepo dans le MyExampleProject projet dans l' ExampleCorp espace et que votre nom d'utilisateur est le suivant LiJuan, votre clone URL peut ressembler à ce qui suit :

   https://[e-mail]/v1/ExampleCorp/MyExampleProject/MyExampleRepo

4. Dans une ligne de commande ou une fenêtre de terminal, utilisez la git clone --mirror commande pour créer un clone miroir du dépôt Git dans lequel vous souhaitez effectuer le clonage CodeCatalyst. Par exemple, si vous souhaitez créer un clone miroir du référentiel codecatalyst-blueprints dans GitHub, vous devez entrer la commande suivante :

   git clone --mirror https://github.com/aws/codecatalyst-blueprints.git

5. Placez-vous dans le répertoire où vous avez créé le clone.

   cd codecatalyst-blueprints.git

6. Exécutez la git push commande en spécifiant le nom URL et le nom du référentiel CodeCatalyst source de destination ainsi que l'--alloption. (Il s'agit de celui URL que vous avez copié à l'étape 3.) Par exemple :

   git push https://[e-mail]/v1/ExampleCorp/MyExampleProject/MyExampleRepo --all

Pour ajouter une télécommande et transférer un dépôt local dans CodeCatalyst

1. Dans la CodeCatalyst console, accédez au projet dans lequel vous avez créé un référentiel vide.

2. Sur la page de résumé de votre projet, choisissez le référentiel vide dans la liste, puis choisissez Afficher le référentiel. Dans le volet de navigation, vous pouvez également choisir Code, puis Référentiels sources. Choisissez le nom du référentiel vide dans la liste des référentiels sources du projet.

3. Copiez le HTTPS clone URL du dépôt vide. Vous en aurez besoin pour transférer le clone miroir. Par exemple, si vous avez nommé le référentiel source MyExampleRepo dans le MyExampleProject projet dans l' ExampleCorp espace et que votre nom d'utilisateur est le suivant LiJuan, votre clone URL peut ressembler à ce qui suit :

   https://[e-mail]/v1/ExampleCorp/MyExampleProject/MyExampleRepo

4. Dans une ligne de commande ou une fenêtre de terminal, remplacez les répertoires par le dépôt local vers lequel vous souhaitez envoyer le message. CodeCatalyst

5. Exécutez la commande git remote -v pour voir les télécommandes existantes pour le dépôt local. Par exemple, si vous clonez un dépôt local d'un AWS CodeCommit dépôt nommé MyDemoRepo dans la région USA Est (Ohio), le résultat de votre commande peut ressembler à ceci :

   origin  https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch)
   origin  https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push) 

   Copiez la télécommande URL si vous souhaitez continuer à utiliser le référentiel.

6. Utilisez la git remote remove commande pour supprimer le CodeCommit dépôt URLs pour fetch et push pour origin :

   git remote remove origin

7. Utilisez la commande git remote add pour ajouter le dépôt CodeCatalyst source en URL tant que source à récupérer et à envoyer à distance pour votre dépôt local. Par exemple :

   git remote add origin https://[e-mail]/v1/ExampleCorp/MyExampleProject/MyExampleRepo

   Cela remplace le CodeCommit dépôt push URL par le dépôt CodeCatalyst sourceURL, mais ne modifie pas le fetchURL. Ainsi, si vous réexécutez la commande git remote -v, vous verrez que vous êtes en train d'extraire (récupérer) du code depuis le dépôt CodeCommit distant, mais que vous êtes configuré pour transférer les modifications de votre dépôt local vers le CodeCatalyst dépôt source :

   origin  https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch)
   origin  https://[e-mail]/v1/ExampleCorp/MyExampleProject/MyExampleRepo (push) 

   Vous pouvez éventuellement ajouter à nouveau la CodeCommit télécommande URL si vous souhaitez envoyer la git remote set-url commande suivante aux deux référentiels :

   git remote set-url --add --push origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

8. Exécutez la git push commande pour transférer le dépôt local vers toutes les télécommandes push configurées. Vous pouvez également exécuter la git push -u -origin commande en spécifiant l'--alloption permettant de transférer le dépôt local vers les deux référentiels. Par exemple :

   git push -u -origin --all

Astuce

Selon votre version de Git, --all peut ne pas fonctionner pour transférer toutes les branches du dépôt local vers le dépôt vide. Vous devrez peut-être vérifier et pousser chaque branche séparément.