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.
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
.enven 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:
| Entorno | Adónde llega |
|---|---|
| Producción y vistas previas | la aplicación en producción y todas las vistas previas de ramas (opción predeterminada) |
| Solo producción | solo la aplicación en producción; por ejemplo, una clave de pagos real |
| Solo vistas previas | solo 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ú:
| Variable | Cuándo |
|---|---|
PORT | siempre: el puerto en el que escucha tu aplicación |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | el proyecto tiene una base de datos PostgreSQL o MySQL |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | la base de datos es PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | el proyecto tiene Valkey |
RIVERVO_<NAME>_URL | para cada base de datos, Valkey y réplica de lectura del proyecto, según el nombre de su servicio |
RIVERVO_<NAME>_URL | para 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_SECRET | el proyecto tiene almacenamiento de objetos |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | una 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.