Oturum açınToplantı planlayın

Bölüm 2.27

Derleme senaryoları

Tek bir beceriden dış ağa kapalı teslimata kadar on üç derlemeden oluşan bir uygulama rehberi. Her tarif; hedefi, yapı taşlarını, adımları ve komutları, çalıştığını kanıtlayan kontrol noktasını ve sürüme ve teslimat biçimine göre nelerin değiştiğini sunar.

Bu sayfa, İngilizce aslından YZ tarafından çevrilmiştir. Anlaşılmayan bir yer olursa İngilizce sayfa esas alınır. Bu sayfayı İngilizce okuyun

25 dakikalık okuma

Bunlar, Corrán Orbital'de ya da bir müşteride biri "Nexus'un X'i yapmasını istiyoruz" dediğinde başvurduğum tariflerdir. Her biri bilerek kısa tutulmuştur. Adımların gerekçesi bu bölümden önceki bölümlerdedir: bölüm 2.20, Skills ve yazılım geliştirme kitini ele alan bölüm 2.21, The Plugin SDK; ardından bölüm 2.23, Alan paketleri ve ondan sonra gelen, oluşturma üzerine üç bölüm. Burada hedefi, hangi yapı taşlarının kullanılacağını, adımları, komutları, işe yaradığını gösteren kapıyı ve sürüm ile teslimat notlarını bulursunuz.

En önemlisi kapıdır. Bir tarif, kapısı yeşil olduğunda tamamlanmış sayılır. Bu bölümdeki her kapı, sizin çalıştırabileceğiniz ya da platformun sizin için çalıştırdığı bir şeydir ve her biri koşulu sağlanmadığında sıfır dışı bir kodla çıkar ya da bir kodla reddeder.

Senaryo Ana yapı taşı Bunu kanıtlayan kapı Sürüm
Yeni bir Skills Engine becerisi SKILL.md paketi Sıfır hatayla skill:validate Community ve Enterprise
host_callback içeren bir manifest becerisi Eklenti manifesti skills[] create-nexus-plugin validate ve nexus-gates Community ve Enterprise
Mevcut bir paketi genişletme inherits ile pack.json Pilot kapısında mercek politikası denetimi Enterprise ve bir paket lisansı
Sıfırdan yeni bir paket Alan paketi altın yolu Hazırlık ve pilot kapıları Enterprise
Bir veri bağlayıcısı plugin_queue becerisi validate, nexus-gates, çıkış reddi Community ve Enterprise
Bir MCP (Model Context Protocol) aracı Manifest mcpTools[] validate (üst düzeyde birleştirici yok) Community ve Enterprise
Beyaz etiketli bir mağaza Manifest domains ve branding scope-adherence genel erişim kuralı Enterprise ve Storefront eklentisi
Bir Edge görev paketi Görev paketi Cihaz üzerinde test senaryoları, üç imzadan ikisi Enterprise ve Nexus Edge eklentisi
Hava boşluklu bir teslimat Mühürlü paket nexus-airgap verify Enterprise
Yalnızca Enterprise'a özgü bir modül @adverant/nexus-spi Lisans sınırı kapısı, sürüm derlemeleri Enterprise
Açık çekirdeği çatallama veya genişletme Community kaynak kodu Testler, lint ve tür denetimi Community
Team sürümü bir bulut uygulaması Yayıncı kümesi İmzalı sürüm, inceleme, müşteri yetkisi Team
Mevcut bir dahili uygulamayı sarmalama /plugin-create migrate, validate, nexus-gates Community ve Enterprise
Yukarıdan aşağıya okunan bir karar ağacı. İlk karar kutusu "Sürekli çalışan koda ihtiyaç duyuyor mu?" diye sorar. "Hayır", "Bir asistan için talimatlar mı?" karar kutusuna götürür; bunun "Evet" yanıtı "Skills Engine becerisi" ile, "Hayır" yanıtı "Mevcut bir paket üzerinde mercek" ile sonlanır. "Evet", "Platformun tek bir sektöre yönelik görünümü mü?" karar kutusuna götürür; bunun "Evet" yanıtı "Alan paketi (eklentisiyle birlikte)" ile sonlanır, "Hayır" yanıtı ise son karar kutusu olan "Kapalı ve lisanslı kalmalı mı?" sorusuna götürür; bu kutu "Evet" için "Enterprise modülü", "Hayır" için "Eklenti" ile sonlanır.
Hangi yapı taşıyla başlanacağı.

