Tugi
Versioon 1.0.0-alpha.1uusim
Dokumentatsioon
Adverant Nexuse dokumentatsioon
Väljalase 1.0.0-alpha.1. Alustage 1. osast, kui olete Nexuse uus kasutaja; 2. osa on mõeldud inimestele, kes seda paigaldavad ja käitavad.
Uurige teadmismudeli kaartiJagatud tuum ja iga valdkonnapakett koos oma vaatenurkade, moodulite ja seostega.
1. osa: Kõigile
- 1.1Mis on Nexus ja kellele see on mõeldudMida Adverant Nexus organisatsiooni heaks teeb, kellele see on loodud ja kuidas selle osad kokku sobivad – lihtsas keeles, Harrow Port Authority näitel. Lõpus on ühes lõigus kirjeldatud kolme väljaannet.
- 1.2Tööpäev NexusegaÜks tööpäev ettevõttes Harrow Port Authority, alates esimesest pilgust vaatele Today kuni viimase kinnituseni, näidates, mida inimesed Nexuses tegelikult teevad ja kus iga tööliik asub.
- 1.3Teie organisatsioon, selle inimesed ja mis jääb privaatseksKuidas Nexus modelleerib organisatsiooni ja selle inimeste rolle, kes võivad Adveranti kontol oste sooritada ja õigusi nõuda, ning kus jookseb piir selle vahel, mida administraatorid näevad ja mis jääb iga inimese jaoks privaatseks.
- 1.4AI teie tingimustelKuidas Nexus kasutab tehisintellekti (AI) organisatsiooni enda tingimustel. Organisatsioon toob kaasa ja omab oma mudelivõtmeid, üks kommutaator suunab iga mudelipäringu organisatsiooni valitud teenusepakkujatele, kohalikud mudelid töötavad organisatsiooni enda serverites ning midagi ei saadeta Adverantile organisatsiooni selja taga.
- 1.5Usaldus ja vastavusNexuse osad, mida vastavusametnik igapäevaselt kasutab. See hõlmab auditilogi ja pitseeritud kirjeid, teist inimest vajavaid kinnitusi ning ülevaatust ootavaid tehisintellekti (AI) otsuseid. Lõpus käsitletakse isikuandmete päringuid ja vastavuslehti, mis hoiavad tõendid valmis enne, kui audiitor neid küsib.
- 1.6Väljaanded ja litsentsid lihtsas keelesNexuse kolm väljaannet ning neile lisanduvad 19 lisamoodulit ja valdkonnapaketti, seejärel litsentsi toimimine ettevõtte jaoks. See hõlmab võrguühenduseta kontrolli ja iga litsentsi oleku praktilist tähendust, lubadusi, mida iga litsents täidab, ning üleminekut Community väljaandelt Enterprise väljaandele ilma uuesti installimata.
- 1.7Valdkonnapaketid ja vertikaalidMida valdkonnapakett lisab Nexusele ühe tegevusala jaoks, kümme Adveranti pakutavat paketti, kuidas pakett ühe üksuse jaoks sisse lülitatakse ja mida pakett teie litsentsilt vajab.
- 1.8Kus Nexus töötabKohad, kus Nexus saab töötada, alates Adveranti EL-i pilvest kuni internetiühenduseta asukoha ja välistingimustes olevate seadmeteni, mida suveräänsus praktikas tähendab ja kuidas valida.
- 1.9AlustamineKaks otsust enne alustamist, mida teeb teie IT-meeskond, esimene käivitamine esimese administraatori pilgu läbi ja kontrollnimekiri sellest, mis peab esimesel päeval valmis olema.
- 1.10Laua juurest eemalNexuse kasutamine telefonis, alates konsooli telefonipaigutusest igas väljaandes kuni iPhone'i ja Androidi omarakendusteni. Hõlmab seda, mis töötab ilma levita ja kuidas ettevõte telefone haldab.
- 1.11Enda omaks kujundamineViisid, kuidas organisatsioon Nexust kujundab, alates üksikust seadistusest kuni omaenda vertikaalini. Samuti see, kuidas anda juhiseid arendajatele või partnerile ja mida platvorm garanteerib sõltumata sellest, mida ehitatakse.
- 1.12Küsimused, mida inimesed küsivadLihtsad vastused küsimustele, mida ostjad, juhid ja andmekaitseametnikud kõige sagedamini küsivad, sealhulgas ebamugavatele küsimustele raha ja teie andmetele juurdepääsu kohta.
2. osa: IT-le, DevOpsile ja arendajatele
- 2.1ArhitektuurMida iga teenus Nexuse chartis omab ja millised andmehoidlad selle all asuvad, seejärel reeglid, mis neid koos hoiavad, alates teenustevahelisest identiteedist kuni teekonnani, mille iga mudelipäring läbib.
- 2.2Väljaanded kapoti allKuidas Community ja Enterprise on ehitatud ühest tootest, kuidas litsents lülitab funktsioonigrupid käitusajal sisse, mida Community installatsioon näitab Enterprise'i lehe puhul ning mida see tähendab tõmmatavate tõmmiste ja ehitatavate laienduste jaoks.
- 2.3Installatsiooni planeerimineMida Nexuse Kubernetese installatsioon vajab enne käsu sisestamist, kui suur see on, ja kaks otsust, mida ei saa tagasi võtta: installatsiooni nimi ja võtmehoidjad. Lõpus on Harrow Port Authority täidetud planeerimistööleht.
- 2.4Väljalaske hankimine ja kontrollimineKus Nexuse väljalaske iga osa asub, kuidas Enterprise'i tõmmised tõmbeloa abil alla laaditakse ning kuidas enne millegi installimist võrguühenduseta tõestada, et iga tõmmis, chart ja allalaadimine pärineb Adverantilt muutmata kujul.
- 2.5Eelkontroll tööriistaga nexusctlIga kontroll, mille `nexusctl preflight` teeb, mida igaüks neist loeb ja kuidas see ebaõnnestub, aruanne, mille see kuvab ja salvestab, kuidas see aruanne jõuab konsooli eelkontrolli lehele, ning iga lipp.
- 2.6Community installimine KubernetesesseCommunity väljaande nummerdatud installimine Helmiga, alates cert-managerist kuni iga töökoormuse valmimiseni, koos väärtuste faili selgitusega võtmete kaupa, miks puudub --wait, charti haakide käivitamise järjekord ja alternatiivina nexusctl installi teekond.
- 2.7Enterprise-väljaande paigaldamine ja litsentsi rakendamineMis muutub Enterprise-väljaande paigaldamisel, kuidas taotleda litsentsi oma Adverant-kontolt, kolm viisi selle importimiseks koos kõigi keeldumiskoodidega ning kuidas Harrow Port Authority viis oma Community-pilootprojekti kohapeal üle Enterprise-väljaandele ilma midagi kaotamata.
- 2.8Ühe masina paigaldusedPaigaldage Nexus ühele Linux-serverile tööriistaga nexusctl või katsetage seda sülearvutis tööriistaga k3d ning avage konsool üle HTTPS-i, et sisselogimine ja pääsuvõtmed töötaksid.
- 2.9Paigaldaja kettatõmmisAlglaadige tühi server või virtuaalmasin Nexuse paigaldaja tõmmiselt ning see paigaldab operatsioonisüsteemi, k3s-i, cert-manager-i ja Nexuse ilma võrguühenduseta, kontrollides iga faili enne kasutamist.
- 2.10Võrgust eraldatud (air-gapped) paigaldusViige allkirjastatud võrguväline pakett internetiühenduseta asukohta, kontrollige seda eraldi toodud võtme abil, laadige see oma registrisse ja paigaldage. Litsentsid, uuendused ja tühistusnimekirjad liiguvad üle võrgueralduse samuti käsitsi.
- 2.11Variatsioonid: välised andmehoidlad, TLS ja ingressVäärtused, mis kohandavad Nexuse klastriga, mis ei ole tühi, sealhulgas TLS (Transport Layer Security), teie juba töötavad andmebaasid, teie enda sertifikaadid, teine ingress-kontroller, salvestusklassid, e-post, puhverserverid, replikad ja hallatud Kubernetes.
- 2.12EsmakäivitusOmastamata paigaldusest töötavate inimesteni. Looge omastamiskood, omastage paigaldus brauseris, looge pääsuvõtmega esimene administraator, seejärel ühendage ettevõtte sisselogimine ja kutsuge kõik teised.
- 2.13LitsentsidMida Nexuse litsentsifail sisaldab, kuidas paigaldus seda võrguväliselt kontrollib, kuus olekut, milles see võib olla, ning kuidas litsentsi taotleda, importida, uuendada ja tagasi võtta.
- 2.14AI-pakkujad ja mudelidKuidas tehisintellekti (AI) Provider Router valib mudeli organisatsiooni enda võtmekogumist ning kuidas skriptid ja AI-tööriistad jõuavad Nexuseni väljastpoolt.
- 2.15Teine päev: Nexuse käitaminePaigalduse igapäevane haldamine pärast esimest nädalat. See algab võtmehoidla avamisega pärast taaskäivitust ja lõpeb eemaldamisega.
- 2.16Turvalisus ja võrguühendusedMida paigaldus sisse ja välja laseb, kuidas selle teenused üksteisele oma identiteeti tõestavad ning kontrollimehhanismid, mida operaator sisselogimise ja andmebaasi jaoks määrab või pärib.
- 2.17TõrkeotsingProbleemid, millega operaatorid kõige sagedamini kokku puutuvad, järjestatuna sümptomite järgi. Iga punkti juures on toodud põhjus, seda kinnitav käsk ja lahendus ning peatükk lõpeb rikketoe paketi saatmisega.
- 2.18LaiendusmudelKuus viisi Nexuse laiendamiseks seadistusest kuni valdkonnapaketini, igaühe piirid ning kuidas usaldus- ja isolatsioonitasemed määravad, kus teie kood töötab. Lugege see läbi enne tarkvaraarenduskomplekti (SDK) avamist.
- 2.19Reeglid, mille iga laiendus päribIsolatsioon kolmel teljel, arvutused läbi UNO, AI (tehisintellekt) läbi ruuteri, organisatsioonile kuuluvad võtmed ja litsentsikontrollid. Mida iga reegel teie koodi jaoks tähendab ja milline värav seda jõustab ning miks te pärite selle ise kirjutamise asemel.
- 2.20Oskused (Skills)Kuidas kirjutada, testida ja avaldada Skills Engine-i oskust, kus see pärast avaldamist ilmub ja kuidas pistikprogrammi manifestioskused sellest erinevad. Sisaldab läbitöötatud kaikohtade jaotuse kokkuvõtet Harrow Port Authority näitel.
- 2.21Plugin SDKPlugin SDK (tarkvaraarenduskomplekti) paigaldamine, selle käsureatööriistad, täisteenuse malli tutvustus, v2 manifest välihaaval ja kakskümmend kaks väravat, mis hoiavad pistikprogrammi reeglite piires.
- 2.22Pistikprogrammi käituskeskkondSDK (tarkvaraarenduskomplekti) moodulid, millel teie pistikprogramm töötab, alates skoobikaitsest ja andmebaasi piirdest kuni UNO suunamise, AI (tehisintellekti) marsruudi lugemise ja litsentsikontrollideni. Seejärel testimine päris andmebaasi vastu, oskuste registreerimine ja kasutuselevõtt.
- 2.23Valdkonnapaketid (Domain packs)Millest valdkonnapakett koosneb ja mida ütleb selle pack.json; vaated (lenses) ja vaadete register; teadmismudelid, konnektorid ja mobiilikihid; kuidas paketti litsentsitakse ja üksuse jaoks sisse lülitatakse; ning kümme paketti, mida Adverant tarnib.
- 2.24Kohandatud vertikaali terviklik loomineKülmaahela valdkonnapaketi praktiline ehitamine alates esimesest lähteülesandest kuni iga üksuse jaoks töötava väljalaskeni, koos teadmismudeli, vaadete, oskuse, täisteenuse pistikprogrammi ja näidisandmetega. Seejärel vaadatakse, kuidas laiendada juba olemasolevat paketti ja kuidas lisada vaade juba avaldatud paketile.
- 2.25Ehitamine iga väljaande jaoksMis muutub, kui üks laiendus peab töötama igas väljaandes, õhuvahega (air-gapped) asukohas, Nexus Edge'i platvormil või kliendi enda kaubamärgi all. Käsitleb Enterprise'i moodulite litsentsipiiri ja allkirjastatud võrguvälist tarnet koos maatriksiga selle kohta, mida iga sihtkeskkonna puhul teisiti teha.
- 2.26Ehitamine AI-kodeerimistööriistadegaKuidas luua Nexuse laiendusi turvaliselt Claude Code'i ja teiste AI (tehisintellekti) kodeerimistööriistadega. See algab teie IDE (integreeritud arenduskeskkonna) ühendamisega Workbenchiga ja platvormi reegleid kandva projekti CLAUDE.md failiga ning lõpeb kuue läbitöötatud viiba ja kontrollväravaga, mis igaühe toimimist tõestab.
- 2.27EhitusstsenaariumidKolmeteistkümnest ehitusest koosnev retseptiraamat alates üksikust oskusest kuni õhuvahega tarneni. Iga retsept annab eesmärgi, ehitusplokid, sammud ja käsud, kontrollvärava, mis tõestab selle toimimist, ning selle, mis muutub olenevalt väljaandest ja tarnevormist.
- 2.28Laienduse avaldamineKuidas pistikprogramm või pakett liigub edukast ehitusest üksustesse, mis seda käitavad, ja kuidas see sealt taas eemaldatakse. Versioonid, väljalaske ülevaatus, kanalid ja paigaldused, allkirjastamine, muudatuste kinnitused, tarne identiteedikirje, migratsioonid, tagasipööramine ja versiooni kasutusest kõrvaldamine.
Lisad: Viited
- ALisa A: Helm-i väärtuste viideIga võti, mida Nexuse chart aktsepteerib, selle tüüp, lubatud väärtused ja vaikeväärtus.
- BLisa B: Väljaannete maatriksMilline väljaanne, lisamoodul või valdkonnapakett iga võimekust sisaldab.
- CLisa C: VeakoodidIga keeldumiskood, millega operaator või arendaja kokku puutub, mida see tähendab ja mida ette võtta.
- DLisa D: Teenused ja pordidIga teenus, mida chart käitab, selle pordid ja seda seadistav väärtuste võti.
- ELisa E: SõnastikMõlemas osas kasutatud terminid lihtsas keeles.
- FLisa F: Arhitektuuri ülevaadeKogu platvorm, avatud tuum ja selle peale litsentsitud osad, iga Nexuse käitamise viis ning igaüks kümnest valdkonnapaketist, igaühe kohta üks skeem.
- GLisa G: Andmesõnastik ja teadmismudelidIga kirje väljad ja see, millest iga valdkonnapakett koosneb.
Allalaadimine
- Part 1, for everyone (PDF) (avaneb uuel vahekaardil) 18 MB
- Part 2, technical, with the appendices (PDF) (avaneb uuel vahekaardil) 40 MB
PDF-id on inglise keeles.