Utiliser la gestion du code source Git

Secure Source Manager est compatible avec toutes les commandes client Git SCM et intègre des demandes d'extraction et un suivi des problèmes. L'authentification HTTPS et SSH sont toutes deux acceptées.

Rôles requis

Pour obtenir les autorisations nécessaires pour utiliser Git afin d'interagir avec un dépôt Secure Source Manager, demandez à votre administrateur de vous accorder les rôles IAM suivants :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour savoir comment accorder des rôles Secure Source Manager, consultez Contrôle des accès avec IAM et Accorder aux utilisateurs l'accès à l'instance.

Installer Git et Google Cloud CLI

  1. Installez Git.

  2. Si le programme d'installation de Git vous invite à choisir un assistant d'identification, sélectionnez Aucun (ne pas utiliser d'assistant d'identification).

  3. Installez la CLI gcloud.

  4. La version 395.0.0 ou ultérieure de gcloud CLI est requise pour utiliser Git avec HTTPS. Pour vérifier votre version de gcloud CLI, exécutez la commande suivante :

    gcloud --version

  5. Pour mettre à jour gcloud CLI, exécutez la commande suivante.

    gcloud components update

  6. Après la mise à jour, exécutez gcloud init pour initialiser gcloud CLI.

    Pour en savoir plus, consultez la documentation gcloud CLI sur la mise à jour des composants.

Configurer vos identifiants

Si vous vous authentifiez auprès de Secure Source Manager à l'aide d'un fournisseur d'identité tiers et de la fédération d'identité de personnel, vous n'avez pas besoin de suivre les étapes de cette section. Vous devez plutôt créer une configuration de connexion au pool d'identités de personnel.

Ajoutez l'assistant d'authentification Secure Source Manager à votre configuration Git globale en exécutant la commande suivante :

Linux 

git config --global credential.'https://*.*.sourcemanager.dev'.helper gcloud.sh

Il est possible que les versions antérieures de Git ne soient pas compatibles avec les caractères génériques. Pour ajouter l'assistant d'authentification sans caractères génériques, exécutez la commande suivante :

git config --global credential.'https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev'.helper gcloud.sh

Remplacez les éléments suivants :

  • INSTANCE_ID par le nom de votre instance Secure Source Manager.
  • PROJECT_NUMBER par votre numéro de projet. Pour savoir comment trouver votre numéro de projet, consultez Identifier des projets.
  • LOCATION par la région de l'instance. Pour en savoir plus sur les régions, consultez la section Emplacements.

Windows

git config --global credential.https://*.*.sourcemanager.dev.helper gcloud.cmd

Il est possible que les versions antérieures de Git ne soient pas compatibles avec les caractères génériques. Pour ajouter l'assistant d'authentification sans caractères génériques, exécutez la commande suivante :

git config --global credential.https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev.helper gcloud.cmd

Remplacez les éléments suivants :

  • INSTANCE_ID par le nom de votre instance Secure Source Manager.
  • PROJECT_NUMBER par votre numéro de projet. Pour savoir comment trouver votre numéro de projet, consultez Identifier des projets.
  • LOCATION par la région de l'instance. Pour en savoir plus sur les régions, consultez la section Emplacements.

L'outil d'authentification utilise gcloud CLI pour récupérer vos identifiantsGoogle Cloud lorsque vous utilisez des commandes Git avec Secure Source Manager.

Pour vous réauthentifier après la configuration initiale des identifiants, exécutez la commande gcloud CLI suivante :

gcloud auth login

Créer une configuration de connexion pour un pool d'identités de personnel

Vous n'avez pas besoin de remplir cette section, sauf si vous utilisez la fédération des identités des employés pour vous authentifier auprès de Secure Source Manager avec un fournisseur d'identité tiers.

Pour vous authentifier auprès de votre instance Secure Source Manager avec vos identifiants de pool d'identités des employés à l'aide de commandes gcloud CLI ou Git, vous devez créer une configuration de connexion avec votre pool d'identités des employés.

Pour créer une configuration de connexion à un pool d'identités de personnel, suivez les instructions de la section Obtenir des jetons de courte durée pour la fédération d'identité de personnel afin de créer une connexion basée sur le navigateur avec gcloud CLI.

Une fois que vous vous êtes authentifié, vous pouvez utiliser les commandes Git pour interagir avec votre instance Secure Source Manager. Vous devez vous réauthentifier lorsque la durée de la session de votre pool d'identités d'employés expire.

Cloner un dépôt

Clonez un dépôt en exécutant la commande suivante :

git clone REPOSITORY_URL

Où REPOSITORY_URL correspond à l'URL HTTPS ou SSH affichée en haut de la page du dépôt que vous souhaitez cloner.

Transférer un dépôt existant vers Secure Source Manager

Vous devez créer un dépôt Secure Source Manager pour qu'il serve de dépôt distant avant de pouvoir y transférer des données.

Pour transférer votre dépôt Git existant vers un dépôt Secure Source Manager vide, vous devez ajouter le dépôt Secure Source Manager en tant que dépôt distant et y transférer les données.

  1. Pour définir le dépôt Secure Source Manager comme dépôt distant, exécutez la commande suivante :

    git remote add origin REPOSITORY_URL

    Où REPOSITORY_URL correspond à l'URL HTTPS ou SSH affichée en haut de la page du dépôt.

  2. Pour envoyer le fichier au dépôt, exécutez la commande suivante :

    git push -u origin main

Pour en savoir plus sur la gestion du code source Git, consultez la documentation Git.

Étapes suivantes