1. Yeni bir Skills Engine becerisi

Hedef, asistanın, ajanların, iş akışlarının ve geliştirici araçlarının hepsinin çalıştırabileceği, örneğin bir gümrük beyannamesini kurallarına göre denetlemek gibi yeniden kullanılabilir bir talimat parçasıdır. Yapı taşlarınız, beceriyle aynı adı taşıyan bir klasördeki SKILL.md paketi, tetikleyiciler ve etiketler için isteğe bağlı bir skill.yaml ve onunla birlikte paketlenen isteğe bağlı bir scripts/ klasörüdür.

  1. skills/<slug>/ oluşturun ve SKILL.md dosyasını şu ön bilgilerle yazın: name (kebab-case, klasör adıyla aynı), description (en fazla 500 karakter), allowed-tools ve isteğe bağlı olarak triggers, capabilities ve version.
  2. Gövdeyi model için yazın: becerinin ne zaman kullanılacağı, adımları, örnekleri ve asla yapmaması gerekenler.
  3. Test senaryoları ekleyin. Bunlardan birine, becerinin uymaması gereken, girdiye yerleştirilmiş bir talimat ekleyin.
  4. Doğrulayın, yükleme planına bakın, ardından yükleyin.
  5. Yayımlayın. Yazma aracı ekleyen bir beceri, adı belirtilmiş iki kişi geçiş anahtarlarıyla onaylayana kadar bekletilir ve öneren kişi kendi değişikliğini onaylayamaz.
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-filing

Kapı skill:validate'dir; herhangi bir şey yayımlanabilmeden önce sıfır hata bildirmesi gerekir. Engelleyici hatalar, eksik ad veya açıklama ile yinelenen slug veya iş türüdür. Zaten yayımlanmış içeriğin yüklenmesi mevcut sürümü (CONTENT_HASH_ALREADY_PUBLISHED) döndürür; bu nedenle yüklemeyi güvenle tekrarlayabilirsiniz.

Community; oluşturucunun tamamını, kütüphaneyi, sürümleri, önceki sürüme dönmeyi, içe aktarmayı ve testleri içerir. Enterprise'da yayımlama ayrıca gölge ve kanarya aşamalarından geçer: onaylanan sürüm önce gölgede, ardından adı belirtilmiş kapıların arkasında tek bir birim için, sonra herkes için çalışır ve bir kapı karşılanmazsa kendiliğinden durur. Hava boşluklu bir müşteri için beceriler, mühürlü paketin içinde önceden imzalanmış olarak taşınır (senaryo 9).

2. host_callback içeren bir bildirim becerisi

Hedef, kendi eklentinizde platformun dağıtabileceği deterministik bir hesaplamadır; örneğin bir okumadan sapma kaydı açmak gibi. Manifestin skills[] bölümünde host_callback katmanına sahip bir satır ve arka ucunuzda SDK'nın hizmet koruyucusuyla korunan bir /internal rotası kullanacaksınız.

  1. Beceriyi bildirin: lower_snake biçiminde id, tier: "host_callback", eklentinizin güven tavanında veya altında bir classification, inputSchema, outputSchema ve 1 saniye ile 6 saat arasında bir timeoutMs.
  2. hostCallback alanını doldurun: kendi Service adınız, bağlantı noktası, /internal/skills/excursion_open gibi göreli bir yol, her iki bayt sınırı (maxRequestBytes ve maxResponseBytes) ve tenantHeader: "X-Organization-ID".
  3. Rotayı api.endpoints[] içinde auth: "service-key" veya auth: "internal" ile bildirin ve kullanıcı kapsamı koruyucusuyla değil, her zaman requireService veya serviceMiddleware ile koruyun.
  4. Doğrulayın, kapıları çalıştırın ve katılım sürecinin becerileri compileRegistry aracılığıyla kayıt defterine eşitlemesine izin verin. Kayıt defteri SQL'ini asla elle yazmazsınız.
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-test

