Compartir a través de

Usar variables de entorno con la configuración del sitio

Las variables de entorno para la configuración del sitio permiten a los creadores y administradores administrar los valores de configuración de manera flexible en todos los entornos. Permiten una gestión del ciclo de vida de las aplicaciones (ALM) y procesos de implementación más fluidos. Más información: Actualizar variables de entorno de Power Platform.

Solución de modelo de datos mejorado

Utilice variables de entorno para definir los valores de la configuración del sitio en varios entornos con el modelo de datos mejorado. Mientras que el modelo de datos estándar se basa en perfiles de implementación, el modelo mejorado permite la configuración dinámica de ajustes específicos del entorno mediante variables de entorno.

Definiciones clave

Para comprender cómo se pueden usar las variables de entorno con la configuración del sitio, familiarícese con las siguientes definiciones clave:

  • Variable de entorno: una variable que contiene valores de configuración específicos de un entorno a los que la aplicación o las características pueden hacer referencia.

  • Configuración del sitio: propiedades configurables que influyen en el comportamiento de un sitio, como la configuración del sitio del proveedor de identidad, las aplicaciones web progresivas y la configuración avanzada en el área de trabajo de seguridad.

  • Referencia de variable de entorno: puntero a una variable de entorno dentro de una configuración de sitio que permite la resolución de valores dinámicos en tiempo de ejecución.

Ventajas

Las variables de entorno para la configuración del sitio ofrecen varias ventajas, entre las que se incluyen:

  • Optimice ALM evitando los valores codificados de forma rígida en la configuración del sitio.
  • Simplifique las implementaciones en varios ambientes con configuraciones específicas del entorno.
  • Habilite actualizaciones dinámicas del comportamiento del sitio sin volver a implementar soluciones.

Cómo funciona

Este artículo describe cómo funcionan las variables de entorno con la configuración del sitio. La siguiente descripción es un resumen de alto nivel:

  1. Los creadores definen variables de entorno en la aplicación Power Pages Management o en el diseñador de soluciones.
  2. La configuración del sitio hace referencia a estas variables de entorno en lugar de a valores estáticos.
  3. Cuando se accede al sitio, el sistema resuelve el valor de la variable de entorno a la que se hace referencia y lo aplica.

Configurar variables de entorno para la configuración del sitio

Requisitos previos

Para utilizar variables de entorno con la configuración del sitio, debe cumplir los siguientes requisitos previos:

  • El sitio debe estar dentro de un entorno en el que esté habilitado el modelo de datos mejorado.
  • Se requieren las siguientes versiones para que las variables de entorno funcionen en Power Pages:
    • Versión del servidor de Dataverse 9.2.25013.x
    • Versión del paquete de Power Pages 1.0.2501.x
    • Versión runtime de Power Pages 9.7.1.x

Usar variables de entorno en la configuración del sitio

Para usar variables de entorno en la configuración del sitio:

  1. Abra la aplicación Power Pages Management y vaya a Configuración del sitio.

  2. Seleccione la configuración del sitio específica que desea configurar con una variable de entorno.

  3. Seleccione el origen como Variable de entorno.

    Captura de pantalla que muestra la configuración de un sitio con el origen como variable de entorno

  4. Si ya se ha creado una definición de variable de entorno, seleccione la búsqueda Variable de entorno. Aparecerá un menú desplegable para la selección.

    Captura de pantalla del cuadro de selección de la variable de entorno.

  5. Si no existe una definición de variable de entorno, seleccione Nueva definición de variable de entorno y rellene los campos obligatorios, como Propietario, Nombre del esquema, Nombre para mostrar y Tipo. Tenga en cuenta el valor del nombre del esquema, ya que es lo que debe usar al asociar una variable de entorno con una configuración de sitio.

    Captura de pantalla de creación de una nueva definición de variable de entorno.

  6. Después de crear la definición de variable de entorno, está disponible para seleccionarla en el control de búsqueda de Variable de entorno. Busque y seleccione el nombre del esquema para relacionarlo con la configuración del sitio.

Nota

  • No se admite el tipo de datos establecido en "origen de datos".
  • Las variables de entorno con el tipo de datos establecido como "secreto" no se pueden configurar sin proporcionar los detalles de la clave de almacén.
  • Para la configuración del sitio de PWAFeature, use el valor {"status":"disable"} para false y {"status":"enable"} para true.

Actualice los valores específicos del entorno

