Unidades de implementación de modelos y paquetes

Versión preliminar

Este producto o función está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección de Términos Generales del Servicio de los Términos Específicos del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se describe cómo modelar y empaquetar unidades de implementación para una oferta de SaaS. En SaaS Runtime, una unidad de implementación se denomina tipo de unidad.

Crea un tipo de unidad para cada componente de la oferta de SaaS que desees administrar de forma independiente. Para obtener más detalles, consulta la siguiente sección: Cómo determinar el modelo de la oferta de SaaS.

Si lo deseas, puedes crear una oferta de SaaS con un solo tipo de unidad para toda la oferta.

Los tipos de unidades se definen mediante un plano, que es una configuración de Terraform empaquetada como una imagen de OCI. Antes de crear un tipo de unidad, debes tener un plano creado para cada tipo de unidad. Para obtener detalles sobre cómo crear planos, consulta Crea y sube un plano.

Antes de comenzar

1. Asegúrate de haber definido una oferta de SaaS para tu aplicación de SaaS.
2. Asegúrate de haber creado un repositorio de Artifact Registry.
3. Asegúrate de tener las cuentas de servicio con los permisos necesarios. Para obtener más información, consulta Cuentas de servicio del entorno de ejecución de SaaS.
4. Para cada tipo de unidad que crees, asegúrate de tener una configuración de Terraform y de haber preparado el blueprint. Para obtener más información, consulta la siguiente sección Cómo determinar el modelo de la oferta de SaaS.

Determina el modelo de la oferta de SaaS

Para modelar la oferta de SaaS, debes determinar cuántos tipos de unidades crearás y la relación entre ellos.

Por ejemplo, puedes crear dos tipos de unidades: un tipo de unidad para la infraestructura, como una VM, y un tipo de unidad para la aplicación implementada en la infraestructura. Si lo deseas, puedes crear una oferta de SaaS con un solo tipo de unidad para toda la oferta.

Para decidir cómo modelar la oferta de SaaS con tipos de unidades, ten en cuenta lo siguiente:

• Revisa las dependencias entre los componentes de la oferta de SaaS. Por ejemplo, si una oferta de SaaS incluye una aplicación implementada en un clúster de Kubernetes compartido, considera usar un tipo de unidad para modelar este clúster compartido.
• Considera el ciclo de lanzamiento y mantenimiento de los componentes de la oferta de SaaS. Si hay componentes que se administran juntos, como la infraestructura, considera modelarlos con un tipo de unidad.

Una vez que hayas determinado este modelo, deberás crear un plan para cada tipo de unidad. Para ello, debes hacer lo siguiente:

1. Identifica la configuración de Terraform para conectarte a este tipo de unidad. Para obtener más detalles sobre las configuraciones de Terraform necesarias, consulta Planos en el entorno de ejecución de SaaS.
2. Asegúrate de que la configuración de Terraform esté empaquetada como una imagen de OCI y se haya enviado a Artifact Registry, o bien que esté en un archivo ZIP o un repositorio de Git. Para obtener más detalles, consulta Crea y sube un plano.

Cuando tengas un plan para cada tipo de unidad, puedes seguir las instrucciones de esta página para crear los tipos de unidad.

Crear un tipo de unidad

Puedes crear un tipo de unidad con una configuración de Terraform proporcionada de las siguientes maneras:

• En un archivo ZIP
• En un repositorio de Git
• Se empaqueta como una imagen de OCI.

Crea un tipo de unidad con un archivo ZIP

Para crear un tipo de unidad con una configuración de Terraform que se encuentra en un archivo ZIP, completa las siguientes instrucciones.

Para obtener detalles sobre cómo preparar un archivo ZIP, consulta Cómo subir un archivo ZIP.

Para crear un tipo de unidad, haz lo siguiente:

1. En la consola, ve a SaaS Runtime > Unit Kinds.

   Ir a Tipos de unidades

2. Selecciona Crear.

3. En Crear plano, selecciona Subir para subir un archivo ZIP que contenga la configuración de Terraform.

   1. Haz clic en Explorar y busca el archivo ZIP con la configuración de Terraform que define los recursos o la aplicación que forman parte de este tipo de unidad.

   2. Haz clic en Siguiente: Configurar el esquema.

