PrisijungtiUžsisakyti pristatymą
Pagalba
Versija 1.0.0-alpha.1naujausia

Dokumentacija

Adverant Nexus dokumentacija

Leidimas 1.0.0-alpha.1. Pradėkite nuo 1 dalies, jei tik pradedate naudotis „Nexus“; 2 dalis skirta tiems, kurie sistemą diegia ir prižiūri.

1 dalis: Visiems

  • 1.1Kas yra Nexus ir kam jis skirtasKą Adverant Nexus daro organizacijai, kam jis sukurtas ir kaip jo dalys dera tarpusavyje – papasakota paprastais žodžiais, kaip pavyzdį pasitelkiant Harrow Port Authority. Pabaigoje viena pastraipa aprašomi trys leidimai.
  • 1.2Darbo diena su NexusViena darbo diena Harrow Port Authority – nuo pirmo žvilgsnio į „Šiandien“ iki paskutinio patvirtinimo, parodant, ką žmonės iš tikrųjų daro su Nexus ir kur vyksta kiekvienos rūšies darbas.
  • 1.3Jūsų organizacija, jos žmonės ir tai, kas lieka privatuKaip Nexus modeliuoja organizaciją ir jos žmonių vaidmenis, kas gali pirkti ir reikšti teises Adverant paskyroje bei riba tarp to, ką gali matyti administratoriai, ir to, kas lieka privatu kiekvienam asmeniui.
  • 1.4DI jūsų sąlygomisKaip Nexus naudoja dirbtinį intelektą (DI) pačios organizacijos sąlygomis. Organizacija atsineša ir valdo savo modelių raktus, vienas komutatorius nukreipia kiekvieną modelio užklausą jos pasirinktiems teikėjams, vietiniai modeliai veikia jos pačios serveriuose, ir niekas nėra siunčiama į Adverant už jos nugaros.
  • 1.5Pasitikėjimas ir atitiktisNexus dalys, kuriose dirba atitikties pareigūnas. Čia aptariamas audito žurnalas ir užantspauduoti įrašai, patvirtinimai, kuriems reikia antro asmens, bei peržiūros laukiantys dirbtinio intelekto (DI) sprendimai. Pabaigoje aprašomos su asmens duomenimis susijusios užklausos ir atitikties puslapiai, kuriuose įrodymai paruošiami dar prieš auditoriui paprašant.
  • 1.6Leidimai ir licencijos paprastais žodžiaisTrys Nexus leidimai bei 19 papildomų priedų ir sričių paketų, taip pat kaip licencija veikia versle. Čia aptariamas patikrinimas neprisijungus ir ką kiekviena licencijos būsena reiškia praktiškai, pažadai, kurių laikosi kiekviena licencija, bei perėjimas iš Community į Enterprise neįdiegiant iš naujo.
  • 1.7Sričių paketai ir vertikalėsKą srities paketas prideda prie Nexus konkrečiai pramonės šakai, dešimt Adverant siūlomų paketų, kaip paketas įjungiamas vienam padaliniui ir ko paketui reikia jūsų licencijoje.
  • 1.8Kur veikia NexusVietos, kuriose gali veikti Nexus – nuo Adverant ES debesijos iki vietos be interneto ir įrenginių lauko sąlygomis, ką suverenumas reiškia praktiškai ir kaip pasirinkti.
  • 1.9Darbo pradžiaDu sprendimai prieš pradedant, ką daro jūsų IT komanda, pirmasis paleidimas, kaip jį mato pirmasis administratorius, ir kontrolinis sąrašas, ką reikia turėti paruoštą pirmąją dieną.
  • 1.10Toli nuo darbo staloNexus naudojimas telefone – nuo pulto išdėstymo telefonui kiekviename leidime iki savųjų iPhone ir Android programėlių. Apima tai, kas veikia be ryšio, ir kaip įmonė valdo telefonus.
  • 1.11Pritaikymas sauBūdai, kuriais organizacija formuoja Nexus – nuo vieno nustatymo iki savos vertikalės. Taip pat kaip instruktuoti programuotojus ar partnerį ir ką platforma garantuoja, kad ir kas būtų sukurta.
  • 1.12Žmonių užduodami klausimaiPaprasti atsakymai į klausimus, kuriuos dažniausiai užduoda pirkėjai, vadovai ir duomenų apsaugos pareigūnai, įskaitant nepatogius klausimus apie pinigus ir prieigą prie jūsų duomenų.

