Ampliación de una arquitectura desplegable durante la incorporación

Al incorporar una arquitectura desplegable a un catálogo privado, puede optar por ampliarla apilándola con otras arquitecturas. Cuando añada esas otras arquitecturas, especifique si son necesarias para desplegar su arquitectura tal y como está prevista, o si pueden utilizarse opcionalmente para ampliar el caso de uso. Cuando termine la integración, el resultado será una solución integral sólida compuesta por varias arquitecturas desplegables que funcionan conjuntamente.

¿Están ya disponibles en un catálogo las arquitecturas desplegables que desea apilar? Si es así, puede apilar esas arquitecturas en un proyecto e incorporar esa solución como una entrada de catálogo independiente. Actualmente, cuando se apilan arquitecturas desplegables en un proyecto, no se admite la inclusión de arquitecturas opcionales o intercambiables. Por lo tanto, este enfoque funciona mejor si todas las arquitecturas que desea apilar son necesarias para desplegar la solución de extremo a extremo.

¿Por qué ampliar una arquitectura desplegable?

Puede ampliar una arquitectura desplegable por diferentes motivos. Por ejemplo, si la arquitectura que está incorporando requiere una dependencia, puede apilarla junto con la arquitectura de la que depende. Si la dependencia aparece como necesaria, se incluirá junto con su arquitectura desplegable cuando un usuario la configure y despliegue.

Del mismo modo, para fomentar la seguridad por defecto de una arquitectura desplegable que está incorporando, puede apilar con ella otras arquitecturas que satisfagan las necesidades de seguridad. Si las otras arquitecturas desplegables se incluyen como se recomienda, ayuda a asegurar que los usuarios en su organización desplieguen la arquitectura de una manera específica con esos guardarraíles de seguridad en su lugar. Las arquitecturas recomendadas se incluyen por defecto, pero los usuarios pueden eliminarlas.

También puede ampliar una arquitectura desplegable para ofrecer más opciones de personalización a los usuarios, de modo que puedan aprovechar un caso de uso ampliado. Tal vez su arquitectura funcione bien con otra arquitectura desplegable que no sea necesaria para cumplir una dependencia o satisfacer la conformidad. Puede añadir la arquitectura desplegable como opcional, y los usuarios pueden elegir incluirla cuando añadan su arquitectura desplegable a un proyecto.

Antes de empezar

Al completar los pasos para incorporar su arquitectura desplegable a un catálogo privado, se le pedirá que configure los detalles de la versión. Vaya a Ampliar su arquitectura para apilar otras arquitecturas desplegables junto con la que está incorporando.

Si ya ha incorporado su arquitectura desplegable, edite la versión en su catálogo privado y, a continuación, vaya a Ampliar su arquitectura.

¿Prefiere trabajar con código? Puede especificar detalles sobre otras arquitecturas desplegables que desee apilar con la que está incorporando en el archivo de manifiesto del catálogo. Establezca la propiedad dependency_version_2 en true y utilice la matriz dependencies para especificar qué arquitecturas desea incluir con la que está incorporando. Para obtener más información sobre cómo estructurar el manifiesto del catálogo, consulte Edición local del archivo de manifiesto.

Añadir arquitecturas desplegables

Al incorporar una arquitectura desplegable, puede ampliarla apilándola con otras arquitecturas. Especifique una relación cuando añada otras arquitecturas y, a continuación, defina variables para que los usuarios las configuren en las arquitecturas que está apilando. Complete los pasossiguientes:

Cuando incorpore una arquitectura desplegable a un catálogo, en la sección Amplíe su arquitectura, haga clic en Añadir.
Utilice el menú Producto para seleccionar la arquitectura desplegable que desea añadir. Puede seleccionar cualquier arquitectura desplegable a la que su cuenta tenga acceso a través de sus catálogos.
Seleccione una opción de Relación para la arquitectura desplegable que está añadiendo. La arquitectura es obligatoria y no se puede eliminar. Es opcional y los usuarios pueden elegir incluirlo o no. O bien, se recomienda y se incluye por defecto, aunque los usuarios pueden optar por eliminarlo. Para más información, vaya a Especificar una relación.
Opcional: si está agregando dos o más arquitecturas implementables que sean intercambiables según las preferencias del usuario, selecciónelas en la tabla Extender su arquitectura y haga clic en Agrupar como intercambiable. Los usuarios pueden elegir la arquitectura que desean utilizar en función de sus necesidades.
Cuando haya terminado de añadir arquitecturas desplegables, haga clic en Siguiente > Definir variables para definir variables para sus usuarios. A partir de ahí, puede conectar las arquitecturas desplegables entre sí para que los usuarios puedan configurar las entradas en una única interfaz, en lugar de configurar las arquitecturas una por una. Para más información, vaya a Definir variables para sus usuarios.

