Antes de empezar

1. Para construir una arquitectura, debe estar familiarizado con Terraform.

2. 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.

3. Cree un repositorio para almacenar su arquitectura desplegable. A efectos de esta guía de aprendizaje, se utiliza GitHub. Para obtener más información, consulte Crear un repositorio.

4. Instale un editor de su elección, por ejemplo, Visual Studio Code.

5. 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 de IAM, todos los servicios de gestión de cuentas y todos los servicios habilitados de identidad y acceso.
   • 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.

Descarga de los archivos de arquitectura desplegables

Para empezar, debe descargar los archivos de arquitectura desplegables. Los archivos incluyen un archivo main.tf que invoca el módulo raíz de Terraform.

1. En la consola IBM Cloud, haga clic en Catálogo.

2. Introduzca Cloud automation for Code Engine en la barra de búsqueda y seleccione la arquitectura en la lista de resultados.

3. Seleccione v4.2.2 como versión del producto.

   Este tutorial ha sido creado en base a la versión 4.2.2 de Cloud automation para Code Engine. No obstante, si lo desea, puede seleccionar otra versión de la arquitectura desplegable.

4. Asegúrese de que está seleccionada la variación New Code Engine apps.

5. Pulse Revisar opciones de despliegue en el panel de resumen.

6. Seleccione Trabajar con código > Descargar paquete para descargar el paquete.

7. Abra el paquete descargado en el sistema local.

8. Extraiga el paquete .tar.gz para acceder a los archivos de una carpeta y editarlos. Cambie el nombre de la carpeta extraída a Example-corp-infrastructure para facilitar su localización y uso.

   Después de descargar y extraer correctamente el paquete, verá los siguientes archivos y carpetas:

   • automation folder
   • ibm_catalog.json
   • main.tf
   • outputs.tf
   • provider.tf
   • README.md
   • variables.tf
   • version.tf

Edición de la lista de variables

Cuando su arquitecto de infraestructuras investigó IBM Cloud Code Engine, decidió modificar la región y la clave API IBM Cloud. El resto de variables que se incluyen en la arquitectura no son necesarias para tus propósitos, por lo que deberás eliminarlas utilizando tu editor favorito Visual Studio Code.

1. En Visual Studio Code, abra el archivo variables.tf.

2. Mueva las variables siguientes al inicio del archivo variables.tf.

   • ibmcloud_api_key
   • prefix
   • existing_resource_group_name
   • region

   El orden de las variables no importa.

3. Suprima todas las demás variables y guarde el archivo.

Actualización del archivo main.tf

Ahora que ha actualizado el archivo variables.tf, asegúrese de que la información de configuración del archivo main.tf sea correcta. Dado que desea utilizar Code Engine para ejecutar una aplicación creada por Example Corp, debe proporcionar información sobre su aplicación.

1. Abra el archivo main.tf.

2. Actualice la variable app_name e introduzca "example-corp-ai-app" como nombre de la aplicación.

3. Actualiza la variable image_reference e introduce "icr.io/codeengine/helloworld", que es la imagen docker para tu aplicación.

4. Añada la variable project_name e introduzca "example-corp-ce-project" como nombre para su proyecto Code Engine.

5. Añade la variable provider_visibility y establécela en "public".

6. Confirme que las variables ibmcloud_api_key, prefix, y region están incluidas como se muestra en el siguiente ejemplo:

   module "deploy-arch-ibm-code-engine" {
     source      = "https://cm.globalcatalog.cloud.ibm.com/api/v1-beta/offering/source/archive//solutions/apps?archive=tgz&catalogID=7a4d68b4-cf8b-40cd-a3d1-f49aff526eb3&flavor=apps&installType=fullstack&kind=terraform&name=deploy-arch-ibm-code-engine&version=v4.2.2"
     ibmcloud_api_key      = var.ibmcloud_api_key
     prefix      = var.prefix
     existing_resource_group_name      = var.existing_resource_group_name
     region      = var.region
     app_name      = "example-corp-ai-app"
     image_reference      = "icr.io/codeengine/helloworld"
     project_name      = "example-corp-ce-project"
     provider_visibility      = "public"
   }
   

7. Guarde el archivo.

Su arquitectura está ahora codificada para hacer referencia a su aplicación de IA de Example Corp y configurada para utilizar las variables para la clave de API IBM Cloud, el prefijo y la región.

Actualización del archivo ibm_catalog.json

El archivo ibm_catalog.json es un archivo JSON de manifiesto que se utiliza para importar automáticamente la información de versión cuando se incorpora una arquitectura desplegable a un catálogo privado. Como ha cambiado la arquitectura desplegable, ha creado una arquitectura totalmente nueva para sus necesidades. Actualice la siguiente información en el archivo ibm_catalog.json para reflejar los cambios.

Para obtener más información sobre el archivo de manifiesto y lo que contiene, consulte Edición local del manifiesto de catálogo.

Prueba de la arquitectura desplegable

Antes de incorporar su arquitectura desplegable configurada a un catálogo privado y ponerla a disposición para su uso, pruebe su configuración para asegurarse de que la arquitectura se ejecuta según lo previsto. Para probar la arquitectura con la línea de mandatos de Terraform, realice los pasos siguientes:

1. Cree o actualice un archivo .netrc necesario para utilizar los módulos Terraform de IBM Cloud. Para obtener más información, consulte ibmcloud catalog utility netrc.

   ibmcloud catalog utility netrc
   

2. Inicialice la CLI de Terraform. Para obtener más información, consulte Inicialización de directorios de trabajo.

   terraform init
   

3. Suministre los recursos. Para obtener más información, consulte Infraestructura de suministro con Terraform.

   1. Ejecute terraform plan para generar un plan de ejecución de Terraform para obtener una vista previa de las acciones propuestas.

      terraform plan
      

   2. Ejecute terraform apply para crear los recursos definidos en el plan.

      terraform apply
      

Próximos pasos

Si su arquitectura desplegable se ejecutó como se esperaba, ha creado con éxito su propia arquitectura desplegable desde Cloud automation para Code Engine. Ahora está preparado para mover los archivos actualizados al repositorio GitHub que ha creado y incorporar el producto a un catálogo privado.

Después de incorporar Example Corp's infrastructure a un catálogo privado, puede compartirlo con su empresa. Si no estás preparado para compartir tu arquitectura desplegable, o no formas parte de una empresa, puedes saltarte el compartirla y continuar con el siguiente tutorial, desplegando Example Corp's infrastructure mediante un proyecto.