BejelentkezésBemutató kérése
Támogatás
Verzió 1.0.0-alpha.1legújabb

Dokumentáció

Adverant Nexus dokumentáció

1.0.0-alpha.1 kiadás. Kezdje az 1. résszel, ha még új Önnek a Nexus; a 2. rész azoknak szól, akik telepítik és futtatják.

1. rész: Mindenkinek

  • 1.1Mi a Nexus, és kinek szólMit nyújt az Adverant Nexus egy szervezetnek, kinek készült, és hogyan illeszkednek össze az egyes részei, közérthetően elmondva a Harrow Port Authority példáján keresztül. A fejezet végén egyetlen bekezdés foglalja össze a három kiadást.
  • 1.2Egy munkanap a NexusszalEgy munkanap a Harrow Port Authoritynél, a Ma nézetre vetett első pillantástól az utolsó jóváhagyásig, bemutatva, mit is csinálnak valójában az emberek a Nexusban, és hol található az egyes munkafolyamatok helye.
  • 1.3Az Ön szervezete, a munkatársak, és ami privát maradHogyan modellezi a Nexus a szervezetet és a munkatársak szerepköreit, ki vásárolhat és érvényesíthet jogosultságot az Adverant-fiókban, valamint hol húzódik a határ aközött, amit a rendszergazdák láthatnak, és ami mindenki számára privát marad.
  • 1.4AI az Ön feltételei szerintHogyan használja a Nexus a mesterséges intelligenciát (AI) a szervezet saját feltételei szerint. A szervezet maga hozza és birtokolja a modellkulcsait, egyetlen kapcsolóközpont irányít minden modellhívást a szervezet által választott szolgáltatókhoz, a helyi modellek a saját szerverein futnak, és semmi sem kerül az Adveranthoz a háta mögött.
  • 1.5Bizalom és megfelelőségA Nexus azon részei, amelyekben a megfelelőségi tisztviselő dolgozik. Lefedi a naplózást és a lezárt rekordokat, a második személyt igénylő jóváhagyásokat, valamint a felülvizsgálatra váró mesterséges intelligencia (AI) döntéseket. Végül kitér a személyes adatokkal kapcsolatos kérelmekre és a megfelelőségi oldalakra, amelyek még azelőtt készenlétben tartják a bizonyítékokat, hogy az auditor kérné őket.
  • 1.6Kiadások és licencek közérthetőenA Nexus három kiadása és a rájuk épülő 19 kiegészítő és iparági csomag, valamint a licenc működése a vállalkozások számára. Bemutatja az offline ellenőrzést, az egyes licencállapotok gyakorlati jelentését, az ígéreteket, amelyeket minden licenc betart, továbbá az újratelepítés nélküli váltást a Community kiadásról az Enterprise kiadásra.
  • 1.7Iparági csomagok és vertikumokMit ad hozzá egy iparági csomag a Nexushoz egy adott ágazatban, melyik az a tíz csomag, amelyet az Adverant kínál, hogyan kapcsolható be egy csomag egyetlen egység számára, és mit igényel egy csomag az Ön licencében.
  • 1.8Hol fut a NexusA helyek, ahol a Nexus futhat, az Adverant EU-s felhőjétől az internetkapcsolat nélküli telephelyekig és a terepen lévő eszközökig, mit jelent a szuverenitás a gyakorlatban, és hogyan érdemes választani.
  • 1.9Első lépésekA két döntés, amelyet az indulás előtt meg kell hoznia, az IT-csapat feladatai, az első futtatás az első rendszergazda szemszögéből, valamint egy ellenőrzőlista arról, minek kell készen állnia az első napon.
  • 1.10Távol az íróasztaltólA Nexus használata telefonon, a konzol minden kiadásban elérhető mobilos elrendezésétől a natív iPhone- és Android-alkalmazásokig. Bemutatja, mi működik térerő nélkül, és hogyan kezeli a vállalat a telefonokat.
  • 1.11Formálja a saját képéreA módok, ahogyan egy szervezet a saját igényeire szabhatja a Nexust, egyetlen beállítástól a saját vertikumig. Emellett útmutató a fejlesztők vagy partnerek eligazításához, és ahhoz, mit garantál a platform, bármi is épüljön rá.
  • 1.12Gyakran feltett kérdésekEgyenes válaszok azokra a kérdésekre, amelyeket a beszerzők, vezetők és adatvédelmi tisztviselők a leggyakrabban tesznek fel, beleértve a pénzzel és az adatokhoz való hozzáféréssel kapcsolatos kényelmetlen kérdéseket is.

