IBM Cloud Docs
Utilización de proyectos para implantar una arquitectura desplegable en varias regiones

Utilización de proyectos para implantar una arquitectura desplegable en varias regiones

Este tutorial muestra cómo utilizar proyectosColección de artefactos que definen y gestionan recursos e infraestructura como despliegues de código. para desplegar dos configuraciones ligeramente diferentes de la misma arquitectura desplegable en dos regiones diferentes.

Imagina que eres desarrollador de software para la empresa Example Corp. Su arquitecto de infraestructuras descubrió la arquitectura desplegable de automatización de la nube para Code Engine, y su profesional de ingeniería de automatización de la nube la personalizó para satisfacer plenamente sus necesidades empresariales. La arquitectura desplegable personalizada se utiliza para automatizar el despliegue de una aplicación en contenedores en IBM Cloud Code Engine. La imagen de contenedor existente en icr.io/codeengine/helloworld se utiliza como aplicación de ejemplo. Ahora, necesita desplegar la arquitectura desplegable en varias regiones por motivos de almacenamiento local de datos y rendimiento o alta disponibilidad para dar el mejor soporte a su aplicación.

Este tutorial utiliza un escenario ficticio para ayudarle a aprender y comprender cómo utilizar proyectos para desplegar en varias regiones. A medida que completes el tutorial, adapta cada paso a las necesidades de tu organización.

Antes de empezar

  1. Configure su cuenta IBM Cloud.

  2. Cree una arquitectura desplegable personalizada denominada Example Corp's infrastructure e incorpórela a un catálogo privado denominado Example Corp catalog.

  3. Tenga en cuenta que la realización de este tutorial puede generar gastos en su cuenta. La automatización de la nube para Code Engine se personalizó para crear Example Corp's infrastructure. Para más información sobre los costes asociados al uso de Code Engine, consulte Precios de Code Engine.

  4. Asegúrese de que dispone de las siguientes funciones de acceso para crear un proyecto y permiso para crear los recursos de herramientas del proyecto dentro de la cuenta:

    • La función de Editor en el servicio IBM Cloud Projects.
    • La función de editor y gestor en el servicio IBM Cloud® Schematics
    • El rol de Observador en el grupo de recursos para el proyecto
    • 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 obtener más información sobre el acceso y los permisos, consulte Asignar a los usuarios acceso a los proyectos.

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

Crear un proyecto

Cree un proyecto en el que pueda configurar y desplegar la infraestructura de Example Corp.

  1. En la consola IBM Cloud, haga clic en el icono del menú de navegación Menú de navegación > Proyectos.
  2. Pulse Crear.
  3. Nombra tu proyecto Example Corp infrastructure.
  4. Añada la siguiente descripción a su proyecto: Project to manage the different configurations and deployments of Example Corp's infrastructure.
  5. Seleccione Dallas como la región donde se almacenan los datos del proyecto.
  6. Mantenga Default para el grupo de recursos.
  7. Pulse Crear.

Cree un entorno en su proyecto

Ahora que su proyecto está creado, está listo para crear un entorno para compartir valores a través de configuraciones para facilitar los despliegues. Las propiedades que añades a un entorno se añaden automáticamente a las configuraciones que utilizan ese entorno. Para más información, consulte las ventajas de utilizar entornos. En este tutorial, añades el método de autenticación al entorno para poder reutilizarlo en tu proyecto.

  1. En el proyecto de infraestructura Example Corp, seleccione Gestionar > Entornos.
  2. Pulse Crear.
  3. Asigne un nombre a su entorno Example Corp infrastructure dev.
  4. Haga clic en Añadir > Añadir manualmente...
  5. Seleccione Autenticación para la categoría.
  6. Especifique el método de autenticación que configuró en los pasos anteriores al inicio. Puede utilizar una clave API o un perfil de confianza.
  7. Dependiendo del método que elija, seleccione el secreto que contiene su clave API o proporcione el ID del perfil de confianza.
  8. Haga clic en Añadir para añadir el método de autenticación al entorno.
  9. Haga clic en Guardar para guardar el entorno.

Añadir una arquitectura desplegable a un proyecto

Antes de poder configurar Example Corp's infrastructure, es necesario encontrar la arquitectura desplegable en Example Corp catalog y añadirla al proyecto Example Corp infrastructure.

  1. En el proyecto de infraestructura Ejemplo Corp, seleccione Configuraciones > Crear.
  2. Utilice el menú de catálogos para abrir el catálogo privado denominado Example Corp catalog.
  3. En la sección Tipo, seleccione Productos privados para filtrar la lista de productos.
  4. Seleccione la infraestructura de Example Corp de la lista de productos restantes.
  5. Seleccione Configurar y desplegar.
  6. Cambie el nombre de la configuración a example-corp-us-south para indicar que desea desplegar la configuración en la región sur de Estados Unidos.
  7. Seleccione Example Corp infrastructure dev como entorno.
  8. Pulse Añadir.

Ha añadido correctamente la arquitectura desplegable a un proyecto y está listo para definir la configuración.

