Configurer un dépôt de modèle

Un dépôt de modèles est un dépôt Git contenant des modèles de départ que votre équipe peut utiliser pour développer des applications.

Cela signifie que, au sein d'une organisation ou d'une équipe, vous pouvez configurer des dépôts de modèles avec Cloud Code, personnalisés pour votre organisation, pour offrir aux utilisateurs un ensemble standard de configurations d'applications, de services et de configurations d'infrastructure standards. . Cela permet d'aligner de nouveaux projets avec les normes et standards techniques de votre organisation, et favorise l'intégration de bonnes pratiques au début du cycle de développement.

Un dépôt de modèles peut être un dépôt existant de modèles d'applications que vous avez déjà créés ou un nouvel ensemble de modèles que vous souhaitez utiliser par d'autres utilisateurs. Il vous suffit d'ajouter un fichier de descripteur de modèle au dépôt pour l'importer avec Cloud Code.

Une fois prêts, les dépôts de modèles sont faciles à partager avec votre équipe. vous aurez besoin de Cloud Code et de l'URL Git du dépôt du modèle à utiliser. Pour les dépôts Git privés, seuls les membres ayant accès au dépôt peuvent utiliser les modèles personnalisés sous-jacents.

Pour voir un exemple de configuration d'un dépôt de modèle, consultez cet exemple de dépôt.

Créer un dépôt de modèles

Pour créer un dépôt de modèles à utiliser, procédez comme suit:

Créez un dépôt Git.

Votre dépôt Git peut être hébergé à distance ou en ligne sur votre ordinateur local. Cet exemple utilise un tout nouveau dépôt GitHub, "my-template-repository".
Ajoutez des répertoires de modèle à ce dépôt.

Vos répertoires de modèles peuvent contenir tous les éléments et être situés n'importe où dans le dépôt. Dans cet exemple, deux répertoires de modèle, "template1" et "template2", contenant un fichier README ont chacun été ajoutés à "my-template-repository".

Un fichier README contenant des instructions sur la manière d'utiliser vos modèles personnalisés est vivement recommandé.
Créez un fichier descripteur de modèle.

Un fichier descripteur de modèle fournit à Cloud Code des informations sur le modèle pour créer correctement votre application. Ce fichier doit être nommé .cctemplate, situé dans votre répertoire racine, et le schéma doit être défini dans la section Modèle de fichier de descripteur de modèle.

Utiliser un dépôt existant

Si vous souhaitez utiliser un dépôt existant, vous devez quand même créer un fichier de descripteur de modèle. Ce fichier fournit à Cloud Code des informations sur votre modèle pour créer correctement votre application.

Votre fichier descripteur de modèle doit être nommé .cctemplate, situé dans votre répertoire racine, et le schéma doit être défini dans la section Schéma du fichier descripteur de modèle.

Schéma du descripteur de modèle

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 de modèles contenus dans un dépôt. Les objets de ce tableau doivent être conformes au schéma de modèle.	Tableau<Modèle>
name (facultatif)	Nom du dépôt de modèles.	Chaîne

Exemple

{
   "metadata":{
      "version":"1"
   },
   "name": "My Template Repository",
   "templates":[
      {
         "path":"/path/to/template1_location",
         "name":"My Template 1",
         "description":"The first template of its name."
      },
      {
         "path":"/path/to/template2_location",
         "name":"My Template 2",
         "description":"The sequel."
      }
   ]
}

Schéma du modèle

Key (Clé)	Description	Type
chemin d'accès	Emplacement du modèle dans un dépôt. Le chemin d'accès est interprété comme provenant de la racine du dépôt.	Chaîne
nom	Nom d'un modèle. Ceci s'affiche dans un IDE lorsque vous sélectionnez un modèle sur lequel baser une application.	Chaîne
description (facultatif)	Description d'un modèle. Ceci s'affiche dans un IDE lorsque vous sélectionnez un modèle sur lequel baser une application.	Chaîne

Exemple

{
   "path":"path/to/template1",
   "name":"My Template 1",
   "description":"The first template of its name."
}

Schéma des métadonnées

Key (Clé)	Description	Type
version	Version du schéma de modèle utilisé. Actuellement, la seule version valide est `1`.	Chaîne

Exemple

{
   "version":"1"
}