Guía del panel

Iniciar sesión

1. En cloady.com, haz clic en Sign in para abrir la página de inicio de sesión. Escribe tu correo en Email y tu contraseña en Password, y haz clic en Sign in. Las contraseñas existentes siguen funcionando.
2. Para entrar con tu cuenta de GitHub o de Google, haz clic en Continue with GitHub o Continue with Google.
3. Si tu empresa ha configurado el inicio de sesión único (SSO), haz clic en Continue with SSO, escribe tu correo de trabajo en Work email y haz clic en Continue with SSO. Inicias sesión en el proveedor de identidad de tu empresa y te unes a su espacio de trabajo con el rol developer.
4. Para crear una cuenta o recuperar el acceso, elige Create account or reset password. Escribe tu correo, solicita un código y, después, introduce ese código y una contraseña nueva de al menos 12 caracteres. El código sirve una sola vez y caduca a los 15 minutos; tras 5 intentos fallidos, espera 15 minutos. A partir de ahí, inicias sesión con tu correo y tu contraseña.
5. Si tienes activada la verificación en dos pasos, introduce el código de 6 dígitos que te enviamos por SMS y haz clic en Verify & continue. Esto ocurre sea cual sea la forma en que hayas iniciado sesión.
6. Todas las cuentas necesitan un teléfono verificado. Si el tuyo no lo está, la página de inicio de sesión te lo pide a continuación: introduce tu número, haz clic en Text me a code, escribe el código de 6 dígitos y haz clic en Verify & continue. Solo se permite una cuenta por número, y nada más en Cloady funciona hasta que completes este paso.
7. Después llegas a tu espacio de trabajo. La primera vez, Cloady crea uno para ti.

También puedes empezar desde el campo de despliegue de cloady.com antes de iniciar sesión: elige una plantilla, un repositorio, una imagen o una carpeta y configúralo ahí. Deploy convierte la tarjeta en el formulario de inicio de sesión sin salir de la página (GitHub, Google y SSO se abren en una ventana pequeña que se cierra sola, y el inicio de sesión con correo y contraseña se queda en la tarjeta) y, en cuanto entras, el despliegue continúa con todo lo que hayas configurado, en un espacio de trabajo nuevo con el nombre que se mostraba en la dirección de la app.

Crear un espacio de trabajo

Un espacio de trabajo reúne tus aplicaciones, tu equipo y una suscripción. Su dirección es cloady.com/w/{slug}.

1. Haz clic en el botón WORKSPACE, a la izquierda de la barra superior, y luego en + New workspace.
2. Escribe un nombre en Name (p. ej., Acme Inc). La vista previa de la URL se actualiza debajo del campo; si ese nombre ya está en uso, Cloady añade un sufijo y te avisa.
3. Si quieres, sube un icono en Icon, en la cabecera de la ventana. Los colores no se eligen a mano: el degradado sale del icono o, si no subes ninguno, del nombre.
4. Haz clic en Create workspace. Crear uno no cuesta nada; la ventana muestra la asignación gratuita que recibe cada espacio de trabajo.

Una sola suscripción cubre todo el espacio de trabajo, y puedes desplegar en cualquier región desde el primer momento. Lo que paga depende de lo que declaran sus apps (consulta Capacidad y precio), y un espacio de trabajo cuyas apps quepan en 0,5 vCPU, 1 GB de RAM y 5 GB de SSD no paga nada.

Recorrido por el panel

El panel es una sola pantalla: una barra superior, la cabecera del espacio de trabajo con sus totales y, debajo, la cuadrícula Applications.

