Primeros pasos

De cero a una app corriendo. Elegí el camino Dashboard (clicks) o API (curl). Hacen exactamente lo mismo.

0. Qué necesitás

  • Una cuenta. Las crea el admin de la plataforma. Si no tenés, pedísela (npm run create-admin -- vos@ejemplo.com <password>).
  • El dashboard: https://app.cynchro.cloud
  • La base de la API: https://api.cynchro.cloud

Camino A — Dashboard (recomendado para empezar)

  1. Abrí https://app.cynchro.cloud y logueate con tu email + contraseña.
  2. En Deploy an app, dejá la pestaña Docker image.
  3. Completá:
    • App name: hello (minúsculas, números, guiones)
    • Docker image: nginxdemos/hello
    • Container port: 80
  4. Click en Deploy. Vas a ver Queued → https://hello.cynchro.cloud.
  5. Esperá ~5–15 segundos y abrí https://hello.cynchro.cloud. 🎉

Listo. La app aparece en la lista APPS con Logs / Restart / Stop / Delete.


Camino B — API (curl)

1. Login para obtener un access token

API=https://api.cynchro.cloud

TOKEN=$(curl -s -X POST $API/auth/login \
  -H 'content-type: application/json' \
  -d '{"email":"vos@ejemplo.com","password":"tu-password"}' \
  | python3 -c 'import sys,json; print(json.load(sys.stdin)["accessToken"])')

echo "$TOKEN"   # un JWT; válido ~15 min (se renueva con /auth/refresh)

2. Desplegar una app

curl -s -X POST $API/deploy \
  -H "authorization: Bearer $TOKEN" \
  -H 'content-type: application/json' \
  -d '{"name":"hello","image":"nginxdemos/hello","port":80}'

3. Verificar que está viva

curl -I https://hello.cynchro.cloud      # esperá HTTP/2 200

Qué pasó

  • La API creó una app hello en tu org y encoló un deployment.
  • El worker bajó nginxdemos/hello y arrancó un contenedor con límites por defecto (1 CPU, 512 MB).
  • Traefik emitió un cert Let’s Encrypt real y ruteó https://hello.cynchro.cloud.

Siguientes pasos


This site uses Just the Docs, a documentation theme for Jekyll.