En el entorno de ejecución de SaaS, un plano es el término que se usa para la configuración empaquetada de Terraform que define la infraestructura y la aplicación que implementas. Las configuraciones empaquetadas de Terraform son imágenes de Open Container Initiative (OCI) que se almacenan en Artifact Registry.
En esta página, se describe lo siguiente:
- Los requisitos para las configuraciones de Terraform cuando se usa el entorno de ejecución de SaaS
- Cómo puedes proporcionar las configuraciones de Terraform al entorno de ejecución de SaaS
- Cómo el entorno de ejecución de SaaS usa la configuración de Terraform
En esta página, se supone que estás familiarizado con Terraform. Para obtener más información sobre Terraform, comienza con ¿Qué es Terraform?.
Para obtener detalles sobre la creación de una imagen de OCI con una configuración de Terraform, consulta Crea y sube un plano.
Requisitos del plano
El entorno de ejecución de SaaS usa Infrastructure Manager para implementar las configuraciones de Terraform en Google Cloud. Para obtener detalles sobre los requisitos y las restricciones, consulta Restricciones en las configuraciones de Terraform.
Para usar la configuración de Terraform, el entorno de ejecución de SaaS usa un paquete de la configuración de Terraform. Este paquete es una imagen de OCI (Open Container Initiative) que se almacena en Artifact Registry.
Puedes proporcionar una imagen de OCI que contenga la configuración de Terraform. De lo contrario, proporciona la configuración de Terraform y el entorno de ejecución de SaaS crea la imagen de OCI. Para obtener detalles sobre cómo puedes proporcionar la configuración de Terraform, consulta la siguiente sección Cómo proporcionar un plano.
Variables de Terraform en planos
Tus configuraciones de Terraform pueden usar variables para personalizar las implementaciones. El entorno de ejecución de SaaS proporciona formas flexibles de administrar estas variables, consulta Administra variables.
Cómo proporcionar un plano
Puedes proporcionar el plano como una configuración de Terraform o una imagen de OCI que empaqueta la configuración de Terraform.
Puedes proporcionar un plano al entorno de ejecución de SaaS de las siguientes maneras:
- Configuración de Terraform almacenada en un repositorio externo
- Configuración de Terraform almacenada en un archivo ZIP
- Con la configuración de Terraform y Cloud Build, compila la imagen de OCI por tu cuenta y envíala a Artifact Registry.
- Automatiza la compilación de la imagen de OCI con la configuración de Terraform y Cloud Build. Este método automatizado es útil para las canalizaciones de CI/CD.
Cómo el entorno de ejecución de SaaS usa el plano
Cuando usas el entorno de ejecución de SaaS, el plano se almacena en Artifact Registry con el formato de Docker. El plano se implementa en Google Cloud usando Infrastructure Manager.
Para obtener detalles sobre el repositorio en Artifact Registry, consulta Crea un repositorio para el entorno de ejecución de SaaS.
Sube un plano
Puedes proporcionar el plano como una configuración de Terraform o una imagen de OCI que empaqueta la configuración de Terraform.
Subes el plano al entorno de ejecución de SaaS cuando creas un tipo de unidad. Puedes seleccionar el plano de una de las siguientes maneras:
- Sube la configuración de Terraform como un archivo ZIP.
- Vincula un repositorio externo.
- Selecciona una imagen existente de Artifact Registry.
Para obtener más detalles, consulta Crea un tipo de unidad.
Aprovisiona el plano
El entorno de ejecución de SaaS aprovisiona la infraestructura que se describe en el plano cuando crea una unidad.
El entorno de ejecución de SaaS usa Infrastructure Manager para aprovisionar la infraestructura. Infrastructure Manager usa Cloud Build como parte de su flujo de trabajo. Cuando el entorno de ejecución de SaaS crea una unidad, la información sobre el estado de la implementación está disponible en los tres servicios:
- Entorno de ejecución de SaaS
- Infrastructure Manager
- Cloud Build
Para obtener más detalles sobre cómo Infrastructure Manager implementa las configuraciones de Terraform, consulta Descripción general de Infrastructure Manager
Controla el control de versiones
El entorno de ejecución de SaaS controla el control de versiones del plano mediante el control de versiones de la imagen de OCI con Artifact Registry y el uso de un lanzamiento en el entorno de ejecución de SaaS para apuntar a una versión específica del plano en Artifact Registry.
¿Qué sigue?
- Prueba la guía de inicio rápido para comenzar a usar el entorno de ejecución de SaaS.
- Crea un registro en Artifact Registry para almacenar planos para el entorno de ejecución de SaaS.
- Crea y sube un plano.
- Para obtener más información sobre el entorno de ejecución de SaaS, consulta Descripción general del entorno de ejecución de SaaS.