1. La barra superior, de izquierda a derecha: el logotipo de cloady (inicio), el selector WORKSPACE con el nombre del espacio de trabajo actual, el selector de región (un globo y el código de la región) y el selector de entorno (un punto de color y PRODUCTION / PREVIEW / DEVELOPMENT).
2. Haz clic en el selector de región para cambiar de región: Deployed agrupa aquellas en las que ya tienes algo en ejecución, y Available, el resto. Puedes desplegar en todas las regiones de la lista.
3. Haz clic en el selector de entorno para cambiar de entorno. Filtra la cuadrícula y determina dónde va la siguiente instalación. Ambos selectores se reflejan en la URL, así que los enlaces del panel se pueden compartir: /w/{slug}/{region}/{env}.
4. Usa el cuadro Search applications… (o pulsa ⌘K) para filtrar la cuadrícula por nombre.
5. También a la derecha: los botones de las herramientas Terminal, Files, Database, Monitor y Git, el engranaje Settings, New application y el menú de tu avatar de cuenta.
6. En la cabecera del espacio de trabajo verás los recuentos apps / running, el cost mensual y cpu, ram y disk: los totales que declaran tus apps.
7. Debajo, Applications muestra todas las apps de la región y el entorno seleccionados. Filtra con All / Running / Stopped, ordena por Name, Status, CPU o Memory, y activa Expand para ver tarjetas con detalles en tiempo real. La tarjeta de borde discontinuo Add application es otra forma de empezar.

Instalar una app

1. Comprueba que el selector de entorno apunta a donde quieres desplegar. Una app se ejecuta exactamente en una región y un entorno; el entorno no se puede cambiar una vez creada la app, y solo Transfer la mueve a otra región.
2. Haz clic en New application en la barra superior o en la tarjeta Add application de la cuadrícula.
3. Usa el campo de la parte superior de la ventana. Pega la URL de un repositorio de GitHub, escribe el nombre de una imagen como nginx o ghcr.io/acme/api:1.4, escribe un registro como docker.io/ para explorar imágenes populares, o escribe para buscar entre las plantillas (WordPress, Postgres…) que aparecen debajo; también puedes soltar en él una carpeta o un docker-compose.yml. Haz clic en una fila, o pulsa Enter para elegir la resaltada.
4. El campo se convierte en la tarjeta de la app. Arriba: tu elección, su precio mensual y el botón de despliegue. Debajo, Services muestra lo que Cloady ha leído de tu origen y Settings enumera lo que puedes cambiar antes de desplegar. Haz clic en una fila para abrirla y pulsa Esc o Done para volver:
   • Resources: escala la CPU y la memoria por encima o por debajo de los valores predeterminados de la plantilla.
   • Payment method: aparece cuando esta app hace que el espacio de trabajo supere su asignación gratuita. Indica la tarjeta a la que se hará el cargo. El propietario del espacio de trabajo puede añadir una tarjeta ahí mismo; pasa a ser la tarjeta predeterminada de su cuenta o, si el espacio de trabajo tiene una tarjeta propia, la sustituye. Si no hay ninguna tarjeta registrada, Deploy te pide una como paso adicional y el despliegue continúa por sí solo en cuanto la guardas.
   • Region: dónde se ejecuta la app. Todas las regiones cuestan lo mismo.
   • Domains: aquí editas el nombre de la app; su dirección de cloady.io sigue al nombre y siempre está activa. Añade tu propio dominio igual que en la configuración de la app; Check DNS te dice si sus registros ya apuntan a Cloady.
   • Managed backups: instantáneas diarias con 7 puntos de restauración, por el 20% del precio de esta app. Aparece cuando la app tiene volúmenes.
   • Environment: las variables de la app. Las plantillas indican las que necesitan y generan las contraseñas por ti.
   • Build: en repositorios y código subido, la rama, el directorio raíz, el redespliegue con cada push y los comandos de build y de inicio (si los dejas vacíos, Cloady los detecta).
5. Pulsa Enter o haz clic en Deploy. Cloady compila la app, le asigna un nombre de host con HTTPS ya funcionando y la arranca.
6. La tarjeta muestra el despliegue a medida que avanza, y las contraseñas o claves generadas quedan disponibles en Settings → Environment de la app.

La dirección de tu app se compone del nombre de la app, un código corto y el nombre del espacio de trabajo:

my-blog-k7q2v9ze-acme.cloady.io