validate, herhangi bir şey eşitlenmeden önce kayıt defteri eşitlemesinin kendi kurallarını uygular ve her ihlali alıcının koduyla reddeder. Şema, // veya ters eğik çizgi içeren bir yol, kaynaklar arası olduğu gerekçesiyle reddedilir. Eksik bir bayt sınırı ENDPOINT_BYTE_CAP_REQUIRED, başka bir katmana ait bir alan FIELD_NOT_FOR_TIER, aralık dışındaki bir zaman aşımı ise TIMEOUT_OUT_OF_BOUNDS hatasıdır. Ardından nexus-gates, /internal rotasının hizmet koruyucusunu taşıdığını ve internal veya service-key olarak bildirildiğini denetler. Bu kapı çifti kanıttır.

Eşitleme bildirimseldir. Her seferinde beceri kümesinin tamamını gönderin, çünkü dışarıda bıraktığınız bir beceri devre dışı bırakılır; dağıtım adımınızı 200 dışındaki her durumda başarısız sayın. Enterprise'da bir eklenti eşitlemesi bütün olarak denetlenir: bir beceri bir kuralı ihlal ederse o eşitlemenin hiçbir kısmı alınmaz (PLUGIN_SYNC_ALL_OR_NOTHING) ve önceki sürüm çalışmaya devam eder. Topluluk güven düzeyindeki bir eklenti, bir modele ulaşan tool_using ve llm_only katmanlarını kullanamaz; bunlar core veya verified güven düzeyi gerektirir.

Eklentiler ve MCP eşitlemesi
Eklentiler ve MCP eşitlemesi
Beceri getiren eklentiler ve her eşitlemede nelerin denetlendiği. Beş becerisinden biri yalnızca platformun barındırabileceği bir katmanı kullandığı için eşitlemesi bütün olarak reddedilen, buna karşın önceki sürümü çalışmaya devam eden eklentiye dikkat edin.

3. Mevcut bir paketi genişletme

Hedef, mevcut bir paketin büyük kısmını yeniden kullanan yeni bir sektör veya alt sektördür; örneğin Insurance paketinin yapısı üzerine kurulan kredi ve kart itirazları. Yapı taşı, inherits içinde üst paketini adlandıran ve yalnızca kendi mercek kümelerini ve sözcüklerini ekleyen bir pack.json'dir.

  1. Paketi alan paketi altın yoluyla başlatın, ardından inherits değerini üst paketin kimliğine ayarlayın.
  2. Her biri kendi koltukları, amacı ve sözlük başvurusuyla birlikte kendi lens kümelerinizi ekleyin.
  3. Sözcüklerinizi her biri için sade bir açıklamayla sözlüğe ekleyin. Yazıldığı gibi gösterilmesi gereken terimleri exact olarak işaretleyin.
  4. Kendi merceğinizi çizmek yerine paylaşılan mercekleri yeniden kullanın: dış kaynaklı teknoloji sicili gibi birden fazla paketin ihtiyaç duyduğu bir düzenleme, tek bir paylaşılan mercektir.
  5. Lisans zincirini denetleyin. Paketiniz, üst paketinin eklenti gereksinimlerini devralır.
  6. Her merceği sentetik bir dal üzerinde bir kişi olarak önizleyin.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Kanıt, pilot kapısının politika denetimidir; bu denetim her merceğin yalnızca kendi tabanını daralttığını ve kişisel alanları varsayılan olarak kapalı tuttuğunu doğrular. Tabanının gizlediğini göstermeye çalışan bir mercek LENS_CANNOT_WIDEN ile reddedilir. Lisanslama tarafında konsol, üst paketin gerektirdiği eklentiler olmadan paketiniz için lisans düzenlemeyi reddeder; Insurance paketi Karar odaları ve mühürlü kayıtlar gerektirir.

Alan paketleri Enterprise'a özgüdür ve paket başına lisanslanır. Bir paketin telefon ekranları ayrıca Mobil uygulamalar eklentisini gerektirir. Bir alt paket kabuğu, bileşenleri veya yazım kurallarını değiştiremez.

