Queremos conocer tu opinión sobre las funciones de marcas de características y la experiencia del usuario. Para proporcionar comentarios y dar forma al diseño de nuestros productos, completa este formulario y registra tu interés.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Crea y sube un esquema

Un plano es una configuración de Terraform empaquetada como una imagen de Open Container Initiative (OCI). La configuración de Terraform especifica la infraestructura y la aplicación que App Lifecycle Manager implementa Google Cloud.

En esta página, se describe cómo crear una imagen de OCI a partir de configuraciones de Terraform existentes y cómo subirlas a App Lifecycle Manager.

Para obtener detalles sobre estas configuraciones de Terraform, consulta Planos en App Lifecycle Manager.

Antes de comenzar

Asegúrate de haber habilitado App Lifecycle Manager.
En el proyecto que usas para App Lifecycle Manager, asegúrate de tener un repositorio de Artifact Registry que esté configurado en el formato de Docker. Para obtener más detalles, consulta Crea un repositorio para App Lifecycle Manager.
Identifica las configuraciones de Terraform que deseas implementar con App Lifecycle Manager.
- Para obtener detalles sobre cómo decidir cómo modelar la oferta de la app con planos, consulta Determina el modelo de la oferta de la app
- Para obtener detalles sobre los requisitos de la configuración de Terraform, consulta Requisitos de los planos.

Crea y sube el plano

Para implementar las configuraciones de Terraform Google Cloud con App Lifecycle Manager, debes hacer lo siguiente:

Empaqueta las configuraciones de Terraform en imágenes de OCI. Estas imágenes de OCI se denominan planos.
Coloca estas imágenes de OCI en el repositorio de Artifact Registry que identificaste o configuraste.

Según cómo elijas crear y subir el plano, puedes realizar todos los pasos de forma manual o App Lifecycle Manager puede realizar algunos de ellos.

Puedes crear la imagen de OCI y subirla al repositorio con cualquiera de los siguientes métodos:

Sube un archivo ZIP que contenga la configuración de Terraform. App Lifecycle Manager usa el archivo ZIP para crear la imagen de OCI.

Consulta los detalles en la siguiente sección: Sube un archivo ZIP.
Conecta un repositorio de Git que tenga los archivos de Terraform. App Lifecycle Manager usa los archivos para crear la imagen de OCI requerida. Luego, App Lifecycle Manager usa Cloud Build para compilar y subir el plano cada vez que actualizas tu repositorio.

Consulta los detalles en la siguiente sección: Conéctate a un repositorio de Git.
Compila la imagen de OCI de forma local y envía la imagen al repositorio en Artifact Registry.

Consulta los detalles en la siguiente sección: Compila y envía una imagen de forma manual.
Automatiza la creación y el envío de la imagen de OCI a un repositorio en Artifact Registry. Automatizar este proceso te ayuda a incorporar App Lifecycle Manager en una canalización de CI/CD.

Consulta los detalles en la siguiente sección: Automatiza la creación de planos.

Sube un archivo ZIP

Puedes crear un archivo ZIP de los archivos de Terraform. Subes este archivo a App Lifecycle Manager cuando creas una versión o un tipo de unidad. App Lifecycle Manager usa el archivo ZIP para crear la imagen de OCI requerida.

Para proporcionar un plano con un archivo ZIP, haz lo siguiente:

Navega al directorio de tu proyecto de Terraform.
Crea un archivo ZIP que contenga la configuración de Terraform.
- Asegúrate de lo siguiente:
  - El archivo ZIP solo contiene tus archivos de Terraform. Por ejemplo, main.tf, variables.tf, outputs.tf, versions.tf y módulos.
  - El archivo ZIP no contiene archivos innecesarios, por ejemplo, directorios .git o un Dockerfile.
- El comando para crear un archivo ZIP podría verse similar a este: zip terraform-files.zip main.tf outputs.tf variables.tf versions.tf
Sube el archivo ZIP cuando crees una versión o cuando crees un tipo de unidad.

App Lifecycle Manager usa el archivo ZIP para crear la imagen de OCI requerida y la envía al repositorio de Artifact Registry.

Conéctate a un repositorio de Git

Si almacenas tu configuración de Terraform en un repositorio de Git, puedes conectar App Lifecycle Manager a este repositorio. App Lifecycle Manager usa los archivos para crear la imagen de OCI requerida cuando creas un tipo de unidad o una versión.

Para proporcionar un plano con un repositorio de Git, haz lo siguiente:

Asegúrate de que tus archivos de Terraform se encuentren en el directorio raíz de tu repositorio de Git.
Conecta tu repositorio de Git a App Lifecycle Manager cuando crees una versión o cuando crees un tipo de unidad.

App Lifecycle Manager usa Developer Connect para conectarse al repositorio de Git. Para obtener más detalles sobre Developer Connect, consulta la documentación de Developer Connect.