2. rész: IT-, DevOps-szakembereknek és fejlesztőknek

  • 2.1ArchitektúraMelyik szolgáltatás miért felel a Nexus chartban, milyen adattárolók találhatók alattuk, és milyen szabályok tartják össze őket, a szolgáltatások közötti identitástól kezdve az útvonalig, amelyet minden modellhívás bejár.
  • 2.2Kiadások a motorháztető alattHogyan épül fel a Community és az Enterprise kiadás egyetlen termékből, hogyan kapcsolja be a licenc a funkciócsoportokat futásidőben, mit mutat egy Community telepítés egy Enterprise oldal helyén, és mit jelent mindez a letöltött képfájlokra (image) és az Ön által épített kiegészítőkre nézve.
  • 2.3A telepítés megtervezéseMire van szüksége a Nexus Kubernetes-alapú telepítésének, mielőtt egyetlen parancsot is begépelne, mekkora a mérete, és melyik az a két döntés, amelyet később nem vonhat vissza: a telepítés neve és a kulcsőrzők személye. A fejezet a Harrow Port Authority kitöltött tervezési munkalapjával zárul.
  • 2.4Kiadás beszerzése és ellenőrzéseHol található a Nexus-kiadás egyes részeinek helye, hogyan tölthetők le az Enterprise képfájlok egy pull token segítségével, és hogyan bizonyítható offline, még bárminek a telepítése előtt, hogy minden képfájl, chart és letöltés változatlan formában az Adveranttól származik.
  • 2.5Előzetes ellenőrzés (preflight) a nexusctl segítségévelMinden ellenőrzés, amelyet a `nexusctl preflight` elvégez, mit olvas be az egyes lépésekben és hogyan jelez hibát, a jelentés, amelyet kiír és elment, hogyan jut el ez a jelentés a konzol előzetes ellenőrzési oldalára, valamint az összes kapcsoló (flag).
  • 2.6A Community kiadás telepítése KubernetesreA Community kiadás számozott lépésekből álló telepítése Helm segítségével, a cert-managertől kezdve egészen addig, amíg minden számítási feladat (workload) készen nem áll; a values fájl kulcsról kulcsra történő magyarázatával, miért nincs --wait kapcsoló, milyen sorrendben futnak le a chart hookjai, valamint a nexusctl install útvonal mint alternatíva.
  • 2.7Az Enterprise telepítése és a licenc alkalmazásaMi változik az Enterprise kiadás telepítésekor, hogyan igényelhet licencet az Adverant-fiókjából, a három importálási mód az összes elutasítási kóddal, és hogyan alakította át a Harrow Port Authority a Community próbaverzióját helyben Enterprise kiadássá adatvesztés nélkül.
  • 2.8Egygépes telepítésekTelepítse a Nexust egyetlen Linux-szerverre a nexusctl segítségével, vagy próbálja ki egy laptopon k3d-vel, és érje el a konzolt HTTPS-en keresztül, hogy a bejelentkezés és a hozzáférési kulcsok (passkey) működjenek.
  • 2.9A telepítő lemezképfájlIndítson el egy üres szervert vagy virtuális gépet a Nexus telepítő lemezképfájljáról, amely hálózat nélkül telepíti az operációs rendszert, a k3s-t, a cert-managert és a Nexust, használat előtt minden fájlt ellenőrizve.
  • 2.10Hálózattól elzárt (air-gapped) telepítésVigyen be egy aláírt offline csomagot egy internetkapcsolat nélküli telephelyre, ellenőrizze egy külön bevitt kulccsal, töltse be a saját tárolójába (registry), és telepítse. A licencek, frissítések és visszavonási listák szintén manuálisan kerülnek át a zárt rendszerbe.
  • 2.11Variációk: külső adattárak, TLS és ingressAzok az értékek, amelyekkel a Nexus egy nem üres klaszterhez igazítható, beleértve a TLS-t (Transport Layer Security), valamint a már futó adatbázisokat, a saját tanúsítványokat, egy másik ingress vezérlőt, a tárolási osztályokat (storage class), a levelezést, a proxykat, a replikákat és a menedzselt Kubernetest.
  • 2.12Az első indításA még birtokba nem vett telepítéstől a munkába állásig. Hozza létre az igénylőkódot, vegye birtokba a telepítést egy böngészőben, hozza létre az első adminisztrátort egy hozzáférési kulccsal (passkey), majd kapcsolja össze a vállalati bejelentkezést, és hívjon meg mindenki mást.
  • 2.13LicencekMit tartalmaz egy Nexus licencfájl, hogyan ellenőrzi azt a telepítés offline, milyen hat állapotban lehet, és hogyan lehet igényelni, importálni, megújítani és visszavonni.
  • 2.14AI-szolgáltatók és modellekHogyan választ ki egy modellt a mesterséges intelligencia (AI) Provider Router a szervezet saját kulcskészletéből, és hogyan érik el a szkriptek és AI-eszközök a Nexust kívülről.
  • 2.15A második nap: a Nexus üzemeltetéseEgy telepítés működtetésének napi rutinfeladatai az első hét után. A kulcstár újraindítás utáni feloldásával (unseal) kezdődik, és az eltávolítással ér véget.
  • 2.16Biztonság és hálózatMit enged be és ki egy telepítés, hogyan igazolják a szolgáltatásai egymásnak a kilétüket, és milyen vezérlőket állít be vagy örököl az üzemeltető a bejelentkezéshez és az adatbázishoz.
  • 2.17HibaelhárításA leggyakoribb problémák, amelyekkel az üzemeltetők találkoznak, a tapasztalt jelenségek szerint rendszerezve. Mindegyiknél szerepel a kiváltó ok, az azt megerősítő parancs és a megoldás, a fejezet pedig a támogatási csomag (support bundle) beküldésével zárul.
  • 2.18A bővítési modellA Nexus bővítésének hat módja a beállítástól a szakterületi csomagig (domain pack), az egyes módok korlátai, valamint az, hogy a megbízhatósági és izolációs szintek miként döntik el, hol fut a kódja. Olvassa el, mielőtt megnyitná a szoftverfejlesztő készletet (SDK).
  • 2.19A szabályok, amelyeket minden bővítmény örökölIzoláció három tengely mentén, számítási műveletek az UNO-n keresztül, AI (mesterséges intelligencia) a routeren keresztül, a szervezet tulajdonában lévő kulcsok és licencellenőrzések. Mit jelent az egyes szabály a kódjára nézve, melyik kapu (gate) kényszeríti ki, és miért örökli ahelyett, hogy Önnek kellene megírnia.
  • 2.20Képességek (Skills)Hogyan írjon meg, teszteljen és tegyen közzé egy Skills Engine képességet (skill), hol jelenik meg az élesítés után, és miben különböznek a beépülő modulok (plugin) manifesztumában szereplő képességek. Tartalmaz egy kidolgozott kikötőhely-kiosztási összefoglalót a Harrow Port Authority számára.
  • 2.21A Plugin SDKA Plugin SDK (szoftverfejlesztő készlet) telepítése, parancssori eszközei, a teljes körű szolgáltatási sablon bemutatása, a v2 manifesztum mezőről mezőre, valamint a huszonkét kapu, amely betartatja a szabályokat a beépülő modullal.
  • 2.22A beépülő modul futtatókörnyezeteAz SDK (szoftverfejlesztő készlet) moduljai, amelyeken a beépülő modulja fut, a hatókörvédőtől (scope guard) és az adatbázis-kerítéstől (database fence) az UNO diszpécserig, az AI (mesterséges intelligencia) útvonal-kiolvasásig és a licencellenőrzésekig. Ezt követi a valós adatbázison végzett tesztelés, a képességek regisztrálása és a bevezetés (onboarding).
  • 2.23Szakterületi csomagok (Domain packs)Miből áll egy szakterületi csomag (domain pack), és mit tartalmaz a pack.json fájlja; lencsék (lenses) és a lencsenyilvántartás; tudásmodellek, összekötők (connectors) és mobil felületi rétegek (mobile overlays); hogyan történik egy csomag licencelése és bekapcsolása egy egység számára; valamint az Adverant által szállított tíz csomag.
  • 2.24Egyedi iparági megoldás felépítése az elejétől a végéigA Cold chain szakterületi csomag kidolgozott felépítése az első igényfelméréstől a minden egységnél futó kiadásig, a hozzá tartozó tudásmodellel, nézetekkel, egy képességgel (skill), egy teljes szolgáltatást nyújtó beépülő modullal és mintaadatokkal. Ezt követően bemutatjuk, hogyan bővíthető egy már meglévő csomag, és hogyan adható hozzá egy új nézet egy már kiadott csomaghoz.
  • 2.25Fejlesztés az egyes kiadásokraMi változik, amikor egyetlen kiegészítőnek minden kiadásban, zárt (air-gapped) telephelyen, Nexus Edge csomagban vagy az ügyfél saját márkaneve alatt is működnie kell. Kitér az Enterprise modulok licenchatáraira és az aláírt offline szállításra, egy mátrixszal együtt, amely bemutatja, mit kell másképp csinálni az egyes célkörnyezetek esetében.
  • 2.26Építkezés AI-kódoló eszközökkelHogyan készíthet biztonságosan Nexus kiegészítőket a Claude Code és más AI (mesterséges intelligencia) alapú kódolóeszközök segítségével. A folyamat az IDE (integrált fejlesztői környezet) és a Workbench összekapcsolásával, valamint a platformszabályokat tartalmazó projekt-szintű CLAUDE.md fájllal kezdődik, és hat kidolgozott prompttal, illetve az ezeket igazoló ellenőrző kapukkal zárul.
  • 2.27Fejlesztési forgatókönyvekTizenhárom felépítést bemutató receptgyűjtemény, egyetlen képességtől (skill) a zárt hálózatú (air-gapped) szállításig. Minden recept megadja a célt, az építőelemeket, a lépéseket és parancsokat, a működést igazoló ellenőrző kaput, valamint azt, hogy mi változik a kiadás és a szállítási forma függvényében.
  • 2.28A kiegészítő kiadásaHogyan jut el egy beépülő modul vagy csomag a sikeres buildtől a futtató egységekig, és hogyan vonható vissza. Verziók, kiadási ellenőrzés, csatornák és telepítések, aláírás, változtatási jóváhagyások, a szállítási identitásrekord, migrációk, visszaállítás és egy verzió kivezetése.

Függelékek: Referencia

Letöltés (Download)

A PDF-ek angol nyelvűek.