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:

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

Read more about: PT-BROperating SystemUbuntu