Destek
Sürüm 1.0.0-alpha.1en son
Dokümantasyon
Adverant Nexus dokümantasyonu
Sürüm 1.0.0-alpha.1. Nexus'ta yeniyseniz Kısım 1 ile başlayın; Kısım 2, sistemi kuran ve çalıştıran kişiler içindir.
Bilgi modeli haritasını keşfedinMercekleri, modülleri ve ilişkileriyle birlikte ortak çekirdek ve her bir alan paketi.
Bölüm 1: Herkes için
- 1.1Nexus nedir ve kimler içindirAdverant Nexus'un bir kuruluş için ne yaptığı, kimler için geliştirildiği ve parçalarının birbiriyle nasıl uyum sağladığı, Harrow Port Authority örneği üzerinden sade bir dille anlatılır. Üç sürümün tek bir paragrafta özetlenmesiyle sona erer.
- 1.2Nexus ile bir iş günüHarrow Port Authority'de Bugün ekranına ilk bakıştan son onaya kadar geçen bir iş günü; insanların Nexus'ta gerçekte ne yaptığını ve her iş türünün nerede yer aldığını gösterir.
- 1.3Kuruluşunuz, çalışanları ve gizli kalanlarNexus'un bir kuruluşu ve çalışanlarının üstlendiği rolleri nasıl modellediği, Adverant hesabında kimlerin satın alma ve hak talebinde bulunabileceği ile yöneticilerin görebildikleri ve her kişiye özel kalanlar arasındaki sınır.
- 1.4Sizin şartlarınızla YZNexus'un yapay zekayı (YZ) kuruluşun kendi şartlarıyla nasıl kullandığı. Kuruluş kendi model anahtarlarını getirir ve bunlara sahip olur, tek bir santral her model çağrısını seçtiği sağlayıcılara yönlendirir, yerel modeller kendi sunucularında çalışır ve arkasından gizlice Adverant'a hiçbir şey gönderilmez.
- 1.5Güven ve uyumlulukBir uyumluluk görevlisinin Nexus'ta kullandığı bölümler. Denetim kaydını ve mühürlü kayıtları, ikinci bir kişi gerektiren onayları ve inceleme bekleyen yapay zeka (YZ) kararlarını kapsar. Kişisel veri talepleri ve bir denetçi istemeden önce kanıtları hazır tutan uyumluluk sayfaları ile sona erer.
- 1.6Sade bir dille sürümler ve lisanslarNexus'un üç sürümü, bunların üzerindeki 19 eklenti ve alan paketi, ardından bir işletme için lisansın nasıl çalıştığı. Çevrimdışı kontrolü ve her lisans durumunun pratikte ne anlama geldiğini, her lisansın tuttuğu sözleri ve yeniden kurulum yapmadan Community sürümünden Enterprise sürümüne geçişi kapsar.
- 1.7Alan paketleri ve dikey çözümlerBir alan paketinin belirli bir sektör için Nexus'a neler kattığı, Adverant'ın sunduğu on paket, bir paketin tek bir birim için nasıl etkinleştirildiği ve bir paketin lisansınızda neye ihtiyaç duyduğu.
- 1.8Nexus nerede çalışırAdverant'ın AB bulutundan internet bağlantısı olmayan bir sahaya ve sahadaki cihazlara kadar Nexus'un çalışabileceği yerler, egemenliğin pratikte ne anlama geldiği ve nasıl seçim yapılacağı.
- 1.9BaşlarkenBaşlamadan önceki iki karar, BT ekibinizin ne yaptığı, ilk yöneticinin gözünden ilk çalıştırma ve ilk gün nelerin hazır bulundurulması gerektiğine dair bir kontrol listesi.
- 1.10Masadan uzaktaHer sürümde konsolun telefon düzeninden yerel iPhone ve Android uygulamalarına kadar Nexus'u telefonda kullanma. Sinyal olmadan nelerin çalıştığını ve bir şirketin telefonları nasıl yönettiğini kapsar.
- 1.11Kendinize göre uyarlamaBir kuruluşun tek bir ayardan kendi dikey çözümüne kadar Nexus'u şekillendirme yolları. Ayrıca geliştiricilerin veya bir iş ortağının nasıl bilgilendirileceği ve ne inşa edilirse edilsin platformun neleri garanti ettiği.
- 1.12Sıkça sorulan sorularAlıcıların, yöneticilerin ve veri koruma görevlilerinin en çok sorduğu sorulara, para ve verilerinize erişim hakkındaki rahatsız edici sorular da dahil olmak üzere sade yanıtlar.
Bölüm 2: BT, DevOps ve geliştiriciler için
- 2.1MimariNexus paketindeki her servisin neye sahip olduğu ve altında hangi veri depolarının bulunduğu, ardından servisler arası kimlikten her model çağrısının izlediği yola kadar bunları bir arada tutan kurallar.
- 2.2Kaputun altında sürümlerCommunity ve Enterprise sürümlerinin tek bir üründen nasıl oluşturulduğu, bir lisansın çalışma zamanında özellik gruplarını nasıl etkinleştirdiği, bir Community kurulumunun bir Enterprise sayfası için ne gösterdiği ve bunun çektiğiniz imajlar ile geliştirdiğiniz uzantılar için ne anlama geldiği.
- 2.3Kurulumu planlamaBir komut yazmadan önce Nexus'un Kubernetes kurulumunun neye ihtiyaç duyduğu, ne kadar büyük olduğu ve geri alamayacağınız iki karar: kurulum adı ve anahtar sorumluları. Harrow Port Authority'nin doldurulmuş planlama çalışma sayfası ile sona erer.
- 2.4Bir sürümü edinme ve doğrulamaBir Nexus sürümünün her parçasının nerede bulunduğu, Enterprise imajlarının bir çekme belirteci ile nasıl alındığı ve herhangi bir şey kurmadan önce her imajın, paketin ve indirmenin Adverant'tan değişmeden geldiğinin çevrimdışı olarak nasıl kanıtlanacağı.
- 2.5nexusctl ile ön kontrol`nexusctl preflight` komutunun yaptığı her kontrol, her birinin neyi okuduğu ve nasıl başarısız olduğu, yazdırdığı ve kaydettiği rapor, bu raporun konsolun ön kontrol sayfasına nasıl ulaştığı ve tüm bayraklar.
- 2.6Kubernetes üzerinde Community kurulumucert-manager'dan tüm iş yüklerinin hazır olmasına kadar Helm ile adım adım numaralandırılmış Community sürümü kurulumu; anahtar bazında açıklanan değerler dosyası, neden --wait kullanılmadığı, paketin kancalarının çalışma sırası ve alternatif olarak nexusctl kurulum yolu.
- 2.7Enterprise sürümünü kurma ve lisans uygulamaEnterprise sürümünü kurduğunuzda nelerin değiştiği, Adverant hesabınızdan nasıl lisans talep edeceğiniz, tüm ret kodlarıyla birlikte lisansı içe aktarmanın üç yolu ve Harrow Port Authority'nin Community pilot kurulumunu hiçbir veri kaybetmeden yerinde Enterprise sürümüne nasıl taşıdığı.
- 2.8Tek makineli kurulumlarNexus'u nexusctl ile tek bir Linux sunucusuna kurun veya k3d ile bir dizüstü bilgisayarda değerlendirin ve oturum açma ile geçiş anahtarlarının (passkey) çalışması için konsola HTTPS üzerinden erişin.
- 2.9Kurucu disk kalıbıÇıplak bir sunucuyu veya sanal makineyi Nexus kurucu kalıbından başlatın; ağ bağlantısı olmadan işletim sistemini, k3s'i, cert-manager'ı ve Nexus'u kurar ve her dosyayı kullanmadan önce kontrol eder.
- 2.10Hava boşluklu (air-gapped) kurulumİmzalı bir çevrimdışı paketi internet olmayan bir sahaya taşıyın, ayrı olarak getirdiğiniz bir anahtarla doğrulayın, kendi kayıt defterinize (registry) yükleyin ve kurun. Lisanslar, güncellemeler ve iptal listeleri de bu boşluğu elden aşar.
- 2.11Varyasyonlar: harici depolar, TLS ve ingressHalihazırda çalıştırdığınız veritabanları, kendi sertifikalarınız, başka bir ingress denetleyicisi, depolama sınıfları, e-posta, vekil sunucular (proxy), replikalar ve yönetilen Kubernetes ile birlikte TLS (Taşıma Katmanı Güvenliği) dahil olmak üzere Nexus'u sıfırdan oluşturulmamış bir kümeye uyarlayan değerler.
- 2.12İlk çalıştırmaSahipsiz bir kurulumdan çalışan insanlara. Sahiplenme kodunu oluşturun, bir tarayıcıda kurulumu sahiplenin, bir geçiş anahtarıyla (passkey) ilk yöneticiyi oluşturun, ardından şirket oturum açma yöntemini bağlayın ve diğer herkesi davet edin.
- 2.13LisanslarBir Nexus lisans dosyasının neler içerdiği, kurulumun bunu çevrimdışı olarak nasıl kontrol ettiği, içinde bulunabileceği altı durum ve bir lisansı nasıl talep edeceğiniz, içe aktaracağınız, yenileyeceğiniz ve geri çekeceğiniz.
- 2.14YZ sağlayıcıları ve modelleriYapay zeka (YZ) Sağlayıcı Yönlendiricisinin (Provider Router) kuruluşun kendi anahtar havuzundan bir modeli nasıl seçtiği ve betikler ile YZ araçlarının dışarıdan Nexus'a nasıl ulaştığı.
- 2.15İkinci gün: Nexus'u işletmeİlk haftadan sonra bir kurulumu çalıştırmanın rutin işleri. Yeniden başlatmanın ardından anahtar deposunun mührünü açmakla başlar ve kaldırma işlemiyle sona erer.
- 2.16Güvenlik ve ağBir kurulumun içeri ve dışarı nelere izin verdiği, hizmetlerinin birbirlerine kim olduklarını nasıl kanıtladığı ve bir operatörün oturum açma ile veritabanı için ayarladığı veya devraldığı kontroller.
- 2.17Sorun gidermeOperatörlerin en sık karşılaştığı, gördüğünüz belirtilere göre düzenlenmiş sorunlar. Her biri nedeni, bunu doğrulayan komutu ve çözümü verir ve bölüm bir destek paketi gönderilmesiyle sona erer.
- 2.18Uzantı modeliBir ayardan bir alan paketine kadar Nexus'u genişletmenin altı yolu, her birinin sınırları ve güven ile yalıtım düzeylerinin kodunuzun nerede çalışacağına nasıl karar verdiği. Yazılım geliştirme kitini (SDK) açmadan önce bunu okuyun.
- 2.19Her uzantının devraldığı kurallarÜç eksende yalıtım, UNO üzerinden bilgi işlem, yönlendirici üzerinden YZ (yapay zeka), kuruluşa ait anahtarlar ve lisans kontrolleri. Her kuralın kodunuz için ne anlama geldiği, hangi geçidin bunu zorunlu kıldığı ve bunu kendiniz yazmak yerine neden devraldığınız.
- 2.20BecerilerBir Skills Engine becerisinin nasıl yazılacağı, test edileceği ve yayınlanacağı, yayına girdiğinde nerede göründüğü ve bir eklentideki bildirim (manifest) becerilerinin nasıl farklılık gösterdiği. Harrow Port Authority için uygulamalı bir rıhtım tahsisi özetini içerir.
- 2.21Plugin SDKPlugin SDK'nın (yazılım geliştirme kiti) kurulumu, komut satırı araçları, tam hizmet şablonunda bir gezinti, alan alan v2 bildirimi (manifest) ve bir eklentiyi kurallara bağlı tutan yirmi iki geçit.
- 2.22Eklenti çalışma zamanı (runtime)Kapsam korumasından ve veritabanı çitinden UNO dağıtımına (dispatch), YZ (yapay zeka) rota okumasına ve lisans kontrollerine kadar eklentinizin üzerinde çalıştığı SDK (yazılım geliştirme kiti) modülleri. Ardından gerçek bir veritabanına karşı test etme, becerilerinizi kaydetme ve ilk kullanıma hazırlama (onboarding).
- 2.23Alan paketleriBir alan paketinin nelerden oluştuğu ve pack.json dosyasının ne söylediği; mercekler (lenses) ve mercek kayıt defteri; bilgi modelleri, bağlayıcılar ve mobil katmanlar; bir paketin bir birim için nasıl lisanslandığı ve etkinleştirildiği; ve Adverant'ın sunduğu on paket.
- 2.24Uçtan uca özel bir dikey çözüm oluşturmaBilgi modeli, lensleri, bir becerisi, tam hizmet eklentisi ve örnek verileriyle birlikte, ilk özetten her birimde çalışan bir sürüme kadar Soğuk zincir alan paketinin uygulamalı bir derlemesi. Ardından halihazırda mevcut olan bir paketin nasıl genişletileceği ve kullanıma sunulmuş bir pakete nasıl lens ekleneceği.
- 2.25Her sürüm için derleme yapmaTek bir uzantının her sürümde, dış ağa kapalı (air-gapped) bir sahada, bir Nexus Edge yükünde veya müşterinin kendi markası arkasında çalışması gerektiğinde nelerin değiştiği. Her hedef için nelerin farklı yapılacağını gösteren bir matrisle birlikte Enterprise modülleri için lisans sınırını ve imzalı çevrimdışı teslimatı kapsar.
- 2.26YZ kodlama araçlarıyla geliştirmeClaude Code ve diğer YZ (yapay zeka) kodlama araçlarıyla güvenli bir şekilde Nexus uzantılarının nasıl oluşturulacağı. IDE'nizi (tümleşik geliştirme ortamı) Workbench'e bağlamakla ve platform kurallarını taşıyan bir proje CLAUDE.md dosyasıyla başlar, altı uygulamalı istem ve her birini doğrulayan kontrol noktasıyla sona erer.
- 2.27Derleme 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.
- 2.28Uzantınızı yayınlamaBir eklenti veya paketin başarılı bir derlemeden onu çalıştıran birimlere nasıl ulaştığı ve oradan nasıl geri çekildiği. Sürümler, yayın incelemesi, kanallar ve kurulumlar, imzalama, değişiklik onayları, teslimat kimlik kaydı, veri taşımalar (migrations), geri alma ve bir sürümü kullanımdan kaldırma.
Ekler: Başvuru Kılavuzu
- AEk A: Helm değerleri başvuru kılavuzuNexus chart'ının kabul ettiği her anahtar, türü, izin verilen değerleri ve varsayılan değeri.
- BEk B: Sürüm matrisiHer bir yeteneğin hangi sürüm, eklenti veya alan paketinde yer aldığı.
- CEk C: Hata kodlarıBir operatörün veya geliştiricinin karşılaştığı her ret kodu, ne anlama geldiği ve ne yapılması gerektiği.
- DEk D: Servisler ve bağlantı noktalarıChart'ın çalıştırdığı her servis, bağlantı noktaları ve onu yapılandıran values anahtarı.
- EEk E: SözlükHer iki bölümde kullanılan terimler, sade bir dille.
- FEk F: Bir bakışta mimariHer biri için birer diyagramla tüm platform, açık çekirdek ve bunun üzerinde nelerin lisanslandığı, Nexus'u çalıştırmanın her bir yolu ve on alan paketinin her biri.
- GEk G: Veri sözlüğü ve bilgi modelleriHer kayıttaki alanlar ve her bir alan paketinin nelerden oluştuğu.
İndirme
- Part 1, for everyone (PDF) (yeni sekmede açılır) 18 MB
- Part 2, technical, with the appendices (PDF) (yeni sekmede açılır) 40 MB
PDF'ler İngilizcedir.