Antes de empezar

1. Verifique que está utilizando una cuenta de Pago según uso o Suscripción yendo a Gestionar > Cuenta > Valores de la cuenta en la consola de IBM Cloud.

2. Compruebe que tiene asignadas las siguientes funciones de IBM Cloud Identity and Access Management (IAM):

   • Administrador en todos los servicios de gestión de cuentas y todos los servicios IAM.
   • Editor en el servicio de Gestión de Catálogos.
   • Función de acceso al servicio de administrador para Schematics.
   • Otros roles que se requieren para recursos específicos en su arquitectura desplegable. La automatización en la nube para Code Engine requiere la función de acceso al servicio Writer, que se aplica a todos los recursos del servicio Code Engine.

   Para más información, consulte Asignación de acceso a los servicios de gestión de cuentas y Gestión del acceso a los recursos.

3. Cree una arquitectura desplegable personalizada denominada Example Corp's infrastructure e incorpórela a un catálogo privado denominado Example Corp catalog. Esta arquitectura es la que irás ampliando a medida que completes este tutorial.

4. Configure un método de autenticación. Puede utilizar una clave API almacenada en Secrets Manager o un perfil de confianza para autorizar una implantación en su cuenta de destino.

   ¿Despliegue de una prueba de concepto con fines de prueba? Puede crear una clave API más adelante, al editar una configuración en su proyecto. Al hacerlo, se autoriza el despliegue del proyecto en la cuenta seleccionada en ese momento.

Creación de una versión de una arquitectura desplegable

Dado que Example Corp's infrastructure ya está disponible en un catálogo privado, es necesario actualizarlo con una nueva versión.

1. En la consola IBM Cloud, haga clic en Gestionar > Catálogos > Catálogos privados y abra el catálogo privado Example Corp catalog.
2. Seleccione la infraestructura de Example Corp de la lista de productos.
3. Haga clic en Versiones > Añadir versión
4. Seleccione Terraform como método de entrega.
5. Especifique si su repositorio es público o privado y proporcione la fuente URL. A efectos de este tutorial, puede utilizar la misma fuente URL que utilizó para incorporar la versión 0.0.1 de Example Corp's infrastructure.
6. Seleccione Deploy Example Corp AI app en IBM Cloud Code Engine como la variación.
7. Introduzca 0.0.2 para la versión del software.
8. Haga clic en Añadir versión

Desde aquí, puede configurar los detalles de la versión que ha añadido.

Ampliación de la infraestructura de Example Corp añadiendo opciones de bases de datos

A medida que configure los detalles de la versión, amplíe Example Corp's infrastructure apilándola con otras dos arquitecturas desplegables que creen bases de datos diferentes. Quiere que sus usuarios elijan IBM Cloud Databases for Elasticsearch o IBM Cloud Databases for PostgreSQL. Complete los pasossiguientes:

1. En el Paso 3 - Amplíe su arquitectura, haga clic en Añadir.

2. En el menú Producto, busque Cloud automation for Databases for Elasticsearch y selecciónelo.

3. User Semantic Versioning Specification ( SemVer ) para listar las versiones de la arquitectura que funcionan con la infraestructura de Example Corp.

   Por lo general, las versiones de parche no contienen cambios importantes, por lo que puede utilizar SemVer para especificar un rango de versiones que sean compatibles con la infraestructura de Example Corp, por ejemplo ~1.32. De esta manera, si la automatización de Cloud para Databases for Elasticsearch se actualiza con una versión de parche a 1.32.5, por ejemplo, cualquier usuario que haya implementado Example Corps con Elasticsearch puede actualizar su proyecto para utilizar la nueva versión. Para cambios importantes en la versión Elasticsearch, cree una nueva versión de la infraestructura de Example Corp para asegurarse de que la nueva Elasticsearch versión funcione correctamente con su arquitectura.

4. Seleccione la variación Estándar.

5. Especifique Estándar como variación por defecto, que es la que se selecciona por defecto para los usuarios.

6. Seleccione Opcional en el menú Relación, ya que la arquitectura no es necesaria para desplegar Example Corp's infrastructure.