4. Sıfırdan yeni bir paket

Hedef, bir sektörün Nexus görünümüdür: bilgi modeli, her rol için mercekler, kurallarının istediği kanıtlar ve verilerini güncel tutan eklenti. Bölüm 2.24, Uçtan uca özel bir dikey oluşturma, bu yapıyı ayrıntılı olarak anlatır; burada kısa biçimi yer alıyor.

  1. Alan paketi altın yolunu çalıştırın ve paketi tanımlayın: amaç, birimler, temel model ve eşlediği kurallar.
  2. Bilgi modelini bir temel model üzerine kurun ve her özelliği eklerken sınıflandırın.
  3. Planı okuyun, parmak izini geçiş anahtarınızla onaylayın ve oluşturun.
  4. Mercekleri, her biri bir temel merceği daraltacak şekilde Lens builder'da biçimlendirin.
  5. Eklentiyi ve paketin ihtiyaç duyduğu tüm Skills Engine becerilerini yazın.
  6. Önemsediğiniz sıra dışı durumları içeren, tohumlanmış sentetik veriler oluşturun ve her merceği bir kişi olarak önizleyin.
  7. Geliştirme alanından hazırlık ortamına, bir pilot birime ve ardından tüm birimlere yükseltin.

Kanıt, yükseltme kapılarıdır: hazırlık ortamına geçişte sentetik dallardaki tüm testlerin başarılı olması, ardından yazar olmayan iki gözden geçiren, ardından hata oranı 1.000'de 1'in altında olacak şekilde pilotta 14 gün. Hiçbir adım atlanamaz (GATE_CANNOT_BE_SKIPPED). Paketler Enterprise'a özgüdür. Community'de alan paketi altın yolu sunulmaz.

5. Bir veri bağlayıcısı

Hedef, bir dış sistemden gelen verilerin bir zamanlamaya göre eklentinizin kendi tablolarına akmasıdır; örneğin bir terminal işletim sisteminden gelen kapı olayları. Yapı taşları bir plugin_queue becerisi, kuyruğunuzu çeken bir çalışan, hedef tablo için bir geçiş ve manifestte bildirilen bir giden adrestir.

  1. queueName değeri <plugin name>.<name> olarak yazılmış bir plugin_queue becerisi bildirin. İki nokta üst üste kullanılamaz ve ad manifestte bulunmalıdır, çünkü düzenleyici doğrudan bu kuyruğa iş ekler.
  2. Kuyruğu çeken ve dış sistemi çağıran çalışanı yazın.
  3. Dış sistemin adresini giden adres olarak bildirin. Listelenmeyen her şey engellenir.
  4. Gelen verileri, her satırda organization_id, owner_user_id ve business_unit_id bulunacak şekilde kendi şemanızda saklayın.
  5. Dış sistemin kimlik bilgisini ortamdan adıyla okuyun ve değişkeni scripts/ci/required-env içinde listeleyin.
  6. Çekme işlemlerini, motorları doğrudan çağıran bir zamanlayıcıyla değil, her zaman iş akışı motoru UNO üzerinden dağıtın.
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-env

validate, kuyruk adını ve zaman aşımını kayıt defteri eşitlemesinin kurallarına göre denetler. Üç kapı, model kimlik bilgisi olmadığını, doğrudan hesaplama olmadığını ve tablonun doğru kapsamlandırıldığını kanıtlar. Göndermeden önce nexus-gates'nin tamamını çalıştırın, çünkü --only çalıştırmayı daraltır ve bunu özetinde belirtir. Çalışma zamanında, manifestin bildirmediği bir adrese yapılan çağrı uçta EGRESS_NOT_DECLARED ile durdurulur.

Platformun sürücülere, wikilere, posta depolarına ve eski sistemlere yönelik, değişiklik yakalama ve köken izleme özellikli kendi bağlayıcıları Data connectors eklentisiyle gelir. Kendi oluşturduğunuz bir bağlayıcı bir eklentidir ve her sürümde çalışır. Sonraki bir sürümde giden adres eklemek bir genişletmedir ve iki gözden geçiren kabul edene kadar bekletilir.

6. Bir MCP aracı

