Como criar uma VM Ubuntu 24 em São Paulo via Terraform na LetsCloud?

Se você está buscando uma forma rápida e confiável de provisionar máquinas virtuais no Brasil com Terraform, a LetsCloud é uma ótima escolha. Neste guia, você aprenderá passo a passo como iniciar uma instância Ubuntu 24.04 LTS na região de São Paulo usando o provedor oficial da LetsCloud para Terraform.

Pré-requisitos

Antes de começar, você precisará de:

• Terraform instalado
• Uma conta em https://www.letscloud.io
• Seu API Token da LetsCloud disponível em: https://my.letscloud.io/profile/client-api
• Uma chave SSH adicionada à sua conta: https://my.letscloud.io/profile/ssh-keys

Estrutura do projeto

Crie uma pasta chamada letscloud-vm e dentro dela, crie o arquivo main.tf com o seguinte conteúdo:

terraform {
  required_providers {
    letscloud = {
      source  = "letscloud-community/letscloud"
      version = "~> 1.0.0"
    }
  }
}

provider "letscloud" {
  api_token = var.letscloud_api_token
}

data "letscloud_ssh_key_lookup" "admin" {
  label = var.letscloud_ssh_key
}

resource "letscloud_instance" "server" {
  label         = "web-server"
  plan_slug     = "1vcpu-2gb-20ssd"
  image_slug    = "ubuntu-24.04-x86_64"
  location_slug = "SAO2"
  hostname      = "web.example.com"

  ssh_keys = [data.letscloud_ssh_key_lookup.admin.id]

  password = "P@ssw0rd123!Secure"
}

Agora crie o arquivo variables.tf:

variable "letscloud_api_token" {
  description = "Seu token de API da LetsCloud"
  type        = string
}

variable "letscloud_ssh_key" {
  description = "Nome (label) da chave SSH registrada na sua conta LetsCloud"
  type        = string
}

Opcionalmente, crie um arquivo terraform.tfvars:

letscloud_api_token = "seu_token_aqui"
letscloud_ssh_key   = "nome_da_sua_chave_ssh"

Como encontrar o nome da sua chave SSH

1. Faça upload da sua chave pública SSH em: https://my.letscloud.io/profile/ssh-keys
2. Copie o nome (label) exibido após o upload. Use este valor na variável correspondente.

Executando o Terraform

Execute os seguintes comandos:

terraform init
terraform plan
terraform apply

Confirme com yes quando solicitado. Em poucos minutos, sua instância Ubuntu 24.04 estará em execução na região de São Paulo.

Resultado esperado

• Instância ativa com Ubuntu 24.04
• IP público atribuído
• Acesso SSH liberado com a chave cadastrada

Dicas finais

• Você pode destruir a VM com terraform destroy
• Altere plan_slug para redimensionar sua VM
• Altere location_slug para outras regiões como MIA1, LON1, etc.
• Documentação completa disponível em: https://github.com/letscloud-community/terraform-provider-letscloud