IBM Cloud Docs
Mover recursos de un espacio de trabajo Schematics a un proyecto

Mover recursos de un espacio de trabajo Schematics a un proyecto

Puede gestionar el ciclo de vida de una arquitectura empresarial moviendo recursos de un espacio de trabajo deIBM Cloud® Schematics a un proyecto de IBM Cloud®. Aunque puede utilizar un espacio de trabajo Schematics para utilizar Terraform y arquitecturas desplegables, puede utilizar un proyecto para gestionar el ciclo de vida completo a escala. Después de completar esta tarea, tiene un mosaico de arquitectura desplegable en el catálogo privado y puede gestionar el ciclo de vida de la arquitectura desplegable desde un proyecto.

Durante este proceso, puede utilizar los mandatos de CLI ibmcloud catalog utility create-product-from-workspace e ibmcloud project config-create para crear un catálogo y un proyecto enlazados entre sí y, a continuación, mover los recursos del espacio de trabajo Schematics al proyecto.

Vea y aprenda el proceso de mover recursos desplegados a un proyecto.

Ver y aprender

Transcripción del vídeo

Soy Gili Mendel, un STSM con el equipo de desarrollo de IBM Cloud. Voy a mostrarle cómo mover un espacio de trabajo Schematics en la arquitectura desplegable o un proyecto de IBM Cloud.

Un espacio de trabajo Schematics es la forma en que ejecuta una automatización de Terraform en IBM Cloud. El espacio de trabajo contiene un enlace a un repositorio Git desde el que capta la plantilla de Terraform. También contiene la variable de plantilla y el estado de los recursos a medida que la crea.

Es una gran forma de ejecutar la automatización de Terraform IaaS en la nube sin mantener un grupo de IBM Cloud® Object Storage de alta disponibilidad para el estado con las integraciones íntimas con los proveedores de recursos de nube.

Sin embargo, este enfoque no se escala si está impulsando varias automatizaciones. La gestión de los recursos y el despliegue de una nueva versión de la plantilla puede ser una tarea desalentadora.

Aunque una empresa aprovecha la automatización de Terraform, se trata de arquitecturas desplegables. Puede publicar una arquitectura de referencia, con una designación de ocupación de conformidad, estimaciones de costes y una plantilla de Terraform que automatiza el despliegue de la arquitectura.

El repositorio Git se utiliza para iterar y crear la arquitectura y sus automatizaciones. Puede o no ser visible para los usuarios que despliegan la arquitectura. La propia arquitectura tiene un ciclo de vida que incluye actualizaciones de versión.

Paso 1: Utilice la CLI de gestión de catálogos para crear una arquitectura desplegable a partir del espacio de trabajo existente y el ciclo de vida necesario para publicar las nuevas versiones para el mismo.

Paso 2: Utilice la CLI de proyecto para modificar el espacio de trabajo de modo que un proyecto lo gestione como una arquitectura desplegable. Como tal, estos recursos se pueden tratar como una única configuración de versión de arquitectura desplegable y se pueden gestionar desde una cuenta de administrador en muchos entornos. La migración de versión, el coste y la ocupación de conformidad son más sencillos y todos implican la arquitectura que se despliega.

Antes de empezar

  • Asegúrese de que se haya creado el espacio de trabajo IBM Cloud® Schematics y de que los recursos se hayan suministrado en su cuenta. El proyecto y el espacio de trabajo deben estar en la misma cuenta.
  • Establezca una variable de entorno GIT_TOKEN para autenticar el repositorio de origen Git. Por ejemplo, ejecute export GIT_TOKEN="enter your GIT TOKEN".
  • Establezca el acceso a su cuenta de una de las maneras siguientes:
    • Establezca la variable de entorno IC_API_KEY para acceder a su cuenta de IBM Cloud. Por ejemplo, ejecute IC_API_KEY="Your API key".
    • Utilice los detalles de trusted-profile-id para acceder a su cuenta de IBM Cloud. Para obtener más información, consulte Búsqueda del ID de perfil de confianza. Por ejemplo, un ID de perfil de confianza podría ser similar a Profile-1bd5eala-000-4a6666-00000.
  • Asegúrese de que los plugins de CLI Project y Catalogs management estén actualizados. Ejecute el mandato ibmcloud plugin list para ver la versión actual de los plugins de CLI.
  • Cree un proyecto para el despliegue de producción y anote el nombre y el ID del proyecto donde desea mover los recursos.
  • Asegúrese de que el servicio de proyectos esté autorizado en su cuenta para comunicarse con otros servicios de IBM Cloud. Para obtener más información, consulte Cómo otorgar acceso entre el servicio de proyectos y otros servicios de IBM Cloud.