Hedef, Claude Code'un, ajanların ve diğer MCP (Model Context Protocol) istemcilerinin çağırabileceği bir araçtır; örneğin bir geminin denetim geçmişini sorgulamak. Yapı taşı, manifestin mcpTools[] bölümünde name, description ve inputSchema içeren bir girdidir.

  1. Aracı adlandırın ve sade bir dille tanımlayın. Açıklama, bir modelin aracı çağırıp çağırmayacağına karar vermek için okuduğu metindir.
  2. inputSchema alanını tek bir nesne şeması olarak yazın. Üst düzeyine oneOf, allOf veya anyOf koymayın.
  3. Aracı sunan rotayı, diğer tüm /api rotaları gibi kapsam koruyucusunun arkasında tutun; böylece kiracılık bilgisi çağıranın belirtecinden gelir.
  4. Manifesti doğrulayın.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Kanıt validate'dir: üst düzey bir birleştirici yazım aşamasında reddedilir, çünkü çalışma zamanında aracı içe aktaran her MCP alt ajanı için aracın başarısız olmasına yol açar ve araç, kimsenin çağıramadığı hâlde var olmaya devam eder.

Enterprise'da bir IDE'nin (tümleşik geliştirme ortamı) çağırabileceği her araç, katmanı, değişiklik yapıp yapmadığı, sabitlenmiş bir parmak izi ve onu kullanabilecek rollerle birlikte Workbench araç kataloğunda listelenir. Aracınızın açıklaması yeni bir sürümde değişirse katalog, bir kişi değişikliği inceleyene kadar aracı bekletir. Bu bilinçli bir tercihtir: değişen bir açıklama, bir aracın modelden istememesi gereken bir şeyi istemeye başlamasının yoludur. Çağıranın izni dışındaki herhangi bir şeye yapılan çağrı CONNECTION_SCOPE_EXCEEDED ile reddedilir.

7. Beyaz etiketli bir vitrin

Hedef, müşterinizin kendi müşterilerinin, müşterinin alan adında ve markasıyla, Adverant'tan hiçbir iz taşımadan kullandığı bir uygulamadır. Yapı taşları manifestin domains ve branding blokları, SDK'nın oturum açma yardımcıları ve müşterinin Storefront / beyaz etiket eklentisidir.

  1. Müşterinin alan adını, varsa aliases ile birlikte domains[] içine primary olarak yazın.
  2. branding alanını doldurun: appName, tagline, primaryColor, accentColor, alan adına eşit bir passkeyRpId ve oauthClientRef.
  3. Kullanıcıların oturumunu SDK'nın oturum açma yardımcılarıyla açın ve bunların iki genel rotasını auth: "public" ve allowAnonymous: true ile tam olarak bildirin.
  4. Her ön uç çağrısını, ön uç için arka uç izin listesi proxy'si üzerinden gönderin. İstemciye asla bir hizmet adresi koymayın.
  5. Ödemeleri, ağ geçitlerini bağlayan ve markalı ödeme sayfasını kuran müşterinin yöneticisine bırakın.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Kanıt scope-adherence'dir. Korunmayan bir /api rotasını yalnızca manifest tam olarak o yöntemi ve yolu genel olarak bildirdiğinde ve yol oturum açma rotalarından biri olduğunda kabul eder; diğer tüm genel bildirimler başarısız olur ve izin verilen iki yolu belirtir. Ardından api-contract, bildirilen rotaları gerçek rotalarla her iki yönde karşılaştırır. definePlugin ayrıca göreli, aynı kaynaklı bir yol olmayan frontend.basePath değerini de reddeder.

Beyaz etiket, Enterprise'daki Storefront / beyaz etiket eklentisidir ve bu eklenti ödemeleri de lisanslar. Kart bilgileri hiçbir zaman Nexus'a ulaşmaz. Markanın sahibi müşterinin yöneticisidir ve platform markayı sizin kodunuzdan değil, kuruluştan çözümler.

8. Bir Edge görev paketi

