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
- Faça upload da sua chave pública SSH em: https://my.letscloud.io/profile/ssh-keys
- 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 comoMIA1
,LON1
, etc. - Documentação completa disponível em: https://github.com/letscloud-community/terraform-provider-letscloud
0 COMMENTS