7. (Opcional) proporcione una descripción de la pantalla para ayudar a los usuarios a entender cómo funciona esta arquitectura con Example Corp's infrastructure y qué ventajas ofrece. Por ejemplo, escriba NoSQL database for full-text searching and querying large datasets.

8. Pulse Añadir.

Ahora que ha añadido Cloud automation para Databases for Elasticsearch, repita los pasos de nuevo pero esta vez, busque Cloud automation for Databases for PostgreSQL. Para la descripción opcional de la pantalla, introduzca SQL database for relational queries and structured data.

Hacer que las bases de datos sean intercambiables entre sí

Ahora que ha añadido ambas bases de datos como opcionales a Example Corp's infrastructure, puede especificar que sean intercambiables entre sí. Sus usuarios pueden seleccionar la opción de base de datos que desean utilizar con Example Corp's infrastructure. Complete los pasossiguientes:

1. En el Paso 3 - Amplíe su arquitectura, marque la casilla de automatización de la nube para Databases for Elasticsearch.
2. Seleccione la casilla de verificación de Automatización en la nube para Databases for PostgreSQL.
3. Haga clic en Agrupar como intercambiable.
4. Introduzca Databases como nombre del grupo y haga clic en Añadir.
5. Pulse Siguiente.

Defina variables para sus usuarios

Ahora que ha añadido algunas opciones de base de datos a su arquitectura, necesita definir variables para sus usuarios. Al hacerlo, las entradas de las arquitecturas se conectan entre sí, lo que facilita a sus usuarios la configuración de Example Corp's infrastructure para su despliegue.

1. En el Paso 4 - Configurar los detalles de despliegue, haga clic en Definir variables.

   Aparecerá la ventana Definir variables con Automatización en la nube para Databases for Elasticsearch seleccionada para usted, de modo que pueda acceder a las entradas y salidas de esa arquitectura. Desde aquí, puede añadir referencias o mover entradas a Example Corp's infrastructure para que los usuarios puedan configurarlas.

2. Cuando se creó Example Corp's infrastructure, la región se limitaba a Estados Unidos. Para asegurarse de que Cloud automation para Databases for Elasticsearch utiliza la misma región que Example Corp's infrastructure, añada una referencia para conectarlos completando los siguientes pasos:

   1. En la ventana Entradas necesarias para la automatización de la nube para Databases for Elasticsearch, seleccione el icono Referencia a una variable para la entrada region.
   2. A continuación, seleccione región en el menú Nombre de la variable.
   3. Pulse Añadir. Cuando un usuario configura la entrada region en Example Corp's infrastructure, la automatización de Nube para Databases for Elasticsearch utilizará ese valor que el usuario proporciona como entrada.

3. Dado que Example Corp's infrastructure también contiene una entrada prefix, complete los mismos pasos para la entrada prefix en Cloud automation para Databases for Elasticsearch:

   1. Seleccione el Referenciar a una variable icono para la prefix aporte.
   2. A continuación, seleccione prefijo en el menú Nombre de la variable.
   3. Pulse Añadir.

4. Dado que Example Corp's infrastructure contiene una entrada para existing_resource_group_name, puede utilizar ese mismo grupo de recursos para la automatización de Nube para Databases for Elasticsearch:

   1. Seleccione el Referenciar a una variable icono para la resource_group_name aporte.
   2. A continuación, seleccione existing_resource_group_name en el menú Variable name.
   3. Pulse Añadir.

5. Establezca el valor predeterminado de use_existing_resource_group en true para indicar que sus usuarios necesitan un grupo de recursos existente para su arquitectura.

6. Para simplificar la configuración y reducir los costes de un entorno de desarrollo, elimine el requisito de cifrado de claves completando los siguientes pasos:

   1. Establezca el valor por defecto de existing_kms_instance_crn en __NULL__.
   2. Haga clic en Entradas opcionales.
   3. Establezca el valor predeterminado de use_ibm_owned_encryption_key en true.
   4. Establezca el valor por defecto de plan en enterprise.
   5. Establezca el valor por defecto de member_cpu_count en 2.
   6. Establezca el valor por defecto de member_host_flavor en multitenant.

Ahora que ha definido variables para Cloud automation para Databases for Elasticsearch, necesita definir variables para la otra opción de base de datos que ha incluido: Automatización en la nube para Databases for PostgreSQL. Complete los pasossiguientes:

