Partilhar via

Manifesto da carga de trabalho no Extensibility Toolkit

O manifesto da carga de trabalho (WorkloadManifest.xml) é a configuração de nível de carga de trabalho para sua carga de trabalho. Ele informa ao Fabric quem é sua carga de trabalho e como chegar ao seu front-end para que o host possa inicializá-la com segurança. Ele complementa, mas não substitui, as definições de produto e item:

  • Os metadados do produto (para descoberta e publicação) vivem em Product.json.
  • Os tipos de item e seus comportamentos vivem nos manifestos de item e nos arquivos JSON.

O que o manifesto da carga de trabalho define

  • Identidade da carga de trabalho: WorkloadName ([Organização].[ WorkloadId]) e Version (versão semântica)
  • Modelo de hospedagem: HostingType (use FERemote)
  • Aplicativo Front-end Microsoft Entra: AADFEApp>AppId
  • Endpoints front-end: entradas com ServiceEndpoint (por exemplo, Name), Frontend (localhost em dev; o domínio de produção deve ser um subdomínio do seu domínio Entra verificado), e Url. IsEndpointResolutionService Consulte Requisitos Gerais de Publicação para restrições de domínio.
  • Relaxamento opcional da sandbox: EnableSandboxRelaxation apenas quando são necessárias capacidades especiais do iFrame (por exemplo, iniciar transferências de ficheiros)

Melhores práticas

  • Mantenha as versões consistentes em todo o seu aplicativo e manifesto
  • Declarar as permissões mínimas necessárias (princípio do menor privilégio)
  • Validar o manifesto como parte da Integração Contínua

Estrutura

Elementos-chave do manifesto e o seu significado:

  • Elemento raiz com uma versão de esquema (por exemplo, SchemaVersion="2.0.0").
  • Workload nó com atributos como:
    • WorkloadName — identificador único na forma [Organization].[WorkloadId] (por exemplo, Org.MyWorkload). Se não pretende publicar para outros inquilinos, pode utilizar Org.[WorkloadId]. Para publicação entre locatários, registre um WorkloadName completo com o Fabric.
    • HostingType — indica o alojamento da carga de trabalho; use FERemote.
  • Version node — versão semântica do seu pacote de carga de trabalho.
  • RemoteServiceConfiguration > CloudServiceConfiguration contendo:
    • Cloud (por exemplo, Public).
    • AADFEApp > AppId — contém o ID da aplicação frontend Microsoft Entra.
    • EnableSandboxRelaxation — defina-o para true se você precisar de recursos especiais do iFrame (por exemplo, iniciar downloads de arquivos). Manter false por padrão para segurança.
    • Endpoints > ServiceEndpoint Inscrições com:
      • Name (por exemplo, Frontend).
      • Url — onde o frontend está hospedado. Uso https://localhost:port para desenvolvimento. Em produção, o domínio deve ser um subdomínio do seu domínio verificado do Entra. Consulte Requisitos Gerais de Publicação para restrições completas de domínio.
      • IsEndpointResolutionService.

Criar output e espaços reservados

No Starter-Kit, preenche os espaços reservados sempre que o Manifesto é criado com base na configuração no arquivo de ambiente. O manifesto final finalizado é criado no diretório build/Manifest. Usar espaços reservados e preenchê-los a partir dos ambientes permite que você crie ambientes diferentes sem alterar os arquivos ou os scripts. A saída de compilação é usada por:

  • DevGateway: registre sua instância de desenvolvimento local com o Fabric para que seu aplicativo possa ser carregado dentro do portal do Fabric durante o desenvolvimento.
  • DevServer: que está fornecendo as informações para o Fabric
  • Portal de Administração: para teste e produção, carregue o pacote de manifesto através do Portal de Administração do Fabric como parte da publicação. Consulte Publicar sua carga de trabalho.

Mais informações

Conteúdo relacionado

  • Last updated on