> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/es/automation-api/terraform-vergeio-provider.md).

# Proveedor de Terraform de VergeIO

El **Proveedor de Terraform de VergeIO** permite la integración y automatización de la infraestructura de VergeOS con **Terraform**. Permite a los usuarios definir, gestionar y escalar recursos de VergeOS como parte de flujos de trabajo de Infraestructura como Código (IaC).

Para la documentación y los ejemplos más recientes del proveedor, consulte lo siguiente:

* [Repositorio de GitHub](https://github.com/verge-io/terraform-provider-vergeio) para el proveedor Terraform de VergeIO.
* [Documentación del Registro de Terraform](https://registry.terraform.io/providers/verge-io/vergeio/latest) para uso oficial y actualizaciones.

***

## Ejemplo de uso

Para ejemplos de uso más detallados, consulte la [carpeta docs](https://github.com/verge-io/terraform-provider-vergeio/tree/main/docs) en el repositorio de GitHub.

### Configuración de ejemplo

```hcl
provider "vergeio" {
  host     = "https://some_url_or_ip"
  username = "my_user"
  password = "my_password"
  insecure = false  # Use true si utiliza certificados SSL autofirmados
}

resource "vergeio_vm" "new_vm" {
  name        = "NEW VM"
  description = "NEW TF VM"
  enabled     = true
  os_family   = "linux"
  cpu_cores   = 4
  machine_type = "q35"
  ram         = 8192
}
```

### Inicialización y aplicación

Para aplicar la configuración:

```bash
terraform init && terraform apply
```

Referencia de configuración

```
host (Required): URL o dirección IP del sistema o inquilino de VergeOS.
username (Required): Nombre de usuario para el sistema o inquilino de VergeOS.
password (Required): Contraseña para el nombre de usuario proporcionado.
insecure (Optional): Establézcalo en true para sistemas que usan certificados SSL autofirmados.
```

### Recursos

Los siguientes recursos de VergeOS se pueden administrar mediante Terraform:

```
vergeio_drive
vergeio_member
vergeio_network
vergeio_nic
vergeio_user
vergeio_vm
```

### Fuentes de datos

Las siguientes fuentes de datos están disponibles para consultar recursos de VergeOS:

```
vergeio_clusters
vergeio_groups
vergeio_mediasources
vergeio_networks
vergeio_nodes
vergeio_version
vergeio_vms
```

## Prueba de una configuración de ejemplo

Para probar su configuración, cree un archivo main.tf en su espacio de trabajo de Terraform:

```hcl

terraform {
  required_providers {
    vergeio = {
      source = "vergeio/cloud/vergeio"
    }
  }
}

provider "vergeio" {
  host     = "https://someURLorIP"
  username = "username"
  password = "password"
}

resource "vergeio_vm" "new_vm" {
  name        = "NEW VM"
  description = "NEW TF VM"
  enabled     = true
  os_family   = "linux"
  cpu_cores   = 4
  machine_type = "q35"
  ram         = 8192
}
```

Luego, ejecute el siguiente comando:

```bash

terraform init && terraform apply
```

***

{% hint style="info" %}
**Información del documento**

* Última actualización: 2024-09-03
* Versión de VergeOS: 4.12.6
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/es/automation-api/terraform-vergeio-provider.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.