1. En la ventana Definir variables, utilice el menú de arquitectura para cambiar de Automatización en la nube para Databases for Elasticsearch a Automatización en la nube para Databases for PostgreSQL.
2. Haga clic en Entradas obligatorias y elimine el requisito de cifrado de claves estableciendo el valor predeterminado de existing_kms_instance_crn en __NULL__.
3. Las otras tres entradas necesarias en esta arquitectura pueden hacer referencia a entradas ya disponibles en Example Corp's infrastructure. Complete los siguientes pasos para añadir referencias a estas entradas:
   1. Seleccione el Referenciar a una variable icono para resource_group_name, luego seleccione existing_resource_group_name del menú Nombre de variable. Haga clic en Añadir, y la entrada resource_group_name dentro de Cloud automation para Databases for PostgreSQL hará referencia al valor existing_resource_group_name de la infraestructura de Example Corp que su usuario proporcione.
   2. Seleccione el Referenciar a una variable icono para prefix y seleccione el prefijo del menú Nombre de variable y haga clic en Agregar.
   3. Seleccione el icono Referencia a una variable para region y seleccione región en el menú Nombre de la variable y haga clic en Añadir.
4. Haga clic en Entradas opcionales.
5. Establezca el valor predeterminado de use_existing_resource_group en true para indicar que sus usuarios necesitan un grupo de recursos existente para su arquitectura.
6. Establezca el valor predeterminado de use_ibm_owned_encryption_key en true.
7. Pulse Guardar.

Comunique los cambios a sus usuarios

La última versión de Example Corp's infrastructure no contiene cambios de última hora, pero sí incluye nuevas funciones que sus usuarios deben conocer. Informe a sus usuarios de las nuevas opciones de base de datos que pueden utilizar con Example Corp's infrastructure añadiendo un aviso de cambio. Complete los pasossiguientes:

1. En el Paso 6 - Añadir avisos de cambio, haga clic en Añadir nueva función.
2. En el campo Título, introduzca Database options added to Example Corp's infrastructure.
3. Para la Descripción, introduzca Version 0.0.2 includes two optional databases that you can choose to add. You can either use Cloud automation for Databases for Elasticsearch, or Cloud automation for Databases for PostgreSQL.
4. Pulse Guardar.

En el menú Acciones, seleccione Generar manifiesto para descargar los últimos cambios. Es una buena práctica descargar los archivos y añadirlos al repositorio de código fuente para que los cambios se apliquen en la próxima versión.

Validar las arquitecturas desplegándolas desde un proyecto

Ahora, la versión 0.0.2 de Example Corp's infrastructure está disponible como borrador en su catálogo privado. Cualquier usuario con acceso a su catálogo privado puede desplegarlo. Para asegurarse de que las opciones de la base de datos funcionan con Example Corp's infrastructure, despliéguela dos veces desde su proyecto. Para un despliegue, incluya Elasticsearch. Y, para el otro despliegue, incluya PostgreSQL. Al desplegar la arquitectura dos veces, se verifica que ambas opciones de base de datos funcionan con Example Corp's infrastructure según lo previsto.

Antes de poder compartir Example Corp's infrastructure con su empresa, debe validar la versión al incorporarla a su catálogo privado. Actualmente, la validación de la versión en el catálogo no valida ninguna arquitectura que haya apilado con la suya. El despliegue de las arquitecturas de un proyecto mientras Example Corp's infrastructure se encuentra en estado borrador en el catálogo privado ayuda a garantizar que las arquitecturas incluidas funcionen correctamente con Example Corp's infrastructure.

Próximos pasos

Continúe incorporando la última versión de Example Corp's infrastructure. Cuando haya terminado, una nueva versión de la arquitectura desplegable estará disponible para los usuarios. Cuando añaden la nueva versión a un proyecto, pueden personalizarlo incluyendo la automatización en la nube para Databases for Elasticsearch o la automatización en la nube para Databases for PostgreSQL.

Si un usuario ya ha desplegado la versión anterior de Example Corp's infrastructure, se le pedirá en su proyecto con el widget de atención a las necesidades que actualice la arquitectura a la última versión.