Έκδοση 1.0.0-alpha.1τελευταία
Κεφάλαιο 2.25
Δημιουργία για κάθε έκδοση
Τι αλλάζει όταν μία επέκταση πρέπει να λειτουργεί σε κάθε έκδοση, σε μια απομονωμένη (air-gapped) εγκατάσταση, σε ένα ωφέλιμο φορτίο Nexus Edge ή κάτω από την επωνυμία ενός πελάτη. Καλύπτει το όριο αδειοδότησης για τις λειτουργικές μονάδες Enterprise και την υπογεγραμμένη παράδοση εκτός σύνδεσης, με έναν πίνακα για το τι πρέπει να κάνετε διαφορετικά σε κάθε περιβάλλον προορισμού.
Αυτή η σελίδα μεταφράστηκε με AI από το αγγλικό πρωτότυπο. Εάν οτιδήποτε είναι ασαφές, η αγγλική σελίδα αποτελεί το σημείο αναφοράς. Διαβάστε αυτή τη σελίδα στα αγγλικά

Στην Corrán Orbital παραδίδουμε σε περισσότερα σημεία από όσα θα συναντήσουν οι περισσότερες ομάδες. Οι δικοί μας μηχανικοί εκτελούν το Enterprise στο έδαφος. Ένας δορυφόρος, ο CORR-3, εκτελεί ένα πακέτο αποστολής στο Nexus Edge. Δύο πελάτες εκτελούν το Community σε έναν μόνο διακομιστή, ένας εκτελεί μια απομονωμένη (air-gapped) εγκατάσταση Enterprise που δεν συνδέεται ποτέ στο διαδίκτυο, και έχουμε δημιουργήσει ένα πακέτο για μια ασφαλιστική εταιρεία στη δική της εγκατάσταση. Ο υποκείμενος κώδικας είναι ως επί το πλείστον ίδιος, και οι διαφορές αφορούν κυρίως το πού επιτρέπεται να φτάσει και πώς φτάνει εκεί.
Αυτό το κεφάλαιο εξετάζει κάθε προορισμό με τη σειρά: σε τι βασίζετε την ανάπτυξη, τι δεν επιτρέπεται να αγγίξετε και πώς το αποτέλεσμα φτάνει στον πελάτη. Ένας πίνακας στο τέλος τα συγκεντρώνει σε μία σελίδα. Το Κεφάλαιο 2.18, Το μοντέλο επεκτάσεων, εξηγεί σε τι διαφέρουν οι δεξιότητες, τα πρόσθετα, τα πακέτα και οι μονάδες. Το Κεφάλαιο 2.2, Οι εκδόσεις στο εσωτερικό τους, περιγράφει τις ίδιες τις εκδόσεις.
Η έκδοση Community και ο ανοιχτός πυρήνας
Το Community είναι ο ανοιχτός πυρήνας, υπό την Apache License, Version 2.0. Μπορείτε να δημιουργήσετε fork και να διανείμετε αλλαγές σε αυτό. Το αρχείο NOTICE που το συνοδεύει αναφέρει κάτι που αξίζει να γνωρίζετε πριν χρησιμοποιήσετε οποιοδήποτε εμπορικό σήμα: η άδεια δεν παραχωρεί χρήση των ονομάτων ή των εμπορικών σημάτων της Adverant πέρα από την αναφορά της προέλευσης του έργου.
Επεκτείνετε το Community με τον ίδιο τρόπο που επεκτείνετε το Enterprise. Το Plugin SDK (κιτ ανάπτυξης λογισμικού) είναι το ίδιο πακέτο και στις δύο εκδόσεις, και ούτε το πλήρες πρότυπο υπηρεσίας ούτε οι 22 πύλες συμμόρφωσης αλλάζουν· το κεφάλαιο 2.21, Το Plugin SDK, το καλύπτει. Οι δεξιότητες λειτουργούν επίσης. Το Community διαθέτει ολόκληρο το εργαλείο δημιουργίας και τη βιβλιοθήκη του Skills Engine, με εκδόσεις και δοκιμές, ενώ οι σταδιακές (canary) εκδόσεις και η έγκριση από δύο πρόσωπα παραμένουν στο Enterprise.
Οι σελίδες για προγραμματιστές στο Community προσφέρουν τις ίδιες προτεινόμενες διαδρομές (golden paths) με τρεις διαφορές που θα αντιληφθείτε αμέσως:
- Ο κώδικάς σας βρίσκεται στο GitHub αντί για τα αποθετήρια της ίδιας της εγκατάστασης. Η προτεινόμενη διαδρομή προσθέτων δημιουργεί ένα αποθετήριο GitHub και έναν χώρο ανάπτυξης από το ίδιο καρφιτσωμένο πρότυπο που χρησιμοποιεί το Enterprise· η οθόνη DV18 δείχνει τη δημιουργία του
room-bookings. - Οι προτεινόμενες διαδρομές πακέτων τομέα και πλατφόρμας ανήκουν στο Enterprise. Στο Community δημιουργείτε πρόσθετα και δεξιότητες, καθώς και φακούς και ροές εργασιών πάνω σε όσα εκτελείτε.
- Τα πάσα του Community σταματούν κάτω από τη βαθμίδα Elevate. Σε έναν μόνο διακομιστή δεν υπάρχει περιβάλλον παραγωγής προς πρόσβαση από ένα IDE (ολοκληρωμένο περιβάλλον ανάπτυξης), και διαχειρίζεστε τον διακομιστή απευθείας. Μια απόπειρα από το IDE απορρίπτεται με
PASS_TIER_REQUIRED.
Ένας χώρος ανάπτυξης Community σε μικρό διακομιστή είναι λιτός. Ο δικός μας είχε 2 πυρήνες και 8 GiB μνήμης, ήταν κλειστός εκτός από όσα δηλώνει το manifest και τερματίστηκε μετά από 7 ημέρες αδράνειας.
Συνεισφορά στο έργο
Το Skills Engine είναι επίσης Apache-2.0 και δέχεται συνεισφορές με τον συνήθη τρόπο. Δημιουργήστε fork του αποθετηρίου, έναν κλάδο από το main, κάντε την αλλαγή μαζί με τις δοκιμές της και εκτελέστε τους ελέγχους πριν ανοίξετε ένα pull request:
git checkout -b feature/skill-synthesis-validation
npm test
npm run lint
npm run typecheckΜια συνεισφορά που αλλάζει τη συμπεριφορά χρειάζεται μια δοκιμή που αποτυγχάνει χωρίς αυτήν. Αυτό δεν είναι θέμα εσωτερικού ύφους: οι ίδιοι οι κανόνες δοκιμών του SDK ορίζουν ότι κάθε νέα δοκιμή πρέπει να αποδεικνύεται ότι αποτυγχάνει στον κώδικα πριν από την αλλαγή, και οι αναθεωρητές ζητούν τα σχετικά αποδεικτικά.
Λειτουργικές μονάδες Enterprise και το όριο αδειοδότησης
Το Enterprise είναι το Community συν αδειοδοτημένες μονάδες. Μια αδειοδοτημένη μονάδα είναι ένα ξεχωριστό τεχνούργημα που φορτώνει μια υπηρεσία Community κατά την εκκίνησή της, και είναι ο τρόπος με τον οποίο οι λειτουργίες του Enterprise, καθώς και κάθε κλειστή μονάδα που δημιουργείτε για πελάτες Enterprise, συνδέονται στον ανοιχτό πυρήνα.
Ο κανόνας που το καθιστά εφικτό είναι η γραμμή αδειοδότησης. Μια κλειστή μονάδα μπορεί να φτάσει στην έκδοση Community μόνο μέσω ενός πακέτου, του @adverant/nexus-spi, της διεπαφής παρόχου υπηρεσιών. Είναι Apache-2.0 και περιέχει διεπαφές καθώς και τους ελέγχους τύπων (type guards) που χρησιμοποιούν ο κεντρικός υπολογιστής (host) και μια μονάδα για να ελέγχουν ο ένας τον άλλον, χωρίς άλλη λογική εκτέλεσης. Η σύζευξη πέρα από τη γραμμή γίνεται μέσω διεπαφής ή πρωτοκόλλου δικτύου, ποτέ μέσω πηγαίου κώδικα.
| Εξαγωγή | Τι είναι |
|---|---|
RouteModule |
Μια αδειοδοτημένη μονάδα διαδρομών: id, featureGroup, bodies και register(app, ctx), η οποία προσαρτά τους δρομολογητές της στην εφαρμογή του host |
SpiApp |
Το μέρος της εφαρμογής HTTP του κεντρικού συστήματος (host) με το οποίο αλληλεπιδρά μια λειτουργική μονάδα: use |
SpiContext |
Τι παραδίδει ο host σε μια μονάδα: την πύλη προϊόντος και τον έλεγχο εμβέλειας, τον αναγνώστη αδειών, τη δεξαμενή ερωτημάτων με εμβέλεια, το σχήμα της υπηρεσίας, τις διευθύνσεις των ανάντη υπηρεσιών και τους πελάτες της πλατφόρμας |
SpiRuntime |
Οι τιμές του plugin SDK που παραδίδει ο host σε μια μονάδα, ώστε η μονάδα να μην εισάγει ποτέ η ίδια το runtime του SDK |
SpiPlane |
Τι προσθέτει ένα αδειοδοτημένο επίπεδο πέρα από τις διαδρομές, όπως οι αναγνώσεις οθονών που εξυπηρετεί |
ScreenModule |
Μια αδειοδοτημένη ομάδα οθονών της κονσόλας: group, featureGroup, routes, screens και menu |
GrantCheck |
(featureGroup) => Promise<{ entitled, code?: 'LICENCE_LOCKED' }> |
Το πλαίσιο HTTP και ο τύπος οθόνης της κονσόλας είναι παράμετροι τύπου, ώστε η διεπαφή να μη δεσμεύει κανένα από τα δύο. Ακολουθεί ο σκελετός μιας μονάδας διαδρομών, με τύπο χειριστή Express:
import type { GrantCheck, RouteModule, SpiApp, SpiContext } from "@adverant/nexus-spi";
import { Router, type RequestHandler } from "express";
export function auditTrail(checkGrant: GrantCheck): RouteModule<RequestHandler> {
return {
id: "audit-trail",
featureGroup: "<feature-group>",
bodies: [],
register(app: SpiApp<RequestHandler>, ctx: SpiContext<RequestHandler>) {
const router = Router();
router.get("/api/audit-trail", ...ctx.requireScope, async (_req, res) => {
const verdict = await checkGrant("<feature-group>");
if (!verdict.entitled) {
res.status(403).json({
error: true,
code: verdict.code,
message: "This organisation's licence does not carry the audit trail.",
troubleshooting: ["An owner or administrator can turn it on with a licence from Adverant."],
});
return;
}
res.json({ entries: [] });
});
app.use(router);
},
};
}Το <feature-group> είναι η ομάδα λειτουργιών του πίνακα εκδόσεων που εξυπηρετεί η μονάδα. Κάθε αδειοδοτημένη διαδρομή εκτελείται πίσω από το ctx.requireScope, την πύλη προϊόντος και τον έλεγχο εμβέλειας του host, και η μονάδα ελέγχει επίσης τη δική της παραχώρηση πριν απαντήσει. Μια μονάδα χωρίς δικαίωμα απορρίπτει με LICENCE_LOCKED και εμφανίζει την προεπισκόπηση της λειτουργίας, ποτέ τα δεδομένα της. Η μονάδα σας επίσης δεν εισάγει ποτέ το runtime του plugin SDK, επειδή το SDK είναι πακέτο Community που η γραμμή δεν επιτρέπει. Ο host της παραδίδει τις τιμές του SDK που καλεί. Πριν φορτώσει οποιαδήποτε μονάδα, ο host εγκαθιστά ένα SpiHost στο globalThis υπό το Symbol.for(SPI_HOST_KEY), που περιέχει το runtime του SDK και το δικό της κιτ διαδρομών της εφαρμογής. Αυτό πρέπει να γίνει πρώτο: μια μονάδα μεταγλωττισμένη σε ένα bundle αξιολογείται ως σύνολο, και μια κλήση register θα ερχόταν πολύ αργά για κώδικα που διαβάζει τις τιμές του SDK κατά τη φόρτωση. Για τους τύπους, το @adverant/nexus-spi/sdk/<module> επανεξάγει τις δηλώσεις του SDK, ενσωματωμένες αμετάβλητες από μία έκδοση του SDK και καρφιτσωμένες με checksum, ώστε η μονάδα σας να ελέγχεται ως προς τους τύπους με βάση τα ίδια σώματα απόρριψης και τους ίδιους πελάτες που χρησιμοποιεί ένα πρόσθετο.
Μια μονάδα οθονών ακολουθεί έναν ακόμη κανόνα: μία μονάδα ανά ομάδα λειτουργιών, οπότε μια ομάδα της οποίας οι οθόνες ανήκουν σε δύο ομάδες λειτουργιών διανέμεται ως δύο μονάδες, και μόνο μία από αυτές φέρει τη γραμμή μενού.
Τι απορρίπτει η πύλη της γραμμής αδειοδότησης
Η πύλη της γραμμής αδειοδότησης της Adverant υποχρεώνει κάθε μονάδα Enterprise να τηρεί τη γραμμή, και αξίζει να υποχρεώνετε και τις δικές σας κλειστές μονάδες στον ίδιο κανόνα. Η διαμόρφωσή της είναι ένα αρχείο:
{
"communityScopes": ["@adverant/", "@adverant-nexus/"],
"allowedCommunityPackages": ["@adverant/nexus-spi"],
"enterprisePrefixes": ["@adverant/enterprise-", "@adverant-enterprise/"],
"communityRepos": ["nexus-community", "nexus-core", "Adverant-Nexus-Open-Core"],
"allowedCommunityGoModules": []
}Καθένα από τα παρακάτω αποτελεί εύρημα με το αρχείο και τη γραμμή του:
- κάθε εισαγωγή πακέτου υπό εμβέλεια Community που δεν είναι η επιτρεπόμενη διεπαφή ή πακέτο Enterprise, συμπεριλαμβανομένων των δυναμικών εισαγωγών·
- κάθε προσδιοριστής, διαδρομή εισαγωγής Go ή URL εξάρτησης που κατονομάζει αποθετήριο Community, εκτός αν πρόκειται για μονάδα Go που περιλαμβάνεται στο
allowedCommunityGoModules· - μια σχετική εισαγωγή που βγαίνει έξω από το αποθετήριο·
- μια εξάρτηση
package.jsonπου είναι διαδρομήfile:,link:,portal:ήworkspace:εκτός του αποθετηρίου, ή URL Git προς αποθετήριο Community· - ένα
go.modreplaceπου δείχνει εκτός του αποθετηρίου.
Τερματίζει με 0 όταν δεν υπάρχουν ευρήματα και με 1 όταν υπάρχουν. Ο κωδικός εξόδου 2 σημαίνει ότι αρνήθηκε να εκτελεστεί, επειδή η διαμόρφωσή της ήταν εσφαλμένη ή δεν σάρωσε τίποτα. Το πακέτο διεπαφής δεν δημοσιεύεται σε μητρώο. Διατηρείτε ένα αντίγραφο του μεταγλωττισμένου πακέτου, καρφιτσωμένο σε επίπεδο byte, μέσα στο αποθετήριό σας ως τοπικό πακέτο file:, με καρφίτσωμα SHA256SUMS και έναν έλεγχο στη ροή σας (pipeline) που απορρίπτει αντίγραφο που διαφέρει. Επειδή το αντίγραφο βρίσκεται μέσα στο αποθετήριο, η πύλη το αποδέχεται.
Δομήσεις ανά έκδοση
Αν η επέκτασή σας διανέμεται σε πελάτες και των δύο εκδόσεων, τη δημιουργείτε μία φορά ανά έκδοση, και κάθε δημιουργία γίνεται στο δικό της συντεθειμένο δέντρο. Η σύνθεση ενός δέντρου σημαίνει ότι λαμβάνονται μόνο τα αρχεία που ανήκουν στη συγκεκριμένη έκδοση. Η εξαγωγή της ίδιας της Adverant το κάνει αυτό με βάση μια λίστα ορίων στην οποία κάθε παρακολουθούμενο αρχείο αντιστοιχίζεται με κανόνες όπου επικρατεί η πρώτη αντιστοίχιση: ένας κανόνας κατονομάζει μια δυνατότητα και η έκδοση του αρχείου προκύπτει από τη βαθμίδα της δυνατότητας αυτής στον πίνακα εκδόσεων, ή κατονομάζει μια κατηγορία αρχείων που δεν διανέμεται σε καμία έκδοση, με αιτιολόγηση. Τα αρχεία που αφορούν μόνο τη δημιουργία διανέμονται στο δέντρο Enterprise και, όταν έχουν επισημανθεί, και στο δέντρο Community. Η αλυσίδα μεταναστεύσεων μιας μονάδας αποτελεί δεδομένα του προγράμματος εγκατάστασης και διανέμεται στο δέντρο κάθε έκδοσης.
Στη συνέχεια εκτελέστε ολόκληρη τη δημιουργία από καθαρή κατάσταση σε κάθε συντεθειμένο δέντρο. Αυτό σημαίνει και τις τρεις εντολές, κάθε φορά:
npm ci
npm test
npm run buildΤο μάθαμε με τον ακριβό τρόπο: ένα δέντρο Enterprise πέρασε τις δοκιμές του ενώ το δέντρο Community απέτυχε στη δημιουργία παραγωγής, επειδή ένας τύπος που χρειαζόταν βρισκόταν μόνο σε αρχείο Enterprise. Η επιτυχία των δοκιμών σε ένα δέντρο δεν σας λέει τίποτα για το άλλο. Οι δοκιμές μιας έκδοσης μπορούν να εισάγουν μόνο όσα περιέχει το δέντρο της έκδοσης αυτής, και η εξαγωγή απορρίπτει δοκιμή που φτάνει εκτός του.
Η εξαγωγή γράφει επίσης την άδεια κάθε έκδοσης. Τα αρχεία Community φέρουν το αναγνωριστικό SPDX (Software Package Data Exchange) Apache-2.0· τα αρχεία Enterprise φέρουν το LicenseRef-Adverant-Enterprise και το package.json τους αναφέρει UNLICENSED. Μην επεξεργάζεστε χειροκίνητα αυτά τα πεδία: η εξαγωγή τα ξαναγράφει, και ένα αντίγραφο που δεν ταιριάζει πλέον με το καρφιτσωμένο κείμενο της άδειάς του απορρίπτεται.
Team: μόνο στο cloud
Το Team είναι το Community συν το σύνολο Team, και εκτελείται μόνο στο Adverant cloud. Δεν υπάρχει αυτο-φιλοξενούμενο Team. Το σύνολο Team προσθέτει έξι δυνατότητες πάνω από το Community, μεταξύ των οποίων το ενοποιημένο πάνελ εργασιών, τα κοινόχρηστα σημειωματάρια, η διαχείριση της βιβλιοθήκης δεξιοτήτων και οι λειτουργίες ροών εργασιών με προώθηση μεταξύ περιβαλλόντων.
Για έναν δημιουργό, το «μόνο cloud» σημαίνει ένα πράγμα: ένας πελάτης Team λαμβάνει το πρόσθετό σας ως υπογεγραμμένη έκδοση μέσω του καταλόγου, ποτέ από τους δικούς σας διακομιστές. Το δημιουργείτε όπως ένας εξωτερικός εκδότης, σε ένα cluster εκδότη.
Ένα cluster εκδότη είναι ένα εικονικό cluster στο Adverant cloud με όριο πόρων που ορίζει η Adverant. Περιέχει μόνο δείγματα δεδομένων και δεν έχει διαδρομή προς κανέναν πελάτη. Αίτημα για αντίγραφο δεδομένων πελάτη με απόκρυψη εκεί απορρίπτεται με TENANT_BOUNDARY· ένας πελάτης μπορεί να μοιραστεί μαζί σας αποτελέσματα δοκιμών, ποτέ τα δεδομένα του. Το πάσο σας σε αυτό δεν φτάνει ποτέ μέσα σε πελάτη. Όταν η έκδοση είναι έτοιμη, υπογράφεται και αξιολογείται από την Adverant πριν καταχωριστεί στον κατάλογο. Κάθε πελάτης επιλέγει στη συνέχεια αν θα την εγκαταστήσει και της παραχωρεί μόνο όσα δηλώνει το manifest της, μονάδα προς μονάδα. Μια κλήση προς οτιδήποτε δεν δήλωσε το manifest απορρίπτεται στην πλευρά του πελάτη με CONNECTION_SCOPE_EXCEEDED, και ο μόνος τρόπος να προστεθεί είναι μια νέα έκδοση την οποία αξιολογεί ο πελάτης.
Πελάτες σε απομονωμένο περιβάλλον (air-gapped)
Ένας από τους πελάτες μας εκτελεί το Nexus σε περιβάλλον όπου τίποτα δεν εισέρχεται ούτε εξέρχεται μέσω δικτύου. Η εγκατάστασή του περιγράφεται στο κεφάλαιο 2.10, Απομονωμένη εγκατάσταση. Για εμάς αυτό σήμαινε διανομή του προσθέτου μας σε υπογεγραμμένα μέσα, και το εργαλείο για αυτό είναι το nexus-airgap, από το κιτ κυρίαρχης παράδοσης @adverant/nexus-sovereign.
Ένα σφραγισμένο bundle είναι ένα υπογεγραμμένο, αυτοτελές tarball. Μπορεί να περιέχει images και μεταναστεύσεις, προϋπογεγραμμένες δεξιότητες και βάρη μοντέλων, καθώς και ένα SBOM (κατάλογο υλικών λογισμικού) με τις άδειες όλων όσων περιέχει. Το manifest του απαριθμεί κάθε αρχείο με το SHA-256 του και είναι υπογεγραμμένο με Ed25519. Η δημιουργία ενός από κώδικα μοιάζει ως εξής:
import { SealedBundleExporter } from "@adverant/nexus-sovereign";
const { bundleDigest } = await new SealedBundleExporter().export(source, {
outPath: "./cold-chain-0.4.0.tar.gz",
profile: "airgap",
signerPrivateKeyPem,
});Το signerPrivateKeyPem είναι το κλειδί υπογραφής των εκδόσεών σας. Η εντολή nexus-airgap bundle κάνει το ίδιο από τη γραμμή εντολών. Ο διαχειριστής του πελάτη στη συνέχεια το ελέγχει πριν από οτιδήποτε άλλο:
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapΗ επαλήθευση υπολογίζει εκ νέου το hash κάθε αρχείου σε σύγκριση με το manifest, απορρίπτει κάθε αρχείο που δεν απαριθμεί το manifest, απαιτεί έμπιστο υπογράφοντα Ed25519 και απορρίπτει κάθε bundle του οποίου η λίστα επιτρεπόμενων δικτύων δεν είναι κενή. Ένα αρχείο που άλλαξε μετά την υπογραφή αποτυγχάνει με BUNDLE_INTEGRITY_VIOLATION. Ενημερώστε τον διαχειριστή να σταματήσει εκεί και να επικοινωνήσει μαζί σας· υπάρχει διακόπτης μη αυστηρής λειτουργίας, και δεν πρέπει να τον χρησιμοποιήσει ποτέ.
Τρεις κανόνες στήριξαν την παράδοσή μας:
- Το έμπιστο κλειδί μεταφέρεται χωριστά από το bundle. Στέλνουμε το δημόσιο κλειδί και το SHA-256 του bundle από διαφορετική οδό από τα μέσα, ώστε ένα bundle να μην μπορεί να εγγυηθεί για τον εαυτό του.
- Τίποτα στο bundle δεν επιτρέπεται να χρειάζεται το δίκτυο κατά την εγκατάσταση. Καμία λήψη πακέτων, καμία λήψη μοντέλων, καμία κλήση αδειοδότησης. Αν το πρόσθετο χρειάζεται μοντέλο, ο δικός του διακομιστής μοντέλων του πελάτη το παρέχει μέσω του AI (τεχνητή νοημοσύνη) Provider Router.
- Μετά την επαλήθευση, ο διαχειριστής εισάγει την έκδοση μέσω των δικών καναλιών εκδόσεων της εγκατάστασης, ακριβώς όπως θα έκανε ένας συνδεδεμένος πελάτης. Το bundle είναι ο τρόπος με τον οποίο φτάνουν τα bytes, όχι τρόπος παράκαμψης των πυλών προώθησης.
Η εργασία σε απομονωμένα περιβάλλοντα είναι πιο αργή, και αυτό δεν διορθώνεται από τη δική μας πλευρά. Ένα λανθασμένο byte κοστίζει ένα νέο σύνολο μέσων και ακόμη ένα ταξίδι, γι' αυτό επαληθεύουμε οι ίδιοι το bundle σε καθαρό μηχάνημα με την ίδια εντολή πριν φύγει από το κτίριο.
Πακέτα αποστολής Nexus Edge
Το Nexus Edge είναι ένα μικρότερο Nexus που εκτελείται σε δορυφόρους και drones, σε υπολογιστές αποστολής που διατηρούνται χωριστά από τον υπολογιστή πτήσης. Είναι ένα πρόσθετο με άδεια ανά πλατφόρμα ή στόλο. Αυτό που αλλάζει από τη μία αποστολή στην άλλη είναι το πακέτο αποστολής, και η κατασκευή τους αποτελεί σημαντικό μέρος της δουλειάς μου.
Ένα πακέτο αποστολής περιέχει ό,τι χρειάζεται το ωφέλιμο φορτίο για μία αποστολή. Μαζί με τα μοντέλα και τους προσαρμογείς του, περιλαμβάνει την οντολογία με έναν αρχικό γράφο, βήματα πρακτόρων, κανόνες ειδοποιήσεων, τις προτεραιότητες για το τι κατεβαίνει πρώτο, έναν πίνακα τοποθέτησης που ορίζει ποιος υπολογιστής εκτελεί τι, τα υποβαθμισμένα βήματα στα οποία μπορεί να μεταπέσει η πλατφόρμα όταν ένας υπολογιστής αστοχεί, και τις περιπτώσεις ελέγχου που πρέπει να περάσει επί του σκάφους.
Τα πακέτα κατασκευάζονται και υπογράφονται στο έδαφος. Ορισμένοι πρακτικοί κανόνες από τις δικές μας κατασκευές:
- Διατηρείτε σταθερά τα μεγάλα μέρη. Το Maritime watch 1.5 πρόσθεσε έναν προσαρμογέα εντοπισμού πλοίων και δύο κανόνες ειδοποιήσεων· το γλωσσικό μοντέλο και η οντολογία δεν άλλαξαν, οπότε το πακέτο ήταν 412 MB αντί για 9.8 GB. Η άνω ζεύξη είναι στενή, και τα βασικά μοντέλα φορτώνονται πριν από την εκτόξευση.
- Χρησιμοποιείτε ένα μοντέλο ενσωμάτωσης για ολόκληρη την οικογένεια αποστολών, τόσο στο έδαφος όσο και στο ωφέλιμο φορτίο, ώστε οι αλλαγές του γράφου που κατεβαίνουν να μπορούν να συγχωνευθούν με τον γράφο εδάφους.
- Το ωφέλιμο φορτίο δεν στέλνει ποτέ εντολή στα συστήματα πτήσης. Στέλνει τυποποιημένα αιτήματα μέσω του επόπτη στον υπολογιστή πτήσης, ο οποίος απαντά σε καθένα με αιτιολογία.
- Κάθε τύπος υλικού χρειάζεται τον δικό του έλεγχο του πακέτου. Η εγκατάσταση ενός πακέτου που δεν έχει ελεγχθεί για το υλικό μιας συσκευής απορρίπτεται με
PACK_NOT_CHECKED_FOR_HARDWARE.
Η έκδοση απαιτεί δύο από τρεις υπογραφές. Η δική μας και της Adverant είναι το συνηθισμένο ζεύγος, και η τρίτη είναι ένα κλειδί εκτός σύνδεσης που φυλάσσουμε σε χρηματοκιβώτιο για την περίπτωση που χαθεί ένα από τα άλλα δύο. Το πακέτο ανεβαίνει στην αδρανή υποδοχή, επαληθεύεται, εκτελεί τις περιπτώσεις ελέγχου του στις πραγματικές πλακέτες και ενεργοποιείται μόνο αν περάσουν όλες, με έναν μετρητή που αποτρέπει την επανεγκατάσταση παλαιότερου πακέτου. Αν ένας έλεγχος αποτύχει, η πλατφόρμα παραμένει στο προηγούμενο πακέτο και η αποτυχία κατεβαίνει στο επόμενο πέρασμα. Διανέμουμε σε μία πλατφόρμα τη φορά, καθεμία μετά από μία εβδομάδα χωρίς προβλήματα. Τα πακέτα παραμένουν έγκυρα όσο μια πλατφόρμα είναι εκτός επικοινωνίας, οπότε ένας δορυφόρος χωρίς ζεύξη συνεχίζει να λειτουργεί με το πακέτο που έχει.
Σε οχήματα και σκάφη το Edge μπορεί να εκτελείται σε k3s. Ένα διαστημόπλοιο εκτελεί έναν επόπτη με υπογεγραμμένα images ή στατικά εκτελέσιμα και έναν σταθερό πίνακα τοποθέτησης αντί για Kubernetes, και γι' αυτό ο πίνακας τοποθέτησης ταξιδεύει μέσα στο πακέτο.
Καταστήματα white-label
Το πρόσθετο Storefront / white-label επιτρέπει σε έναν πελάτη να εφαρμόσει τη δική του επωνυμία και τον δικό του τομέα σε ό,τι βλέπουν οι χρήστες του, με τις δικές του οθόνες σύνδεσης, και να δέχεται πληρωμές μέσω των δικών του πυλών. Τα στοιχεία καρτών δεν αγγίζουν ποτέ το Nexus.
Ένα plugin που κατασκευάζεται για πελάτη white-label δεν πρέπει ποτέ να εμφανίζει την Adverant. Το manifest περιέχει όλα τα στοιχεία που αφορούν την επωνυμία, και η πλατφόρμα επιλύει τα υπόλοιπα από την επωνυμία του ίδιου του οργανισμού και όχι από οτιδήποτε είναι ενσωματωμένο στον κώδικά σας:
{
"domains": [
{ "primary": "<app-domain>", "aliases": ["www.<app-domain>"] }
],
"branding": {
"appName": "<app name>",
"tagline": "<one line>",
"primaryColor": "<hex>",
"accentColor": "<hex>",
"passkeyRpId": "<app-domain>",
"oauthClientRef": "brand:<plugin name>:google"
}
}Το <app-domain> είναι ο δικός τομέας του πελάτη, και το passkeyRpId πρέπει να συμφωνεί με αυτόν, επειδή τα passkeys συνδέονται με τον τομέα στον οποίο συνδέεται ένα άτομο. Μια web εφαρμογή στη δική της προέλευση συνδέει τους χρήστες μέσω των βοηθητικών λειτουργιών σύνδεσης του SDK, των οποίων οι δύο δημόσιες διαδρομές είναι οι μόνες απροστάτευτες διαδρομές /api που δέχεται η πύλη εμβέλειας, και μόνο όταν το manifest τις δηλώνει auth: public με allowAnonymous: true. Οι κλήσεις του frontend περνούν μέσω του διακομιστή μεσολάβησης λίστας επιτρεπόμενων του backend for frontend, ποτέ απευθείας σε διεύθυνση υπηρεσίας. Ο διαχειριστής του πελάτη ρυθμίζει το σκέλος των πληρωμών, από τις πύλες έως το επώνυμο checkout. Το plugin σας όχι.
Ο πίνακας
| Στόχος κατασκευής | Κατασκευή με βάση | Τι κάνετε διαφορετικά | Πώς φτάνει στον πελάτη |
|---|---|---|---|
| Community | Plugin SDK, Skills Engine | Κώδικας στο GitHub· χωρίς domain pack ή διαδρομές πλατφόρμας· χωρίς Elevate | Ο πελάτης το εγκαθιστά· δεν απαιτείται έλεγχος καταλόγου |
| Enterprise (η δική σας εγκατάσταση) | Plugin SDK, Skills Engine, πρότυπα πακέτων | Χώροι ανάπτυξης, κλάδοι δεδομένων, αντίγραφα με απόκρυψη μαζί με τον κάτοχο των δεδομένων· πακέτα και lenses | Προώθηση από το staging σε πιλοτική μονάδα και στη συνέχεια παντού |
| Enterprise module (κλειστό) | Μόνο @adverant/nexus-spi |
Κανόνας γραμμής άδειας· έλεγχος δικαιωμάτων στη δική του ομάδα λειτουργιών· LICENCE_LOCKED όταν δεν υπάρχει δικαίωμα |
Φορτώνεται από μια υπηρεσία Community κατά την εκκίνηση, σε αδειοδοτημένες εγκαταστάσεις |
| Και οι δύο εκδόσεις | Plugin SDK | Σύνθεση του δέντρου κάθε έκδοσης· npm ci, έλεγχοι και κατασκευή παραγωγής σε καθεμία |
Μία έκδοση κυκλοφορίας ανά έκδοση προϊόντος |
| Team | Plugin SDK σε publisher cluster | Μόνο δείγματα δεδομένων· μόνο cloud | Υπογεγραμμένη έκδοση, έλεγχος από την Adverant, κατάλογος |
| Air-gapped | Plugin SDK, @adverant/nexus-sovereign |
Σφραγισμένο πακέτο· κλειδί και checksum αποστέλλονται χωριστά· τίποτα δεν λαμβάνεται κατά την εγκατάσταση | Υπογεγραμμένα μέσα, επαληθευμένα, και στη συνέχεια τα κανάλια έκδοσης της εγκατάστασης |
| Nexus Edge | Περιεχόμενα πακέτου αποστολής | Πίνακας τοποθέτησης, υποβαθμισμένα βήματα, έλεγχοι επί του σκάφους, έλεγχοι υλικού | Δύο από τρεις υπογραφές, αδρανής υποδοχή, ενεργοποίηση αφού περάσουν οι έλεγχοι |
| Λευκή ετικέτα | Plugin SDK | domains και branding στο manifest· πουθενά το όνομα Adverant |
Όπως για το Enterprise, στον δικό τομέα του πελάτη |
Όποιος κι αν είναι ο στόχος, η ανάπτυξη γίνεται μόνο μέσω των καναλιών έκδοσης της εγκατάστασης. Το Κεφάλαιο 2.28, Έκδοση της επέκτασής σας, καλύπτει αυτά τα κανάλια. Το Κεφάλαιο 2.27, Σενάρια κατασκευής, περιέχει μια συνταγή για κάθε γραμμή παραπάνω.



