{"id":43798,"date":"2024-03-29T07:00:00","date_gmt":"2024-03-29T14:00:00","guid":{"rendered":"https:\/\/dhblog.dream.press\/blog\/?p=43798"},"modified":"2025-01-07T05:32:41","modified_gmt":"2025-01-07T13:32:41","slug":"variables-entorno-guia-principiantes","status":"publish","type":"post","link":"https:\/\/www-dev.dreamhost.com\/blog\/es\/variables-entorno-guia-principiantes\/","title":{"rendered":"Qu\u00e9 Son las Variables de Entorno: Una Gu\u00eda Completa Para Principiantes"},"content":{"rendered":"\n

Las variables de entorno permiten configurar aplicaciones sin necesidad de cambiar el c\u00f3digo. Separan los datos externos de la l\u00f3gica de la aplicaci\u00f3n, lo cual puede resultar bastante misterioso para los desarrolladores novatos (incluso para algunos experimentados).<\/p>\n\n\n\n

A trav\u00e9s de esta gu\u00eda pr\u00e1ctica, levantaremos el velo alrededor de las variables de entorno para que puedas entender qu\u00e9 implican, por qu\u00e9 son importantes y c\u00f3mo aprovecharlas con confianza.<\/p>\n\n\n\n

Trae tu bebida favorita (y tal vez algunas galletas) porque estamos a punto de sumergirnos en ello. Vamos a desentra\u00f1ar los conceptos de variables de entorno desde cero.<\/p>\n\n\n\n

\u00bfQu\u00e9 Son las Variables de Entorno?<\/strong><\/h2>\n\n\n\n
\"\"<\/figure>\n\n\n\n

Las variables de entorno son valores nombrados din\u00e1micos que pueden afectar c\u00f3mo se comportan los procesos en ejecuci\u00f3n en una computadora. Algunas propiedades clave de las variables de entorno son:<\/p>\n\n\n\n

    \n
  • Nombradas:<\/strong> Tienen nombres descriptivos como APP_MODE<\/strong> y DB_URL<\/strong>.<\/li>\n\n\n\n
  • Externas:<\/strong> Los valores se establecen fuera del c\u00f3digo de la aplicaci\u00f3n a trav\u00e9s de archivos, l\u00edneas de comandos y sistemas.<\/li>\n\n\n\n
  • Din\u00e1micas:<\/strong> Pueden actualizar variables sin reiniciar aplicaciones.<\/li>\n\n\n\n
  • Configuradas:<\/strong> El c\u00f3digo depende de variables, pero no las define.<\/li>\n\n\n\n
  • Desacopladas:<\/strong> No es necesario modificar las configuraciones de c\u00f3digo una vez que se establecen las variables.<\/li>\n<\/ul>\n\n\n\n

    Aqu\u00ed tienes una analog\u00eda. Imagina que est\u00e1s siguiendo una receta de galletas con chispas de chocolate. La receta podr\u00eda decir:<\/p>\n\n\n\n

      \n
    • Agregar 1 taza de az\u00facar<\/li>\n\n\n\n
    • Agregar 1 barra de mantequilla ablandada<\/li>\n\n\n\n
    • Agregar 2 huevos<\/li>\n<\/ul>\n\n\n\n

      En lugar de esos valores codificados directamente, podr\u00edas usar variables de entorno en su lugar:<\/p>\n\n\n\n

        \n
      • Agregar $AZ\u00daCAR taza de az\u00facar<\/li>\n\n\n\n
      • Agregar $MANTEQUILLA barras de mantequilla ablandada<\/li>\n\n\n\n
      • Agregar $HUEVOS huevos<\/li>\n<\/ul>\n\n\n\n

        Antes de hacer las galletas, configurar\u00edas esos nombres de variables de entorno con valores de tu elecci\u00f3n:<\/p>\n\n\n\n

        AZUCAR=1
        MANTEQUILLA=1
        HUEVOS=2 <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

        Entonces, al seguir la receta, tus ingredientes se resolver\u00edan como:<\/p>\n\n\n\n

          \n
        • Agregar 1 taza de az\u00facar<\/li>\n\n\n\n
        • Agregar 1 barra de mantequilla ablandada<\/li>\n\n\n\n
        • Agregar 2 huevos<\/li>\n<\/ul>\n\n\n\n

          Esto te permite configurar la receta de galletas sin cambiar el c\u00f3digo de la receta.<\/p>\n\n\n\n

          El mismo concepto se aplica a la inform\u00e1tica y al desarrollo. Las variables de entorno te permiten alterar el entorno en el que se ejecuta un proceso sin cambiar el c\u00f3digo subyacente. Aqu\u00ed tienes algunos ejemplos comunes:<\/p>\n\n\n\n

            \n
          • Establecer el entorno como “desarrollo” o “producci\u00f3n”<\/li>\n\n\n\n
          • Configurar claves de API para servicios externos<\/li>\n\n\n\n
          • Pasar claves secretas o credenciales<\/li>\n\n\n\n
          • Activar o desactivar ciertas caracter\u00edsticas<\/li>\n<\/ul>\n\n\n\n

            Las variables de entorno proporcionan una gran flexibilidad. Puedes implementar el mismo c\u00f3digo en m\u00faltiples entornos sin cambiar el c\u00f3digo en s\u00ed mismo. Pero vamos a entender m\u00e1s a fondo por qu\u00e9 son valiosas.<\/p>\n\n\n\n

            \u00bfPor Qu\u00e9 Son Valiosas las Variables de Entorno?<\/strong><\/h2>\n\n\n\n
            \"Razones<\/figure>\n\n\n\n

            Considera las variables de entorno como perillas de aplicaci\u00f3n utilizadas para ajustar preferencias. Exploraremos excelentes casos de uso en breve.<\/p>\n\n\n\n

            \u00a1Solidifiquemos la intuici\u00f3n sobre por qu\u00e9 las variables de entorno son importantes!<\/p>\n\n\n\n

            Raz\u00f3n #1: Separan el C\u00f3digo de la Aplicaci\u00f3n de las Configuraciones<\/strong><\/h3>\n\n\n\n
            \"<\/figure>\n\n\n\n

            Codificar directamente configuraciones y credenciales en tu c\u00f3digo puede causar todo tipo de problemas:<\/p>\n\n\n\n

              \n
            • Commit accidental al control de origen<\/li>\n\n\n\n
            • Reconstrucci\u00f3n y redespliegue de c\u00f3digo solo para cambiar un valor<\/li>\n\n\n\n
            • Problemas de configuraci\u00f3n al promover a trav\u00e9s de entornos<\/li>\n<\/ul>\n\n\n\n

              Tambi\u00e9n conduce a un c\u00f3digo desordenado:<\/p>\n\n\n\n

              import os

              # Hard-coded configuration
              DB_USER = ‘appuser’
              DB_PASS = ‘password123’
              DB_HOST = ‘localhost’
              DB_NAME = ‘myappdb’

              def connect_to_db():
                print(f”Connecting to {DB_USER}:{DB_PASS}@{DB_HOST}\/{DB_NAME}”) 

              connect_to_db() <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

              Esto enreda la l\u00f3gica del negocio con detalles de configuraci\u00f3n. El acoplamiento estrecho hace que el mantenimiento sea arduo con el tiempo:<\/p>\n\n\n\n

                \n
              • Los cambios requieren modificar el c\u00f3digo fuente<\/li>\n\n\n\n
              • Riesgo de filtrar secretos en el control de origen<\/li>\n<\/ul>\n\n\n\n

                El uso de variables de entorno reduce estos problemas. Por ejemplo, puedes configurar las variables de entorno DB_USER y DB_NAME.<\/p>\n\n\n\n

                # .env file
                DB_USER=appuser
                DB_PASS=password123 
                DB_HOST=localhost
                DB_NAME=myappdb<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                El c\u00f3digo de la aplicaci\u00f3n puede acceder a las variables de entorno cuando sea necesario, manteniendo el c\u00f3digo limpio y simple. <\/p>\n\n\n\n

                import os

                # Load config from environment
                DB_USER = os.environ[‘DB_USER’]
                DB_PASS = os.environ[‘DB_PASS’]
                DB_HOST = os.environ[‘DB_HOST’]
                DB_NAME = os.environ[‘DB_NAME’]

                def connect_to_db():
                  print(f”Connecting to {DB_USER}:{DB_PASS}@{DB_HOST}\/{DB_NAME}”)
                 
                connect_to_db()<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                Las variables de entorno separan de manera limpia la configuraci\u00f3n del c\u00f3digo, manteniendo los valores sensibles abstractos en el entorno.<\/p>\n\n\n\n

                Puedes implementar el mismo c\u00f3digo desde desarrollo hasta producci\u00f3n sin cambiar nada. Las variables de entorno pueden diferir entre entornos sin afectar en absoluto al c\u00f3digo.<\/p>\n\n\n\n

                Raz\u00f3n #2: Simplifican la Configuraci\u00f3n de las Aplicaciones<\/strong><\/h3>\n\n\n\n
                \"Simplifican<\/figure>\n\n\n\n

                Las variables de entorno simplifican el ajuste de las configuraciones sin necesidad de modificar el c\u00f3digo:<\/p>\n\n\n\n

                # .env file:
                DEBUG=true<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                As\u00ed es como podr\u00edamos usarlo dentro del archivo de script:<\/p>\n\n\n\n

                # Script content<\/strong>:
                import os

                DEBUG = os.environ.get(‘DEBUG’) == ‘true’

                if DEBUG<\/strong>:
                  print(“In DEBUG mode”)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                Cambiar el modo de depuraci\u00f3n solo requiere actualizar el archivo .env, sin necesidad de cambiar el c\u00f3digo, reconstruir o implementar de nuevo. Las variables de entorno tambi\u00e9n ayudan a implementar de manera fluida a trav\u00e9s de los entornos:<\/p>\n\n\n\n

                import os

                # Retrieve environment variable to determine the current environment (production or staging)
                current_env = os.getenv(‘APP_ENV’, ‘staging’)  # Default to ‘staging’ if not set

                # Production API key
                PROD_API_KEY = os.environ[‘PROD_API_KEY’]

                # Staging API key
                STG_API_KEY = os.environ[‘STG_API_KEY’]

                # Logic that sets api_key based on the current environment
                if current_env == ‘production’:
                    api_key = PROD_API_KEY
                else:
                    api_key = STG_API_KEY

                # Initialize API client with the appropriate API key
                api = ApiClient(api_key)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                El mismo c\u00f3digo puede usar claves API separadas para producci\u00f3n versus preparaci\u00f3n sin realizar cambios.<\/p>\n\n\n\n

                Y por \u00faltimo, permiten alternar funcionalidades sin nuevas implementaciones:<\/p>\n\n\n\n

                NEW_FEATURE = os.environ[‘NEW_FEATURE’] == ‘true’

                if NEW_FEATURE:
                  enableNewFeature()<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                Cambiar la variable NEW_FEATURE activa la funcionalidad instant\u00e1neamente dentro de nuestro c\u00f3digo. La interfaz para actualizar configuraciones depende de los sistemas:<\/p>\n\n\n\n

                  \n
                • Las plataformas en la nube<\/a> como Heroku utilizan paneles web<\/li>\n\n\n\n
                • Los servidores utilizan herramientas de comando del sistema operativo<\/li>\n\n\n\n
                • El desarrollo local puede utilizar archivos .env<\/li>\n<\/ul>\n\n\n\n

                  Las variables de entorno son beneficiosas al crear aplicaciones, permitiendo a los usuarios configurar elementos seg\u00fan sus requisitos.<\/p>\n\n\n\n

                  Raz\u00f3n #3: Ayudan a Gestionar Secretos y Credenciales<\/strong><\/h3>\n\n\n\n
                  \"Ayudan<\/figure>\n\n\n\n

                  Incluir secretos como claves API, contrase\u00f1as y claves privadas directamente en el c\u00f3digo fuente plantea riesgos de seguridad<\/a> sustanciales:<\/p>\n\n\n\n

                  # Avoid exposing secrets in code!
                  STRIPE_KEY = ‘sk_live_1234abc’
                  DB_PASSWORD = ‘password123’

                  stripe.api_key = STRIPE_KEY
                  db.connect(DB_PASSWORD)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                  \u00a1Esos credenciales ahora est\u00e1n expuestos si este c\u00f3digo se compromete en un repositorio p\u00fablico de GitHub<\/a>!<\/p>\n\n\n\n

                  Las variables de entorno evitan la fuga al externalizar los secretos:<\/p>\n\n\n\n

                  import os

                  STRIPE_KEY = os.environ.get(‘STRIPE_KEY’) 
                  DB_PASS = os.environ.get(‘DB_PASS’)  

                  stripe.api_key = STRIPE_KEY 
                  db.connect(DB_PASS)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                  Los valores de los secretos reales se establecen en un archivo .env local.<\/p>\n\n\n\n

                  # .env file

                  STRIPE_KEY=sk_live_1234abc
                  DB_PASS=password123<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                  No olvides agregar al archivo .gitignore el archivo .env para mantener los secretos fuera del control de origen. Esto implica definir el archivo .env en un archivo .gitignore en cualquier directorio ra\u00edz del repositorio, lo que le indica a git que ignore el archivo durante la creaci\u00f3n de confirmaciones.<\/p>\n\n\n\n

                  Esto separa las definiciones de secretos del c\u00f3digo de la aplicaci\u00f3n, carg\u00e1ndolos de manera segura desde entornos protegidos durante el tiempo de ejecuci\u00f3n. El riesgo de exponer accidentalmente credenciales se reduce dr\u00e1sticamente.<\/p>\n\n\n\n

                  Raz\u00f3n #4: Promueven la Consistencia<\/strong><\/h3>\n\n\n\n
                  \"Las<\/figure>\n\n\n\n

                  Imagina tener diferentes archivos de configuraci\u00f3n para los entornos de desarrollo, QA y producci\u00f3n:<\/p>\n\n\n\n

                  # Development
                  DB_HOST = ‘localhost’
                  DB_NAME = ‘appdb_dev’

                  # Production
                  DB_HOST = ‘db.myapp.com’
                  DB_NAME = ‘appdb_prod’<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                  Esta discrepancia introduce errores sutiles que son dif\u00edciles de detectar. El c\u00f3digo que funciona perfectamente en desarrollo podr\u00eda romperse repentinamente en producci\u00f3n debido a configuraciones desiguales.<\/p>\n\n\n\n

                  Las variables de entorno resuelven esto al centralizar la configuraci\u00f3n en un solo lugar:<\/p>\n\n\n\n

                  DB_HOST=db.myapp.comDB_NAME=appdb_prod<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                  Ahora, las mismas variables se utilizan de manera consistente en todos los entornos. Ya no tienes que preocuparte por configuraciones aleatorias o incorrectas que se activen.<\/p>\n\n\n\n

                  El c\u00f3digo de la aplicaci\u00f3n simplemente hace referencia a las variables:<\/strong><\/p>\n\n\n\n

                  import os

                  db_host = os.environ[‘DB_HOST’]
                  db_name = os.environ[‘DB_NAME’]

                  db.connect(db_host, db_name)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                  Ya sea que la aplicaci\u00f3n se ejecute localmente o en un servidor de producci\u00f3n, siempre utiliza el host y el nombre de la base de datos correctos.<\/p>\n\n\n\n

                  Esta uniformidad reduce los errores, mejora la previsibilidad y hace que la aplicaci\u00f3n sea m\u00e1s robusta en general. Los desarrolladores pueden tener la confianza de que el c\u00f3digo se comportar\u00e1 de manera id\u00e9ntica en cada entorno.<\/p>\n\n\n\n

                  \n\n\n

                  Get Content Delivered Straight to Your Inbox<\/h2>

                  Subscribe now to receive all the latest updates, delivered directly to your inbox.<\/p>

                  <\/div>