Utilisation de la console pour créer la définition de la pile

Dans un projet, votre définition de pile est créée automatiquement lorsque vous empilez des architectures déployables et que vous définissez des variables. L'utilisation de la console pour empiler des architectures déployables et définir des variables de pile offre les avantages suivants :

• Vous pouvez utiliser le sélecteur de références dans la console pour créer des références entre des architectures déployables empilées, au lieu d'écrire les références à partir de zéro.
• Le déploiement des architectures empilées d'un projet permet de vérifier que la solution globale fonctionne comme prévu avant que d'autres ne la configurent et ne la déploient.
• Étant donné que la définition de la pile est créée automatiquement en fonction des sélections dans la console, les informations telles que les identifiants de localisateur de version des architectures déployables membres sont précises et mises à jour automatiquement.

Dans le projet, vous pouvez sélectionner les entrées que vous souhaitez inclure au niveau de la pile. Ces entrées sont incluses dans la section inputs de la définition de la pile et sont configurées comme références dans l'architecture déployable des membres de votre projet. Dans l'image suivante, l'entrée prefix est mise en évidence dans l'architecture déployable du membre Custom Apache. Si cette entrée est sélectionnée, le Default value devient une référence à l'entrée au niveau de la pile. Lorsqu'un utilisateur ajoute votre solution à un projet à partir d'un catalogue, il peut configurer l'entrée prefix et l'architecture membre Custom Apache fera référence à cette valeur. L'entrée fp_vsi_floating_ip_address fait référence à une sortie d'une autre architecture déployable membre. Cette entrée ne devrait pas être sélectionnée, car cette référence relie les architectures membres entre elles. Ces entrées provenant des architectures membres sont incluses dans la section members du fichier de définition de la pile.

Modification de la définition de votre pile

Pour modifier votre définition de pile localement, procédez comme suit :

1. Suivez les étapes pour empiler des architectures déployables, définir des variables d'empilement et intégrer les architectures empilées dans un catalogue privé.

   Configurez et déployez les architectures empilées pour vérifier que la solution fonctionne comme prévu avant de l'ajouter à un catalogue privé.

2. Une fois l'architecture déployable ajoutée à votre catalogue privé, vous accédez à la page Configurer la version du catalogue. De là, cliquez sur le menu Actions > Générer un manifeste.

   Vous pouvez également utiliser la méthode de définition de pile de l'API des projets ou la commande ibmcloud project stack-definition de l'interface de ligne de commande des projets pour exporter la définition de pile.

3. Ouvrez le fichier stack_definition.json.

4. En utilisant l’exemple de définition comme guide, modifiez les variables d’entrée et de sortie.

5. Ajoutez le fichier dans le dossier racine de votre référentiel de code source.

La prochaine fois que vous ajouterez une nouvelle version de votre solution au catalogue, vos mises à jour seront incluses.

Exemple de fichier de définition

Il est recommandé d'utiliser un projet pour créer la définition de la pile afin d'en garantir l'exactitude. Toutefois, l'extrait de code suivant peut être utilisé comme modèle pour créer la définition de la pile à partir de zéro :

{
   "inputs": [
      {
         "name": "Stack input 1",
         "type": "string",
         "hidden": false,
         "required": true,
         "default" : "Default value"
      },
      {
         "name": "Stack input 2",
         "type": "string",
         "hidden": false,
         "required": true
      }
   ],
   "outputs": [
      {
         "name": "Output 1 name",
         "value": "The reference to this output value"
      },
      {
         "name": "Output 2 name",
         "value": "The reference to this output value"
      }
   ],
   "members": [
      {
         "Name": "Deployable architecture 1 name",
         "Version_locator": "",
         "inputs": [
            {
               "name": "Input 1 name",
               "value": "reference"
            },
            {
               "name": "Input 2 name",
               "value": "reference"
            }
         ]
      },
      {
         "Name": "Deployable architecture 2 name",
         "Version_locator": "",
         "inputs": [
            {
               "name": "Input 1 name",
               "value": "reference"
            },
            {
               "name": "Input 2 name",
               "value": "reference"
            }
         ]
      }
   ]
}

"inputs": [
   {
      "name": "Stack input 1",
      "type": "string",
      "hidden": false,
      "required": true,
      "default" : "Default value"
   },
   {
      "name": "Stack input 2",
      "type": "string",
      "hidden": false,
      "required": true
   }
]

"outputs": [
   {
      "name": "Output 1 name",
      "value": "The reference to this output value"
   },
   {
      "name": "Output 2 name",
      "value": "The reference to this output value"
   }
]

"members": [
   {
      "Name": "Deployable architecture 1 name",
      "Version_locator": "",
      "inputs": [
         {
            "name": "Input 1 name",
            "value": "reference"
         },
         {
            "name": "Input 2 name",
            "value": "reference"
         }
      ]
   }
]