Variables de entorno
Las variables de entorno permiten gestionar de forma segura valores de configuración y secretos en tus flujos de trabajo, incluidas las claves de API y otros datos sensibles a los que tus flujos de trabajo necesitan acceder. Mantienen los secretos fuera de las definiciones de los flujos de trabajo y los dejan disponibles durante la ejecución.
Tipos de variables
Las variables de entorno en TradingGoose funcionan en dos niveles:
- Variables de entorno personales: Privadas de tu cuenta; solo tú puedes verlas y usarlas
- Variables de entorno del espacio de trabajo: Compartidas en todo el espacio de trabajo, disponibles para todos los miembros del equipo
Las variables de entorno del espacio de trabajo tienen prioridad sobre las personales cuando hay un conflicto de nombres.
Configurar variables de entorno
Abre Environment desde la navegación del espacio de trabajo. Selecciona la vista Workspace o Personal en el encabezado y usa su botón de creación para añadir una variable en ese ámbito.
Elegir un ámbito
Crea secretos compartidos en Workspace y secretos de tu cuenta en Personal. La vista seleccionada determina el ámbito de las variables nuevas; no hay un interruptor de ámbito por variable.
Vista de variables del espacio de trabajo
Las variables del espacio de trabajo y las personales aparecen en vistas separadas, no en una lista mixta. Cambia de vista para gestionar el otro ámbito. Ambos ámbitos pueden resolverse durante la ejecución; los valores del espacio de trabajo tienen prioridad cuando los nombres coinciden.
Usar variables en flujos de trabajo
Para referenciar variables de entorno en tus flujos de trabajo, usa la notación {{}}. Al escribir {{ en cualquier campo de entrada, aparecerá un menú desplegable con tus variables de entorno personales y de espacio de trabajo. Selecciona la variable que quieras usar.
Precedencia de variables
Cuando tienes variables personales y de espacio de trabajo con el mismo nombre:
- Las variables de espacio de trabajo tienen prioridad sobre las variables personales
- Esto evita conflictos de nombres y garantiza un comportamiento coherente en los flujos de trabajo del equipo
- Si existe una variable de espacio de trabajo, se ignora la variable personal con el mismo nombre
Elige con cuidado los nombres de las variables para evitar anulaciones no deseadas. Considera anteponer tus iniciales a las variables personales o el nombre del proyecto a las variables de espacio de trabajo.
Prácticas recomendadas de seguridad
Para datos confidenciales
- Almacena las claves de API, los tokens y las contraseñas como variables de entorno en lugar de escribirlos en el código
- Usa variables de espacio de trabajo para recursos compartidos que necesiten varios miembros del equipo
- Mantén las credenciales personales en variables personales
Nombres de variables
- Usa nombres descriptivos:
DATABASE_URLen lugar deDB - Sigue convenciones de nomenclatura coherentes en todo el equipo
- Considera usar prefijos para evitar conflictos:
PROD_API_KEY,DEV_API_KEY
Control de acceso
- Las variables de entorno de espacio de trabajo respetan los permisos del espacio de trabajo
- Solo los usuarios con acceso de escritura o superior pueden crear o modificar variables de espacio de trabajo
- Las variables personales siempre son privadas para cada usuario