Todas las regiones y todos los entornos usan este mismo formato; el código corto hace que la dirección de cada app sea única.

Si el espacio de trabajo no supera su asignación gratuita, la app se lanza sin ningún cargo. Si la supera, se cobra el resto del mes a la tarjeta registrada. Si no hay ninguna tarjeta registrada, Deploy te pide primero una en Payment method; si la tarjeta es rechazada, el lanzamiento falla con payment_required, y Use another card te lleva de vuelta allí. También puedes reducir el tamaño de la app.

Gestionar una app

1. Haz clic en la tarjeta de una app en la cuadrícula para abrir su vista de detalle, o usa los controles de la propia tarjeta.
2. Usa los botones de ciclo de vida de la cabecera: Start arranca una app detenida, Stop apaga sus contenedores y conserva los datos, Restart los reinicia y Open abre la URL pública en una pestaña nueva.
3. Haz clic en Settings para abrir la ventana App settings:
   • General: Name, Slug (letras minúsculas, números y guiones, hasta 24 caracteres), Region (se cambia con Transfer, en Danger zone) y, en las apps basadas en un repositorio, el selector de rama, el interruptor Auto-deploy y el seguimiento de ramas en preview.
   • Services: los contenedores que ejecuta esta app, cada uno con un botón de terminal.
   • Volumes: el almacenamiento persistente. Sobrevive a reinicios, redespliegues y paradas; solo se borra si eliminas la app.
   • Resources: el uso actual de CPU, memoria y disco, los controles deslizantes de escala CPU y MEMORY (de 0.5× a 4×) y la ampliación de cada volumen. Los volúmenes pueden crecer, pero nunca reducirse. Antes de que hagas clic en Save changes, muestra cuánto añade o ahorra el cambio en la factura mensual; un aumento se cobra al guardar y una reducción se aplica en tu próxima renovación.
   • Environment: las variables de la app. Los secretos permanecen ocultos hasta que los muestras, y puedes soltar un archivo .env en esta pestaña para importar muchas a la vez. Los cambios se aplican en el siguiente despliegue.
   • Deployments: cada despliegue con sus logs de build, un botón para desplegar y la opción de revertir a los anteriores que salieron bien.
   • Domains: el nombre de host integrado y los dominios propios (siguiente sección).
   • Backups: la instantánea de emergencia automática que recibe cada app, más el interruptor Managed backups (instantáneas diarias con 7 puntos de restauración, por el 20% del precio de esta app). Cada instantánea tiene un botón Restore, y restaurar sustituye los datos actuales por los de la instantánea.
   • Logs: la salida de tus contenedores en tiempo real.
   • Danger zone: Stop application, Transfer application a otro espacio de trabajo, a otra región o a ambos (los datos se conservan; mover la app a otra región la detiene mientras se copian sus volúmenes) y Delete application.

Renombrar es seguro; eliminar, no. Cambia Name en General cuando quieras: la dirección sigue al nombre y los dominios propios siguen funcionando. Si editas el Slug manualmente, deja de seguir al nombre a partir de ese momento. Eliminar una app destruye de forma permanente sus servicios, su almacenamiento, sus variables, sus dominios y su historial de despliegues: nunca elimines una app para cambiarle el nombre. Para confirmar la eliminación, tienes que escribir el slug de la app.

Añadir un dominio propio

1. Abre la app, haz clic en Settings y luego en la pestaña Domains.
2. El nombre de host BUILT-IN de la parte superior es la dirección de cloady.io en la que la app ya responde, con HTTPS.
3. Escribe tu nombre de host (p. ej., app.yourdomain.com) en la fila para añadir dominios y haz clic en Add domain. Si en lugar de eso quieres enviar a los visitantes a otro sitio, marca primero Redirect to another host (permanent) y rellena el destino.
4. En DNS configuration, elige un método con el selector:
   • CNAME: la opción predeterminada para subdominios. Añade en tu proveedor de DNS el único registro CNAME que se muestra.
   • A / AAAA: para un dominio raíz (apex), que no puede ser un CNAME. Añade los registros A (IPv4) y AAAA (IPv6) que se muestran.