Creación de una arquitectura desplegable desde un espacio de trabajo Schematics

Omita esta sección si ya tiene una arquitectura desplegable en el espacio de trabajo Schematics.

Si ha desplegado software utilizando un espacio de trabajo Schematics o a través de un catálogo privado, puede mover los recursos desplegados a un proyecto utilizando el mandato ibmcloud catalog utility create-product-from-workspace.

El mandato realiza las siguientes tareas relacionadas con Git:

  • Clona el repositorio de arquitectura desplegable.
  • Envía el archivo de manifiesto ibm_catalog.json a una rama nueva.
  • Crea un diagrama de arquitectura de marcador (architecture-diagram-placeholder.drawio.svg).
  • Crea un release de Git en el repositorio.
  • Proporciona el URL de activo de actualización.

El mandato también completa las siguientes tareas relacionadas con IBM Cloud:

  • Crea un catálogo privado en IBM Cloud.
  • Crea un proyecto en el que realiza el desarrollo y las pruebas.
  • Enlaza el proyecto y el catálogo utilizando un ID de perfil de confianza o una clave de API.
  • Crea el mosaico del producto en el catálogo privado.
  • Incorpora la versión del producto al nuevo catálogo privado.
  • Marca la versión como lista para compartir.
  • Completa la incorporación del espacio de trabajo y la arquitectura desplegable moviendo el espacio de trabajo al catálogo.
  • Muestra el ID de proyecto, el ID de catálogo, el ID de oferta y el localizador de versión.

Realice los pasos siguientes para crear una arquitectura desplegable y mover todos los recursos desplegados a una configuración de proyecto:

  1. Ejecute el mandato ibmcloud catalog utility create-product-from-workspace.

    ibmcloud catalog utility create-product-from-workspace [--workspace-id ID] [--api-key KEY] [--trusted-profile-id ID] [--catalog-label LABEL] [--offering-label LABEL] [--project-name NAME] [--project-resource-group GROUP] [--target-version VERSION] [--variation-label LABEL]
    

    --api-key y --trusted-profile-id son mutuamente excluyentes. Sólo necesita uno u otro. El parámetro --project-name crea el proyecto donde realiza el desarrollo y las pruebas. Es posible que desee asignarle el mismo nombre que el ID de espacio de trabajo para mayor simplicidad.

    Consulte el ejemplo siguiente de las opciones del mandato utility create-product-from-workspace.

    ibmcloud catalog utility create-product-from-workspace --workspace-id us-south.workspace.move.xxxx --api-key $IC_API_KEY --catalog-label myCatalog --offering-label myOffering --project-name myProject --project-resource-group Default --target-version 1.0.0 --variation-label test_standard
    

    Cuando el mandato ha terminado de ejecutarse, el indicador de mandatos devuelve OK.

  2. Verifique los resultados en Git visualizando la confirmación, el repositorio y el nuevo release. Puede ver el archivo .tgz con las versiones.

  3. Verifique los resultados en la consola de IBM Cloud:

    1. Vaya a Gestionar > Catálogos > Catálogos privados.
    2. Seleccione el nuevo catálogo privado.
    3. Seleccione el nuevo producto en su catálogo privado y, a continuación, seleccione el separador Versiones. Consulte que tiene la versión 1.0.0 (o similar) de la arquitectura desplegable. Si va al catálogo privado, verá la misma arquitectura desplegable en un mosaico.
    4. Pulse el icono Menú de navegación icono Menú de navegación > Proyectos y mire el nuevo proyecto.
    5. Seleccione el separador Configuraciones para ver la arquitectura desplegable. Consulte que está en estado draft.