Configurar la arquitectura desplegable

  1. En la sección Detalles, revise la información y asegúrese de que está seleccionado el entorno Example Corp infrastructure dev.

  2. En la sección Seguridad, confirme que se ha seleccionado el método de autenticación correcto en función de lo que haya añadido al entorno.

  3. Durante la validación, se ejecuta un análisis de riesgos de código en su arquitectura, que incluye un análisis de conformidad basado en un conjunto de controles. Example Corp's infrastructure no incluye ningún control aplicable, pero puede configurar su propio anexo a través de Security and Compliance Center si lo desea. Para más información, consulte Configuración de la arquitectura. Seleccione Arquitectura por defecto si no desea utilizar su propio archivo adjunto de Security and Compliance Center.

  4. En la sección Entradas, introduzca los valores de las variables de entrada necesarias para la configuración de la arquitectura desplegable:

    1. Introduzca us-south como prefix a utilizar para las convenciones de nomenclatura.
    2. Seleccione Predeterminado como existing_resource_group_name.
    3. Seleccione us-south como region para desplegar los recursos.
  5. Pulse Guardar.

  6. Pulse Validar. El modal que se muestra proporciona más detalles sobre su validación en curso.

    Si la validación falla, puede solucionar el problema. O bien, un administrador del servicio IBM Cloud Projects puede revisar los resultados a través del servicio Schematics y anular el fallo y aprobar la configuración para desplegarla de todos modos. Sin embargo, asegúrese de que la canalización falló debido al análisis del Analizador de Riesgos de Código y no debido a un fallo de validación o del plan. No se recomienda anular un fallo marcado debido a un fallo de validación o del plan, ya que la configuración no puede desplegarse correctamente. Para más información sobre seguridad y conformidad en los proyectos, consulte Lograr la conformidad continua en la empresa.

Durante el proceso de configuración y despliegue, supervise los elementos de atención a sus necesidades. El widget refleja cualquier incidencia que se produzca en tus configuraciones.

Apruebe y despliegue su primera configuración

Como Editor en el servicio IBM Cloud® Projects, puede aprobar los cambios de configuración y desplegar la configuración. Puede ser beneficioso desplegar su primera configuración para asegurarse de que sus cambios funcionan como se espera. A continuación, si el despliegue se realiza correctamente, puede continuar creando su segunda configuración.

Antes de aprobar y desplegar sus configuraciones, debe resolver cualquier elemento pendiente de Atención necesaria en la pestaña Descripción general.

  1. En el proyecto Example Corp infrastructure, seleccione la pestaña Configuraciones.
  2. Haga clic en el icono Opciones Icono de opciones para example-corp-us-south > Ver última validación.
  3. Añada un comentario con más detalles sobre la aprobación y haga clic en Aprobar.
  4. Haga clic en Desplegar y espere a que finalice el despliegue.

Añadir y configurar la segunda arquitectura desplegable

Ahora que ha configurado y desplegado su arquitectura en una región, puede duplicarla para desplegar la arquitectura en otra región.

  1. En el proyecto Example Corp infrastructure, seleccione la pestaña Configuraciones.

  2. Haga clic en el icono Opciones Icono de opciones para example-corp-us-south > Duplicar. example-corp-us-south-copy-01 se agrega a su proyecto.

  3. Haga clic en el icono Opciones para example-corp-us-south-copy-01 > Editar.

  4. En la sección Detalles, haga clic en Editar y cambie el nombre de la configuración a example-corp-us-east.

  5. En la sección Detalles, asegúrese de que está seleccionado el entorno Example Corp infrastructure dev.

  6. En la sección Seguridad, revise la información que se extrajo del entorno que creó.

  7. En la sección Entradas, haga clic en Editar e introduzca los valores de las variables de entrada necesarias para la configuración de la arquitectura desplegable:

    1. Introduzca us-east como prefix a utilizar para las convenciones de nomenclatura.
    2. Seleccione Predeterminado como existing_resource_group_name.
    3. Seleccione us-east como region para desplegar los recursos.
  8. Pulse Guardar.

  9. Pulse Validar. El modal que se muestra proporciona más detalles sobre su validación en curso.

    Si la validación falla, puede solucionar el problema. O bien, un administrador del servicio IBM Cloud Projects puede revisar los resultados a través del servicio Schematics y anular el fallo y aprobar la configuración para desplegarla de todos modos. Sin embargo, asegúrese de que la canalización falló debido al análisis del Analizador de Riesgos de Código y no debido a un fallo de validación o del plan. No se recomienda anular un fallo marcado debido a un fallo de validación o del plan, ya que la configuración no puede desplegarse correctamente. Para más información sobre seguridad y conformidad en los proyectos, consulte Lograr la conformidad continua en la empresa.

Durante el proceso de configuración y despliegue, supervise los elementos de atención a sus necesidades. El widget refleja cualquier incidencia que se produzca en tus configuraciones.

Apruebe y despliegue su segunda configuración

Una vez completada la validación, puede desplegar su segunda configuración.

Antes de aprobar y desplegar sus configuraciones, debe resolver cualquier elemento pendiente de Atención necesaria en la pestaña Descripción general.

  1. En el proyecto Example Corp infrastructure, seleccione la pestaña Configuraciones.
  2. Haga clic en el icono Opciones para example-corp-us-east > Editar.
  3. Haga clic en Ver detalles para ver la última validación y aprobar los cambios.
  4. Añada un comentario con más detalles sobre la aprobación y haga clic en Aprobar.
  5. Haga clic en Desplegar y espere a que finalice el despliegue.

Próximos pasos

Una vez completado el despliegue con éxito, su aplicación se despliega en dos regiones separadas. Las dos configuraciones, ligeramente diferentes, se basan en la misma arquitectura desplegable. Para encontrar las aplicaciones, vaya a la consola IBM Cloud, haga clic en el icono del menú de navegación Menú de navegación > Contenedores > Proyectos Severless.

Consulte el siguiente tutorial sobre Cómo añadir opciones personalizables a Example Corp's infrastructure.