Saltar al contenido
Olimpia
Esc
↑↓navegar↵abrir⌘Jvista previa
En esta página

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>")

¿Te ha resultado útil esta página?