4. En la página Store blueprint, haz lo siguiente:

   1. En Seleccionar repositorio de Artifact Registry, haz clic en Explorar y selecciona el repositorio que creaste.

   2. En Nombre de la imagen del artefacto, ingresa un nombre para la imagen de OCI.

   3. En Versión de Terraform de Infrastructure Manager, selecciona la versión de Terraform que se usará para las implementaciones. Para obtener una lista de las versiones de Terraform compatibles, consulta Versiones de Terraform compatibles.

   4. Para la cuenta de servicio de Cloud Build, selecciona la cuenta de servicio que tiene los permisos para compilar la imagen. Para obtener más información, consulta Cuenta de servicio de creación de artefactos.

   5. Haz clic en Siguiente: Detalles del tipo de unidad.

5. En la página Configurar las propiedades del tipo de unidad, haz lo siguiente:

   1. En Nombre del tipo de unidad, ingresa un nombre para el tipo de unidad. El nombre solo debe contener letras minúsculas, números o guiones.

   2. En Oferta de SaaS, selecciona la oferta de SaaS que deseas asociar con este tipo de unidad.

   3. Para Dependencies, haz lo siguiente:

      • Si es el primer o único tipo de unidad que creas para la oferta de SaaS, no agregues una dependencia.

      • Si creaste otros tipos de unidades que dependen de este tipo de unidad, selecciona Agregar dependencia.

        1. En Tipo de unidad, selecciona el tipo de unidad existente que depende del tipo de unidad que estás creando.

        2. En Alias, escribe un nombre que puedas usar para la asignación de variables de entrada.

        3. Haz clic en Listo.

        4. Si deseas definir la asignación de variables, sigue estos pasos. Para obtener detalles sobre la asignación de variables, consulta Asignación de variables.

           1. Selecciona Define input and output variable mappings.

           2. Para Input variable mappings:

              1. Selecciona Agregar asignación de variable de entrada.
              2. En Variable, escribe el nombre de la variable de entrada.
              3. En Tipo de asignación, selecciona una de las siguientes opciones:
                 • From: Unidad desde la que se realizará la asignación de la otra unidad.
                 • To para asignar el otro tipo de unidad.
              4. En Dependency, selecciona el tipo de unidad existente al que asignarás variables.
              5. En Variable de salida, escribe el nombre de la variable de salida.
              6. Seleccione Listo.

           3. Para agregar otra variable de entrada, selecciona Agregar asignación de variable de entrada y repite los pasos.

           4. Para agregar asignaciones de variables de salida, haz lo siguiente:

              1. Selecciona la pestaña Asignaciones de variables de salida.
              2. Selecciona Agregar asignación de variables de salida y repite los pasos que seguiste para la asignación de variables de entrada.

6. Haz clic en Siguiente: Configuración de lanzamiento.

7. En Nombre de la versión, escribe un nombre para la versión.

8. Opcional: Agrega una etiqueta a los recursos que implementas. Para obtener más detalles sobre las etiquetas, consulta la Descripción general de las etiquetas.

   Para agregar una etiqueta, sigue estos pasos:

   1. En Etiquetas, selecciona Agregar etiquetas.

   2. En Clave 1 y Valor 1, ingresa el par clave-valor deseado.

   3. Repite los pasos para cada etiqueta que desees agregar.

9. Haz clic en Crear.

Ya creaste un tipo de unidad. Para crear otro tipo de unidad, repite los mismos pasos y usa el archivo ZIP que contiene la configuración de Terraform para este siguiente tipo de unidad.

Si creaste todos los tipos de unidades necesarios para la oferta de SaaS, puedes implementar una instancia de unidad.

Crea un tipo de unidad con un repositorio de Git

Para crear un tipo de unidad con una configuración de Terraform que se encuentra en un repositorio de Git, completa las siguientes instrucciones.

Para obtener detalles sobre el uso de un repositorio de Git para los archivos de Terraform, consulta Conéctate a un repositorio de Git.

1. En la consola, ve a SaaS Runtime > Unit Kinds.

   Ir a Tipos de unidades

2. Selecciona Crear.

3. En Crear esquema, selecciona Vincular repositorio externo.

