Versão 1.0.0-alpha.1mais recente
Capítulo 2.27
Cenários de construção
Um livro de receitas com treze construções, desde uma única competência até uma entrega em ambiente isolado da rede (air-gapped). Cada receita indica o objetivo, os blocos de construção, os passos e comandos, a barreira de controlo que prova que funcionou e o que muda consoante a edição e a forma de entrega.
Esta página foi traduzida por IA a partir do original em inglês. Em caso de dúvida, a página em inglês serve de referência. Ler esta página em inglês

Estas são as receitas a que recorro quando alguém na Corrán Orbital, ou num cliente, diz «queremos que o Nexus faça X». Cada uma é curta de propósito. O raciocínio por detrás dos passos está nos capítulos anteriores a este: o capítulo 2.20, Competências, e o capítulo 2.21, O Plugin SDK, que aborda o kit de desenvolvimento de software, depois o capítulo 2.23, Pacotes de domínio, e os três capítulos seguintes sobre construção. Aqui encontra o objetivo, que blocos de construção utilizar, os passos, os comandos, a porta de controlo que lhe indica que funcionou e as notas sobre a edição e a entrega.
A porta de controlo é o que mais importa. Uma receita está concluída quando a sua porta de controlo está verde. Cada porta de controlo neste capítulo é algo que pode executar ou algo que a plataforma executa por si, e cada uma termina com um valor diferente de zero ou recusa com um código quando não é satisfeita.
| Cenário | Bloco de construção principal | A porta de controlo que o comprova | Edição |
|---|---|---|---|
| Uma nova competência do Skills Engine | Pacote SKILL.md |
skill:validate com zero erros |
Community e Enterprise |
Uma competência de manifesto com host_callback |
Manifesto do plugin skills[] |
create-nexus-plugin validate e nexus-gates |
Community e Enterprise |
| Estender um pacote existente | pack.json com inherits |
Verificação da política da lente na porta de controlo piloto | Enterprise e uma licença de pacote |
| Um novo pacote de raiz | Caminho ideal do pacote de domínio | Portas de controlo de preparação e piloto | Enterprise |
| Um conector de dados | Competência plugin_queue |
validate, nexus-gates, recusa de saída |
Community e Enterprise |
| Uma ferramenta MCP (Model Context Protocol) | mcpTools[] do manifesto |
validate (sem combinadores de nível superior) |
Community e Enterprise |
| Uma montra de marca branca | domains e branding do manifesto |
Regra pública scope-adherence |
Enterprise e o suplemento Storefront |
| Um pacote de missão Edge | Pacote de missão | Casos de teste a bordo, duas de três assinaturas | Enterprise e o suplemento Nexus Edge |
| Uma entrega isolada da rede (air-gapped) | Pacote selado | nexus-airgap verify |
Enterprise |
| Um módulo exclusivo da edição Enterprise | @adverant/nexus-spi |
Porta de controlo da linha de licença, compilações de edição | Enterprise |
| Bifurcar ou estender o núcleo aberto | O código-fonte da edição Community | Testes, lint e verificação de tipos | Community |
| Uma aplicação na nuvem da edição Team | Cluster de editor | Lançamento assinado, revisão, concessão do cliente | Team |
| Encapsular uma aplicação interna existente | /plugin-create |
migrate, validate, nexus-gates |
Community e Enterprise |
1. Uma nova competência do Skills Engine
O objetivo é uma peça de instrução reutilizável que o assistente, os agentes, os fluxos de trabalho e as ferramentas de programação possam todos executar, tal como verificar uma declaração aduaneira face às suas regras. Os seus blocos de construção são um pacote SKILL.md numa pasta com o nome da competência, um skill.yaml opcional para acionadores e etiquetas, e uma pasta scripts/ opcional incluída com o mesmo.
- Crie
skills/<slug>/e escrevaSKILL.mdcom metadados iniciais (frontmatter):name(em kebab-case, igual ao nome da pasta),description(até 500 caracteres),allowed-toolse, opcionalmente,triggers,capabilitieseversion. - Escreva o corpo para o modelo: quando utilizar a competência, os seus passos, exemplos e o que nunca deve fazer.
- Adicione casos de teste. Inclua um com uma instrução inserida nos dados de entrada que a competência não deva seguir.
- Valide, consulte o plano de carregamento e, em seguida, carregue.
- Publique. Uma competência que adiciona uma ferramenta de escrita fica retida até que duas pessoas designadas a aprovem com chaves de acesso (passkeys), e o proponente não pode aprovar a sua própria alteração.
npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filing --dry-run
npm run skill:upload skills/check-a-customs-filingA porta de controlo é skill:validate, que tem de comunicar zero erros antes de algo poder ser publicado. Os erros bloqueantes são um nome ou descrição em falta e um slug ou tipo de tarefa duplicado. O carregamento de conteúdo que já está publicado devolve a versão existente (CONTENT_HASH_ALREADY_PUBLISHED), pelo que é seguro repetir o carregamento.
A edição Community recebe todo o criador, a biblioteca, as versões, a reversão para versões anteriores, a importação e os testes. Na edição Enterprise, a publicação também passa pelos modos sombra (shadow) e canário (canary): a versão aprovada é executada em modo sombra, depois para uma unidade atrás de portas de controlo designadas, depois para todos, e para automaticamente se uma porta de controlo não for cumprida. Para um cliente isolado da rede (air-gapped), as competências viajam pré-assinadas dentro do pacote selado (cenário 9).
2. Uma competência de manifesto com host_callback
O objetivo é a computação determinística no seu próprio plugin que a plataforma possa despachar, tal como abrir um registo de desvio a partir de uma leitura. Utilizará uma linha em skills[] do manifesto com o nível host_callback, e uma rota /internal no seu backend protegida pela guarda de serviço do SDK.
- Declare a competência:
idem lower_snake,tier: "host_callback", umclassificationigual ou inferior ao limite máximo de confiança do seu plugin,inputSchema,outputSchemae umtimeoutMsentre 1 segundo e 6 horas. - Preencha
hostCallback: o nome do seu próprio Service, a respetiva porta, um caminho relativo como/internal/skills/excursion_open, ambos os limites de bytes (maxRequestBytesemaxResponseBytes) etenantHeader: "X-Organization-ID". - Declare a rota em
api.endpoints[]comauth: "service-key"ouauth: "internal", e proteja-a comrequireServiceouserviceMiddleware, nunca com a guarda de âmbito do utilizador. - Valide, execute as portas de controlo e deixe a integração sincronizar as competências com o registo através de
compileRegistry. Nunca escreve SQL de registo manualmente.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testvalidate aplica as próprias regras da sincronização de registo antes de algo ser sincronizado, sendo cada violação recusada com o código do recetor. Um caminho com um esquema, // ou uma barra invertida é recusado como sendo de origem cruzada (cross-origin). Um limite de bytes em falta é ENDPOINT_BYTE_CAP_REQUIRED, um campo de outro nível é FIELD_NOT_FOR_TIER e um tempo limite fora do intervalo é TIMEOUT_OUT_OF_BOUNDS. Em seguida, nexus-gates verifica se a rota /internal contém a guarda de serviço e está declarada como internal ou service-key. Esse par de portas de controlo é a prova.
A sincronização é declarativa. Publique sempre o conjunto completo de competências, porque uma competência que omita é desativada, e faça falhar o seu passo de implementação em qualquer estado que não seja 200. Na edição Enterprise, a sincronização de um plugin é verificada como um todo: se uma competência violar uma regra, nada dessa sincronização é aceite (PLUGIN_SYNC_ALL_OR_NOTHING) e a versão anterior continua em execução. Um plugin com nível de confiança da comunidade não pode utilizar os níveis que acedem a um modelo, tool_using e llm_only; esses necessitam de confiança core ou verified.
3. Estender um pacote existente
O objetivo é um novo setor ou subsetor que reutiliza a maior parte de um pacote existente, tal como a concessão de crédito e os litígios de cartões sobre a estrutura do pacote de Seguros. O bloco de construção é um pack.json que indica o seu pacote pai em inherits e adiciona apenas os seus próprios grupos de lentes e palavras.
- Inicie o pacote com o caminho ideal do pacote de domínio e, em seguida, defina
inheritscomo o identificador do pacote pai. - Adicione os seus próprios grupos de
lens, cada um com os seus lugares, finalidade e referência de léxico. - Adicione as suas palavras ao léxico com uma explicação simples para cada uma. Marque um termo com
exactonde deva ser apresentado exatamente como está escrito. - Reutilize lentes partilhadas em vez de criar as suas próprias: um regime de que vários pacotes necessitam, como um registo de tecnologia subcontratada, é uma lente partilhada.
- Verifique a cadeia de licenças. O seu pacote herda os requisitos de suplementos do respetivo pacote pai.
- Pré-visualize cada lente assumindo o papel de uma pessoa num ramo sintético.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }A prova é a verificação de política da porta de controlo piloto, que confirma que cada lente apenas restringe a sua base e mantém os campos pessoais desativados por predefinição. Uma lente que tente mostrar o que a sua base oculta é recusada com LENS_CANNOT_WIDEN. Do lado do licenciamento, a consola recusa emitir uma licença para o seu pacote sem os suplementos de que o pacote pai necessita; o pacote de Seguros necessita de Salas de decisão e de registos selados.
Os pacotes de domínio pertencem à edição Enterprise e são licenciados por pacote. Os ecrãs de telemóvel de um pacote também necessitam do suplemento de aplicações móveis (Mobile apps). Um pacote filho não pode alterar a interface base (shell), os componentes ou as regras de escrita.
4. Um novo pacote de raiz
O objetivo é a visão de um setor sobre o Nexus: o seu modelo de conhecimento, as lentes para cada função, as evidências que as suas regras exigem e o plugin que mantém os seus dados atualizados. O Capítulo 2.24, Construir uma vertical personalizada de ponta a ponta, percorre esta construção na íntegra; aqui está a versão resumida.
- Execute o caminho ideal do pacote de domínio e descreva o pacote: finalidade, unidades, o modelo base e as regras que mapeia.
- Construa o modelo de conhecimento sobre um modelo base e classifique cada propriedade à medida que a adiciona.
- Leia o plano, confirme a respetiva impressão digital com a sua chave de acesso (passkey) e crie.
- Molde as lentes no construtor de lentes (Lens builder), restringindo cada uma delas uma lente base.
- Escreva o plugin e quaisquer competências do Skills Engine de que o pacote necessite.
- Gere dados sintéticos iniciais com os casos atípicos que lhe interessam e pré-visualize cada lente assumindo o papel de uma pessoa.
- Promova do espaço de desenvolvimento para o ambiente de preparação (staging), para uma unidade piloto e, em seguida, para todas as unidades.
A prova são as portas de controlo de promoção: todos os testes a passar nos ramos sintéticos para o ambiente de preparação, depois dois revisores que não sejam o autor e, por fim, 14 dias no piloto com erros inferiores a 1 em 1000. Nenhum passo pode ser ignorado (GATE_CANNOT_BE_SKIPPED). Os pacotes pertencem à edição Enterprise. Na edição Community, o caminho ideal do pacote de domínio não é disponibilizado.
5. Um conector de dados
O objetivo é fazer fluir dados de um sistema externo para as tabelas próprias do seu plugin de forma agendada, tal como eventos de portaria de um sistema operativo de terminal. Os blocos de construção são uma competência plugin_queue, um worker que extrai da sua fila, uma migração para a tabela de destino e um endereço de saída declarado no manifesto.
- Declare uma competência
plugin_queuecomqueueNameescrito como<plugin name>.<name>. Não são permitidos dois pontos, e o nome tem de constar no manifesto, porque o orquestrador coloca na fila diretamente através dele. - Escreva o worker que extrai da fila e chama o sistema externo.
- Declare o endereço do sistema externo como um endereço de saída. Tudo o que não estiver listado é bloqueado.
- Armazene o que chega no seu próprio esquema, com
organization_id,owner_user_idebusiness_unit_idem cada linha. - Leia a credencial do sistema externo pelo nome a partir do ambiente e liste a variável em
scripts/ci/required-env. - Despache as extrações através do UNO, o motor de fluxos de trabalho, nunca com um temporizador que chame os motores diretamente.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only no-credentials --only no-direct-compute --only migrations-are-scoped
node scripts/ci/required-envvalidate verifica o nome da fila e o tempo limite face às regras da sincronização de registo. As três portas de controlo provam que não existe credencial de modelo, nem computação direta, e que existe uma tabela com o âmbito adequado. Execute o nexus-gates completo antes de enviar (push), uma vez que --only restringe a execução e indica-o no seu resumo. Em tempo de execução, uma chamada para um endereço que o manifesto não tenha declarado é travada na periferia com EGRESS_NOT_DECLARED.
Os conectores próprios da plataforma para unidades de disco, wikis, arquivos de correio e sistemas legados, com captura de alterações e linhagem, estão incluídos no suplemento de conectores de dados (Data connectors). Um conector que construa por si mesmo é um plugin e funciona em qualquer edição. Adicionar um endereço de saída num lançamento posterior constitui um alargamento de âmbito, ficando retido até que dois revisores o aceitem.
6. Uma ferramenta MCP
O objetivo é uma ferramenta que o Claude Code, os agentes e outros clientes MCP (Model Context Protocol) possam chamar, tal como consultar o histórico de inspeções de uma embarcação. O bloco de construção é uma entrada em mcpTools[] do manifesto, com um name, um description e um inputSchema.
- Dê um nome à ferramenta e descreva-a de forma clara. A descrição é o que um modelo lê para decidir se a deve chamar.
- Escreva o
inputSchemacomo um único esquema de objeto. Não coloqueoneOf,allOfouanyOfno seu nível superior. - Mantenha a rota que serve a ferramenta atrás da guarda de âmbito, tal como qualquer outra rota
/api, para que a propriedade do inquilino (tenancy) provenha do token de quem efetua a chamada. - Valide o manifesto.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonA prova é validate: um combinador de nível superior é recusado no momento da autoria, porque em tempo de execução faria a ferramenta falhar para cada subagente MCP que a importasse, e a ferramenta existiria sem que ninguém a pudesse chamar.
Na edição Enterprise, cada ferramenta que um IDE (ambiente de desenvolvimento integrado) pode chamar está listada no catálogo de ferramentas da Workbench com o respetivo nível, se altera elementos, uma impressão digital afixada e as funções que a podem utilizar. Se a descrição da sua ferramenta mudar num novo lançamento, o catálogo retém a ferramenta até que uma pessoa reveja a alteração. Isto é deliberado: uma descrição alterada é a forma como uma ferramenta pode começar a pedir a um modelo algo que não deveria. Uma chamada a qualquer elemento fora do passe de quem efetua a chamada é recusada com CONNECTION_SCOPE_EXCEEDED.
7. Uma montra de marca branca
O objetivo é uma aplicação utilizada pelos próprios clientes do seu cliente, no domínio do cliente e com a marca deste, sem qualquer vestígio da Adverant. Os blocos de construção são os blocos domains e branding do manifesto, os auxiliares de início de sessão do SDK e o suplemento Storefront / marca branca do cliente.
- Coloque o domínio do cliente em
domains[]comoprimary, com quaisqueraliases. - Preencha
branding:appName,tagline,primaryColor,accentColor, umpasskeyRpIdigual ao domínio eoauthClientRef. - Inicie a sessão das pessoas através dos auxiliares de início de sessão do SDK e declare exatamente as suas duas rotas públicas, com
auth: "public"eallowAnonymous: true. - Envie todas as chamadas de frontend através do proxy de lista de permissões do backend para frontend. Nunca coloque um endereço de serviço no cliente.
- Deixe os pagamentos para o administrador do cliente, que liga os gateways e configura o checkout com a sua marca.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contractA prova é scope-adherence. Admite uma rota /api desprotegida apenas quando o manifesto declara esse método e caminho exatos como públicos e o caminho é uma das rotas de início de sessão; qualquer outra declaração pública falha e indica os dois caminhos permitidos. Em seguida, api-contract compara as diferenças entre as rotas declaradas e as reais em ambas as direções. definePlugin também recusa um frontend.basePath que não seja um caminho relativo da mesma origem.
A marca branca corresponde ao suplemento Storefront / marca branca na edição Enterprise, que também licencia os pagamentos. Os dados dos cartões nunca tocam no Nexus. O administrador do cliente detém a marca, e a plataforma resolve-a a partir da organização e não a partir do seu código.
8. Um pacote de missão Edge
O objetivo é uma missão nova ou atualizada para um satélite ou drone que execute o Nexus Edge, tal como adicionar um adaptador de localização de navios a uma missão de vigilância marítima. O bloco de construção é um pacote de missão, construído e assinado em terra.
- Comece a partir do pacote atual na página Construir um pacote de missão (Build a mission pack), que elabora o rascunho da nova versão a partir da antiga e assinala todas as alterações.
- Altere apenas o que a missão necessita. Mantenha as partes de grandes dimensões, o modelo de linguagem e a ontologia, estáveis sempre que possível.
- Verifique a tabela de alocação em cada passo de degradação, para que cada placa continue a ter capacidade para o que executa.
- Execute os casos de teste a bordo do pacote numa bancada de ensaio com as mesmas placas.
- Envie-o para assinatura: são necessárias duas de três assinaturas.
- Lance-o para uma plataforma. Entra na ranhura inativa e só é ativado depois de os seus casos de teste passarem a bordo.
- Implemente na plataforma seguinte após uma semana sem incidentes.
Não existem comandos nesta receita; o processo é feito nas páginas do Nexus Edge na consola. A prova são os casos de teste a bordo, que têm todos de passar antes de o pacote ser ativado, e as duas assinaturas. Se um teste falhar a bordo, a plataforma mantém-se no pacote anterior e a falha é descarregada na passagem seguinte. A instalação de um pacote em hardware para o qual não foi verificado é recusada com PACK_NOT_CHECKED_FOR_HARDWARE.
O Nexus Edge é um suplemento, licenciado por plataforma ou por frota. Os pacotes permanecem válidos enquanto uma plataforma está sem contacto. A ligação ascendente (uplink) é estreita, pelo que deve planear os tamanhos em função disso: o nosso lançamento 1.5 tinha 412 MB, contra 9.8 GB para um pacote com um novo modelo de linguagem.
9. Uma entrega em ambiente isolado da rede (air-gapped) a um cliente
O objetivo é ter o seu plugin ou pacote instalado nas instalações de um cliente sem rede. Os blocos de construção são um pacote selado de @adverant/nexus-sovereign, a sua chave de assinatura de lançamentos e os canais de lançamento próprios do cliente.
- Construa o plugin e as respetivas imagens exatamente como faria para um cliente ligado à rede, com todas as portas de controlo verdes.
- Crie um pacote selado com o perfil
airgap, contendo as imagens, as migrações, as competências pré-assinadas e uma SBOM (lista de materiais de software) com as licenças. - Assine-o com a sua chave de lançamento Ed25519.
- Verifique-o você mesmo numa máquina limpa.
- Envie o pacote em suporte físico e envie a sua chave pública e o SHA-256 do pacote por uma via separada.
- O operador do cliente verifica o pacote com a sua chave e, em seguida, introduz o lançamento através dos seus próprios canais de lançamento.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapnexus-airgap bundle constrói o pacote a partir da sua configuração de pacote. A prova é nexus-airgap verify do lado do cliente. Volta a calcular o hash de cada ficheiro, rejeita qualquer ficheiro que o manifesto não liste, exige um signatário fidedigno e recusa um pacote cuja lista de permissões de rede não esteja vazia. Um ficheiro alterado falha com BUNDLE_INTEGRITY_VIOLATION. Ninguém deve nunca desativar a verificação estrita para contornar isto.
As instalações isoladas da rede (air-gapped) pertencem à edição Enterprise. Nada no pacote pode transferir o que quer que seja durante a instalação, e um modelo de que o plugin necessite provém do servidor de modelos próprio do cliente através do encaminhador de fornecedores de IA (inteligência artificial) (AI Provider Router).
10. Um módulo exclusivo Enterprise
O objetivo é uma capacidade fechada e licenciada que se anexa ao núcleo aberto, tal como um registo de auditoria de retenção prolongada vendido apenas a clientes Enterprise. O bloco de construção é o pacote de interface @adverant/nexus-spi, e mais nada da edição Community.
- Mantenha uma cópia fixada ao byte do pacote de interface compilado no seu repositório como um pacote
file:local, com a respetiva fixaçãoSHA256SUMS. - Escreva um
RouteModule(ou umScreenModulepara ecrãs de consola) com base nele, com o grupo de funcionalidades que serve. - Execute todas as rotas atrás de
ctx.requireScopee verifique a concessão própria do módulo antes de responder. - Recuse com
LICENCE_LOCKEDquando a organização não tiver direito de acesso e apresente a pré-visualização promocional (teaser) da funcionalidade, nunca os seus dados. - Mantenha o repositório em conformidade com a linha de licença e, em seguida, compile a árvore composta de cada edição.
npm ci
npm test
npm run buildA prova é a regra da linha de licença: nenhuma importação de um âmbito Community exceto o pacote de interface, nenhuma importação relativa para fora do repositório e nenhuma dependência file:, link: ou workspace: fora do mesmo. Além disso, os três comandos acima têm de passar em cada árvore de edição composta, e não apenas na sua árvore de trabalho. O Capítulo 2.25, Construir para cada edição, contém o esqueleto do módulo.
Um módulo é carregado num serviço Community no arranque, em instalações cuja licença inclua o respetivo grupo de funcionalidades. Sem essa concessão, recusa o carregamento, pelo que a mesma compilação é distribuída para todo o lado e não faz nada onde não está licenciada.
11. Fazer fork ou estender o núcleo aberto
O objetivo é uma alteração à própria edição Community, mantida na sua bifurcação (fork) ou contribuída de volta. O bloco de construção é o código-fonte da edição Community ao abrigo da Licença Apache, Versão 2.0.
- Bifurque o repositório e crie um ramo a partir de
main. - Prefira um plugin ou uma competência se o que pretende puder ser implementado dessa forma. Uma alteração ao núcleo fica sob a sua responsabilidade de manutenção em cada lançamento.
- Faça a alteração com testes que falhem sem ela.
- Execute as verificações que o projeto executa antes de propor qualquer alteração.
- Mantenha o ficheiro NOTICE e não utilize os nomes ou marcas registadas da Adverant além de indicar a origem do trabalho.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheckA prova é a passagem dessas três verificações, juntamente com a evidência de que cada novo teste falhava antes da sua alteração. Mantenha uma propriedade do núcleo aberto verdadeira na sua bifurcação: a edição Community executa um agente de ponta a ponta num modelo local sem chave e sem rede. Uma alteração que quebre isto quebra o que torna a edição Community utilizável por si só.
Isto aplica-se apenas à edição Community. Tudo o que precise de permanecer fechado pertence antes a um módulo Enterprise (cenário 10), para que a linha de licença permaneça num ponto claramente identificável por qualquer pessoa.
12. Uma aplicação cloud da edição Team
O objetivo é uma aplicação que os clientes da edição Team possam instalar. A edição Team é executada apenas na nuvem da Adverant, pelo que a aplicação chega até eles apenas através do catálogo. Os blocos de construção são um plugin e um cluster de editor: o seu próprio cluster virtual na nuvem da Adverant com dados de exemplo.
- Construa e teste no cluster de editor, apenas com dados de exemplo.
- Declare tudo o que a aplicação necessita no respetivo manifesto, e nada mais.
- Lance-a assinada, para revisão da Adverant e listagem no catálogo.
- Cada cliente instala-a, concedendo cada âmbito declarado unidade a unidade.
A prova divide-se em duas partes. O lançamento assinado e revisto permite-lhe entrar no catálogo. Depois, a concessão do cliente decide a que é que a aplicação pode aceder nas suas instalações, e qualquer chamada que não tenha declarado é recusada com CONNECTION_SCOPE_EXCEEDED. Só pode adicionar um âmbito em falta num novo lançamento que o cliente reveja.
Um cluster de editor não tem rota para nenhum cliente, e pedir dados de um cliente nesse local é recusado com TENANT_BOUNDARY. Os clientes podem partilhar resultados de testes consigo, mas nunca os seus dados. A edição Team inclui a capacidade de operações de fluxo de trabalho, pelo que, se a sua aplicação fornecer fluxos de trabalho, os clientes Team podem promovê-los eles próprios entre ambientes.
13. Encapsular uma aplicação interna existente como um plugin
O objetivo é trazer uma aplicação que a sua empresa já executa para dentro do Nexus, para que herde o início de sessão, o isolamento e a governação. Os blocos de construção são a competência /plugin-create para o primeiro rascunho e as ferramentas de manifesto e portas de controlo do SDK para o concluir.
- Execute
/plugin-createcom o repositório. Este analisa o código e escolhe uma estratégia de encapsulamento, gerando em seguida o backend, as migrações, a interface de utilizador (UI), o manifesto e os testes. - Eleve o manifesto para o contrato v2.
migrateadiciona as três frases de regra e movedomainparadomains[], recusando-se a inventar um ponto de entrada. - Substitua qualquer valor de inquilino (tenant) que o encapsulador leia a partir de cabeçalhos pela guarda de âmbito do SDK.
- Adicione
organization_id,owner_user_idebusiness_unit_ida cada tabela, com chaves primárias encabeçadas pelo inquilino. - Declare cada rota com o respetivo direito e instale o livro-razão de recusas.
- Execute as portas de controlo até ficarem verdes.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin migrate nexus.manifest.json --write
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testA prova é nexus-gates terminar com o código 0, com scope-adherence, one-fence, migrations-are-scoped, crud-adherence e api-contract todos a passar. Espere que a primeira execução falhe na maioria deles; a nossa comunicou todas as rotas como sem âmbito definido, porque o rascunho confiava em cabeçalhos que o navegador podia definir. As portas de controlo não têm opção de correção automática, de propósito.
As aplicações encapsuladas funcionam em qualquer edição. A implementação é feita apenas através dos canais de lançamento da instalação, pelo que deve ignorar quaisquer ficheiros de implementação que o rascunho tenha gerado. O trabalho de isolamento é o que consome mais tempo: planeie dias para uma aplicação real, e não horas.


