Υποστήριξη
Έκδοση 1.0.0-alpha.1τελευταία
Τεκμηρίωση
Τεκμηρίωση του Adverant Nexus
Έκδοση 1.0.0-alpha.1. Ξεκινήστε με το Μέρος 1 αν είστε νέοι στο Nexus· το Μέρος 2 απευθύνεται σε όσους το εγκαθιστούν και το λειτουργούν.
Εξερευνήστε τον χάρτη του μοντέλου γνώσηςΟ κοινόχρηστος πυρήνας και κάθε πακέτο τομέα, με τις οπτικές, τις λειτουργικές μονάδες και τις συσχετίσεις τους.
Μέρος 1: Για όλους
- 1.1Τι είναι το Nexus και σε ποιους απευθύνεταιΤι κάνει το Adverant Nexus για έναν οργανισμό, για ποιους έχει σχεδιαστεί και πώς συνδέονται τα μέρη του μεταξύ τους, με απλά λόγια και με παράδειγμα το Harrow Port Authority. Κλείνει με τις τρεις εκδόσεις σε μία παράγραφο.
- 1.2Μια εργάσιμη ημέρα με το NexusΜια εργάσιμη ημέρα στο Harrow Port Authority, από την πρώτη ματιά στη σελίδα «Σήμερα» έως την τελευταία έγκριση, που δείχνει τι κάνουν στην πράξη οι άνθρωποι στο Nexus και πού βρίσκεται κάθε είδος εργασίας.
- 1.3Ο οργανισμός σας, οι άνθρωποί του και τι παραμένει ιδιωτικόΠώς το Nexus αποτυπώνει έναν οργανισμό και τους ρόλους που έχουν οι άνθρωποί του, ποιος μπορεί να αγοράζει και να διεκδικεί στον λογαριασμό της Adverant, και πού μπαίνει το όριο ανάμεσα σε όσα μπορούν να δουν οι διαχειριστές και σε όσα παραμένουν ιδιωτικά για κάθε άτομο.
- 1.4Το AI με τους δικούς σας όρουςΠώς το Nexus χρησιμοποιεί την τεχνητή νοημοσύνη (AI) με τους όρους του ίδιου του οργανισμού. Ο οργανισμός φέρνει και κατέχει τα κλειδιά των μοντέλων του, ένα κέντρο δρομολόγησης κατευθύνει κάθε κλήση μοντέλου στους παρόχους που επέλεξε, τα τοπικά μοντέλα εκτελούνται στους δικούς του διακομιστές και τίποτα δεν στέλνεται στην Adverant εν αγνοία του.
- 1.5Εμπιστοσύνη και συμμόρφωσηΤα μέρη του Nexus στα οποία εργάζεται καθημερινά ένας υπεύθυνος συμμόρφωσης. Καλύπτει το αρχείο καταγραφής ελέγχου και τις σφραγισμένες εγγραφές, τις εγκρίσεις που απαιτούν δεύτερο άτομο και τις αποφάσεις τεχνητής νοημοσύνης (AI) που αναμένουν επανεξέταση. Κλείνει με τα αιτήματα προσωπικών δεδομένων και τις σελίδες συμμόρφωσης που διατηρούν τα τεκμήρια έτοιμα πριν τα ζητήσει ένας ελεγκτής.
- 1.6Εκδόσεις και άδειες χρήσης με απλά λόγιαΟι τρεις εκδόσεις του Nexus και τα 19 πρόσθετα και πακέτα τομέα που προστίθενται σε αυτές, καθώς και πώς λειτουργεί μια άδεια χρήσης για μια επιχείρηση. Καλύπτει τον έλεγχο εκτός σύνδεσης και τι σημαίνει στην πράξη κάθε κατάσταση άδειας, τις δεσμεύσεις που τηρεί κάθε άδεια και τη μετάβαση από την έκδοση Community στην Enterprise χωρίς επανεγκατάσταση.
- 1.7Πακέτα τομέα και κλαδικές λύσειςΤι προσθέτει ένα πακέτο τομέα στο Nexus για έναν κλάδο, τα δέκα πακέτα που προσφέρει η Adverant, πώς ενεργοποιείται ένα πακέτο για μία μονάδα και τι χρειάζεται ένα πακέτο στην άδεια χρήσης σας.
- 1.8Πού εκτελείται το NexusΤα μέρη όπου μπορεί να εκτελεστεί το Nexus, από το cloud της Adverant στην ΕΕ έως μια εγκατάσταση χωρίς διαδίκτυο και συσκευές στο πεδίο, τι σημαίνει στην πράξη η κυριαρχία και πώς να επιλέξετε.
- 1.9ΞεκινώνταςΟι δύο αποφάσεις πριν ξεκινήσετε, τι κάνει η ομάδα IT σας, η πρώτη εκτέλεση όπως τη βλέπει ο πρώτος διαχειριστής και μια λίστα ελέγχου με όσα πρέπει να έχετε έτοιμα την πρώτη ημέρα.
- 1.10Μακριά από το γραφείοΧρήση του Nexus σε τηλέφωνο, από τη διάταξη τηλεφώνου της κονσόλας σε κάθε έκδοση έως τις εγγενείς εφαρμογές για iPhone και Android. Καλύπτει τι λειτουργεί χωρίς σήμα και πώς μια εταιρεία διαχειρίζεται τα τηλέφωνα.
- 1.11Προσαρμόστε το στα μέτρα σαςΟι τρόποι με τους οποίους ένας οργανισμός διαμορφώνει το Nexus, από μια μεμονωμένη ρύθμιση έως μια δική του κλαδική λύση. Επίσης, πώς να καθοδηγήσετε τους προγραμματιστές ή έναν συνεργάτη, και τι εγγυάται η πλατφόρμα ανεξάρτητα από το τι θα κατασκευαστεί.
- 1.12Συχνές ερωτήσειςΞεκάθαρες απαντήσεις στις ερωτήσεις που κάνουν συχνότερα οι αγοραστές, οι διευθυντές και οι υπεύθυνοι προστασίας δεδομένων, συμπεριλαμβανομένων των δύσκολων ερωτήσεων σχετικά με το κόστος και την πρόσβαση στα δεδομένα σας.
Μέρος 2: Για ομάδες IT, DevOps και προγραμματιστές
- 2.1ΑρχιτεκτονικήΤι διαχειρίζεται κάθε υπηρεσία στο chart του Nexus και ποια συστήματα αποθήκευσης βρίσκονται από κάτω της, καθώς και οι κανόνες που τα συνδέουν μεταξύ τους, από την ταυτότητα μεταξύ υπηρεσιών έως τη διαδρομή που ακολουθεί κάθε κλήση μοντέλου.
- 2.2Πώς λειτουργούν εσωτερικά οι εκδόσειςΠώς οι εκδόσεις Community και Enterprise δημιουργούνται από ένα ενιαίο προϊόν, πώς μια άδεια χρήσης ενεργοποιεί ομάδες δυνατοτήτων κατά τον χρόνο εκτέλεσης, τι εμφανίζει μια εγκατάσταση Community για μια σελίδα Enterprise και τι σημαίνει αυτό για τα images που κάνετε pull και τις επεκτάσεις που δημιουργείτε.
- 2.3Σχεδιασμός μιας εγκατάστασηςΤι χρειάζεται μια εγκατάσταση του Nexus σε Kubernetes πριν πληκτρολογήσετε οποιαδήποτε εντολή, τι μέγεθος έχει και οι δύο αποφάσεις που δεν μπορείτε να ανακαλέσετε: το όνομα της εγκατάστασης και οι θεματοφύλακες κλειδιών. Κλείνει με το συμπληρωμένο φύλλο εργασίας σχεδιασμού του Harrow Port Authority.
- 2.4Λήψη και επαλήθευση μιας έκδοσης (release)Πού βρίσκεται κάθε μέρος μιας έκδοσης (release) του Nexus, πώς γίνεται η λήψη των images της έκδοσης Enterprise με ένα pull token και πώς να αποδείξετε εκτός σύνδεσης ότι κάθε image, chart και αρχείο λήψης προήλθε αναλλοίωτο από την Adverant, πριν εγκαταστήσετε οτιδήποτε.
- 2.5Προέλεγχος (preflight) με το nexusctlΚάθε έλεγχος που εκτελεί η εντολή `nexusctl preflight`, τι διαβάζει ο καθένας και πώς αποτυγχάνει, η αναφορά που εκτυπώνει και αποθηκεύει, πώς αυτή η αναφορά φτάνει στη σελίδα προελέγχου της κονσόλας, καθώς και κάθε παράμετρος (flag).
- 2.6Εγκατάσταση της έκδοσης Community σε KubernetesΜια αριθμημένη εγκατάσταση της έκδοσης Community με το Helm, από το cert-manager έως την ετοιμότητα κάθε workload, με επεξήγηση του αρχείου values κλειδί προς κλειδί, γιατί δεν χρησιμοποιείται η παράμετρος --wait, τη σειρά με την οποία εκτελούνται τα hooks του chart και την εναλλακτική οδό εγκατάστασης μέσω του nexusctl.
- 2.7Εγκατάσταση της έκδοσης Enterprise και εφαρμογή άδειας χρήσηςΤι αλλάζει όταν εγκαθιστάτε την έκδοση Enterprise, πώς να ζητήσετε άδεια χρήσης από τον λογαριασμό σας στην Adverant, οι τρεις τρόποι εισαγωγής της μαζί με κάθε κωδικό απόρριψης, καθώς και πώς η Harrow Port Authority μετέφερε την πιλοτική της εγκατάσταση Community σε Enterprise επιτόπου, χωρίς καμία απώλεια.
- 2.8Εγκαταστάσεις σε ένα μόνο μηχάνημαΕγκαταστήστε το Nexus σε έναν διακομιστή Linux με το nexusctl ή αξιολογήστε το σε έναν φορητό υπολογιστή με το k3d, και συνδεθείτε στην κονσόλα μέσω HTTPS ώστε να λειτουργούν η σύνδεση και τα κλειδιά πρόσβασης (passkeys).
- 2.9Το είδωλο δίσκου του προγράμματος εγκατάστασηςΕκκινήστε έναν γυμνό διακομιστή ή μια εικονική μηχανή από το είδωλο εγκατάστασης του Nexus και αυτό θα εγκαταστήσει το λειτουργικό σύστημα, το k3s, το cert-manager και το Nexus χωρίς δίκτυο, ελέγχοντας κάθε αρχείο πριν χρησιμοποιηθεί.
- 2.10Εγκατάσταση σε απομονωμένο δίκτυο (air-gapped)Μεταφέρετε ένα υπογεγραμμένο πακέτο εκτός σύνδεσης σε μια τοποθεσία χωρίς διαδίκτυο, επαληθεύστε το με ένα κλειδί που φέρατε ξεχωριστά, φορτώστε το στο δικό σας μητρώο (registry) και εγκαταστήστε το. Οι άδειες χρήσης, οι ενημερώσεις και οι λίστες ανάκλησης περνούν επίσης το κενό χειροκίνητα.
- 2.11Παραλλαγές: εξωτερικοί χώροι αποθήκευσης, TLS και ingressΟι τιμές που προσαρμόζουν το Nexus σε μια συστοιχία που δεν είναι κενή, συμπεριλαμβανομένου του TLS (Transport Layer Security), μαζί με βάσεις δεδομένων που ήδη λειτουργείτε, τα δικά σας πιστοποιητικά, άλλον ελεγκτή ingress, κλάσεις αποθήκευσης, ηλεκτρονικό ταχυδρομείο, διακομιστές μεσολάβησης (proxies), αντίγραφα (replicas) και διαχειριζόμενο Kubernetes.
- 2.12Η πρώτη εκτέλεσηΑπό μια αδιεκδίκητη εγκατάσταση στους ανθρώπους εν ώρα εργασίας. Δημιουργήστε τον κωδικό διεκδίκησης, διεκδικήστε την εγκατάσταση σε ένα πρόγραμμα περιήγησης, δημιουργήστε τον πρώτο διαχειριστή με ένα κλειδί πρόσβασης (passkey) και, στη συνέχεια, συνδέστε την εταιρική σύνδεση και προσκαλέστε όλους τους υπόλοιπους.
- 2.13Άδειες χρήσηςΤι περιέχει ένα αρχείο άδειας χρήσης του Nexus, πώς το ελέγχει η εγκατάσταση εκτός σύνδεσης, οι έξι καταστάσεις στις οποίες μπορεί να βρίσκεται και πώς μπορείτε να ζητήσετε, να εισαγάγετε, να ανανεώσετε και να αποσύρετε μια άδεια.
- 2.14Πάροχοι και μοντέλα AIΠώς ο Δρομολογητής Παρόχων τεχνητής νοημοσύνης (AI) επιλέγει ένα μοντέλο από τη δεξαμενή κλειδιών του ίδιου του οργανισμού, και πώς τα σενάρια (scripts) και τα εργαλεία AI αποκτούν πρόσβαση στο Nexus εξωτερικά.
- 2.15Δεύτερη ημέρα: λειτουργία του NexusΟι εργασίες ρουτίνας για τη λειτουργία μιας εγκατάστασης μετά την πρώτη εβδομάδα. Ξεκινούν με την αποσφράγιση του χώρου αποθήκευσης κλειδιών μετά από επανεκκίνηση και καταλήγουν στην απεγκατάσταση.
- 2.16Ασφάλεια και δικτύωσηΤι επιτρέπει μια εγκατάσταση να εισέρχεται και να εξέρχεται, πώς οι υπηρεσίες της αποδεικνύουν η μία στην άλλη την ταυτότητά τους, και οι έλεγχοι που ορίζει ή κληρονομεί ένας χειριστής για τη σύνδεση και τη βάση δεδομένων.
- 2.17Αντιμετώπιση προβλημάτωνΤα προβλήματα που συναντούν συχνότερα οι χειριστές, οργανωμένα με βάση αυτό που βλέπετε. Κάθε περίπτωση παρουσιάζει την αιτία, την εντολή που την επιβεβαιώνει και τη λύση, ενώ το κεφάλαιο κλείνει με την αποστολή ενός πακέτου υποστήριξης.
- 2.18Το μοντέλο επέκτασηςΟι έξι τρόποι επέκτασης του Nexus, από μια ρύθμιση έως ένα πακέτο τομέα (domain pack), τα όρια του καθενός και πώς τα επίπεδα εμπιστοσύνης και απομόνωσης καθορίζουν πού εκτελείται ο κώδικάς σας. Διαβάστε το πριν ανοίξετε το κιτ ανάπτυξης λογισμικού (SDK).
- 2.19Οι κανόνες που κληρονομεί κάθε επέκτασηΑπομόνωση σε τρεις άξονες, υπολογιστική επεξεργασία μέσω UNO, AI (τεχνητή νοημοσύνη) μέσω του δρομολογητή, κλειδιά που ανήκουν στον οργανισμό και έλεγχοι αδειών χρήσης. Τι σημαίνει κάθε κανόνας για τον κώδικά σας, ποια πύλη (gate) τον επιβάλλει και γιατί τον κληρονομείτε αντί να τον γράφετε.
- 2.20Δεξιότητες (Skills)Πώς να γράψετε, να δοκιμάσετε και να δημοσιεύσετε μια δεξιότητα του Skills Engine, πού εμφανίζεται μόλις τεθεί σε λειτουργία και πώς διαφέρουν οι δεξιότητες manifest σε ένα πρόσθετο (plugin). Περιλαμβάνει ένα ολοκληρωμένο παράδειγμα σύνοψης κατανομής θέσεων ελλιμενισμού για τη Harrow Port Authority.
- 2.21Το Plugin SDKΕγκατάσταση του Plugin SDK (κιτ ανάπτυξης λογισμικού), τα εργαλεία γραμμής εντολών του, μια περιήγηση στο πρότυπο πλήρους υπηρεσίας, το manifest έκδοσης v2 πεδίο προς πεδίο, και οι είκοσι δύο πύλες που διασφαλίζουν ότι ένα πρόσθετο τηρεί τους κανόνες.
- 2.22Το περιβάλλον εκτέλεσης προσθέτων (plugin runtime)Οι λειτουργικές μονάδες του SDK (κιτ ανάπτυξης λογισμικού) στις οποίες βασίζεται η εκτέλεση του προσθέτου σας, από τον φύλακα εμβέλειας (scope guard) και τον φράχτη της βάσης δεδομένων έως την αποστολή UNO, την ανάγνωση διαδρομής AI (τεχνητής νοημοσύνης) και τους ελέγχους αδειών χρήσης. Στη συνέχεια, δοκιμές σε πραγματική βάση δεδομένων, καταχώριση των δεξιοτήτων σας και ενσωμάτωση (onboarding).
- 2.23Πακέτα τομέα (Domain packs)Από τι αποτελείται ένα πακέτο τομέα και τι ορίζει το αρχείο pack.json του, φακοί (lenses) και το μητρώο φακών, μοντέλα γνώσης, σύνδεσμοι (connectors) και επικαλύψεις για κινητές συσκευές, πώς αδειοδοτείται και ενεργοποιείται ένα πακέτο για μια μονάδα, καθώς και τα δέκα πακέτα που διαθέτει η Adverant.
- 2.24Δημιουργία μιας προσαρμοσμένης κάθετης λύσης από την αρχή έως το τέλοςΜια ολοκληρωμένη υλοποίηση του πακέτου τομέα Cold chain, από την πρώτη περιγραφή απαιτήσεων έως την έκδοση που εκτελείται για κάθε μονάδα, με το μοντέλο γνώσης του, τις όψεις, μια δεξιότητα, ένα πλήρες πρόσθετο υπηρεσίας και δείγμα δεδομένων. Έπειτα, πώς να επεκτείνετε ένα πακέτο που υπάρχει ήδη και πώς να προσθέσετε μια όψη σε ένα πακέτο που έχει ήδη διατεθεί.
- 2.25Δημιουργία για κάθε έκδοσηΤι αλλάζει όταν μία επέκταση πρέπει να λειτουργεί σε κάθε έκδοση, σε μια απομονωμένη (air-gapped) εγκατάσταση, σε ένα ωφέλιμο φορτίο Nexus Edge ή κάτω από την επωνυμία ενός πελάτη. Καλύπτει το όριο αδειοδότησης για τις λειτουργικές μονάδες Enterprise και την υπογεγραμμένη παράδοση εκτός σύνδεσης, με έναν πίνακα για το τι πρέπει να κάνετε διαφορετικά σε κάθε περιβάλλον προορισμού.
- 2.26Ανάπτυξη με εργαλεία προγραμματισμού AIΠώς να δημιουργείτε επεκτάσεις του Nexus με ασφάλεια χρησιμοποιώντας το Claude Code και άλλα εργαλεία προγραμματισμού AI (τεχνητής νοημοσύνης). Ξεκινά με τη σύνδεση του IDE σας (ολοκληρωμένου περιβάλλοντος ανάπτυξης) με το Workbench και ένα αρχείο έργου CLAUDE.md που περιέχει τους κανόνες της πλατφόρμας, και καταλήγει σε έξι ολοκληρωμένες προτροπές (prompts) και την πύλη ελέγχου που επαληθεύει καθεμία από αυτές.
- 2.27Σενάρια δημιουργίαςΈνας οδηγός με δεκατρείς υλοποιήσεις, από μια μεμονωμένη δεξιότητα έως μια παράδοση σε απομονωμένο περιβάλλον (air-gapped). Κάθε συνταγή παρουσιάζει τον στόχο, τα δομικά στοιχεία, τα βήματα και τις εντολές, την πύλη ελέγχου που αποδεικνύει ότι λειτούργησε, καθώς και τι αλλάζει ανά έκδοση και μορφή παράδοσης.
- 2.28Κυκλοφορία της επέκτασής σαςΠώς ένα πρόσθετο ή ένα πακέτο περνά από μια επιτυχημένη δόμηση στις μονάδες που το εκτελούν, και πώς αποσύρεται ξανά. Εκδόσεις, έλεγχος κυκλοφορίας, κανάλια και εγκαταστάσεις, υπογραφή, εγκρίσεις αλλαγών, η εγγραφή ταυτότητας παράδοσης, μεταφορές (migrations), επαναφορά και απόσυρση μιας έκδοσης.
Παραρτήματα: Αναφορά
- AΠαράρτημα Α: Αναφορά τιμών HelmΚάθε κλειδί που δέχεται το chart του Nexus, ο τύπος του, οι επιτρεπόμενες τιμές του και η προεπιλογή του.
- BΠαράρτημα Β: Πίνακας εκδόσεωνΠοια έκδοση, συμπλήρωμα (add-on) ή πακέτο τομέα περιλαμβάνει κάθε δυνατότητα.
- CΠαράρτημα Γ: Κωδικοί σφαλμάτωνΚάθε κωδικός απόρριψης που συναντά ένας διαχειριστής ή προγραμματιστής, τι σημαίνει και τι πρέπει να κάνετε.
- DΠαράρτημα Δ: Υπηρεσίες και θύρεςΚάθε υπηρεσία που εκτελεί το chart, οι θύρες της και το κλειδί τιμών που τη ρυθμίζει.
- EΠαράρτημα Ε: ΓλωσσάριΟι όροι που χρησιμοποιούνται και στα δύο μέρη, με απλά λόγια.
- FΠαράρτημα ΣΤ: Η αρχιτεκτονική με μια ματιάΟλόκληρη η πλατφόρμα, ο ανοιχτός πυρήνας και ό,τι αδειοδοτείται πάνω σε αυτόν, κάθε τρόπος εκτέλεσης του Nexus και καθένα από τα δέκα πακέτα τομέα, με ένα διάγραμμα για το καθένα.
- GΠαράρτημα Ζ: Λεξικό δεδομένων και μοντέλα γνώσηςΤα πεδία σε κάθε εγγραφή και από τι αποτελείται κάθε πακέτο τομέα.
Λήψη
- Part 1, for everyone (PDF) (ανοίγει σε νέα καρτέλα) 18 MB
- Part 2, technical, with the appendices (PDF) (ανοίγει σε νέα καρτέλα) 40 MB
Τα αρχεία PDF είναι στα αγγλικά.