Creación de la configuración del proyecto

El mandato ibmcloud project config-create crea una configuración de proyecto que hace que el espacio de trabajo Schematics se ejecute bajo un proyecto donde puede crear otra versión a partir del proyecto y modificar la arquitectura desplegable según sea necesario.

Antes de empezar esta sección, asegúrese de que tiene una arquitectura desplegable en un catálogo privado y un espacio de trabajo Schematics en ejecución y conozca su CRN. Puede localizar el CRN del espacio de trabajo desde la lista de recursos en la consola de IBM Cloud o utilizando la CLI.

  • Consola de IBM Cloud: en la consola de IBM Cloud, pulse el icono Menú de navegación icono del menú de navegación > Lista de recursos > Herramientas de desarrollador > busque el espacio de trabajo y copie el CRN.
  • CLI de IBM Cloud: ejecute el mandato ibmcloud schematics workspace get para captar los detalles del CRN del espacio de trabajo. Por ejemplo, ejecute ibmcloud schematics workspace get --id workspace-id --output destination folder --json output.json para captar los detalles de CRN del espacio de trabajo Schematics.

Complete los pasos siguientes para añadir una configuración de proyecto y mover los recursos del espacio de trabajo Schematics al proyecto:

  1. Ejecute el mandato ibmcloud project config-create.

    ibmcloud project config-create --project-id PROJECT-ID [--schematics-workspace-crn SCHEMATICS-WORKSPACE-CRN] [--definition-name DEFINITION-NAME] [--definition-locator-id DEFINITION-LOCATOR-ID]
    

    El valor de --project-id es del proyecto que ha creado para el despliegue de producción utilizando la interfaz de usuario de proyectos anterior. El valor de --definition-locator-id es el mismo que el localizador de versión de la sección anterior.

    Consulte el ejemplo siguiente de opciones de mandato project config-create.

    ibmcloud project config-create --project-id myProdProject --schematics-workspace-crn MyWorkspaceCRN --definition-name production-deployment --definition-locator-id myVersionLocator
    

    Cuando el mandato ha terminado de ejecutarse, el indicador de mandatos devuelve el nombre, el estado y el tipo.

  2. Verifique que las plantillas de Terraform están desplegadas en el proyecto:

    1. En la consola de IBM Cloud, pulse el icono Menú de navegación icono Menú de navegación > Proyectos.
    2. Seleccione el proyecto que ha creado primero para la producción de despliegue y vaya al separador Configuraciones.
    3. Pulse el icono Acciones icono Acciones > Ver último despliegue.
    4. En la sección Despliegue satisfactorio, pulse Cambios desplegados correctamente > Registros para ver todos los recursos desplegados en el proyecto.

El despliegue del espacio de trabajo Schematics se incluye ahora en los registros que están dentro del nuevo proyecto.

Si desea verificar los resultados utilizando la CLI, ejecute los mandatos ibmcloud project get o ibmcloud project list para verificar que el espacio de trabajo se ha movido correctamente al proyecto.

Próximos pasos

Para completar el resto del proceso para la arquitectura desplegable, realice los pasos siguientes:

  1. Configure los detalles de despliegue para la arquitectura desplegable.
  2. Defina el acceso de IAM.
  3. Añada un diagrama de arquitectura, requisitos previos y resaltados.
  4. Añadir información de conformidad (controles).
  5. Vuelva a validar para recibir una estimación de coste.

Para obtener más información sobre cómo completar los pasos, consulte Incorporación de una arquitectura desplegable personalizada al catálogo privado.

Para obtener más información, consulte Adopción de Enterprise Architecture.