Hedef, Nexus Edge çalıştıran bir uydu veya drone için yeni ya da güncellenmiş bir görevdir; örneğin bir deniz gözetleme görevine gemi bulucu adaptör eklemek gibi. Yapı taşı, yerde oluşturulan ve imzalanan bir görev paketidir.

  1. Mevcut paketten Görev paketi oluşturma sayfasında başlayın; bu sayfa yeni sürümün taslağını eskisinden hazırlar ve her değişikliği işaretler.
  2. Yalnızca görevin gerektirdiği şeyleri değiştirin. Mümkün olduğunda büyük parçaları, yani dil modelini ve ontolojiyi sabit tutun.
  3. Her kartın çalıştırdığı şeye hâlâ uyduğundan emin olmak için her kademeli düşüş adımında yerleşim tablosunu kontrol edin.
  4. Paketin araç üstü test senaryolarını aynı kartlara sahip bir test düzeneğinde çalıştırın.
  5. İmzalanması için gönderin: üç imzadan ikisi gereklidir.
  6. Tek bir platforma yayımlayın. Paket boştaki yuvaya yerleşir ve yalnızca test senaryoları araç üstünde başarılı olduktan sonra etkinleştirilir.
  7. Bir hafta sorunsuz geçtikten sonra bir sonraki platforma dağıtın.
Görev paketleri
Görev paketleri
Görev paketi kitaplığı; her paketin neler taşıdığını ve onu çalıştıran platformları gösterir. Geri dönmek için araç üstünde tutulan eski sürüme ve her paketin kendi donanımında geçmesi gereken test senaryosu sayısına dikkat edin.

Bu tarifte komut yoktur; işlem konsolun Nexus Edge sayfalarında yapılır. Kanıt, paket etkinleştirilmeden önce tümünün başarılı olması gereken araç üstü test senaryoları ve iki imzadır. Araç üstünde bir test başarısız olursa platform önceki paketinde kalır ve hata bir sonraki geçişte yere indirilir. Bir paketi doğrulanmadığı bir donanıma yükleme girişimi PACK_NOT_CHECKED_FOR_HARDWARE ile reddedilir.

Nexus Edge, platform veya filo başına lisanslanan bir eklentidir. Paketler, bir platformla iletişim kesildiğinde de geçerliliğini korur. Yukarı bağlantı dardır, bu nedenle boyutları buna göre planlayın: 1.5 sürümümüz 412 MB iken yeni bir dil modeli içeren bir paket 9.8 GB idi.

9. Bir müşteriye dış ağa kapalı teslimat

Hedef, eklentinizin veya paketinizin ağ bağlantısı olmayan bir müşteri sahasına kurulmasıdır. Yapı taşları, @adverant/nexus-sovereign ile oluşturulan mühürlü bir paket, sürüm imzalama anahtarınız ve müşterinin kendi sürüm kanallarıdır.

  1. Eklentiyi ve imajlarını, bağlı bir müşteri için yaptığınız gibi, tüm denetim kapıları yeşil olacak şekilde oluşturun.
  2. airgap profiliyle; imajları, geçişleri, önceden imzalanmış becerileri ve lisansları içeren bir SBOM'u (yazılım malzeme listesi) taşıyan mühürlü bir paket oluşturun.
  3. Paketi Ed25519 sürüm anahtarınızla imzalayın.
  4. Paketi temiz bir makinede kendiniz doğrulayın.
  5. Paketi bir ortam üzerinde gönderin; açık anahtarınızı ve paketin SHA-256 değerini ise ayrı bir yoldan iletin.
  6. Müşterinin operatörü paketi sizin anahtarınızla doğrular, ardından sürümü kendi sürüm kanalları üzerinden içeri alır.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgap

nexus-airgap bundle, paketi sizin paket yapılandırmanızdan oluşturur. Kanıt, müşteri tarafındaki nexus-airgap verify komutudur. Bu komut her dosyanın karmasını yeniden hesaplar, manifestte listelenmeyen her dosyayı reddeder, güvenilir bir imzacı gerektirir ve ağ izin listesi boş olmayan bir paketi reddeder. Değiştirilmiş bir dosya BUNDLE_INTEGRITY_VIOLATION ile başarısız olur. Hiç kimse bunu aşmak için katı denetimi kapatmamalıdır.

