Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Créer et mettre à jour un dépôt

Cette page explique comment créer et mettre à jour un dépôt à l'aide de l'interface Web Secure Source Manager ou de l'API Secure Source Manager.

Si votre instance Secure Source Manager n'a pas encore été créée, consultez Créer une instance Secure Source Manager pour commencer.

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.
Installez la Google Cloud CLI.
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
Pour initialiser la gcloud CLI, exécutez la commande suivante :
```
gcloud init
```
Installez le composant beta 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 accorder 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 :
- 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 dans le 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, saisissez une 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. Branche par défaut : nom de la branche par défaut.
Compte de service : facultatif. Saisissez le compte de service à associer au dépôt. Ce compte de service géré par l'utilisateur est utilisé pour les intégrations telles que Cloud Build. Pour en savoir plus, consultez Se connecter à Cloud Build.
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.
.gitignore : facultatif. Choisissez les fichiers à ne pas suivre à l'aide des modèles du menu déroulant.
license (licence) : facultatif. Sélectionnez une licence courante dans le menu déroulant.
Cliquez sur Créer un dépôt.

gcloud

Créez un dépôt à l'aide de la gcloud CLI en exécutant la commande suivante :
```
gcloud source-manager repos create REPOSITORY_ID \
    --region=LOCATION \
    --project=PROJECT_ID \
    --instance=INSTANCE_ID \
    --description=DESCRIPTION \
    --default-branch=BRANCH \
    --gitignores=GITIGNORES \
    --license=LICENSE \
    --readme=README \
    --service-account=SERVICE_ACCOUNT
```
Remplacez les éléments suivants :
- REPOSITORY_ID par le nom de votre 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.
- LOCATION par la région dans laquelle vous souhaitez créer le dépôt. Pour en savoir plus sur les emplacements compatibles, consultez la page Emplacements.
- PROJECT_ID par l'ID du projet de l'instance Secure Source Manager dans laquelle vous souhaitez créer le dépôt.
- INSTANCE_ID par l'ID de l'instance dans laquelle vous créez le dépôt. Pour répertorier les instances Secure Source Manager de votre projet, consultez Lister et afficher les instances.
- DESCRIPTION avec une description du dépôt. Cette information est facultative et peut être omise.
  
  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é.
- BRANCH avec le nom de branche par défaut. Cette opération est facultative et peut être omise. Si aucun nom de branche par défaut n'est défini, la valeur main est utilisée.
- GITIGNORES par une liste de noms de modèles gitignore séparés par une virgule. Cette information est facultative et peut être omise. Pour afficher la liste complète des modèles disponibles, consultez la documentation de référence sur la configuration de l'initialisation du dépôt.
- LICENSE par le nom du modèle de licence à appliquer à votre dépôt. Cette information est facultative et peut être omise. Pour afficher la liste complète des modèles de licence disponibles, consultez la documentation de référence sur la configuration de l'initialisation du dépôt.
- README avec default pour créer un fichier README à partir du modèle par défaut. Cette information est facultative et peut être omise. Si cette option est omise, aucun fichier README ne sera créé.
- SERVICE_ACCOUNT par l'adresse e-mail du compte de service que vous souhaitez associer au dépôt. Cette opération est facultative et peut être omise.

API

Créez un dépôt à l'aide d'un appel REST en exécutant la commande suivante :

curl \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/repositories?repository_id=REPOSITORY_ID \
    -d '{
      "instance": "projects/PROJECT_ID/locations/REGION/instances/INSTANCE_ID",
      "serviceAccount": "SERVICE_ACCOUNT"
    }'

Remplacez les éléments suivants :

REGION par la région de votre instance Secure Source Manager. Pour en savoir plus sur les emplacements compatibles, consultez la page Emplacements.
INSTANCE_ID par l'ID de votre instance Secure Source Manager.
PROJECT_ID par l'ID de projet de votre instance Secure Source Manager. Pour savoir où trouver l'ID de votre projet, consultez Identifier des projets.
REPOSITORY_ID par le nom de votre dépôt.
SERVICE_ACCOUNT par l'adresse e-mail du compte de service que vous souhaitez associer au dépôt.

Des valeurs supplémentaires peuvent être spécifiées à l'aide du flag de données HTTP POST, -d'{}', y compris pour initialiser le dépôt, ajouter un fichier .gitignore spécifique ou des licences. Pour en savoir plus, consultez la documentation de référence.

