Gérer les exemples de dépôts personnalisés dans Cloud Code for VS Code

Un exemple de dépôt est un dépôt Git qui contient des exemples personnalisés que vous pouvez utiliser pour développer des applications.

Cela signifie, au sein d'une organisation ou d'une équipe, que vous pouvez configurer des dépôt d'exemples avec Cloud Code et les personnaliser pour votre organisation afin de proposer un ensemble standard d'applications de démarrage, de services et de configuration d'infrastructure que d'autres peuvent utiliser. Cela permet d'aligner les nouveaux projets avec la pile technique et les normes de votre organisation et encourage les bonnes pratiques au début du cycle de développement.

Il peut s'agir d'un dépôt existant d'exemples d'applications que vous avez déjà créés, ou d'un nouvel ensemble d'exemples que vous souhaitez utiliser par d'autres. Pour importer un dépôt avec Cloud Code, vous devez ajouter un exemple de fichier de descripteur.

Une fois prêt, le dépôt d'exemples peut être partagé facilement avec votre équipe. Il suffit que les membres installent Cloud Code et accèdent à l'URL Git correspondant pour l'utiliser. Pour les dépôts Git privés, seuls les membres ayant accès au dépôt peuvent utiliser les exemples personnalisés sous-jacents.

Pour savoir comment configurer un dépôt d'exemples, consultez ce dépôt.

Avant de commencer

Assurez-vous que Git 2.25.0 ou version ultérieure est installé sur votre ordinateur local.

Créer un exemple de dépôt

Pour utiliser un dépôt existant, passez à la section Créer un exemple de fichier descripteur. Pour créer un dépôt qui servira d'exemple de dépôt, procédez comme suit:

1. Créez un dépôt Git.

   Votre dépôt Git peut être hébergé à distance ou en direct sur votre ordinateur local. Cet exemple utilise un nouveau dépôt GitHub, 'custom-sample-repo'.

   

2. Ajoutez des exemples de répertoires au dépôt.

   Vos exemples de répertoires peuvent contenir n'importe quel élément et se trouver n'importe où dans le dépôt. Dans le cas présent, deux répertoires d'exemples ("hello-world" et "kubernetes-custom-sample") ont été ajoutés à "custom-sample-repo".

   Nous vous recommandons vivement d'utiliser un fichier "readme" contenant des instructions sur la meilleure façon d'utiliser vos exemples personnalisés.

   

3. Créez un exemple de fichier descripteur.

   Un exemple de fichier de descripteur fournit à Cloud Code les informations requises pour créer correctement l'application. Ce fichier doit être nommé .cctemplate, doit se trouver dans votre répertoire racine et avoir le schéma défini dans la section schema schema schema.

4. Testez votre échantillon personnalisé en suivant les étapes de création d'une application à partir d'un exemple personnalisé.

Exemple de schéma de descripteur

Key (Clé)	Description	Type
metadata	Métadonnées utilisées par Cloud Code pour la lecture. Conforme au schéma de métadonnées.	Métadonnées
Modèles	Tableau des exemples contenus dans un dépôt. Les objets de ce tableau doivent être conformes à l'exemple de schéma.	Tableau<Exemple>
Nom (facultatif)	Nom du dépôt d'exemples.	String

Exemple

{
   "metadata":{
      "version":"1"
   },
   "name": "My Sample Repository",
   "templates":[
      {
         "path":"/path/to/sample1_location",
         "name":"My Sample 1",
         "description":"The first sample of its name."
      },
      {
         "path":"/path/to/sample2_location",
         "name":"My Sample 2",
         "description":"The sequel."
      }
   ]
}

Schéma d'exemple

Key (Clé)	Description	Type
chemin d'accès	Emplacement de l'exemple dans un dépôt. Le chemin est relatif à la racine du dépôt.	String
nom	Nom d'un exemple. Le nom s'affiche dans un IDE lorsque vous sélectionnez un exemple sur lequel baser une application.	String
description (facultatif)	Description d'un exemple. La description s'affiche dans un IDE lorsque vous sélectionnez un exemple sur lequel baser une application.	String

Exemple

{
   "path":"path/to/sample1",
   "name":"My Sample 1",
   "description":"The first sample of its name."
}

Schéma de métadonnées

Key (Clé)	Description	Type
version	Version de l'exemple de schéma à utiliser. La seule version valide est 1.	String

Exemple

{
   "version":"1"
}

Supprimer un dépôt d'exemples personnalisé

Pour supprimer un exemple personnalisé, afin de le supprimer du flux du sélecteur d'application personnalisé et des machines des utilisateurs, procédez comme suit :

1. Dans le fichier settings.json, recherchez localPath pour l'exemple d'entrée personnalisé.

   "cloudcode.customApplications": [
     {
       "repoUrl": https://github.com/GoogleCloudPlatform/cloud-code-custom-samples-example.git,
       "branchName": "",
       "localPath": "/Users/username/Library/cloud-code/custom-templates/https-github-com-google-cloud-platform-cloud-code-custom-samples-example-git"
     }
   ],
   

2. Supprimez le dossier de modèle au niveau du chemin d'accès.

   Remarque:Sous Mac, Library est un dossier masqué.

3. Supprimez l'exemple de section personnalisé du fichier settings.json.

Obtenir de l'aide

Pour envoyer des commentaires, signalez des problèmes sur GitHub ou posez une question sur Stack Overflow.