Empezar

Variables de entorno.

Tus propias variables y las que Rivervo define por ti, producción frente a vistas previas, cómo sustituir un valor automático y cuándo se aplican los cambios.

3 MIN DE LECTURA

Las claves, contraseñas y ajustes de tu aplicación viven en la pestaña Variables. Se guardan cifrados y llegan a tu aplicación como variables de entorno normales.

Añadir las tuyas

Variables → Añadir una variable, escribe un NOMBRE y un valor y haz clic en Guardar.

  • Un nombre lleva letras latinas, números y _, y no empieza por un número. Cada nombre debe ser único.
  • Consejo: pega el contenido de un archivo .env en un campo de nombre y se añadirán todas las líneas de una vez.

Las variables llegan a la aplicación cuando se ejecuta, no a la fase de compilación. Los cambios llegan a la aplicación con el siguiente despliegue. Después de guardar, el panel te ofrece Desplegar ahora, que vuelve a desplegar la versión en ejecución con las nuevas variables, sin una nueva compilación.

Producción y vistas previas

Cada variable tiene un Entorno:

EntornoAdónde llega
Producción y vistas previasla aplicación en producción y todas las vistas previas de ramas (opción predeterminada)
Solo producciónsolo la aplicación en producción; por ejemplo, una clave de pagos real
Solo vistas previassolo las vistas previas de ramas; por ejemplo, una clave de pagos de prueba

Las vistas previas reciben solo las variables definidas para ellas. Cada vista previa tiene además su propia pestaña Variables: ahí ves lo que recibe De la aplicación, y un valor propio con el mismo nombre ocupa su lugar solo en esa vista previa.

Definidas automáticamente

La lista Definidas automáticamente muestra lo que Rivervo proporciona a tu aplicación y mantiene al día. No tienes que añadirlas tú:

VariableCuándo
PORTsiempre: el puerto en el que escucha tu aplicación
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORDel proyecto tiene una base de datos PostgreSQL o MySQL
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORDla base de datos es PostgreSQL
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENTel proyecto tiene Valkey
RIVERVO_<NAME>_URLpara cada base de datos, Valkey y réplica de lectura del proyecto, según el nombre de su servicio
RIVERVO_<NAME>_URLpara cada uno de los demás servicios web de la aplicación: su dirección interna, por ejemplo RIVERVO_API_URL=http://api:8080 (consulta Comunicación entre servicios)
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRETel proyecto tiene almacenamiento de objetos
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STOREuna aplicación Laravel (consulta Laravel)

La primera base de datos de un proyecto recibe los nombres habituales (DATABASE_URL, DB_*). Una segunda solo añade su propia RIVERVO_<NAME>_URL, así que nada cambia por sí solo; consulta Bases de datos.

Sustituir un valor automático

Una variable propia con el mismo nombre ocupa el lugar de la automática; el panel la marca con Se usa tu valor. Sirve para apuntar la aplicación a otro sitio, por ejemplo DATABASE_URL a otra base de datos del proyecto.

PORT es la única excepción: siempre lo gestiona Rivervo.

Servicios de un proyecto

Cada servicio de un proyecto —workers, tareas programadas, otros servicios web— recibe las variables del proyecto, incluida su base de datos. Un servicio también puede tener variables propias, que tienen prioridad sobre las del proyecto. Un servicio web siempre recibe su propia APP_URL. Cada servicio de código recibe además la dirección interna de cada uno de los demás servicios web como RIVERVO_<NAME>_URL; después de añadir o renombrar un servicio web, vuelve a desplegar los demás servicios para que la reciban. Consulta Servicios de un proyecto.

Quién puede ver los valores

Los valores los ven el propietario de la cuenta y las personas con el rol de Desarrollador o Administrador en la aplicación. El rol de Lector no los ve. Consulta Acceso a una aplicación.

¿Sigues con dudas?

Escríbenos por chat: la AI responde al momento y un ingeniero se une cuando hace falta, a cualquier hora del día.

Contactar con soporte