Si vous souhaitez que votre sortie soit lisible par l'homme, vous pouvez la rediriger vers JSON à l'aide de json_pp.

Exemple :

curl \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    https://securesourcemanager.googleapis.com/v1/projects/my-project-id/locations/us-central1/repositories?repository_id=my-repo \
    -d '{
      "instance": "projects/my-project-id/locations/us-central1/instances/prod-test-instance",
      "serviceAccount": "my-service-account@my-project-id.iam.gserviceaccount.com",
      "initialConfig": {
        "defaultBranch": "main"
      }
    }' | json_pp

La réponse se présente comme suit :

{
  "name": "operations/266bf4c7-13fe-11ed-be24-da823b7355d0",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
    "createTime": "2022-08-04T14:02:59.810496928Z",
    "endTime": "2022-08-04T14:03:00.558354528Z",
    "target": "projects/654987321654/locations/us-central1/repositories/my-repo",
    "verb": "create",
    "apiVersion": "v1"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Repository",
    "name": "projects/my-project-id/locations/us-central1/repositories/my-repo",
    "instance": "projects/654987321654/locations/us-central1/instances/prod-test-instance",
    "serviceAccount": "my-service-account@my-project-id.iam.gserviceaccount.com",
    "createTime": "2022-08-04T14:03:00Z",
    "uris": {
      "html": "https://prod-test-instance-654987321654.us-central1.sourcemanager.dev/my-project-id/my-repo",
      "gitHttps": "https://prod-test-instance-654987321654-git.us-central1.sourcemanager.dev/my-project-id/my-repo.git"
    }
}

Où :

654987321654 est le numéro du projet de dépôt.
my-project-id est l'ID du projet de dépôt.
my-repo correspond à la REPOSITORY_ID que vous avez définie dans la commande de création. Le champ uris contient les URL permettant d'accéder au dépôt via le navigateur Web ou via l'accès HTTPS au protocole Git.

Accédez à votre nouveau dépôt avec l'URI HTML dans la réponse. L'examen du code, le suivi des problèmes et les demandes d'extraction sont compatibles avec l'interface Web Secure Source Manager.

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

Lorsque vous créez un dépôt, le rôle Administrateur de dépôt (roles/securesourcemanager.repoAdmin) vous est attribué. La propagation de la nouvelle autorisation IAM peut prendre jusqu'à deux minutes. Si vous recevez un message d'erreur d'autorisation lorsque vous essayez d'accéder au dépôt après sa création, patientez quelques minutes, puis 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.

Mettre à jour un dépôt

Interface Web

Accédez à la page du dépôt dans l'interface Web Secure Source Manager.
Cliquez sur Paramètres du dépôt dans le menu de navigation.
Dans la section Paramètres de base, saisissez l'adresse e-mail du compte de service dans le champ Compte de service.
Cliquez sur Enregistrer les modifications.

gcloud

Pour mettre à jour le compte de service du dépôt, exécutez la commande suivante :
```
gcloud source-manager repos update REPOSITORY_ID \
    --region=LOCATION \
    --project=PROJECT_ID \
    --service-account=SERVICE_ACCOUNT
```
Remplacez les éléments suivants :
- REPOSITORY_ID par le nom du dépôt que vous souhaitez mettre à jour.
- LOCATION par la région où se trouve le dépôt.
- PROJECT_ID par l'ID du projet.
- SERVICE_ACCOUNT par l'adresse e-mail du compte de service que vous souhaitez associer au dépôt.

API

Pour mettre à jour le compte de service du dépôt à l'aide d'un appel REST, exécutez la commande suivante :

curl --request PATCH \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/repositories/REPOSITORY_ID?updateMask=serviceAccount \
    -d '{"serviceAccount": "SERVICE_ACCOUNT"}'

Remplacez les éléments suivants :

PROJECT_ID par l'ID du projet.
REGION par la région.
REPOSITORY_ID par l'ID du dépôt.
SERVICE_ACCOUNT par l'adresse e-mail du compte de service.

Étapes suivantes

Accorder aux utilisateurs l'accès au dépôt
Utilisez la gestion du code source Git avec Secure Source Manager.
Lister et afficher les dépôts dans l'interface Web Secure Source Manager

Créer et mettre à jour un dépôt Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer

Rôles requis

Créer un dépôt

Interface Web

gcloud

API

Mettre à jour un dépôt

Interface Web

gcloud

API

Étapes suivantes

Créer et mettre à jour un dépôt