4. En Repositorio, selecciona el repositorio de Git que tiene la configuración de Terraform:

   1. Si el repositorio de Git está vinculado, selecciónalo en la lista.

   2. Si el repositorio no está vinculado, haz clic en Vincular repositorio nuevo para usar Developer Connect y vincularlo.

      1. Selecciona Crear conexión nueva.

      2. En Región, selecciona una región para la conexión de Developer Connect. Te recomendamos que uses la misma región que la que se usa para el repositorio de Artifact Registry.

      3. Opcional: En Clave de KMS, puedes especificar una clave de KMS para la encriptación.

      4. En Branch, especifica la rama de Git que tiene la configuración de Terraform que deseas asociar con este tipo de unidad.

5. En la página Store blueprint, haz lo siguiente:

   1. En Seleccionar repositorio de Artifact Registry, haz clic en Explorar y selecciona el repositorio de Artifact Registry que usas para la oferta de SaaS.

   2. En Nombre de la imagen del artefacto, ingresa un nombre para la imagen de OCI.

   3. En Versión de Terraform de Infrastructure Manager, selecciona la versión de Terraform que se usará para las implementaciones. Para obtener una lista de las versiones de Terraform compatibles, consulta Versiones de Terraform compatibles.

   4. Para la cuenta de servicio de Cloud Build, selecciona la cuenta de servicio que tiene los permisos para compilar la imagen. Para obtener más información, consulta Cuenta de servicio de creación de artefactos.

   5. Haz clic en Siguiente: Detalles del tipo de unidad.

6. En la página Configurar las propiedades del tipo de unidad, haz lo siguiente:

   1. En Nombre del tipo de unidad, ingresa un nombre para el tipo de unidad. El nombre solo debe contener letras minúsculas, números o guiones.

   2. En Oferta de SaaS, selecciona la oferta de SaaS que deseas asociar con este tipo de unidad.

   3. Para Dependencies, haz lo siguiente:

      • Si es el primer o único tipo de unidad que creas para la oferta de SaaS, no agregues una dependencia.

      • Si creaste otros tipos de unidades que dependen de este tipo de unidad, selecciona Agregar dependencia.

        1. En Tipo de unidad, selecciona el tipo de unidad existente que depende del tipo de unidad que estás creando.

        2. En Alias, escribe un nombre que puedas usar para la asignación de variables de entrada.

        3. Haz clic en Listo.

        4. Si deseas definir la asignación de variables, sigue estos pasos. Para obtener detalles sobre la asignación de variables, consulta Asignación de variables.

           1. Selecciona Define input and output variable mappings.

           2. Para Input variable mappings:

              1. Selecciona Agregar asignación de variable de entrada.
              2. En Variable, escribe el nombre de la variable de entrada.
              3. En Tipo de asignación, selecciona una de las siguientes opciones:
                 • From: Unidad desde la que se realizará la asignación de la otra unidad.
                 • To para asignar el otro tipo de unidad.
              4. En Dependency, selecciona el tipo de unidad existente al que asignarás variables.
              5. En Variable de salida, escribe el nombre de la variable de salida.
              6. Seleccione Listo.

           3. Para agregar otra variable de entrada, selecciona Agregar asignación de variable de entrada y repite los pasos.

           4. Para agregar asignaciones de variables de salida, haz lo siguiente:

              1. Selecciona la pestaña Asignaciones de variables de salida.
              2. Selecciona Agregar asignación de variables de salida y repite los pasos que seguiste para la asignación de variables de entrada.

7. Haz clic en Siguiente: Configuración de lanzamiento.

8. En Nombre de la versión, escribe un nombre para la versión.

9. Opcional: Agrega una etiqueta a los recursos que implementas. Para obtener más detalles sobre las etiquetas, consulta la Descripción general de las etiquetas.

   Para agregar una etiqueta, sigue estos pasos:

   1. En Etiquetas, selecciona Agregar etiquetas.

   2. En Clave 1 y Valor 1, ingresa el par clave-valor deseado.

   3. Repite los pasos para cada etiqueta que desees agregar.

10. Haz clic en Crear.

Ya creaste un tipo de unidad. Para crear otro tipo de unidad, repite los mismos pasos y usa el repositorio de Git que contiene la configuración de Terraform para este próximo tipo de unidad.

Si creaste todos los tipos de unidades necesarios para la oferta de SaaS, puedes implementar una instancia de unidad.

