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

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:

  1. 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".

    Interface de création de dépôts GitHub avec un champ de nom de dépôt renseigné avec "my-template-repository"

  2. 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é.

    "my-template-repository" avec deux répertoires de modèles sous-jacents, "template1" et "template2"

  3. 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"
}

Assistance

Pour envoyer vos commentaires, signalez tout problème sur GitHub ou posez une question sur Stack Overflow.