Asistență
Versiune 1.0.0-alpha.1cea mai recentă
Documentație
Documentația Adverant Nexus
Versiunea 1.0.0-alpha.1. Începeți cu Partea 1 dacă sunteți la început cu Nexus; Partea a 2-a este destinată persoanelor care îl instalează și îl rulează.
Explorați harta modelului de cunoștințeNucleul comun și fiecare pachet de domeniu, cu perspectivele, modulele și relațiile lor.
Partea 1: Pentru toți utilizatorii
- 1.1Ce este Nexus și cui i se adreseazăCe face Adverant Nexus pentru o organizație, pentru cine este conceput și cum se îmbină componentele sale, explicat pe înțelesul tuturor, având ca exemplu Harrow Port Authority. Se încheie cu cele trei ediții prezentate într-un singur paragraf.
- 1.2O zi de lucru cu NexusO zi de lucru la Harrow Port Authority, de la prima privire asupra secțiunii Today până la ultima aprobare, arătând ce fac oamenii efectiv în Nexus și unde se desfășoară fiecare tip de activitate.
- 1.3Organizația dumneavoastră, oamenii săi și ce rămâne privatCum modelează Nexus o organizație și rolurile deținute de membrii acesteia, cine poate cumpăra și revendica în contul Adverant și limita dintre ceea ce pot vedea administratorii și ceea ce rămâne privat pentru fiecare persoană.
- 1.4IA în condițiile dumneavoastrăCum utilizează Nexus inteligența artificială (IA) în condițiile stabilite de organizație. Organizația aduce și deține propriile chei de model, un singur comutator direcționează fiecare apel de model către furnizorii aleși de aceasta, modelele locale rulează pe propriile servere și nimic nu este trimis către Adverant pe ascuns.
- 1.5Încredere și conformitateSecțiunile din Nexus în care își desfășoară activitatea un responsabil cu conformitatea. Acoperă jurnalul de audit și înregistrările sigilate, aprobările care necesită o a doua persoană și deciziile inteligenței artificiale (IA) aflate în așteptarea revizuirii. Se încheie cu solicitările privind datele cu caracter personal și paginile de conformitate care mențin dovezile pregătite înainte ca un auditor să le ceară.
- 1.6Ediții și licențe pe înțelesul tuturorCele trei ediții Nexus și cele 19 module suplimentare și pachete de domeniu disponibile, urmate de modul în care funcționează o licență pentru o companie. Acoperă verificarea offline și ce înseamnă fiecare stare a licenței în practică, angajamentele pe care le respectă fiecare licență și trecerea de la Community la Enterprise fără reinstalare.
- 1.7Pachete de domeniu și verticaleCe adaugă un pachet de domeniu în Nexus pentru o anumită industrie, cele zece pachete oferite de Adverant, cum se activează un pachet pentru o singură unitate și ce necesită un pachet în licența dumneavoastră.
- 1.8Unde rulează NexusLocurile în care poate rula Nexus, de la cloudul din UE al Adverant până la o locație fără internet și dispozitive pe teren, ce înseamnă suveranitatea în practică și cum să alegeți.
- 1.9Primii pașiCele două decizii pe care trebuie să le luați înainte de a începe, ce face echipa dumneavoastră IT, prima rulare așa cum o vede primul administrator și o listă de verificare cu ce trebuie să aveți pregătit în prima zi.
- 1.10Departe de birouUtilizarea Nexus pe telefon, de la interfața pentru mobil a consolei în fiecare ediție până la aplicațiile native pentru iPhone și Android. Acoperă ce funcționează fără semnal și cum gestionează o companie telefoanele.
- 1.11Personalizarea platformeiModurile în care o organizație își adaptează Nexus, de la o simplă setare până la o verticală proprie. De asemenea, cum să instruiți dezvoltatorii sau un partener și ce garantează platforma indiferent de ceea ce se construiește.
- 1.12Întrebări frecventeRăspunsuri clare la cele mai frecvente întrebări adresate de cumpărători, manageri și responsabilii cu protecția datelor, inclusiv cele incomode despre costuri și accesul la datele dumneavoastră.
Partea 2: Pentru IT, DevOps și dezvoltatori
- 2.1ArhitecturăCe deține fiecare serviciu din chartul Nexus și ce medii de stocare se află sub acesta, apoi regulile care le leagă împreună, de la identitatea între servicii până la calea pe care o urmează fiecare apel de model.
- 2.2Edițiile în detaliuCum sunt construite edițiile Community și Enterprise dintr-un singur produs, cum activează o licență grupurile de funcționalități în timpul execuției, ce afișează o instalare Community pentru o pagină Enterprise și ce înseamnă acest lucru pentru imaginile pe care le descărcați și extensiile pe care le construiți.
- 2.3Planificarea unei instalăriCe necesită o instalare Nexus pe Kubernetes înainte de a tasta o comandă, cât de mare este și cele două decizii ireversibile: numele instalării și custozii cheilor. Se încheie cu fișa de planificare completată pentru Harrow Port Authority.
- 2.4Obținerea și verificarea unei versiuniUnde se află fiecare parte a unei versiuni Nexus, cum sunt preluate imaginile Enterprise cu un token de descărcare și cum să demonstrați offline că fiecare imagine, chart și fișier descărcat provine de la Adverant fără modificări, înainte de a instala ceva.
- 2.5Verificarea prealabilă cu nexusctlFiecare verificare efectuată de `nexusctl preflight`, ce citește fiecare și cum eșuează, raportul pe care îl afișează și îl salvează, cum ajunge acel raport în pagina de verificare prealabilă a consolei și fiecare indicator (flag).
- 2.6Instalarea ediției Community pe KubernetesO instalare pas cu pas a ediției Community cu Helm, de la cert-manager până când fiecare sarcină de lucru (workload) este pregătită, cu fișierul values explicat cheie cu cheie, motivul pentru care nu se folosește --wait, ordinea în care rulează hook-urile din chart și varianta de instalare cu nexusctl ca alternativă.
- 2.7Instalarea ediției Enterprise și aplicarea unei licențeCe se schimbă când instalați ediția Enterprise, cum să solicitați o licență din contul dvs. Adverant, cele trei moduri de a o importa împreună cu fiecare cod de refuz și cum și-a trecut Harrow Port Authority proiectul pilot Community la Enterprise pe loc, fără a pierde nimic.
- 2.8Instalări pe o singură mașinăInstalați Nexus pe un singur server Linux cu nexusctl sau evaluați-l pe un laptop cu k3d și accesați consola prin HTTPS, astfel încât autentificarea și cheile de acces (passkeys) să funcționeze.
- 2.9Imaginea de disc a programului de instalarePorniți un server fizic sau o mașină virtuală de pe imaginea de instalare Nexus, iar aceasta instalează sistemul de operare, k3s, cert-manager și Nexus fără rețea, verificând fiecare fișier înainte de a fi utilizat.
- 2.10Instalare izolată de rețea (air-gapped)Transportați un pachet offline semnat într-o locație fără internet, verificați-l cu o cheie adusă separat, încărcați-l în propriul registru și instalați. Licențele, actualizările și listele de revocare traversează spațiul izolat tot manual.
- 2.11Variații: stocări externe, TLS și ingressValorile care adaptează Nexus la un cluster care nu este gol, inclusiv TLS (Transport Layer Security), alături de baze de date pe care le rulați deja, certificate proprii, un alt controler ingress, clase de stocare, e-mail, servere proxy, replici și Kubernetes gestionat.
- 2.12Prima rulareDe la o instalare nerevendicată la oameni care lucrează. Generați codul de revendicare, revendicați instalarea într-un browser, creați primul administrator cu o cheie de acces (passkey), apoi conectați autentificarea companiei și invitați restul persoanelor.
- 2.13LicențeCe conține un fișier de licență Nexus, cum îl verifică instalarea offline, cele șase stări în care se poate afla și cum solicitați, importați, reînnoiți și retrageți o licență.
- 2.14Furnizori și modele de IACum alege Ruterul pentru furnizori de inteligență artificială (IA) un model din rezerva proprie de chei a organizației și cum accesează scripturile și instrumentele de IA sistemul Nexus din exterior.
- 2.15Ziua a doua: operarea NexusMunca de rutină pentru rularea unei instalări după prima săptămână. Începe cu desigilarea depozitului de chei după o repornire și se încheie cu dezinstalarea.
- 2.16Securitate și rețelisticăCe permite o instalare la intrare și la ieșire, cum își dovedesc serviciile sale identitatea unele față de altele și controalele pe care un operator le setează sau le moștenește pentru autentificare și baza de date.
- 2.17DepanareProblemele pe care operatorii le întâlnesc cel mai des, organizate în funcție de ceea ce observați. Fiecare prezintă cauza, comanda care o confirmă și soluția, iar capitolul se încheie cu trimiterea unui pachet de asistență.
- 2.18Modelul de extensieCele șase moduri de a extinde Nexus, de la o setare la un pachet de domeniu, limitele fiecăruia și modul în care nivelurile de încredere și de izolare decid unde rulează codul dvs. Citiți acest capitol înainte de a deschide kitul de dezvoltare software (SDK).
- 2.19Regulile pe care le moștenește fiecare extensieIzolare pe trei axe, procesare prin UNO, IA (inteligență artificială) prin ruter, chei deținute de organizație și verificări ale licenței. Ce înseamnă fiecare regulă pentru codul dvs., ce poartă de control o impune și de ce o moșteniți în loc să o scrieți.
- 2.20Abilități (Skills)Cum să scrieți, să testați și să publicați o abilitate Skills Engine, unde apare odată ce este activă și cum diferă abilitățile din manifest într-un plugin. Include un exemplu practic de rezumat pentru alocarea danelor destinat Harrow Port Authority.
- 2.21Plugin SDKInstalarea Plugin SDK (kitul de dezvoltare software), instrumentele sale în linie de comandă, o prezentare a șablonului complet de servicii, manifestul v2 câmp cu câmp și cele douăzeci și două de porți de control care obligă un plugin să respecte regulile.
- 2.22Mediul de execuție (runtime) pentru pluginuriModulele SDK (kit de dezvoltare software) pe care rulează pluginul dvs., de la garda de domeniu (scope guard) și bariera bazei de date până la expedierea UNO, citirea rutei IA (inteligență artificială) și verificările licenței. Apoi, testarea pe o bază de date reală, înregistrarea abilităților și integrarea inițială (onboarding).
- 2.23Pachete de domeniuDin ce este compus un pachet de domeniu și ce specifică fișierul său pack.json; lentilele și registrul de lentile; modelele de cunoștințe, conectorii și suprapunerile mobile; cum este licențiat și activat un pachet pentru o unitate; și cele zece pachete pe care le livrează Adverant.
- 2.24Construirea unei verticale personalizate de la un capăt la altulUn exemplu practic de construire a pachetului de domeniu Cold chain, de la primul rezumat până la o versiune lansată care rulează pentru fiecare unitate, cu modelul său de cunoștințe, lentile, o competență, un plugin cu servicii complete și date de test. Apoi, cum să extindeți un pachet care există deja și cum să adăugați o lentilă la unul care a fost deja livrat.
- 2.25Construirea pentru fiecare edițieCe se schimbă atunci când o extensie trebuie să funcționeze în fiecare ediție, pe un amplasament izolat de rețea (air-gapped), pe o încărcătură utilă Nexus Edge sau sub propria marcă a unui client. Acoperă linia de licențiere pentru modulele Enterprise și livrarea offline semnată, cu o matrice a ceea ce trebuie făcut diferit pentru fiecare destinație.
- 2.26Construirea cu instrumente de programare bazate pe IACum să construiți extensii Nexus în siguranță cu Claude Code și alte instrumente de programare bazate pe IA (inteligență artificială). Începe cu conectarea mediului dumneavoastră IDE (mediu de dezvoltare integrat) la Workbench și un fișier CLAUDE.md de proiect care conține regulile platformei, și se încheie cu șase instrucțiuni (prompturi) exemplificate practic și poarta de validare care o demonstrează pe fiecare.
- 2.27Scenarii de construireUn ghid practic cu treisprezece construcții, de la o singură competență până la o livrare izolată de rețea (air-gapped). Fiecare rețetă prezintă obiectivul, blocurile de construcție, pașii și comenzile, poarta de validare care demonstrează că a funcționat și ceea ce se schimbă în funcție de ediție și de forma de livrare.
- 2.28Lansarea extensiei dumneavoastrăCum ajunge un plugin sau un pachet de la o compilare validată la unitățile care îl rulează și cum este retras din nou. Versiuni, revizuirea lansării, canale și instalări, semnare, aprobări de modificare, înregistrarea identității livrării, migrări, revenire la versiunea anterioară (rollback) și retragerea unei versiuni.
Anexe: Referință
- AAnexa A: Referință pentru valorile HelmFiecare cheie pe care o acceptă diagrama (chart) Nexus, tipul acesteia, valorile permise și valoarea sa implicită.
- BAnexa B: Matricea edițiilorCe ediție, modul suplimentar (add-on) sau pachet de domeniu include fiecare capabilitate.
- CAnexa C: Coduri de eroareFiecare cod de refuz pe care îl întâlnește un operator sau un dezvoltator, ce înseamnă și ce trebuie făcut.
- DAnexa D: Servicii și porturiFiecare serviciu pe care îl rulează diagrama (chart), porturile sale și cheia de valori care îl configurează.
- EAnexa E: GlosarTermenii utilizați în ambele părți, explicați în cuvinte simple.
- FAnexa F: Arhitectura pe scurtÎntreaga platformă, nucleul deschis și ceea ce este licențiat peste acesta, fiecare mod de a rula Nexus și fiecare dintre cele zece pachete de domeniu, câte o diagramă pentru fiecare.
- GAnexa G: Dicționar de date și modele de cunoștințeCâmpurile din fiecare înregistrare și din ce este alcătuit fiecare pachet de domeniu.
Descărcare
- Part 1, for everyone (PDF) (se deschide într-o filă nouă) 18 MB
- Part 2, technical, with the appendices (PDF) (se deschide într-o filă nouă) 40 MB
Fișierele PDF sunt în limba engleză.