Usare la console per creare la definizione dello stack

In un progetto, la definizione di stack viene creata automaticamente quando si impilano le architetture distribuibili e si definiscono le variabili. L'utilizzo della console per impilare architetture distribuibili e definire variabili di stack offre i seguenti vantaggi:

• È possibile usare il selezionatore di riferimenti nella console per creare riferimenti tra architetture distribuibili impilate, invece di scrivere i riferimenti da zero.
• La distribuzione delle architetture impilate di un progetto aiuta a verificare che la soluzione complessiva funzioni come progettato prima che altri la configurino e la distribuiscano.
• Poiché la definizione dello stack viene creata automaticamente in base alle selezioni nella console, informazioni come gli ID di localizzazione della versione delle architetture distribuibili dei membri sono accurate e vengono aggiornate automaticamente.

Nel progetto puoi selezionare quali input vuoi includere a livello di stack. Questi input sono inclusi nella sezione inputs della definizione dello stack e sono configurati come riferimenti nell'architettura distribuibile dei membri nel progetto. Nell'immagine seguente, l'input prefix è evidenziato all'interno dell'architettura distribuibile del membro Custom Apache. Se questo input è selezionato, Default value cambia in un riferimento all'input a livello di stack. Quando un utente aggiunge la vostra soluzione a un progetto da un catalogo, può configurare l'input prefix e l'architettura dei membri Custom Apache farà riferimento a quel valore. L'input fp_vsi_floating_ip_address fa riferimento a un output di un'altra architettura distribuibile membro. Questo ingresso non dovrebbe essere selezionato, poiché il riferimento collega le architetture dei membri. Tali input provenienti dalle architetture membro sono inclusi nella sezione members del file di definizione dello stack.

Modifica la definizione dello stack

Per modificare localmente la definizione dello stack, procedere come segue:

1. Completare i passaggi per impilare le architetture distribuibili, definire le variabili di impilamento e inserire le architetture impilate in un catalogo privato.

   Configurare e distribuire le architetture sovrapposte per verificare che la soluzione funzioni come progettato prima di aggiungerla a un catalogo privato.

2. Dopo che l'architettura distribuibile è stata aggiunta al catalogo privato, si accede alla pagina Configura versione del catalogo. Da qui, fare clic sul menu Azioni > Genera manifesto.

   È anche possibile utilizzare il metodo Ottieni una definizione dello stack dell'API del progetto o il comando ibmcloud project stack-definition della CLI del progetto per esportare la definizione dello stack.

3. Aprire il file stack_definition.json.

4. Utilizzando la definizione di esempio come guida, modifica le variabili di input e di output.

5. Aggiungi il file nella cartella principale del tuo repository del codice sorgente.

La prossima volta che aggiungerete una nuova versione della soluzione al catalogo, gli aggiornamenti saranno inclusi.

Esempio di file di definizione

Si consiglia di usare un progetto per creare la definizione dello stack, per garantire la precisione. Tuttavia, il seguente frammento di codice può essere usato come modello per creare la definizione di stack da zero:

{
   "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"
         }
      ]
   }
]