Compartir a través de

Manifiesto de carga de trabajo en el kit de herramientas de extensibilidad

El manifiesto de carga de trabajo (WorkloadManifest.xml) es la configuración a nivel de carga de trabajo para tu tarea. Indica a Fabric quién es la carga de trabajo y cómo llegar al front-end para que el host pueda arrancarlo de forma segura. Complementa, pero no reemplaza, las definiciones de productos y elementos:

  • Los metadatos del producto (para la detección y publicación) residen en Product.json.
  • Los tipos de elementos y sus comportamientos residen en los manifiestos de elemento y los archivos JSON.

Qué define el manifiesto de carga de trabajo

  • Identidad de carga de trabajo: WorkloadName ([Organización].[ WorkloadId]) y Version (versión semántica)
  • Modelo de hospedaje: HostingType (use FERemote)
  • Aplicación front-end de Microsoft Entra: AADFEApp>AppId
  • Puntos de conexión de front-end: ServiceEndpoint entradas con Name (por ejemplo, Frontend), Url (localhost en desarrollo; el dominio de producción debe ser un subdominio del dominio Entra comprobado) y IsEndpointResolutionService. Consulte Requisitos generales de publicación para las restricciones de dominio.
  • Relajación opcional del espacio aislado: EnableSandboxRelaxation solo cuando se requieren funcionalidades especiales de iFrame (por ejemplo, iniciar descargas de archivos)

procedimientos recomendados

  • Mantén las versiones coherentes en tu aplicación y el manifiesto
  • Declarar los permisos mínimos necesarios (principio de privilegios mínimos)
  • Validar el manifiesto como parte de CI

Estructura

Elementos clave en el manifiesto y lo que significan:

  • Elemento raíz con una versión de esquema (por ejemplo, SchemaVersion="2.0.0").
  • Workload node con atributos como:
    • WorkloadName : identificador único en el formulario [Organization].[WorkloadId] (por ejemplo, Org.MyWorkload). Si no tiene intención de publicar a otros arrendatarios, puede usar Org.[WorkloadId]. Para publicar a través de varios inquilinos, registre un WorkloadName completo con Fabric.
    • HostingType — indica el hospedaje de cargas de trabajo; use FERemote.
  • Version node: versión semántica del paquete de carga de trabajo.
  • RemoteServiceConfiguration > CloudServiceConfiguration Contiene:
    • Cloud (por ejemplo, Public).
    • AADFEApp > AppId — contiene el identificador de aplicación de Microsoft Entra del front-end.
    • EnableSandboxRelaxation — ajústelo a true si requiere capacidades especiales de iFrame (como la iniciación de descargas de archivos). Mantenga false en la configuración predeterminada por seguridad.
    • Endpoints > ServiceEndpoint entradas con:
      • Name (por ejemplo, Frontend).
      • Url : donde se hospeda el front-end. Utilice https://localhost:port para el desarrollo. En producción, el dominio debe ser un subdominio del dominio Entra verificado. Consulte Requisitos generales de publicación para obtener restricciones de dominio completas.
      • IsEndpointResolutionService.

Generar resultados y marcadores de posición

En Starter-Kit, rellena los marcadores de posición cada vez que se crea el manifiesto en función de la configuración del archivo de entorno. El manifiesto finalizado se crea en el build/Manifest directorio . El uso de marcadores de posición y rellenarlos desde los entornos permite crear diferentes entornos sin cambiar los archivos ni los scripts. La salida de compilación es usada por:

  • DevGateway: registre la instancia de desarrollo local con Fabric para que la aplicación pueda cargarse dentro del portal de Fabric durante el desarrollo.
  • DevServer: que proporciona la información al tejido
  • Portal de administración: para pruebas y producción, cargue el paquete de manifiesto a través del Portal de administración de Fabric como parte de la publicación. Ver Publica tu carga de trabajo.

Aprende más

Contenido relacionado

  • Last updated on