Vertexa
Voltar para o site

Documentação Vertexa

Guia completo para começar a usar a plataforma de computação de alta performance

Introdução

A Vertexa é uma plataforma de computação de alta performance (HPC) que democratiza o acesso a infraestrutura computacional de ponta. Com apenas alguns comandos, você pode processar simulações CFD, análises genômicas, processamento de imagens e muito mais.

Simples

Deploy em minutos, não em semanas

Escalável

De 1 vCPU a clusters inteiros

Acessível

Preços justos baseados em VCUs

Quick Start

Comece a usar a Vertexa em menos de 5 minutos.

1

Instale o CLI

curl -fsSL https://cli.vertexa.cloud/install.sh | bash

Ou via npm: npm install -g @vertexa/cli

2

Autentique-se

vertexa login

Você será redirecionado para o navegador para completar a autenticação.

3

Execute sua primeira job

vertexa run \
  --env cfd \
  --input simulation.case \
  --output results/

CLI - Interface de Linha de Comando

O CLI da Vertexa é a forma mais rápida de interagir com a plataforma.

Comandos Principais

vertexa run

Executa uma job de computação

vertexa status [job-id]

Verifica o status de uma job

vertexa logs [job-id]

Visualiza logs em tempo real

vertexa list

Lista todas as suas jobs

vertexa cancel [job-id]

Cancela uma job em execução

Opções Avançadas

vertexa run \
  --env cfd \
  --cpu 64 \
  --memory 256GB \
  --gpu a100 \
  --gpu-count 4 \
  --timeout 24h \
  --input ./data \
  --output ./results \
  --name "CFD Simulation Wing Design"

API REST

Integre a Vertexa diretamente em suas aplicações usando nossa API REST.

Base URL: https://api.vertexa.cloud/v1

Autenticação: Bearer token no header Authorization

POST /jobs - Criar Job

curl -X POST https://api.vertexa.cloud/v1/jobs \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "cfd",
    "resources": {
      "cpu": 64,
      "memory": "256GB",
      "gpu": "a100",
      "gpuCount": 2
    },
    "input": "s3://bucket/input",
    "output": "s3://bucket/output",
    "timeout": "24h"
  }'

GET /jobs/:id - Status da Job

curl https://api.vertexa.cloud/v1/jobs/job_abc123 \
  -H "Authorization: Bearer YOUR_TOKEN"

Resposta:

{
  "id": "job_abc123",
  "status": "running",
  "progress": 45,
  "vcus_consumed": 1250,
  "created_at": "2025-01-16T10:30:00Z",
  "started_at": "2025-01-16T10:31:00Z"
}

DELETE /jobs/:id - Cancelar Job

curl -X DELETE https://api.vertexa.cloud/v1/jobs/job_abc123 \
  -H "Authorization: Bearer YOUR_TOKEN"

Ambientes Pré-configurados

A Vertexa oferece ambientes otimizados para diferentes casos de uso.

CFD (OpenFOAM)

Simulações de dinâmica de fluidos computacional

--env cfd

Genomics

Análise genômica e bioinformática

--env genomics

Satellite

Processamento de imagens de satélite

--env satellite

Machine Learning

Treinamento de modelos com GPUs

--env ml

Exemplos Práticos

Simulação CFD de Asa de Avião

# Preparar arquivos
mkdir -p input output

# Executar simulação
vertexa run \
  --env cfd \
  --cpu 128 \
  --memory 512GB \
  --input ./input/wing.mesh \
  --output ./output \
  --timeout 12h \
  --name "Wing Analysis v2.1"

# Monitorar progresso
vertexa logs -f [job-id]

Análise de DNA com GPU

vertexa run \
  --env genomics \
  --cpu 64 \
  --memory 256GB \
  --gpu a100 \
  --gpu-count 4 \
  --input ./sequences \
  --output ./results \
  --name "Genome Assembly"

Processamento de Imagem Satelital

vertexa run \
  --env satellite \
  --cpu 32 \
  --memory 128GB \
  --input s3://my-bucket/sentinel2/ \
  --output s3://my-bucket/processed/ \
  --name "NDVI Analysis 2025"

Segurança e Boas Práticas

API Keys

  • • Nunca compartilhe suas API keys
  • • Rotacione keys regularmente
  • • Use variáveis de ambiente
  • • Revogue keys não utilizadas

Dados Sensíveis

  • • Criptografe dados em repouso
  • • Use conexões TLS/SSL
  • • Implemente controle de acesso
  • • Audite logs regularmente

Custos

  • • Configure alertas de VCUs
  • • Use timeouts em jobs
  • • Monitore consumo diário
  • • Otimize recursos alocados

Performance

  • • Escolha o ambiente correto
  • • Aloque recursos adequados
  • • Use cache quando possível
  • • Paralelizar workloads

Precisa de ajuda? Entre em contato: support@vertexa.cloud

TermosPrivacidadeStatus