Variables de entorno

Introducción

Las variables de entorno son pares clave-valor que se pueden definir fuera del código fuente de tu aplicación. Estas variables ofrecen las siguientes ventajas:

• Seguridad: Las variables de entorno ayudan a mantener segura la información sensible. Elementos como claves de API, tokens y credenciales de base de datos nunca deben almacenarse directamente en tu código, ya que cualquier persona con acceso a tu código podría verlos. En su lugar, las variables de entorno almacenan estos secretos de forma segura, manteniéndolos fuera de tu base de código.

• Flexibilidad de configuración: Al usar variables de entorno, puedes cambiar fácilmente la configuración según el entorno de despliegue. Por ejemplo, podrías usar un endpoint de API diferente para desarrollo local que para producción, o activar y desactivar herramientas de depuración. Esta flexibilidad te permite controlar el comportamiento de tu app en diferentes escenarios sin modificar el código.

• Escalabilidad: Las variables de entorno te permiten crear configuraciones reutilizables. Si tienes múltiples proyectos que comparten configuraciones similares (como claves de API o endpoints), puedes definir esas configuraciones una vez como variables de entorno y usarlas en todos los proyectos, facilitando mucho la gestión de tu configuración.

Dónde usar variables de entorno

Las variables de entorno se usan típicamente en estas áreas:

1. Claves de API y endpoints: Almacena claves y endpoints de servicios externos, como APIs de terceros (por ejemplo, REACT_APP_API_KEY, REACT_APP_BASE_URL). De esta manera, la información sensible se mantiene segura y puedes intercambiar endpoints según el entorno de despliegue.

2. Feature flags: Si deseas habilitar o deshabilitar condicionalmente ciertas funciones, las variables de entorno pueden actuar como feature flags. Por ejemplo, configurar REACT_APP_ENABLE_NEW_FEATURE como true o false te permite alternar funciones sin cambiar el código.

Mejores prácticas

Aquí hay dos prácticas clave que puedes seguir para asegurar que tu aplicación permanezca segura durante todo su ciclo de vida:

• Revisa y rota regularmente tus claves de API y otros secretos para mantener la seguridad.
• Configura valores diferentes para las variables en los entornos de desarrollo, vista previa y producción para asegurar un aislamiento y seguridad adecuados.

Crear variables de entorno

Puedes crear variables de entorno para tus aplicaciones directamente desde la consola de Catalyst. Las variables de entorno de las aplicaciones desplegadas usando la integración con repositorio Git privado, plantillas de Slate o integración con repositorio público se crearán en el entorno de desarrollo de Catalyst por defecto.

Sigue los pasos a continuación para crear variables de entorno en Slate:

1. Haz clic en cualquier despliegue y navega a la pestaña Configuration en el panel izquierdo y expande Environment Variables.

2. Haz clic en Add Variable.

3. Haz clic en Save.

Puedes agregar cualquier cantidad de variables según sea necesario para tu aplicación.

Crear variables en producción

Si has desplegado tu proyecto de Catalyst a producción, puedes crear variables de entorno específicas para el entorno de producción, si es necesario. Puedes usar los mismos pasos mencionados anteriormente para crear variables en producción.