Crea un tipo de unidad con una imagen existente

Para crear un tipo de unidad con un plano existente, que es una imagen de OCI, completa las siguientes instrucciones.

Para obtener detalles sobre cómo compilar una imagen de OCI, consulta los siguientes recursos:

• Compila y envía una imagen de forma manual
• Automatiza la creación de planos.

1. En la consola, ve a SaaS Runtime > Unit Kinds.

   Ir a Tipos de unidades

2. Selecciona Crear.

3. En Create blueprint, selecciona Select an existing image from artifact registry.

4. Haz clic en Siguiente: Configurar el esquema.

5. En la página Store blueprint, haz lo siguiente:

   1. En Selecciona o ingresa un esquema existente de Artifact Registry, haz lo siguiente:

      1. Haz clic en Explorar.

      2. Navega a la imagen que contiene la configuración de Terraform.

      3. Haz clic en Seleccionar.

   2. Haz clic en Siguiente: Detalles del tipo de unidad.

6. En la página Configurar las propiedades del tipo de unidad, haz lo siguiente:

   1. En Nombre del tipo de unidad, ingresa un nombre para el tipo de unidad. El nombre solo debe contener letras minúsculas, números o guiones.

   2. En Oferta de SaaS, selecciona la oferta de SaaS que deseas asociar con este tipo de unidad.

   3. Para Dependencies, haz lo siguiente:

      • Si es el primer o único tipo de unidad que creas para la oferta de SaaS, no agregues una dependencia.

      • Si creaste otros tipos de unidades que dependen de este tipo de unidad, selecciona Agregar dependencia.

        1. En Tipo de unidad, selecciona el tipo de unidad existente que depende del tipo de unidad que estás creando.

        2. En Alias, escribe un nombre que puedas usar para la asignación de variables de entrada.

        3. Haz clic en Listo.

        4. Si deseas definir la asignación de variables, sigue estos pasos. Para obtener detalles sobre la asignación de variables, consulta Asignación de variables.

           1. Selecciona Define input and output variable mappings.

           2. Para Input variable mappings:

              1. Selecciona Agregar asignación de variable de entrada.
              2. En Variable, escribe el nombre de la variable de entrada.
              3. En Tipo de asignación, selecciona una de las siguientes opciones:
                 • From: Unidad desde la que se realizará la asignación de la otra unidad.
                 • To para asignar el otro tipo de unidad.
              4. En Dependency, selecciona el tipo de unidad existente al que asignarás variables.
              5. En Variable de salida, escribe el nombre de la variable de salida.
              6. Seleccione Listo.

           3. Para agregar otra variable de entrada, selecciona Agregar asignación de variable de entrada y repite los pasos.

           4. Para agregar asignaciones de variables de salida, haz lo siguiente:

              1. Selecciona la pestaña Asignaciones de variables de salida.
              2. Selecciona Agregar asignación de variables de salida y repite los pasos que seguiste para la asignación de variables de entrada.

7. Haz clic en Siguiente: Configuración de lanzamiento.

8. En Nombre de la versión, escribe un nombre para la versión.

9. Opcional: Agrega una etiqueta a los recursos que implementas. Para obtener más detalles sobre las etiquetas, consulta la Descripción general de las etiquetas.

   Para agregar una etiqueta, sigue estos pasos:

   1. En Etiquetas, selecciona Agregar etiquetas.

   2. En Clave 1 y Valor 1, ingresa el par clave-valor deseado.

   3. Repite los pasos para cada etiqueta que desees agregar.

10. Haz clic en Crear.

Ya creaste un tipo de unidad. Para crear otro tipo de unidad, repite los mismos pasos y usa la imagen de OCI que contiene la configuración de Terraform para este próximo tipo de unidad.

Si creaste todos los tipos de unidades necesarios para la oferta de SaaS, puedes implementar una instancia de unidad.

¿Qué sigue?

• Después de modelar la oferta de SaaS, puedes implementar una instancia de unidad.
• Para obtener más información sobre el entorno de ejecución de SaaS, consulta la descripción general.
• Para obtener más detalles sobre las cuentas de servicio necesarias cuando se usa el entorno de ejecución de SaaS, consulta Cuentas de servicio.