2 dalis: IT, DevOps ir programuotojams

  • 2.1ArchitektūraKą valdo kiekviena Nexus paketo paslauga ir kokios saugyklos yra po ja, taip pat taisyklės, kurios jas jungia – nuo tapatybės tarp paslaugų iki kelio, kurį nueina kiekviena modelio užklausa.
  • 2.2Leidimai iš vidausKaip Community ir Enterprise sukuriami iš vieno produkto, kaip licencija vykdymo metu įjungia funkcijų grupes, ką Community diegimas rodo Enterprise puslapyje ir ką tai reiškia jūsų atsiunčiamiems atvaizdams bei kuriamiems plėtiniams.
  • 2.3Diegimo planavimasKo reikia Nexus diegimui Kubernetes aplinkoje prieš įvedant komandą, koks jo dydis ir du sprendimai, kurių negalėsite atšaukti – diegimo pavadinimas ir raktų saugotojai. Pabaigoje pateikiamas užpildytas Harrow Port Authority planavimo darbalapis.
  • 2.4Leidimo gavimas ir patikrinimasKur yra kiekviena Nexus leidimo dalis, kaip Enterprise atvaizdai paimami naudojant atsiuntimo prieigos raktą ir kaip prieš ką nors diegiant neprisijungus įrodyti, kad kiekvienas atvaizdas, paketas ir atsisiuntimas gautas iš Adverant nepakeistas.
  • 2.5Išankstinė patikra su nexusctlKiekvienas patikrinimas, kurį atlieka `nexusctl preflight`, ką kiekvienas iš jų nuskaito ir dėl ko nepavyksta, ataskaita, kurią jis išspausdina ir išsaugo, kaip ši ataskaita pasiekia pulto išankstinės patikros puslapį bei visi parametrai.
  • 2.6Community diegimas Kubernetes aplinkojeSunumeruotas Community leidimo diegimas naudojant Helm – nuo cert-manager iki kiekvieno darbo krūvio parengties, raktas po rakto paaiškinant reikšmių failą, kodėl nenaudojamas --wait, kokia tvarka vykdomi paketo kabliai (hooks) bei alternatyvus diegimo kelias su nexusctl.
  • 2.7Enterprise leidimo diegimas ir licencijos pritaikymasKas keičiasi įdiegus Enterprise leidimą, kaip užsakyti licenciją iš savo Adverant paskyros, trys jos importavimo būdai su kiekvienu atmetimo kodu ir kaip Harrow Port Authority vietoje perkėlė savo bandomąją Community versiją į Enterprise nieko neprarasdama.
  • 2.8Diegimas viename kompiuteryjeĮdiekite Nexus viename Linux serveryje naudodami nexusctl arba išbandykite jį nešiojamajame kompiuteryje su k3d ir pasiekite pultą per HTTPS, kad veiktų prisijungimas ir prieigos raktai.
  • 2.9Diegimo programos disko atvaizdasPaleiskite fizinį serverį arba virtualiąją mašiną iš Nexus diegimo programos atvaizdo, ir jis be tinklo ryšio įdiegs operacinę sistemą, k3s, cert-manager bei Nexus, patikrindamas kiekvieną failą prieš jį panaudojant.
  • 2.10Diegimas izoliuotoje aplinkojeNuneškite pasirašytą neprisijungus naudojamą paketą į vietą be interneto, patikrinkite jį su atskirai atsineštu raktu, įkelkite į savo registrą ir įdiekite. Licencijos, atnaujinimai ir atšauktų licencijų sąrašai šią atskirtį taip pat kerta rankiniu būdu.
  • 2.11Variacijos: išorinės saugyklos, TLS ir įeinantis srautasReikšmės, pritaikančios Nexus klasteriui, kuris nėra tuščias, įskaitant TLS (Transport Layer Security), kartu su jūsų jau naudojamomis duomenų bazėmis, jūsų pačių sertifikatais, kitu įeinančio srauto valdikliu, saugyklų klasėmis, paštu, tarpiniais serveriais, replikomis ir valdomu Kubernetes.
  • 2.12Pirmasis paleidimasNuo neperimto diegimo iki dirbančių žmonių. Sukurkite perėmimo kodą, perimkite diegimą naršyklėje, sukurkite pirmąjį administratorių su prieigos raktu, tada prijunkite įmonės prisijungimo sistemą ir pakvieskite visus kitus.
  • 2.13LicencijosKas yra Nexus licencijos faile, kaip diegimas jį tikrina be interneto ryšio, šešios jo galimos būsenos ir kaip jį užsakyti, importuoti, atnaujinti bei atšaukti.
  • 2.14DI tiekėjai ir modeliaiKaip dirbtinio intelekto (DI) tiekėjų maršrutizatorius parenka modelį iš organizacijos raktų telkinio ir kaip scenarijai bei DI įrankiai pasiekia Nexus iš išorės.
  • 2.15Antroji diena: Nexus eksploatavimasKasdienis diegimo priežiūros darbas po pirmosios savaitės. Jis prasideda raktų saugyklos atplombavimu po paleidimo iš naujo ir baigiasi pašalinimu.
  • 2.16Saugumas ir tinklasKą diegimas įleidžia ir išleidžia, kaip jo tarnybos viena kitai įrodo savo tapatybę ir kokius prisijungimo bei duomenų bazės valdiklius operatorius nustato arba paveldi.
  • 2.17Trikčių šalinimasProblemos, su kuriomis operatoriai susiduria dažniausiai, suskirstytos pagal tai, ką matote. Prie kiekvienos nurodoma priežastis, ją patvirtinanti komanda ir sprendimas, o skyrius baigiamas pagalbos paketo išsiuntimu.
  • 2.18Plėtinių modelisŠeši būdai išplėsti Nexus – nuo parametro iki srities paketo, kiekvieno iš jų ribos ir kaip pasitikėjimo bei izoliacijos lygiai lemia, kur vykdomas jūsų kodas. Perskaitykite tai prieš atidarydami programinės įrangos kūrimo rinkinį (SDK).
  • 2.19Taisyklės, kurias paveldi kiekvienas plėtinysIzoliacija trijose ašyse, skaičiavimai per UNO, DI (dirbtinis intelektas) per maršrutizatorių, organizacijai priklausantys raktai ir licencijų patikrinimai. Ką kiekviena taisyklė reiškia jūsų kodui, kuris barjeras užtikrina jos vykdymą ir kodėl jūs ją paveldite, o ne rašote patys.
  • 2.20ĮgūdžiaiKaip parašyti, išbandyti ir paskelbti Skills Engine įgūdį, kur jis rodomas tapęs aktyvus ir kuo skiriasi manifesto įgūdžiai įskiepyje. Apima išsamų krantinių paskirstymo suvestinės pavyzdį, skirtą Harrow Port Authority.
  • 2.21Įskiepių SDKĮskiepių SDK (programinės įrangos kūrimo rinkinio) diegimas, jo komandinės eilutės įrankiai, pilnos tarnybos šablono apžvalga, v2 manifesto laukai po vieną ir dvidešimt du barjerai, užtikrinantys, kad įskiepis laikytųsi taisyklių.
  • 2.22Įskiepių vykdymo aplinkaSDK (programinės įrangos kūrimo rinkinio) moduliai, kuriais remiasi jūsų įskiepis: nuo aprėpties sargo ir duomenų bazės užtvaros iki UNO dispečerio, DI (dirbtinio intelekto) maršruto nuskaitymo bei licencijų patikrinimų. Toliau – testavimas su tikra duomenų baze, jūsų įgūdžių registravimas ir įvedimas.
  • 2.23Sričių paketaiIš ko susideda srities paketas ir kas nurodyta jo pack.json faile; lęšiai ir lęšių registras; žinių modeliai, jungtys ir mobiliosios perdangos; kaip paketas licencijuojamas ir įjungiamas padaliniui; bei dešimt Adverant tiekiamų paketų.
  • 2.24Pasirinktinio šakinio sprendimo kūrimas nuo pradžios iki pabaigosPraktinis „Cold chain“ srities paketo sukūrimas – nuo pirminės užduoties iki kiekvienam padaliniui veikiančios laidos, įskaitant žinių modelį, perspektyvas, įgūdį, pilno funkcionalumo įskiepį ir pavyzdinius duomenis. Taip pat aprašoma, kaip išplėsti jau esamą paketą ir kaip pridėti perspektyvą prie jau išleisto paketo.
  • 2.25Kūrimas kiekvienam leidimuiKas keičiasi, kai vienas plėtinys turi veikti kiekviename leidime, izoliuotoje svetainėje, „Nexus Edge“ pakete arba su paties kliento prekės ženklu. Apima „Enterprise“ modulių licencijavimo ribą ir pasirašytą pristatymą neprisijungus bei matricą, nurodančią, ką daryti kitaip kiekvienoje tikslinėje aplinkoje.
  • 2.26Kūrimas su DI programavimo įrankiaisKaip saugiai kurti „Nexus“ plėtinius su „Claude Code“ ir kitais DI (dirbtinio intelekto) programavimo įrankiais. Pradedama nuo jūsų IDE (integruotos kūrimo aplinkos) prijungimo prie „Workbench“ ir projekto failo CLAUDE.md, kuriame aprašytos platformos taisyklės, o baigiama šešiomis praktiškai išbandytomis užklausomis bei patikros vartais, patvirtinančiais kiekvieną iš jų.
  • 2.27Kūrimo scenarijaiTrylikos darinių receptų knyga – nuo vieno įgūdžio iki pristatymo į izoliuotą tinklą. Kiekviename recepte nurodomas tikslas, sudedamosios dalys, žingsniai ir komandos, patikros vartai, įrodantys, kad viskas suveikė, bei tai, kas keičiasi priklausomai nuo leidimo ir pristatymo formos.
  • 2.28Jūsų plėtinio išleidimasKaip įskiepis ar paketas nukeliauja nuo sėkmingo darinio iki jį vykdančių padalinių ir kaip jis iš ten pašalinamas. Versijos, laidos peržiūra, kanalai ir diegimai, pasirašymas, pakeitimų patvirtinimai, pristatymo tapatybės įrašas, migracijos, atšaukimas ir versijos eksploatavimo nutraukimas.

Priedai: Žinynas

Atsisiųsti

PDF failai pateikiami anglų kalba.