Para asegurarse de que la configuración del sitio esté correctamente configurada para cada entorno, siga estos pasos para actualizar los valores específicos del entorno en la aplicación Power Pages Management o estudio de diseño.

Nota

No todas las configuraciones del sitio tienen una opción de configuración correspondiente en el estudio de diseño.

  1. Para cada entorno (por ejemplo, desarrollo, control de calidad y producción), vaya a la aplicación Power Pages Management.
  2. Localice la variable de entorno abriendo la configuración del sitio asociada.
  3. Seleccione la Variable de entorno.
  4. En la sección Valores, seleccione Nuevo valor de variable de entorno.
  5. Escriba un Valor y elija Guardar y cerrar.

Después de establecer la variable de entorno, siga estos pasos adicionales:

  1. Vaya a una solución y agregue su sitio existente, comprobando que también se incluyen las variables de entorno relevantes.
  2. Exporte la solución, e impórtela al entorno de destino deseado.

Durante el proceso de importación al entorno de destino, asigne un valor a la variable de entorno. Al cambiar el valor, se actualiza la configuración del sitio correspondiente en el entorno de destino.

Administración de variables de entorno

Puede administrar la configuración del sitio con variables de entorno, ya sea que implemente soluciones manualmente o a través de canalizaciones.

Soluciones

Configure las variables de entorno y los sitios en diferentes entornos siguiendo estos pasos:

  1. Configure las variables de entorno en el entorno de origen:

    1. Abra el portal de Power Pages o el portal de Power Apps.

    2. Vaya a Soluciones en el entorno de origen.

    3. Dentro de una solución, agregue una nueva variable de entorno introduciendo los detalles requeridos y guardándola.

      Captura de pantalla de la asignación de variables de entorno durante la importación de la solución.

      Captura de pantalla de la configuración del canalización para variables de entorno.

    4. Agregue el sitio existente a la solución.

  2. Configurar los ajustes del sitio:

    1. Abra la aplicación Power Pages Management y vaya a Configuración del sitio.
    2. Seleccione la configuración del sitio que desea definir para el entorno.
    3. Utilice el menú desplegable para seleccionar o crear una variable de entorno. Los usuarios pueden ver y elegir variables de entorno creadas a través del flujo de soluciones en este menú desplegable.

Nota

En la configuración del sitio, el menú desplegable muestra los nombres de las variables de entorno creadas con el flujo de soluciones, lo que permite a los usuarios seleccionarlas y asociarlas fácilmente.

  • Durante el proceso de importación al entorno de destino, se le solicita que asigne un valor a la variable de entorno.
  • Cualquier modificación realizada en la variable de entorno actualiza la configuración del sitio correspondiente con el nuevo valor en el entorno de destino.

Canalizaciones

Si utiliza canalizaciones para implementar soluciones, especifique el valor de la variable de entorno para el entorno de destino. Si actualiza la variable de entorno, refresque la configuración del sitio correspondiente para reflejar el nuevo valor.

Captura de pantalla de la configuración de implementación de canalizaciones para variables de entorno.

Interfaces que admiten variables de entorno para la configuración del sitio

Puede usar variables de entorno para la configuración del sitio en las siguientes interfaces:

  • Aplicación Power Pages Management: crear y administrar variables de entorno.
  • Estudio de diseño: ver o editar la configuración del sitio con variables de entorno.
  • Diseñador de soluciones: incluya variables de entorno en su proceso de ALM.
  • Implementaciones de pipeline: administre y valide las configuraciones específicas del entorno durante la implementación.

Borrar caché después de las actualizaciones

Cuando se realicen cambios en el valor de la variable de entorno o en el valor predeterminado, borre manualmente la memoria caché mediante uno de los siguientes métodos:

  1. Seleccione Sincronizar en el estudio de diseño.

    Captura de pantalla del botón Sincronizar en la interfaz del estudio.

  2. Borre la caché del portal:

    1. Inicie sesión en el portal como administrador y vaya al sitio web con /_services/about agregado a la URL. Por ejemplo: https://contoso.powerappsportals.com/_services/about.

      Captura de pantalla de la página de detalles del portal que muestra el bot Borrar caché

    2. En la página de detalles del portal, seleccione Borrar caché.

  3. Reinicie el portal desde el Centro de administración de Power Platform.

Solución de problemas

