Uso de la consola para crear la definición de pila

En un proyecto, la definición de la pila se crea automáticamente cuando se apilan arquitecturas desplegables y se definen variables. El uso de la consola para apilar arquitecturas implementables y definir variables de pila proporciona los siguientes beneficios:

• Puede utilizar el selector de referencias de la consola para crear referencias entre arquitecturas desplegables apiladas, en lugar de escribir las referencias desde cero.
• El despliegue de las arquitecturas apiladas de un proyecto ayuda a verificar que la solución global funciona según lo diseñado antes de que otros la configuren y desplieguen.
• Dado que la definición de la pila se crea automáticamente en función de las selecciones en la consola, la información como los identificadores de localizador de versiones de las arquitecturas implementables de los miembros es precisa y se actualiza automáticamente.

En el proyecto, puede seleccionar qué entradas desea incluir en el nivel de pila. Estas entradas se incluyen en la sección inputs de la definición de la pila y se configuran como referencias en la arquitectura implementable del miembro en su proyecto. En la siguiente imagen, la entrada prefix está resaltada dentro de la arquitectura implementable del miembro Custom Apache. Si se selecciona esta entrada, el Default value cambia a una referencia a la entrada de nivel de pila. Cuando un usuario añade su solución a un proyecto desde un catálogo, puede configurar la entrada prefix y la arquitectura miembro Custom Apache hará referencia a ese valor. La entrada fp_vsi_floating_ip_address hace referencia a una salida de otra arquitectura implementable del miembro. Esa entrada no debería seleccionarse, ya que esa referencia vincula las arquitecturas miembro entre sí. Estas entradas de las arquitecturas miembro se incluyen en la sección members del archivo de definición de la pila.

Editar la definición de tu pila

Para editar la definición de su pila localmente, complete los siguientes pasos:

1. Complete los pasos para apilar arquitecturas desplegables, defina variables de apilamiento e incorpore las arquitecturas apiladas a un catálogo privado.

   Configure e implante las arquitecturas apiladas para verificar que la solución funciona según lo diseñado antes de añadirla a un catálogo privado.

2. Una vez añadida la arquitectura desplegable a su catálogo privado, accederá a la página Configurar versión del catálogo. Desde ahí, haga clic en el menú Acciones > Generar manifiesto.

   También puede utilizar el método Obtener una definición de pila de la API de proyectos o el comando ibmcloud project stack-definition de la CLI de proyectos para exportar la definición de pila.

3. Abra el archivo stack_definition.json.

4. Utilizando la definición de ejemplo como guía, edite las variables de entrada y salida.

5. Agregue el archivo a la carpeta raíz de su repositorio de código fuente.

La próxima vez que añada una nueva versión de su solución al catálogo, se incluirán sus actualizaciones.

Ejemplo de archivo de definición

Se recomienda utilizar un proyecto para crear la definición de la pila con el fin de garantizar la precisión. Sin embargo, el siguiente fragmento de código puede utilizarse como plantilla para crear la definición de pila desde cero:

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