Créer un dépôt

Cette page explique comment créer un dépôt à l'aide de l'interface Web 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 la 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 en savoir plus sur l'attribution de rôles Secure Source Manager, consultez Contrôle des accès avec IAM et Accorder aux utilisateurs l'accès à une instance.

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 de l'instance Google Cloud. Pour en savoir plus sur l'identification des projets, consultez Identifier des projets.
- LOCATION par la région de l'instance.
Authentifiez-vous à l'aide de vos identifiants Secure Source Manager si nécessaire.
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'Avis de confidentialité.
  Google Cloud
3. Branche par défaut : nom de la branche par défaut.
4. 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.
5. .gitignore : facultatif. Choisissez les fichiers à ne pas suivre à l'aide des modèles de menu déroulant.
6. 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
```
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 section Emplacements.
- PROJECT_ID par l'ID de projet de l'instance Secure Source Manager dans laquelle vous souhaitez créer le dépôt.
- INSTANCE_ID par l'ID d'instance de l'instance dans laquelle vous créez le dépôt. Pour afficher la liste des instances Secure Source Manager de votre projet, consultez Lister et afficher les instances.
- DESCRIPTION par une description du dépôt. Cette opération 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'Avis de confidentialité.
  Google Cloud
- BRANCH par le nom de la branche par défaut. Cette opération est facultative et peut être omise. Lorsque le nom de la branche par défaut n'est pas défini, il est main.
- GITIGNORES par une liste de noms de modèles gitignore séparés par une virgule. Cette opération 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 opération 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 par default pour créer un fichier README à partir du modèle par défaut. Cette opération est facultative et peut être omise. Si vous omettez cette option, aucun fichier README ne sera créé.

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"}'

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 section 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.

Vous pouvez spécifier des valeurs supplémentaires à l'aide de l'indicateur de données HTTP POST, -d'{}' y compris l'initialisation du dépôt, l'ajout d'un fichier spécifique .gitignore ou des licences. Pour en savoir plus, consultez la documentation de référence.

Si vous souhaitez que votre sortie soit lisible, 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", "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",
    "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 de projet du dépôt.
my-project-id est l'ID de projet du dépôt.
my-repo est le REPOSITORY_ID que vous avez défini 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. La revue de code, le suivi des problèmes et les requêtes d'extraction sont compatibles avec l'interface Web Secure Source Manager.

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 recevez une erreur d'autorisation lorsque vous tentez 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.

Étape suivante

Accorder aux utilisateurs l'accès au dépôt
Utiliser 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 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

Étape suivante

Créer un dépôt