Introducción

Obtener acceso

Codara Cloud no tiene contraseñas propias. Tu cuenta se crea con una identidad verificada de GitHub o una identidad de Google habilitada, y ser miembro de una organización determina a qué puede acceder esa cuenta.

Unirse a la beta

Mientras Codara Cloud esté en beta, para contratar un plan necesitas un código de invitación personal. Para unirte a la organización de otra persona no hace falta: si te invitan al equipo, solo tienes que iniciar sesión.

1

Solicita acceso

Rellena el formulario de codaracloud.com/es/beta. Recibirás un correo de confirmación de cloud@codaracloud.com. Apuntarte a la lista no crea ninguna cuenta, suscripción ni cargo.

2

Recibe tu invitación

Una persona revisa cada solicitud. Cuando podemos ofrecerte una plaza, te enviamos por correo una invitación con un código como BETA-XXXXXXXXXX. El código es para un plan con facturación mensual, solo funciona una vez y caduca a los 30 días.

3

Inicia sesión e introduce el código

Abre el enlace del correo: te lleva por el inicio de sesión y rellena el plan y el código por ti. También puedes elegir Tengo un código de invitación en codaracloud.com/es, iniciar sesión con GitHub o Google e introducir el código del correo.

4

Conecta Discord (opcional)

La configuración de tu cuenta te ofrece conectar Discord. Al conectarlo, te unes al servidor de Codara en Discord y tus 3 primeros meses son gratis en lugar de uno. Hazlo antes del checkout: no se puede añadir a una suscripción que ya tengas. Si más adelante sales de Discord, conservas tus meses gratis. Cada cuenta de Discord desbloquea la oferta una sola vez.

5

Confirma en Stripe Checkout

Antes de confirmar, el checkout te muestra el precio, los impuestos y cuándo termina el periodo gratuito. Se necesita tarjeta. Tu plan empieza en cuanto se completa el checkout.

La oferta de la beta

Si entras en la beta y te unes a nuestro Discord, tus 3 primeros meses son gratis; si no, el primer mes es gratis. En cualquier plan (Starter, Standard, Pro o Scale), con facturación mensual, tarjeta obligatoria y cancelación cuando quieras. En Starter, antes tienes la prueba gratuita de 7 días. Los 3 meses gratis cubren el plan que elegiste; cuando terminen, puedes elegir otro plan. Después del periodo gratuito, el plan se renueva cada mes a su precio normal más impuestos hasta que lo canceles. Puedes cancelar cuando quieras en Cuenta y organización → Facturación y uso; los precios normales están en precios.

Quién puede iniciar sesión

Mientras el registro desde el navegador esté habilitado, cualquier identidad verificada de un proveedor puede crear una cuenta, pero una cuenta por sí sola no crea ninguna organización, carga de trabajo, suscripción, prueba gratuita ni cargo. Una persona propietaria o administradora de una organización puede invitar al correo verificado de esa cuenta. El enlace generado es de un solo uso y, por defecto, caduca a los 7 días.

No hay cuentas compartidas. Cada persona usa su propia identidad de proveedor, y ser miembro de una organización determina qué espacios de trabajo puede ver.

Roles de la organización

RolAcceso
PropietarioAcceso completo a la organización, incluidos los administradores y las invitaciones.
AdministradorGestiona recursos y miembros, salvo invitar a otro administrador.
DesarrolladorDespliega y gestiona los recursos de las aplicaciones dentro de los espacios de trabajo autorizados.
FacturaciónConsulta la información de espacios de trabajo, uso, cuotas, facturas y auditoría.
LectorAcceso de solo lectura; no puede ver secretos ni hacer cambios.

Iniciar sesión en la consola

1

Abre la consola

Ve a console.codaracloud.com. Cualquier página que visites sin haber iniciado sesión te lleva a la pantalla de inicio de sesión y recuerda adónde ibas.

2

Continúa con GitHub o Google

Autoriza el proveedor que aparece en la página de inicio de sesión. GitHub pide acceso de solo lectura a tu identidad y tu correo; el acceso a los repositorios lo gestiona aparte la GitHub App de Codara. Google solo pide los scopes de identidad de OpenID.

3

Vuelves adonde estabas

Tu sesión en el navegador dura 7 días; después tendrás que volver a iniciar sesión. Puedes cerrar la sesión cuando quieras desde el menú de la cuenta.

Idioma de la consola

La consola se muestra en español o en inglés, según el idioma de tu cuenta. Para cambiarlo, abre Cuenta y organización → Cuenta → Idioma y elige Español o English. El cambio se aplica al momento. La CLI sigue en inglés.

Usa GitHub y Google para la misma cuenta

Inicia sesión en la cuenta que quieres conservar, abre Cuenta y organización → Cuenta y elige Conectar Google. Completa la verificación de Google y Codara añadirá esa identidad inmutable de Google como segundo método de inicio de sesión. A partir de ahí, iniciar sesión con cualquiera de los dos proveedores te da acceso a las mismas organizaciones y espacios de trabajo.

Que el correo coincida no vincula las cuentas