Hava boşluklu (air-gapped) kurulumlar Enterprise kapsamındadır. Paketteki hiçbir şey kurulum sırasında herhangi bir şey indiremez; eklentinin ihtiyaç duyduğu bir model, YZ (yapay zekâ) Sağlayıcı Yönlendiricisi aracılığıyla müşterinin kendi model sunucusundan gelir.

10. Yalnızca Enterprise sürümüne özel bir modül

Hedef, açık çekirdeğe bağlanan kapalı ve lisanslı bir yetenektir; örneğin yalnızca Enterprise müşterilerine satılan uzun saklama süreli bir denetim kaydı gibi. Yapı taşı, arayüz paketi @adverant/nexus-spi'dir ve Community'den başka hiçbir şey kullanılmaz.

  1. Oluşturulmuş arayüz paketinin bayt düzeyinde sabitlenmiş bir kopyasını, SHA256SUMS sabitlemesiyle birlikte deponuzda yerel bir file: paketi olarak tutun.
  2. Buna karşı, hizmet ettiği özellik grubuyla birlikte bir RouteModule (veya konsol ekranları için bir ScreenModule) yazın.
  3. Her rotayı ctx.requireScope arkasında çalıştırın ve yanıt vermeden önce modülün kendi yetkisini kontrol edin.
  4. Kuruluşun hakkı olmadığında LICENCE_LOCKED ile reddedin ve özelliğin verisini değil, yalnızca tanıtım görünümünü gösterin.
  5. Depoyu lisans sınırına uygun tutun, ardından her sürümün birleştirilmiş ağacını oluşturun.
npm ci
npm test
npm run build

Kanıt, lisans sınırı kuralıdır: arayüz paketi dışında hiçbir Community kapsamından içe aktarma yapılmaz, depo dışına göreli içe aktarma yapılmaz ve depo dışında file:, link: veya workspace: bağımlılığı bulunmaz. Ardından yukarıdaki üç komut, yalnızca çalışma ağacınızda değil, her birleştirilmiş sürüm ağacında başarılı olmalıdır. Bölüm 2.25, Her sürüm için oluşturma, modül iskeletini içerir.

Bir modül, lisansı ilgili özellik grubunu içeren kurulumlarda başlangıçta bir Community hizmetine yüklenir. Bu yetki olmadan reddeder; böylece aynı derleme her yere gönderilir ve lisanslı olmadığı yerde hiçbir şey yapmaz.

11. Açık çekirdeği çatallama (forking) veya genişletme

Hedef, Community'nin kendisinde yapılan, fork'unuzda tutulan veya geri katkı olarak sunulan bir değişikliktir. Yapı taşı, Apache License, Version 2.0 kapsamındaki Community kaynak kodudur.

  1. Depoyu fork edin ve main üzerinden dal oluşturun.
  2. İstediğiniz şey bir eklenti veya beceri olabiliyorsa bunu tercih edin. Çekirdekte yapılan bir değişikliğin her sürümde bakımı size aittir.
  3. Değişikliği, o değişiklik olmadan başarısız olan testlerle birlikte yapın.
  4. Herhangi bir şey önermeden önce projenin çalıştırdığı denetimleri çalıştırın.
  5. NOTICE dosyasını koruyun ve Adverant'ın adlarını veya ticari markalarını, çalışmanın nereden geldiğini belirtmenin ötesinde kullanmayın.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Kanıt, bu üç denetimin başarılı olması ve her yeni testin değişikliğinizden önce başarısız olduğuna dair kanıttır. Fork'unuzda açık çekirdeğin bir özelliğini doğru tutun: Community, bir ajanı anahtar ve ağ olmadan yerel bir model üzerinde uçtan uca çalıştırır. Bunu bozan bir değişiklik, Community'yi tek başına kullanılabilir kılan şeyi bozar.

Bu yalnızca Community içindir. Kapalı kalması gereken her şey bunun yerine bir Enterprise modülüne (senaryo 10) aittir; böylece lisans sınırı herkesin gösterebileceği bir yerde kalır.

12. Team sürümü bir bulut uygulaması