A continuación se indican algunos motivos por los que puede encontrar errores al utilizar variables de entorno con la configuración del sitio:

  • Incompatibilidad en el valor de la variable de entorno y el tipo esperado

    Por ejemplo, si una configuración de sitio como Search/Enabled espera un valor booleano (verdadero/falso), pero la variable de entorno contiene un valor no válido (como «abc») o falta, causa problemas.

  • Tipo de fuente de variable de entorno no admitida

    Este problema se produce cuando la variable de entorno se configura de una manera no compatible, como establecer el tipo de origen en "almacenamiento de datos".

  • Problemas de acceso a Key Vault

    Este tipo de problema puede producirse si el origen de la variable de entorno es Key Vault, pero al entorno de ejecución le faltan permisos o falta el secreto.

Procedimientos recomendados

Al trabajar con variables de entorno para la configuración del sitio, es importante seguir los procedimientos recomendados para garantizar una administración eficiente y eficaz. Aquí ofrecemos algunas recomendaciones clave:

  • Uso

    Use esta función solo para configuraciones o secretos relacionados con ALM. Evite usarlo para todas las configuraciones del sitio, ya que puede provocar una degradación del rendimiento.

  • Asigne nombres a las variables de forma coherente

    Utilice nombres coherentes para las variables de entorno para que sean más fáciles de identificar.

  • Variables de documento

    Mantenga un documento de referencia que enumere todas las variables de entorno, sus propósitos y sus valores predeterminados.

  • Probar a fondo

    Valide los cambios en un entorno que no sea de producción antes de aplicarlos a producción.

  • Use descripciones

    Utilice el campo de descripción para explicar el propósito de la variable.

Configurar las variables de entorno como secretos

Para configurar variables de entorno como secretos y usarlas en Power Pages, siga estos pasos:

  1. Configure una variable de entorno como un secreto. Más información en: Usar variables de entorno para secretos de Azure Key Vault.

  2. Agregue permisos para acceder al secreto desde el portal.

    1. Dentro del portal Azure, obtenga el nombre de su aplicación en Registros de la aplicación que corresponde a su sitio web Power Pages.
    2. El nombre de la aplicación es el mismo que el nombre de su sitio web con el prefijo "Portals-". Si el nombre de su sitio es Aplicaciones bancarias Woodgrove, el nombre de la aplicación en Azure Portal será Portals-Aplicaciones bancarias Woodgrove. Recuerde el nombre de registro de la aplicación para su uso posterior.
    3. Inicie sesión en el portal Azure y acceda a los Key Vaults

  3. Cree un nuevo almacén de claves o use un existente.

    Al crear un nuevo almacén de claves, debe elegir un modelo de permiso. Puede elegir el Control de acceso basado en roles de Azure o una Directiva de acceso de Key Vault. Para ver los pasos adecuados, seleccione la siguiente pestaña en función del modelo de permisos que elija:

  1. Vaya a su almacén de claves en el portal Azure.
  2. Seleccione Control de acceso (IAM) en el menú de la izquierda.
  3. Seleccione + Agregar en la parte superior de la página y, a continuación, seleccione Agregar asignación de funciones.
  4. En la pestaña Roles de función de trabajo, busque Usuario de secretos de Key Vault, selecciónelo y, a continuación, seleccione Siguiente.
  5. En Asignar acceso a, seleccione Usuario, grupo o entidad de servicio.
  6. Elija + Seleccionar miembros y busque el nombre de registro de la aplicación de su sitio como se describió anteriormente.
  7. Seleccione la aplicación para su sitio y, a continuación, Siguiente.
  8. Seleccione Revisar + asignar.

Su sitio ahora tiene permisos para leer secretos de este almacén de claves.

  1. Agregue la clave como secreto en el almacén de claves. Más información sobre cómo crear un secreto en Azure Key Vault, vaya a Establecer y recuperar un secreto de Azure Key Vault en Azure Portal.

Preguntas frecuentes

  1. ¿Puedo usar variables de entorno para cualquier configuración del sitio?
    Sí, cualquier configuración de sitio que admita valores dinámicos puede usar una variable de entorno.

  2. ¿Qué sucede si no se define un valor específico del entorno?
    El valor predeterminado se utiliza como alternativa.

  3. ¿Puedo editar los valores de las variables de entorno directamente en producción?
    Sí, pero asegúrese de que los cambios se prueben y documenten para evitar consecuencias no deseadas.

Conclusión

La característica de la variable de entorno para la configuración del sitio simplifica ALM, mejora la capacidad de configuración y reduce el riesgo de errores manuales. Los creadores y administradores que adopten esta característica garantizan que sus sitios sigan siendo flexibles y se alineen con las estrategias de implementación de la organización.