App Lifecycle Manager usa los archivos de Terraform del repositorio de Git para crear la imagen de OCI requerida y la envía al repositorio de Artifact Registry.

Esta integración automatiza el proceso de creación de planos cada vez que actualizas tu código de Terraform en tu repositorio. Cuando hay cambios en el repositorio de Git vinculado, App Lifecycle Manager usa los archivos modificados para compilar automáticamente una nueva imagen de OCI y, luego, la envía al repositorio de Artifact Registry.

Compila y envía una imagen de forma manual

Este método te brinda un control detallado sobre el proceso de creación de planos.

Para crear un plano de forma manual, sigue estos pasos:

En el directorio raíz de tus archivos de Terraform, crea un archivo llamado Dockerfile con el siguiente contenido:
```
# syntax=docker/dockerfile:1-labs
FROM scratch
COPY --exclude=Dockerfile --exclude=.git --exclude=.gitignore . /
```
Este Dockerfile usa una imagen base mínima (scratch). Considera incluir dockerignore en el comando para excluir archivos que no sean relevantes, como los siguientes:
- el Dockerfile en sí
- el directorio .git
- el archivo .gitignore
Si no tienes un compilador de Docker, crea un compilador docker-container con docker buildx usando el siguiente comando:
```
docker buildx create --name container --driver=docker-container
```

Ejecuta el siguiente comando docker buildx build desde tu directorio de Terraform para compilar y enviar el plano a Artifact Registry:

IMAGE_NAME=us-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/IMAGE_NAME:TAG
ENGINE_TYPE=inframanager
ENGINE_VERSION=TERRAFORM_VERSION

docker buildx build -t $IMAGE_NAME \
  --builder=container \
  --push \
  --annotation "com.easysaas.engine.type=$ENGINE_TYPE" \
  --annotation "com.easysaas.engine.version=$ENGINE_VERSION" \
  --provenance=false .

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto.
REPOSITORY_NAME: Es el nombre de tu repositorio de Artifact Registry.
IMAGE_NAME: Es un nombre para la imagen de tu plano.
TAG: Es una etiqueta para la versión de tu imagen (por ejemplo, latest o v1.0.0). Elegir una etiqueta descriptiva te ayuda a administrar de manera eficaz las versiones del plano.
TERRAFORM_VERSION: Es la versión compatible de Terraform que se usará. Consulta Versiones compatibles de Terraform para obtener la lista de versiones compatibles con Infrastructure Manager.

Un comando podría verse similar al siguiente ejemplo:

IMAGE_NAME=us-docker.pkg.dev/saas-docs-testing/blueprints-repo/my-terraform-blueprint:v1.0.0
ENGINE_TYPE=inframanager
ENGINE_VERSION=1.5.7

docker buildx build -t $IMAGE_NAME \
  --builder=container \
  --push \
  --annotation "com.easysaas.engine.type=$ENGINE_TYPE" \
  --annotation "com.easysaas.engine.version=$ENGINE_VERSION" \
  --provenance=false .

La imagen de OCI está en el repositorio de Artifact Registry.

Para usar esta imagen con App Lifecycle Manager, selecciónala cuando la crees una versión, o cuando crees un tipo de unidad.

Automatiza la creación de planos

Puedes automatizar la creación de la imagen de OCI y el envío a Artifact Registry con Cloud Build. Puedes configurar un activador para que, cada vez que se cambie el código de Terraform, la imagen de OCI se compile y se envíe automáticamente a Artifact Registry.

Para configurar esta automatización, haz lo siguiente:

En la raíz de tu repositorio de Terraform, crea un archivo cloudbuild.yaml con la siguiente configuración:

steps:
- id: 'Create Dockerfile'
  name: 'bash'
  args: ['-c', 'echo -e "# syntax=docker/dockerfile:1-labs\nFROM scratch\nCOPY --exclude=Dockerfile.Blueprint --exclude=.git --exclude=.gitignore . /" > Dockerfile.Blueprint']
- id: 'Create docker-container driver'
  name: 'docker'
  args: ['buildx', 'create', '--name', 'container', '--driver=docker-container']
- id: 'Build and Push docker image'
  name: 'docker'
  args: ['buildx', 'build', '-t', '${_IMAGE_NAME}', '--builder=container', '--push', '--annotation', 'com.easysaas.engine.type=${_ENGINE_TYPE}','--annotation', 'com.easysaas.engine.version=${_ENGINE_VERSION}', '--provenance=false','-f', 'Dockerfile.Blueprint', '.']
serviceAccount: '${_SERVICE_ACCOUNT}'
substitutions:
  _SERVICE_ACCOUNT: 'projects/PROJECT_ID/serviceAccounts/CLOUD_BUILD_SERVICE_ACCOUNT'
  _IMAGE_NAME: 'us-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/IMAGE_NAME:latest'
  _ENGINE_TYPE: 'inframanager'
  _ENGINE_VERSION: 'TERRAFORM_VERSION'
options:
  logging: CLOUD_LOGGING_ONLY