Especificar una relación

Cuando apilas arquitecturas desplegables junto con la que estás incorporando, se te pide que especifiques una Relación. ¿Cuál es la relación entre la arquitectura desplegable que está añadiendo y la solución global que está incorporando a su catálogo privado? Puede elegir entre tres opciones: Obligatorio, Opcional y Recomendado. La siguiente tabla describe y explica cómo afecta cada opción a la personalización de la solución integral cuando un usuario añade la arquitectura a un proyecto desde el catálogo privado:

Explicación de las opciones de relación
Opción	Descripción
Obligatorio	Se incluye cuando un usuario añade su arquitectura a un proyecto. El usuario no puede eliminar las arquitecturas requeridas porque son necesarias para que su solución global funcione según lo previsto.
Opcional	No se incluye por defecto. Los usuarios pueden optar por incluir arquitecturas opcionales si desean aprovechar un caso de uso ampliado.
Recomendado	Se incluye por defecto, pero los usuarios pueden eliminarlo si lo desean. Por ejemplo, tal vez desee fomentar las implantaciones seguras añadiendo IBM Cloud Secrets Manager como recomendación a su arquitectura desplegable. Secrets Manager se incluirá entonces por defecto cuando un usuario añada su arquitectura desplegable a un proyecto. Sin embargo, si dispone de otra herramienta para gestionar secretos o no necesita Secrets Manager, el usuario puede optar por excluirla.

Definición de variables para los usuarios

Después de ampliar su arquitectura desplegable apilando otras arquitecturas con ella, necesita definir variables para sus usuarios. El objetivo final es vincular las arquitecturas desplegables para que los usuarios puedan configurar las entradas en una única interfaz, en lugar de configurar las arquitecturas una por una. Plantéese las siguientes cuestiones:

¿Qué entradas de las arquitecturas desplegables deben configurar los usuarios? Estas entradas deben añadirse a su producto para que los usuarios puedan configurarlas sin tener que editar las arquitecturas individuales una por una. Seleccione Añadir al producto para hacerlo.
¿Qué arquitecturas desplegables deben vincularse con referencias a entradas o salidas? Por ejemplo, si una entrada de una arquitectura depende de la salida de otra, añada una referencia en la entrada para conectarla a la salida. Seleccione Referencia a una variable para hacerlo.

Sólo las entradas que añada a su producto pueden hacer referencia a una salida. Si ha añadido una arquitectura y una de sus entradas necesita hacer referencia a una salida de otra arquitectura, seleccione Añadir al producto para esa entrada. A continuación, seleccione Referencia a una variable para la entrada que ha añadido. A partir de ahí, puede seleccionar la arquitectura que contiene la salida. Seleccione Salida como tipo de variable y, a continuación, seleccione el nombre de la salida a la que desea que haga referencia la entrada.
¿Se han resuelto todas las entradas necesarias para los usuarios? Para las entradas necesarias que no se añaden al producto, proporcione un valor fijo o una referencia para resolver esas entradas. De este modo, se conectan las arquitecturas de esta solución integral y se facilita a los usuarios su configuración e implantación.

No se pueden proporcionar valores por defecto en la consola. Utilice la propiedad default_value dentro de la matriz configuration en el archivo de manifiesto del catálogo para especificar los valores por defecto. Para más información, consulte Edición local del archivo de manifiesto.
¿Necesitan los usuarios información adicional sobre una variable para poder configurarla? Cuando añades una variable de entrada a tu producto, puedes cambiar la forma en que la entrada aparece a los usuarios. A menudo, puede ser útil dar un nuevo nombre a una variable o una descripción, sobre todo si se incluyen dos variables similares. Por ejemplo, si la arquitectura que está incorporando contiene una entrada region, y añade también una entrada region de una arquitectura de infraestructura, considere la posibilidad de nombrar la entrada region-infrastructure cuando la añada a su producto. Un nombre significativo ayuda a identificar dónde se utiliza la entrada y facilita su configuración.

Cualquier entrada que haya añadido a su producto se incluye en la tabla de variables de entrada. Si necesita eliminar una variable que ha añadido, selecciónela y haga clic en Eliminar.

Próximos pasos

Una vez definidas las variables para sus usuarios, continúe incorporando su arquitectura desplegable. Cuando haya terminado, los usuarios que tengan acceso a su catálogo privado podrán añadir su arquitectura desplegable a un proyecto. Cuando lo hagan, podrán personalizarlo seleccionando qué arquitecturas quieren incluir en función de lo que usted haya especificado durante el proceso de incorporación.