Cette page a été traduite par l'API Cloud Translation.

Créer et cloner un dépôt

Créez un dépôt dans Secure Source Manager et clonez-le sur votre machine locale.

Avant de commencer

Créez une instance Secure Source Manager ou demandez-y l'accès. Pour en savoir plus, consultez Créer une instance Secure Source Manager.
Install the Google Cloud CLI.
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```
Installez le composant alpha de Google Cloud CLI :
```
gcloud components install alpha
```

Rôles requis

Pour obtenir les autorisations nécessaires pour créer un dépôt, demandez à votre administrateur de vous accorder les rôles IAM suivants :

Rôle Créateur de dépôts d'instances Secure Source Manager (roles/securesourcemanager.instanceRepositoryCreator) sur l'instance Secure Source Manager
Rôle Créateur de dépôts Secure Source Manager (roles/securesourcemanager.repoCreator) sur le projet d'instance

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 attribuer des rôles Secure Source Manager, consultez Contrôle des accès avec IAM et Accorder aux utilisateurs l'accès aux instances.

Créer un dépôt

Interface Web

Pour accéder à l'instance Secure Source Manager via son interface Web, copiez l'URL suivante dans la barre d'adresse de votre navigateur.
```
INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev
```
Remplacez les éléments suivants :
- Remplacez INSTANCE_ID par le nom de l'instance.
- PROJECT_NUMBER par le numéro de projet Google Cloudde l'instance. Pour savoir comment identifier des projets, consultez Identifier des projets.
- LOCATION par la région de l'instance.
Si nécessaire, authentifiez-vous à l'aide de vos identifiants Secure Source Manager.
Cliquez sur l'icône + Créer un dépôt en haut à droite du menu de navigation.
Renseignez les informations sur le dépôt :
1. ID du dépôt : saisissez un nom pour le dépôt.
  
  Remarque : Les ID de dépôt doivent respecter la convention d'attribution de noms des ressources. Ils ne doivent contenir que des lettres minuscules, des chiffres ou des tirets, doivent commencer par une lettre et ne peuvent pas être modifiés après la création du dépôt.
2. Description : facultatif. Description du dépôt.
  
  Attention : N'incluez pas de données sensibles ou permettant d'identifier l'utilisateur dans la description ni dans d'autres champs de ressources similaires. Ces champs sont traités comme des données de service conformément à l' Google Cloud Avis de confidentialité.
3. Initialiser le dépôt : facultatif. Sélectionnez cette option si vous souhaitez initialiser le dépôt et ajouter les fichiers .gitignore, de licence et README.
4. .gitignore : facultatif. Choisissez les fichiers à ne pas suivre à l'aide des modèles de menu déroulant.
5. license : facultatif. Sélectionnez une licence courante dans le menu déroulant.
6. Branche par défaut : nom de la branche par défaut.
Cliquez sur Envoyer.

Le dépôt est créé dans votre instance Secure Source Manager.

Le rôle Administrateur de dépôt (roles/securesourcemanager.repoAdmin) vous est attribué lorsque vous créez un dépôt. La propagation de la nouvelle autorisation IAM peut prendre jusqu'à deux minutes. Par conséquent, si vous obtenez une erreur d'autorisation lorsque vous essayez d'accéder au dépôt après sa création, patientez quelques minutes et réessayez.

Les dépôts que vous avez créés sont listés dans l'interface Web Secure Source Manager sur la page Mes dépôts.

Configurer vos identifiants

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

Windows

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

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

Cloner un dépôt

Dans l'interface Web Secure Source Manager, accédez à la page de votre dépôt.
Copiez l'URL HTTPS en haut de la page de votre dépôt.
Clonez votre dépôt en exécutant la commande suivante :
```
git clone REPOSITORY_URL
```
Où REPOSITORY_URL correspond à l'URL HTTPS affichée en haut de la page du dépôt que vous souhaitez cloner.

Ignorez l'avertissement concernant le clonage d'un dépôt vide.

Effectuer un transfert vers un dépôt

Dans une fenêtre de terminal, accédez au dépôt cloné.
```
cd REPOSITORY_NAME
```
Où REPOSITORY_NAME est le nom de votre dépôt.
Créez un fichier README vide :
```
touch README.md
```
Ajoutez le fichier README à Git et créez un message de commit :
```
git add README.md
git commit -m "initial commit"
```

Transférez vos modifications vers votre dépôt distant :

git push -u origin main

Git transfère le fichier de la branche principale vers le dépôt distant d'origine. Le résultat ressemble à ce qui suit :

Enumerating objects: 3, done.
Counting objects: 100% (3/3), done.
Writing objects: 100% (3/3), 211 bytes | 211.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
remote: . Processing 1 references
remote: Processed 1 references in total
To https://instance-id-123456789012-git.us-central1.sourcemanager.dev/my-project/my-repo.git
* [new branch]      main -> main
branch 'main' set up to track 'origin/main'.

Afficher vos fichiers dans Secure Source Manager

Dans l'interface Web Secure Source Manager, cliquez sur le nom de votre dépôt.

La page de votre dépôt s'ouvre et votre fichier README.md est listé dans l'onglet <> Code.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , procédez comme suit :

Avant de supprimer le dépôt, assurez-vous que tous les fichiers que vous souhaitez conserver sont disponibles à un autre emplacement.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

PROJECT_ID : ID du projet Google Cloud dans lequel Secure Source Manager est exécuté.
LOCATION : région où se trouve votre instance. Pour en savoir plus sur les emplacements acceptés, consultez la page Emplacements.
REPOSITORY_ID : ID du dépôt.

Méthode HTTP et URL :

DELETE https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID"

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}
```

La réponse se présente comme suit :

{"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}

Étapes suivantes

Lister et afficher les dépôts dans l'interface Web Secure Source Manager.
Découvrez comment utiliser les demandes d'extraction et les problèmes dans Secure Source Manager.