Aprovisiona recursos de Colab Enterprise con Terraform
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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
recursos de Google Cloud , incluido Colab Enterprise.
En esta página, se presenta el uso de Terraform con Colab Enterprise, 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 Colab Enterprise, ejemplos de código y guías para usar Terraform y aprovisionar recursos de Colab Enterprise.
Terraform tiene una sintaxis declarativa y orientada a la configuración que puedes
usar para describir la infraestructura que deseas aprovisionar en tu
proyecto de Google Cloud . 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 Colab Enterprise.
En los siguientes pasos, se explica cómo funciona Terraform:
Describe la infraestructura que deseas aprovisionar en un archivo de configuración de Terraform. No es necesario que escribas código que describa cómo aprovisionar la infraestructura. Terraform aprovisiona la infraestructura por ti.
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.
Luego, ejecuta el comando terraform apply, que realiza las siguientes acciones:
Aprovisiona tu infraestructura según tu plan de ejecución invocando las APIs de Colab Enterprise correspondientes en segundo plano.
Crea un archivo de estado de Terraform, que es un archivo JSON que asigna los recursos
de tu archivo de configuración a los recursos de la infraestructura del mundo real. Terraform usa este archivo para mantener un registro del estado más reciente de tu infraestructura y determinar cuándo crear, actualizar y destruir recursos.
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 se define un objeto de recurso 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 Colab Enterprise
Los recursos son los elementos fundamentales del 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 Colab Enterprise:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eTerraform is an infrastructure-as-code (IaC) tool that uses providers to manage cloud resources, including Colab Enterprise resources through the Google Cloud provider.\u003c/p\u003e\n"],["\u003cp\u003eTerraform uses a declarative syntax, where you describe the desired infrastructure in configuration files, and Terraform handles the provisioning, eliminating the need to write code for infrastructure management.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eterraform apply\u003c/code\u003e command provisions infrastructure based on your configuration, creates a state file to track resources, and then compares it to the infrastructure, making updates as needed.\u003c/p\u003e\n"],["\u003cp\u003eColab Enterprise offers specific Terraform resources, including \u003ccode\u003egoogle_colab_notebook_execution\u003c/code\u003e, \u003ccode\u003egoogle_colab_runtime\u003c/code\u003e, and \u003ccode\u003egoogle_colab_schedule\u003c/code\u003e, to manage different aspects of Colab Enterprise environments.\u003c/p\u003e\n"],["\u003cp\u003eThere are several Terraform-based guides available to help users manage Colab Enterprise, such as creating runtime templates, creating runtimes, and scheduling notebook runs.\u003c/p\u003e\n"]]],[],null,["# Provision Colab Enterprise resources with Terraform\n\nHashiCorp Terraform is an infrastructure-as-code (IaC) tool that lets you\nprovision and manage cloud infrastructure. Terraform provides plugins called\n*providers* that let you interact with cloud providers and other APIs. You can\nuse the *Terraform provider for Google Cloud* to provision and manage\nGoogle Cloud resources, including Colab Enterprise.\n\nThis page introduces you to using Terraform with Colab Enterprise, including an\nintroduction to how Terraform works and some resources to help you get started using\nTerraform with Google Cloud. You'll also find links to Terraform reference docs for\nColab Enterprise, code examples, and guides for using Terraform to provision\nColab Enterprise resources.\n\nFor instructions on how to get started with Terraform for Google Cloud, see\n[Install and configure Terraform](/docs/terraform/install-configure-terraform) or the\n[Terraform for Google Cloud quickstart](/docs/terraform/create-vm-instance).\n\nHow Terraform works\n-------------------\n\nTerraform has a declarative and configuration-oriented syntax, which you can\nuse to describe the infrastructure that you want to provision in your\nGoogle Cloud project. After you author this configuration in one or more\nTerraform configuration files, you can use the Terraform CLI to apply this\nconfiguration to your Colab Enterprise resources.\n\nThe following steps explain how Terraform works:\n\n1. You describe the infrastructure you want to provision in a *Terraform\n configuration file*. You don't need to write code describing how to provision the infrastructure. Terraform provisions the infrastructure for you.\n2. You run the `terraform plan` command, which evaluates your configuration and generates an execution plan. You can review the plan and make changes as needed.\n3. You run the `terraform apply` command, which performs the following\n actions:\n\n 1. It provisions your infrastructure based on your execution plan by invoking the corresponding Colab Enterprise APIs in the background.\n 2. It creates a *Terraform state file*, which is a JSON file that maps the resources in your configuration file to the resources in the real-world infrastructure. Terraform uses this file to keep a record of the most recent state of your infrastructure, and to determine when to create, update, and destroy resources.\n 3. When you run `terraform apply`, Terraform uses the mapping in\n the state file to compare the existing infrastructure to the code, and make\n updates as necessary:\n\n - If a resource object is defined in the configuration file, but doesn't exist in the state file, Terraform creates it.\n - If a resource object exists in the state file, but has a different configuration from your configuration file, Terraform updates the resource to match your configuration file.\n - If a resource object in the state file matches your configuration file, Terraform leaves the resource unchanged.\n\nTerraform resources for Colab Enterprise\n----------------------------------------\n\n*Resources* are the fundamental elements in the Terraform language. Each\nresource block describes one or more infrastructure objects, such as virtual\nnetworks or compute instances.\n\nThe following table lists the Terraform resources available for\nColab Enterprise:\n\n\n\u003cbr /\u003e\n\nTerraform-based guides for Colab Enterprise\n-------------------------------------------\n\nThe following table lists Terraform-based how-to guides and tutorials for\nColab Enterprise:\n\n\n\u003cbr /\u003e\n\nWhat's next\n-----------\n\n- [Terraform code samples for Colab Enterprise](/docs/samples?language=terraform)\n- [Terraform on Google Cloud documentation](/docs/terraform)\n- [Google Cloud provider documentation in HashiCorp](https://registry.terraform.io/providers/hashicorp/google/latest/docs)\n- [Infrastructure as code for Google Cloud](/docs/terraform/iac-overview)"]]