5. Usa los botones de copiar para obtener los valores exactos y crea los registros en tu registrador.
6. En cuanto el DNS resuelve, Cloady obtiene el certificado por ti; el estado de cada dominio pasa por queued → pending → issued. Si al cabo de unos minutos todavía no está en issued, el registro no apunta a Cloady: vuelve a revisarlo en tu registrador.

Configuración del espacio de trabajo y cambios de capacidad

1. Haz clic en Settings (el engranaje de la barra superior) para abrir la ventana Settings del espacio de trabajo. Pestañas: General, Members, Single sign-on, Domains, Billing, Integrations, Import, Danger zone.
2. Abre Billing. Las tarjetas de la parte superior muestran THIS MONTH (lo facturado en este periodo), DUE TODAY (lo que quede pendiente de pago) y NEXT MONTH (lo que costará la renovación). Una sola suscripción cubre todo el espacio de trabajo: no hay facturación por región.
3. Subscribed capacity muestra el total que declaran tus apps: el plan en el que cae, la CPU, la RAM y el SSD con la parte del precio que corresponde a cada uno, y el total mensual. Aquí no hay nada que comprar; se ajusta a tus apps.
4. Para cambiarla, escala una app en su pestaña Settings → Resources, o despliega o elimina apps. La pestaña muestra cuánto añade o ahorra un cambio en la factura mensual antes de que hagas clic en Save changes. Los aumentos se cobran de inmediato y solo se aplican cuando el pago se completa. Las reducciones empiezan en tu próxima renovación, así que conservas lo que ya pagaste.
5. Cuando el espacio de trabajo tiene una suscripción, Workspace card sustituye la tarjeta predeterminada de tu cuenta solo para este espacio de trabajo. Déjalo vacío para usar la tarjeta predeterminada de la cuenta, que se muestra debajo.
6. Para invitar a tus compañeros de equipo, abre Members y añádelos por correo electrónico.
7. Para que tu empresa pueda iniciar sesión a través de su proveedor de identidad, abre Single sign-on (solo para admins del espacio de trabajo). Crea una app de OpenID Connect en tu proveedor (Okta, Microsoft Entra ID, Google Workspace, Auth0, Keycloak…) con la Redirect URI que se muestra; después rellena Email domain, Issuer URL, Client ID y Client secret, y haz clic en Save. Añade el DNS record que aparece como registro TXT en tu proveedor de DNS y haz clic en Check DNS. Cuando indique ACTIVE, cualquier persona a la que tu proveedor autentique con un correo de ese dominio se une al espacio de trabajo con el rol developer.
8. Integrations conecta GitHub para que puedas desplegar repos privados. Danger zone contiene Delete workspace: escribes el slug del espacio de trabajo para confirmar, y todas sus aplicaciones, todos sus datos y todos sus dominios se destruyen de forma permanente.

Cuenta y tokens de API

Los tokens de acceso personal autentican la CLI, la API, el proveedor de Terraform y el servidor MCP en tu nombre, en todos tus espacios de trabajo.

1. Haz clic en tu avatar de cuenta, a la derecha de la barra superior, y luego en Account settings. Pestañas: Profile, Security, Preferences, Notifications, API tokens, Billing, Danger zone.
2. Abre la pestaña API tokens y haz clic en + New token.
3. Ponle un nombre en Name (p. ej., CLI · macbook), elige un alcance en Scope (Full access, Deploy only o Read only) y una caducidad en Expiry (No expiry, 30 days, 90 days o 1 year). Haz clic en Create token.
4. El secreto cldy_ se muestra una sola vez: haz clic en el botón de copiar para guardarlo y luego en Done. No se puede volver a consultar.
5. Usa el token como credencial bearer para la CLI, la API o el MCP. Para revocar un token, haz clic en Revoke en su fila.