Flujos comunes
Las secuencias de herramientas que usa un agente para desplegar, conectar bases, configurar dominios y arreglar un deploy roto.
Desplegar una carpeta local
create_app(name: "web", source: "upload", port: 3000)
→ upload.command_git (o command_tar si no hay git)
deploy(app: "web", source_key: "<de create_app>", message: "primer deploy")
get_deployment(app: "web", wait_seconds: 50) # repetir mientras esté queued, building o deploying
get_logs(app: "web", since: "5m")
Para subir código nuevo después: get_upload_url → subir → deploy(source_key).
Desplegar desde GitHub
create_app(name: "api", source: "github", repo: "acme/api", branch: "main")
get_deployment(app: "api", wait_seconds: 50)
Desde ahí, cada push a main despliega solo. Si create_app devuelve invalid_repo, la GitHub App de Olimpia no está instalada en ese repo: la persona tiene que agregarlo desde la consola (Apps → Nueva app), o se puede desplegar con source=upload.
Imagen de Docker
create_app(name: "uptime", source: "image", image: "louislam/uptime-kuma:2", port: 3001)
Template
list_templates(search: "n8n")
deploy_template(template: "n8n", name: "flujos") # crea la app, la base "flujos" y las variables
get_deployment(app: "flujos", wait_seconds: 50)
Base de datos para una app
create_resource(kind: "postgres", name: "main", connect_to_app: "api")
deploy(app: "api")
connect_to_app carga DATABASE_URL en la app. Lo mismo con kind: "redis" (REDIS_URL) y kind: "bucket" (variables AWS_* y BUCKET_NAME). Para una base que ya existe: connect_resource(app, kind, name).
Email desde un dominio propio
create_resource(kind: "email", name: "mail.tuempresa.com") # devuelve dns_records
get_connection(kind: "email", name: "mail.tuempresa.com") # revisa el DNS hasta status SUCCESS
connect_resource(app: "api", kind: "email", name: "mail.tuempresa.com")
La persona carga los dns_records en su proveedor DNS. Con el dominio verificado, la app manda con POST $EMAIL_API_URL/v1/emails y Authorization: Bearer $EMAIL_API_KEY. Ver Enviar emails.
Revisar y arreglar datos
list_tables(database: "main")
query_postgres(database: "main", sql: "select id, email from users order by created_at desc limit 20")
query_postgres(database: "main", sql: "update users set plan = 'pro' where id = 42", write: true)
Antes de cualquier sentencia que borre o reescriba datos, el agente tiene que pedir confirmación.
Backups de una base
set_backups(database: "main", bucket: "backups") # un bucket de Olimpia del mismo proyecto
run_backup(database: "main") # verifica que funcione
set_backups(database: "main", schedule: "0 */6 * * *") # después, cambiar solo la frecuencia
Para guardarlos en un S3 propio, en vez de bucket se pasan endpoint, s3_bucket, access_key_id y secret_access_key, más confirm con el nombre de la base cuando la persona lo aprobó. get_backups muestra la configuración y los últimos archivos.
Dominio propio
add_domain(app: "web", domain: "app.acme.com") # devuelve los registros DNS
check_domain(app: "web", domain: "app.acme.com") # repetir hasta active
La persona carga los dos registros en su proveedor de DNS: el CNAME y el TXT de _olimpia, que prueba que el dominio es suyo. Sin ese TXT, el dominio no se activa.
Estimar el costo
estimate_cost(memory_gb: 0.5, vcpu: 0.1, disk_gb: 2) # usage_usd: 7.5, hobby: 7.5, pro: 20
get_usage() # uso actual del proyecto
estimate_cost no toca nada: sirve antes de desplegar o para comparar planes. Ver Precios y facturación.
Variables de entorno
get_env(app: "api")
set_env(app: "api", set: { "LOG_LEVEL": "debug" }, remove: ["OLD_FLAG"], redeploy: true)
Arreglar un deploy que falló
get_deployment(app: "web") # leer error y build_log_tail
# corregir la causa en el código
get_upload_url(app: "web") → subir → deploy(app: "web", source_key: "...")
error |
Qué hacer |
|---|---|
source_failed |
Upload: la subida venció o no terminó. GitHub: revisar acceso al repo y la rama. |
build_failed |
Leer build_log_tail y corregir el código o la configuración. |
release_failed |
El proceso termina al arrancar: get_logs(since: "5m"). |
import_failed, internal_error |
Reintentar una vez con deploy. |
No reintentes el mismo build sin cambios, salvo con internal_error. Más casos en Si algo falla.
Volver atrás
get_app(app: "web") # lista los últimos deploys
rollback(app: "web", deployment: "<id anterior>")