Hedef, Team müşterilerinin kurabileceği bir uygulamadır. Team yalnızca Adverant bulutunda çalışır, bu nedenle uygulama onlara yalnızca katalog aracılığıyla ulaşır. Yapı taşları bir eklenti ve bir yayıncı kümesidir: Adverant bulutunda örnek verilerle çalışan kendi sanal kümeniz.

  1. Yayıncı kümesinde yalnızca örnek verilerle oluşturun ve test edin.
  2. Uygulamanın ihtiyaç duyduğu her şeyi manifestinde bildirin, fazlasını değil.
  3. Adverant'ın incelemesi ve katalogda listelenmesi için imzalı olarak yayımlayın.
  4. Her müşteri uygulamayı kurar ve bildirilen her kapsamı birim birim yetkilendirir.

Kanıt iki bölümden oluşur. İmzalı ve incelenmiş sürüm sizi kataloğa sokar. Ardından müşterinin verdiği yetki, uygulamanın onların sahasında nelere erişebileceğini belirler ve bildirilmemiş her çağrı CONNECTION_SCOPE_EXCEEDED ile reddedilir. Eksik bir kapsamı yalnızca müşterinin incelediği yeni bir sürümde ekleyebilirsiniz.

Üçüncü taraf bir eklenti yükleyin
Üçüncü taraf bir eklenti yükleyin
Üçüncü taraf bir eklenti kuran bir yönetici; bildirilen her kapsamı birim başına yetkilendiriyor ve birini dışarıda bırakıyor. Panel, eklentinin hiç bildirmediği bir çağrının reddedildiğini gösteriyor.

Bir yayıncı kümesinin herhangi bir müşteriye giden bir yolu yoktur ve orada bir müşterinin verilerini istemek TENANT_BOUNDARY ile reddedilir. Müşteriler sizinle test sonuçlarını paylaşabilir, ancak verilerini asla paylaşamaz. Team, iş akışı operasyonları yeteneğini içerir; bu nedenle uygulamanız iş akışları içeriyorsa Team müşterileri bunları ortamlar arasında kendileri yükseltebilir.

13. Mevcut bir şirket içi uygulamayı eklenti olarak sarmalama

Hedef, şirketinizin zaten çalıştırdığı bir uygulamanın Nexus'a getirilerek oturum açma, yalıtım ve yönetişimi devralmasıdır. Yapı taşları, ilk taslak için /plugin-create becerisi ve tamamlamak için SDK'nın manifest araçları ile denetim kapılarıdır.

  1. /plugin-create'i depo ile çalıştırın. Kodu analiz eder ve bir sarmalama stratejisi seçer, ardından arka ucu, geçişleri, kullanıcı arayüzünü (UI), manifesti ve testleri oluşturur.
  2. Manifesti v2 sözleşmesine yükseltin. migrate üç kural cümlesini ekler ve domain öğesini domains[] öğesine taşır; bir giriş noktası uydurmayı ise reddeder.
  3. Sarmalayıcının üst bilgilerden okuduğu tüm kiracı değerlerini SDK'nın kapsam korumasıyla değiştirin.
  4. Her tabloya, kiracıyla başlayan birincil anahtarlarla birlikte organization_id, owner_user_id ve business_unit_id ekleyin.
  5. Her rotayı yetkisiyle birlikte bildirin ve ret kaydını kurun.
  6. Denetim kapılarını yeşil olana kadar çalıştırın.
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-test

Kanıt, nexus-gates komutunun 0 ile çıkması ve scope-adherence, one-fence, migrations-are-scoped, crud-adherence ve api-contract denetimlerinin tümünün başarılı olmasıdır. İlk çalıştırmanın bunların çoğunda başarısız olmasını bekleyin; bizimkinde her rota kapsamsız olarak raporlandı, çünkü taslak tarayıcının ayarlayabileceği üst bilgilere güveniyordu. Denetim kapılarında bilerek bir düzeltme anahtarı yoktur.

Sarmalanmış uygulamalar her sürümde çalışır. Dağıtım yalnızca kurulumun sürüm kanalları üzerinden yapılır, bu nedenle taslağın yazdığı dağıtım dosyalarını göz ardı edin. Zamanın asıl harcandığı yer yalıtım çalışmasıdır: gerçek bir uygulama için saatler değil, günler planlayın.