Sürüm 1.0.0-alpha.1en son
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

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 |
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.
skills/<slug>/oluşturun veSKILL.mddosyasını şu ön bilgilerle yazın:name(kebab-case, klasör adıyla aynı),description(en fazla 500 karakter),allowed-toolsve isteğe bağlı olaraktriggers,capabilitiesveversion.- Gövdeyi model için yazın: becerinin ne zaman kullanılacağı, adımları, örnekleri ve asla yapmaması gerekenler.
- Test senaryoları ekleyin. Bunlardan birine, becerinin uymaması gereken, girdiye yerleştirilmiş bir talimat ekleyin.
- Doğrulayın, yükleme planına bakın, ardından yükleyin.
- 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-filingKapı 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.
- Beceriyi bildirin: lower_snake biçiminde
id,tier: "host_callback", eklentinizin güven tavanında veya altında birclassification,inputSchema,outputSchemave 1 saniye ile 6 saat arasında birtimeoutMs. hostCallbackalanını doldurun: kendi Service adınız, bağlantı noktası,/internal/skills/excursion_opengibi göreli bir yol, her iki bayt sınırı (maxRequestBytesvemaxResponseBytes) vetenantHeader: "X-Organization-ID".- Rotayı
api.endpoints[]içindeauth: "service-key"veyaauth: "internal"ile bildirin ve kullanıcı kapsamı koruyucusuyla değil, her zamanrequireServiceveyaserviceMiddlewareile koruyun. - Doğrulayın, kapıları çalıştırın ve katılım sürecinin becerileri
compileRegistryaracı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-testvalidate, 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.
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.
- Paketi alan paketi altın yoluyla başlatın, ardından
inheritsdeğerini üst paketin kimliğine ayarlayın. - Her biri kendi koltukları, amacı ve sözlük başvurusuyla birlikte kendi
lenskümelerinizi ekleyin. - Sözcüklerinizi her biri için sade bir açıklamayla sözlüğe ekleyin. Yazıldığı gibi gösterilmesi gereken terimleri
exactolarak işaretleyin. - 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.
- Lisans zincirini denetleyin. Paketiniz, üst paketinin eklenti gereksinimlerini devralır.
- 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.
- Alan paketi altın yolunu çalıştırın ve paketi tanımlayın: amaç, birimler, temel model ve eşlediği kurallar.
- Bilgi modelini bir temel model üzerine kurun ve her özelliği eklerken sınıflandırın.
- Planı okuyun, parmak izini geçiş anahtarınızla onaylayın ve oluşturun.
- Mercekleri, her biri bir temel merceği daraltacak şekilde Lens builder'da biçimlendirin.
- Eklentiyi ve paketin ihtiyaç duyduğu tüm Skills Engine becerilerini yazın.
- Önemsediğiniz sıra dışı durumları içeren, tohumlanmış sentetik veriler oluşturun ve her merceği bir kişi olarak önizleyin.
- 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.
queueNamedeğeri<plugin name>.<name>olarak yazılmış birplugin_queuebecerisi bildirin. İki nokta üst üste kullanılamaz ve ad manifestte bulunmalıdır, çünkü düzenleyici doğrudan bu kuyruğa iş ekler.- Kuyruğu çeken ve dış sistemi çağıran çalışanı yazın.
- Dış sistemin adresini giden adres olarak bildirin. Listelenmeyen her şey engellenir.
- Gelen verileri, her satırda
organization_id,owner_user_idvebusiness_unit_idbulunacak şekilde kendi şemanızda saklayın. - Dış sistemin kimlik bilgisini ortamdan adıyla okuyun ve değişkeni
scripts/ci/required-enviçinde listeleyin. - Ç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-envvalidate, 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.
- 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.
inputSchemaalanını tek bir nesne şeması olarak yazın. Üst düzeyineoneOf,allOfveyaanyOfkoymayın.- Aracı sunan rotayı, diğer tüm
/apirotaları gibi kapsam koruyucusunun arkasında tutun; böylece kiracılık bilgisi çağıranın belirtecinden gelir. - Manifesti doğrulayın.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonKanı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.
- Müşterinin alan adını, varsa
aliasesile birliktedomains[]içineprimaryolarak yazın. brandingalanını doldurun:appName,tagline,primaryColor,accentColor, alan adına eşit birpasskeyRpIdveoauthClientRef.- 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"veallowAnonymous: trueile tam olarak bildirin. - 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.
- Ö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-contractKanı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.
- 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.
- 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.
- 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.
- Paketin araç üstü test senaryolarını aynı kartlara sahip bir test düzeneğinde çalıştırın.
- İmzalanması için gönderin: üç imzadan ikisi gereklidir.
- 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.
- Bir hafta sorunsuz geçtikten sonra bir sonraki platforma dağıtın.
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.
- 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.
airgapprofiliyle; 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.- Paketi Ed25519 sürüm anahtarınızla imzalayın.
- Paketi temiz bir makinede kendiniz doğrulayın.
- Paketi bir ortam üzerinde gönderin; açık anahtarınızı ve paketin SHA-256 değerini ise ayrı bir yoldan iletin.
- 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 airgapnexus-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.
- Oluşturulmuş arayüz paketinin bayt düzeyinde sabitlenmiş bir kopyasını,
SHA256SUMSsabitlemesiyle birlikte deponuzda yerel birfile:paketi olarak tutun. - Buna karşı, hizmet ettiği özellik grubuyla birlikte bir
RouteModule(veya konsol ekranları için birScreenModule) yazın. - Her rotayı
ctx.requireScopearkasında çalıştırın ve yanıt vermeden önce modülün kendi yetkisini kontrol edin. - Kuruluşun hakkı olmadığında
LICENCE_LOCKEDile reddedin ve özelliğin verisini değil, yalnızca tanıtım görünümünü gösterin. - 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 buildKanı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.
- Depoyu fork edin ve
mainüzerinden dal oluşturun. - İ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.
- Değişikliği, o değişiklik olmadan başarısız olan testlerle birlikte yapın.
- Herhangi bir şey önermeden önce projenin çalıştırdığı denetimleri çalıştırın.
- 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 typecheckKanı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.
- Yayıncı kümesinde yalnızca örnek verilerle oluşturun ve test edin.
- Uygulamanın ihtiyaç duyduğu her şeyi manifestinde bildirin, fazlasını değil.
- Adverant'ın incelemesi ve katalogda listelenmesi için imzalı olarak yayımlayın.
- 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.
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.
/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.- Manifesti v2 sözleşmesine yükseltin.
migrateüç kural cümlesini ekler vedomainöğesinidomains[]öğesine taşır; bir giriş noktası uydurmayı ise reddeder. - Sarmalayıcının üst bilgilerden okuduğu tüm kiracı değerlerini SDK'nın kapsam korumasıyla değiştirin.
- Her tabloya, kiracıyla başlayan birincil anahtarlarla birlikte
organization_id,owner_user_idvebusiness_unit_idekleyin. - Her rotayı yetkisiyle birlikte bildirin ve ret kaydını kurun.
- 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-testKanı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.


