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)
- Abrí
https://app.cynchro.cloudy logueate con tu email + contraseña. - En Deploy an app, dejá la pestaña Docker image.
- Completá:
- App name:
hello(minúsculas, números, guiones) - Docker image:
nginxdemos/hello - Container port:
80
- App name:
- Click en Deploy. Vas a ver
Queued → https://hello.cynchro.cloud. - 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
helloen tu org y encoló un deployment. - El worker bajó
nginxdemos/helloy 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
- Buildear desde tu repo → Desplegar desde Git
- Agregar config/credenciales → Secrets
- Ver logs / restart / delete → Gestionar apps