Por seguridad, Codara nunca une cuentas de proveedores porque el texto del correo coincida. Usa siempre Conectar Google desde una cuenta con la sesión iniciada. Si la identidad de Google ya pertenece a una cuenta activa de Codara, la vinculación queda pendiente de una revisión manual.

Si falla el inicio de sesión

Comprueba que el correo de la invitación coincide exactamente con un correo verificado de tu cuenta de GitHub. Si el enlace ha caducado, se ha revocado o ya se ha usado, pide uno nuevo a quien sea propietario o administrador de la organización.

Iniciar sesión desde la CLI

La CLI codaracloud inicia sesión con tu cuenta de Codara Cloud en un navegador. Ejecuta:

bash
$ codaracloud login> Open this URL in your browser: https://console.codaracloud.com/auth/cli> And enter this code: XXXX-XXXX

Inicia sesión en la consola como siempre, con GitHub o Google, y aprueba el código. Después, la CLI guarda la credencial en el llavero de tu sistema operativo o, si no hay llavero disponible, en ~/.config/codara/config.yaml. Comprueba que ha funcionado con codaracloud whoami.

Las sesiones de la CLI caducan a los 7 días

codaracloud login guarda una credencial de sesión con la misma duración de 7 días que una sesión del navegador; no genera un token de larga duración. Para cualquier cosa desatendida (CI, scripts, tareas programadas), crea un token de API.

Tokens de API

Los tokens de API no dependen de tu sesión del navegador ni de la CLI. Llevan una lista explícita de scopes, su duración está limitada a entre 1 y 365 días y se pueden revocar uno a uno. Los tokens nuevos duran 90 días por defecto y tienen un perfil de permisos de solo lectura. Crea uno desde Cuenta y organización → Tokens de API en la consola o desde la CLI:

bash
# Name is a positional argument, not a flag$ codaracloud token create ci-deploys --scopes apps:read,deploys:create --expires-in-days 90 $ codaracloud token list$ codaracloud token revoke <token-id>

El token se muestra una sola vez

Codara solo guarda un hash del token. El valor en claro aparece una vez, al crearlo, y no se puede recuperar nunca más: cópialo en ese momento. Si lo pierdes, revócalo y crea otro.

Gestiona las credenciales con una sesión real

Para listar, crear y revocar tokens de API necesitas una sesión actual en el navegador o en la CLI. Un token de API no puede crear otros tokens ni enumerar tus demás credenciales. Siempre que puedas, limita cada automatización a un solo espacio de trabajo.

Usar un token

Pásalo como token bearer o dáselo a la CLI:

bash
$ curl -H "Authorization: Bearer cdr_live_xxxxxxxx" \    https://console.codaracloud.com/v1/apps # The CLI reads --token, then $CODARA_TOKEN, then the keyring, then the config file$ export CODARA_TOKEN=cdr_live_xxxxxxxx$ codaracloud apps list

Scopes

Un token solo tiene los permisos que le concedes. La pantalla de tokens ofrece 28 scopes para usuarios; la API también reconoce los comodines equivalentes * y admin, además del scope de servicio builder, que es solo interno. Estos son los scopes más habituales.

ScopePermite
apps:readListar y consultar apps.
apps:writeCrear, actualizar y eliminar apps.
deploys:readLeer el historial y el estado de los deploys.
deploys:createLanzar builds y releases.
deploys:promotePromover una release a otro entorno.
logs:readLeer los logs de runtime y de build.
env:readListar las claves de las variables de entorno (los valores siguen ocultos).
env:writeDefinir y eliminar variables de entorno.
env:revealLeer el valor en claro de una variable. Queda registrado en la auditoría.
domains:read / domains:writeConsultar y gestionar dominios propios.
db:read / db:write / db:connectConsultar bases de datos, gestionarlas y abrir una conexión a través de la plataforma.
buckets:read / buckets:writeConsultar y gestionar buckets de almacenamiento de objetos.
cost:read / metrics:readLeer los costes y las métricas.

Un token sin scopes apenas sirve para nada

La consola exige al menos un scope. La CLI y la API pueden crear un token con la lista de scopes vacía; ese token solo llega a /v1/me y a los endpoints públicos de estado. Las peticiones a recursos que requieren scopes devuelven 403.

Qué puede ver tu cuenta

Ser miembro de una organización es lo que marca el límite de acceso:

  • Los miembros de una organización solo pueden actuar sobre los espacios de trabajo de las organizaciones a las que pertenecen, y solo en la medida en que su rol lo permita.
  • Un espacio de trabajo agrupa proyectos, acceso y uso dentro de una organización. Las personas se unen a la organización en lugar de compartir un inicio de sesión del espacio de trabajo.
  • Los scopes de un token de API solo pueden restringir el rol que su propietario tiene en la organización. Un token también puede limitarse a un espacio de trabajo (client_id en la API); nunca puede ampliar el acceso a otra organización o espacio de trabajo.
  • Los operadores de la plataforma Codara conservan acceso global al clúster para soporte y operaciones.

Comprobar quién eres

DóndeCómo
ConsolaCuenta y organización → Cuenta
CLIcodaracloud whoami
APIGET /v1/me

Última actualización: