RESOURCE CATALOG

Compute (Instância Linux)

Linux instance: web, API, workers, or cron — web terminal and root SSH.

type: "compute"managed Linux compute — optional KVM hypervisor (Enterprise)

Definition

The customer's compute instance. Provisions declared vCPU and memory, exposes HTTP when applicable, and after **Start** offers **web root terminal**, **password SSH**, and the **tesserra-info** shell command. Autoscale applies to web/api/worker subtypes with replicas — not to the SSH Linux instance.

When to use

Sites and SPAs (React, Vue, Next.js, Astro).
HTTP and gRPC APIs.
Workers consuming queues.
Periodic jobs (cron subtype).

When not to use

Databases — use Datastore.
Workloads requiring dedicated GPU — available on Enterprise contracts only.

Configuration fields

Each field is validated at creation time. Defaults apply when fields are omitted.

config · compute

Campo	Tipo	Default · Opções
subtipo Tipo	enum	`linux_instancewebapiworkercrongame` Default`linux_instance`
imagem Imagem da aplicação	string	Default`nginx:latest`
porta Porta	int	Default`80`
cpu vCPU	string	Default`0.25`
memoria_mb Memória (MB)	int	Default`256`
replicas_min Réplicas mín.	int	Default`1`
replicas_max Réplicas máx.	int	Default`1`

Examples

Full payloads for POST to /api/projetos/{id}/recursos:

API with 2 minimum replicas

json

{
  "tipo": "compute",
  "nome": "api-pedidos",
  "config": {
    "subtipo": "api",
    "imagem": "ghcr.io/acme/api-pedidos:1.4.0",
    "porta": 3000,
    "cpu": "0.5",
    "memoria_mb": 512,
    "replicas_min": 2,
    "replicas_max": 6
  }
}

Async worker

json

{
  "tipo": "compute",
  "nome": "servidor-dev",
  "config": {
    "subtipo": "linux_instance",
    "sistema_operacional": "ubuntu-24.04",
    "cpu": "1.0",
    "memoria_mb": 2048,
    "acesso_ssh": true,
    "acesso_root": true
  }
}

Worker assíncrono

json

{
  "tipo": "compute",
  "nome": "fila-emails",
  "config": {
    "subtipo": "worker",
    "imagem": "ghcr.io/acme/email-worker:0.9",
    "cpu": "0.25",
    "memoria_mb": 256,
    "replicas_min": 1,
    "replicas_max": 4
  }
}

Related resources

Gateway

Receives traffic, distributes across replicas, manages domain and TLS.

Autoscale

Adjusts Compute replica count based on a metric.

Fabric

Private isolated network between Project resources.

Insight

Collects logs and metrics from Applications, with optional alerts.

Resource catalog

Datastore