Aprovisiona recursos de Agent Platform Workbench con Terraform

HashiCorp Terraform es una herramienta de infraestructura como código (IaC) que te permite aprovisionar y administrar la infraestructura de nube. Terraform proporciona complementos llamados proveedores que te permiten interactuar con proveedores de servicios en la nube y otras APIs. Puedes usar el proveedor de Terraform para Google Cloud para aprovisionar y administrar Google Cloud recursos, incluido Agent Platform Workbench.

En esta página, se presenta el uso de Terraform con Agent Platform Workbench, incluida una introducción a cómo funciona Terraform y algunos recursos para ayudarte a comenzar a usar Terraform con Google Cloud. También encontrarás vínculos a documentos de referencia de Terraform para Agent Platform Workbench, ejemplos de código y guías para usar Terraform para aprovisionar Agent Platform Workbench resources.

Para obtener instrucciones sobre cómo comenzar a usar Terraform para Google Cloud, consulta Instala y configura Terraform o la guía de inicio rápido de Terraform para Google Cloud .

Cómo funciona Terraform

Terraform tiene una sintaxis declarativa y orientada a la configuración que puedes usar para describir la infraestructura que deseas aprovisionar en tu Google Cloud proyecto. Después de crear esta configuración en uno o más archivos de configuración de Terraform, puedes usar la CLI de Terraform para aplicarla a tus recursos de Agent Platform Workbench.

En los siguientes pasos, se explica cómo funciona Terraform:

  1. Describe la infraestructura que deseas aprovisionar en un Terraform archivo de configuración. No es necesario que escribas código que describa cómo aprovisionar la infraestructura. Terraform aprovisiona la infraestructura por ti.
  2. Ejecuta el comando terraform plan, que evalúa tu configuración y genera un plan de ejecución. Puedes revisar el plan y realizar cambios según sea necesario.

  3. Luego, ejecuta el comando terraform apply que realiza las siguientes acciones:

    1. Aprovisiona tu infraestructura según tu plan de ejecución mediante la invocación las APIs de Agent Platform Workbench correspondientes en segundo plano.
    2. Crea un archivo de estado de Terraform, que es un archivo JSON que asigna los recursos del archivo de configuración a los recursos en la infraestructura del mundo real. Terraform usa este archivo para mantener un registro del estado más reciente de la infraestructura y determinar cuándo crear, actualizar y destruir recursos.

    3. Luego, cuando ejecutes terraform apply, Terraform usa la asignación en el archivo de estado para comparar la infraestructura existente con el código y realizar actualizaciones según sea necesario:

      • Si un objeto de recurso se define en el archivo de configuración, pero no existe en el archivo de estado, Terraform lo crea.
      • Si existe un objeto de recurso en el archivo de estado, pero tiene una configuración diferente de tu archivo de configuración, Terraform actualiza el recurso para que coincida con tu archivo de configuración.
      • Si un objeto de recurso en el archivo de estado coincide con tu archivo de configuración, Terraform deja el recurso sin cambios.

Recursos de Terraform para Agent Platform Workbench

Los recursos son los elementos fundamentales en el lenguaje de Terraform. Cada bloque de recursos describe uno o más objetos de infraestructura, como redes virtuales o instancias de procesamiento.

En la siguiente tabla, se enumeran los recursos de Terraform disponibles para Agent Platform Workbench:

Servicio Recursos de Terraform Fuentes de datos
Agent Platform Workbench google_workbench_instance_iam_policy

Guías basadas en Terraform para Agent Platform Workbench

En la siguiente tabla, se enumeran las guías prácticas y los instructivos basados en Terraform para Agent Platform Workbench:

Guía Detalles
Crea una instancia de Agent Platform Workbench Crea una instancia de Agent Platform Workbench con una configuración básica.
Administra el cierre inactivo en Terraform Configura los parámetros de configuración de cierre inactivo en una instancia de Agent Platform Workbench.
Actualiza un contenedor personalizado Cambia el campo container_image en la configuración de Terraform para actualizar la carga útil del contenedor.
Crear una instancia con metadatos específicos Crea una instancia de Agent Platform Workbench con metadatos específicos.

Planos y esquemas de Terraform para Agent Platform Workbench

Los módulos y los esquemas te ayudan a automatizar el aprovisionamiento y la administración de Google Cloud recursos a gran escala. Un módulo es un conjunto reutilizable de archivos de configuración de Terraform que crea una abstracción lógica de los recursos de Terraform. Un plano es un paquete de módulos implementables y reutilizables y una política que implementa y documenta una solución específica.

En la siguiente tabla, se enumeran los módulos y los esquemas relacionados con Agent Platform Workbench:

Módulo o esquema Detalles
ai-notebook En este módulo, se muestra cómo proteger datos confidenciales en una instancia de Agent Platform Workbench.

¿Qué sigue?