Podpora
Verze 1.0.0-alpha.1nejnovější
Dokumentace
Dokumentace Adverant Nexus
Vydání 1.0.0-alpha.1. Začněte Částí 1, pokud je pro vás Nexus nový; Část 2 je pro ty, kdo jej instalují a provozují.
Prozkoumejte mapu znalostního modeluSdílené jádro a každý doménový balíček se svými pohledy, moduly a vazbami.
Část 1: Pro každého
- 1.1Co je Nexus a pro koho je určenCo Adverant Nexus přináší organizaci, pro koho je vytvořen a jak do sebe jeho části zapadají, vysvětleno srozumitelně na příkladu organizace Harrow Port Authority. Na závěr jsou v jednom odstavci představeny tři edice.
- 1.2Pracovní den se systémem NexusJeden pracovní den v organizaci Harrow Port Authority, od prvního pohledu na zobrazení Dnes až po poslední schválení, ukazující, co lidé v systému Nexus skutečně dělají a kde má každý druh práce své místo.
- 1.3Vaše organizace, její lidé a co zůstává soukroméJak Nexus modeluje organizaci a role jejích lidí, kdo může nakupovat a nárokovat na účtu Adverant a kde leží hranice mezi tím, co mohou vidět správci, a tím, co zůstává soukromé pro každého jednotlivce.
- 1.4AI podle vašich podmínekJak Nexus využívá umělou inteligenci (AI) podle vlastních podmínek organizace. Organizace si přináší a vlastní klíče ke svým modelům, jedna ústředna směruje každé volání modelu k jí zvoleným poskytovatelům, lokální modely běží na jejích vlastních serverech a společnosti Adverant se nic neodesílá za jejími zády.
- 1.5Důvěra a soulad s předpisyČásti systému Nexus, ve kterých se pohybuje manažer pro soulad s předpisy (compliance officer). Zahrnuje auditní protokol a zapečetěné záznamy, schválení vyžadující druhou osobu a rozhodnutí umělé inteligence (AI) čekající na revizi. Končí žádostmi týkajícími se osobních údajů a stránkami souladu s předpisy, které udržují důkazy připravené dříve, než o ně požádá auditor.
- 1.6Edice a licence srozumitelněTři edice systému Nexus a 19 doplňků a oborových balíčků nad jejich rámec a poté způsob, jakým licence funguje pro firmu. Pokrývá offline kontrolu a to, co jednotlivé stavy licence znamenají v praxi, sliby, které každá licence plní, a přechod z edice Community na Enterprise bez přeinstalování.
- 1.7Oborové balíčky a vertikályCo oborový balíček přidává do systému Nexus pro jedno odvětví, deset balíčků, které Adverant nabízí, jak se balíček zapíná pro jednu jednotku a co balíček vyžaduje ve vaší licenci.
- 1.8Kde Nexus běžíMísta, kde může Nexus běžet, od EU cloudu společnosti Adverant až po lokalitu bez internetu a zařízení v terénu, co v praxi znamená suverenita a jak si vybrat.
- 1.9ZačínámeDvě rozhodnutí, než začnete, co dělá váš IT tým, první spuštění z pohledu prvního správce a kontrolní seznam toho, co mít připraveno první den.
- 1.10Mimo pracovní stůlPoužívání systému Nexus na telefonu, od telefonního rozvržení konzole v každé edici až po nativní aplikace pro iPhone a Android. Pokrývá, co funguje bez signálu a jak firma spravuje telefony.
- 1.11Přizpůsobení vašim potřebámZpůsoby, jakými si organizace utváří Nexus, od jediného nastavení až po vlastní vertikálu. Také jak zadat práci vývojářům nebo partnerovi a co platforma garantuje bez ohledu na to, co se vytvoří.
- 1.12Časté dotazySrozumitelné odpovědi na otázky, které nejčastěji kladou nákupčí, manažeři a pověřenci pro ochranu osobních údajů, včetně těch nepříjemných ohledně peněz a přístupu k vašim datům.
Část 2: Pro IT, DevOps a vývojáře
- 2.1ArchitekturaCo vlastní každá služba v chartu Nexus a jaká úložiště se pod ní nacházejí, a dále pravidla, která je drží pohromadě, od identity mezi službami až po cestu, kterou prochází každé volání modelu.
- 2.2Edice pod kapotouJak jsou edice Community a Enterprise sestaveny z jednoho produktu, jak licence zapíná skupiny funkcí za běhu, co instalace Community zobrazuje místo stránky Enterprise a co to znamená pro obrazy, které stahujete, a rozšíření, která vytváříte.
- 2.3Plánování instalaceCo instalace systému Nexus v prostředí Kubernetes potřebuje, než zadáte příkaz, jak je velká, a dvě rozhodnutí, která nelze vzít zpět: název instalace a správci klíčů. Končí vyplněným plánovacím pracovním listem organizace Harrow Port Authority.
- 2.4Získání a ověření vydáníKde se nachází každá část vydání systému Nexus, jak se obrazy Enterprise stahují pomocí pull tokenu a jak offline prokázat, že každý obraz, chart a stažený soubor pochází od společnosti Adverant v nezměněné podobě, ještě než cokoli nainstalujete.
- 2.5Předletová kontrola pomocí nexusctlKaždá kontrola, kterou `nexusctl preflight` provádí, co každá z nich čte a jak selhává, zpráva, kterou vypíše a uloží, jak se tato zpráva dostane na stránku předletové kontroly v konzoli, a každý příznak.
- 2.6Instalace edice Community v prostředí KubernetesOčíslovaný postup instalace edice Community pomocí nástroje Helm, od komponenty cert-manager až po stav připravenosti všech úloh (workloads), s vysvětlením souboru hodnot klíč po klíči, proč se nepoužívá příznak --wait, v jakém pořadí se spouštějí hooky chartu a instalační cesta pomocí nexusctl jako alternativa.
- 2.7Instalace edice Enterprise a uplatnění licenceCo se změní při instalaci edice Enterprise, jak požádat o licenci ze svého účtu Adverant, tři způsoby jejího importu včetně všech kódů zamítnutí a jak organizace Harrow Port Authority převedla svůj pilotní provoz edice Community na Enterprise přímo na místě bez ztráty dat.
- 2.8Instalace na jeden strojNainstalujte Nexus na jeden linuxový server pomocí nexusctl nebo jej vyzkoušejte na notebooku s k3d a přistupujte ke konzoli přes HTTPS, aby fungovalo přihlašování a přístupové klíče (passkeys).
- 2.9Obraz instalačního diskuSpusťte fyzický server nebo virtuální stroj z instalačního obrazu systému Nexus a ten bez připojení k síti nainstaluje operační systém, k3s, cert-manager a Nexus, přičemž každý soubor před použitím zkontroluje.
- 2.10Instalace v izolované síti (air-gap)Přineste podepsaný offline balíček do lokality bez internetu, ověřte jej pomocí klíče, který jste přinesli odděleně, nahrajte jej do vlastního registru a proveďte instalaci. Licence, aktualizace a seznamy zneplatnění se přes tuto bariéru přenášejí rovněž ručně.
- 2.11Varianty: externí úložiště, TLS a ingressHodnoty, které přizpůsobí Nexus clusteru, jenž není prázdný – včetně TLS (Transport Layer Security), databází, které již provozujete, vlastních certifikátů, jiného ingress controlleru, tříd úložiště, pošty, proxy serverů, replik a spravovaného prostředí Kubernetes.
- 2.12První spuštěníOd nepřevzaté instalace k pracujícím lidem. Vytvořte kód pro převzetí, převezměte instalaci v prohlížeči, vytvořte prvního administrátora s přístupovým klíčem (passkey), poté připojte firemní přihlašování a pozvěte všechny ostatní.
- 2.13LicenceCo obsahuje licenční soubor systému Nexus, jak jej instalace kontroluje offline, šest stavů, ve kterých se může nacházet, a jak o licenci požádat, importovat ji, obnovit a odebrat.
- 2.14Poskytovatelé a modely AIJak směrovač poskytovatelů umělé inteligence (AI) vybírá model z vlastního fondu klíčů organizace a jak skripty a nástroje AI přistupují k systému Nexus zvenčí.
- 2.15Druhý den: provoz systému NexusBěžná práce spojená s provozem instalace po prvním týdnu. Začíná odpečetěním úložiště klíčů po restartu a končí odinstalací.
- 2.16Zabezpečení a sítěCo instalace vpouští dovnitř a ven, jak si její služby navzájem prokazují svou identitu a jaké ovládací prvky pro přihlašování a databázi operátor nastavuje nebo dědí.
- 2.17Řešení potížíProblémy, se kterými se operátoři setkávají nejčastěji, uspořádané podle toho, co vidíte. U každého je uvedena příčina, příkaz pro její potvrzení a oprava; kapitola končí odesláním balíčku pro podporu.
- 2.18Model rozšířeníŠest způsobů, jak rozšířit Nexus, od nastavení až po oborový balíček, limity každého z nich a jak úrovně důvěryhodnosti a izolace rozhodují o tom, kde váš kód běží. Přečtěte si to před otevřením sady pro vývoj softwaru (SDK).
- 2.19Pravidla, která dědí každé rozšířeníIzolace ve třech osách, výpočty přes UNO, AI (umělá inteligence) přes směrovač, klíče vlastněné organizací a kontroly licencí. Co jednotlivá pravidla znamenají pro váš kód, která brána je vynucuje a proč je dědíte, místo abyste je sami psali.
- 2.20DovednostiJak napsat, otestovat a publikovat dovednost v modulu Skills Engine, kde se zobrazí po spuštění a jak se liší dovednosti v manifestu pluginu. Obsahuje vypracovaný přehled přidělování kotvišť pro organizaci Harrow Port Authority.
- 2.21Plugin SDKInstalace sady Plugin SDK (sada pro vývoj softwaru), její nástroje příkazového řádku, prohlídka šablony plnohodnotné služby, manifest v2 pole po poli a dvacet dva bran, které zajišťují, že plugin dodržuje pravidla.
- 2.22Běhové prostředí pluginuModuly SDK (sady pro vývoj softwaru), na kterých váš plugin běží – od strážce rozsahu a databázové ohrady přes dispečink UNO až po čtení trasy AI (umělé inteligence) a kontroly licencí. Následuje testování oproti reálné databázi, registrace dovedností a úvodní nastavení.
- 2.23Oborové balíčkyZ čeho se skládá oborový balíček a co říká jeho soubor pack.json; optiky a registr optik; znalostní modely, konektory a mobilní překryvné vrstvy; jak je balíček licencován a zapnut pro jednotku; a deset balíčků, které dodává Adverant.
- 2.24Kompletní vytvoření vlastní vertikály od začátku do koncePraktická ukázka sestavení doménového balíčku Cold chain, od prvního zadání až po vydání běžící v každé jednotce, včetně znalostního modelu, pohledů, dovednosti, plnohodnotného pluginu a vzorových dat. Následuje postup, jak rozšířit již existující balíček a jak přidat pohled do již vydaného balíčku.
- 2.25Sestavení pro jednotlivé ediceCo se mění, když musí jedno rozšíření fungovat v každé edici, v izolovaném (air-gapped) prostředí, v nákladu Nexus Edge nebo pod vlastní značkou zákazníka. Zahrnuje licenční hranici pro moduly Enterprise a podepsané offline doručení, včetně matice odlišných postupů pro každý cíl.
- 2.26Tvorba pomocí programovacích nástrojů s AIJak bezpečně vytvářet rozšíření pro Nexus pomocí Claude Code a dalších nástrojů pro programování s AI (umělou inteligencí). Začíná propojením vašeho IDE (integrovaného vývojového prostředí) s nástrojem Workbench a projektovým souborem CLAUDE.md, který nese pravidla platformy, a končí šesti vypracovanými prompty a kontrolní bránou, která každý z nich ověří.
- 2.27Scénáře sestaveníKuchařka třinácti sestavení, od jediné dovednosti až po doručení do izolovaného (air-gapped) prostředí. Každý recept uvádí cíl, stavební bloky, kroky a příkazy, kontrolní bránu ověřující funkčnost a rozdíly podle edice a formy doručení.
- 2.28Vydání vašeho rozšířeníJak plugin nebo balíček putuje od úspěšného sestavení do jednotek, které jej spouštějí, a jak se opět stahuje. Verze, kontrola před vydáním, kanály a instalace, podepisování, schvalování změn, záznam identity doručení, migrace, vrácení změn (rollback) a vyřazení verze.
Přílohy: Referenční příručka
- APříloha A: Referenční přehled hodnot pro HelmKaždý klíč, který chart Nexus přijímá, jeho typ, povolené hodnoty a výchozí nastavení.
- BPříloha B: Matice edicKterá edice, doplněk nebo doménový balíček obsahuje jednotlivé schopnosti.
- CPříloha C: Chybové kódyKaždý kód odmítnutí, se kterým se operátor nebo vývojář setká, jeho význam a postup řešení.
- DPříloha D: Služby a portyKaždá služba, kterou chart spouští, její porty a klíč hodnot, který ji konfiguruje.
- EPříloha E: Slovníček pojmůPojmy použité v obou částech, vysvětlené srozumitelně.
- FPříloha F: Přehled architekturyCelá platforma, otevřené jádro a licencované nadstavby, jednotlivé způsoby provozu systému Nexus a každý z deseti doménových balíčků, vždy v samostatném diagramu.
- GPříloha G: Datový slovník a znalostní modelyPole na každém záznamu a složení jednotlivých doménových balíčků.
Stahování
- Part 1, for everyone (PDF) (otevře se na nové kartě) 18 MB
- Part 2, technical, with the appendices (PDF) (otevře se na nové kartě) 40 MB
Soubory PDF jsou v angličtině.