ΣύνδεσηΚλείστε μια ενημέρωση

Κεφάλαιο 2.25

Δημιουργία για κάθε έκδοση

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

Αυτή η σελίδα μεταφράστηκε με AI από το αγγλικό πρωτότυπο. Εάν οτιδήποτε είναι ασαφές, η αγγλική σελίδα αποτελεί το σημείο αναφοράς. Διαβάστε αυτή τη σελίδα στα αγγλικά

17 λεπτά ανάγνωσης

Στην 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
Ανάπτυξη στην έκδοση Community
Δημιουργία ενός προσθέτου κρατήσεων σε έναν μόνο διακομιστή Community. Προσέξτε το πάσο πρόσβασης, που φτάνει έως το Propose μέσω GitHub και δεν προσφέρει Elevate, καθώς και την προεπισκόπηση στα δεξιά που απαριθμεί όσα προσθέτει το Enterprise.

Οι σελίδες για προγραμματιστές στο Community προσφέρουν τις ίδιες προτεινόμενες διαδρομές (golden paths) με τρεις διαφορές που θα αντιληφθείτε αμέσως:

  1. Ο κώδικάς σας βρίσκεται στο GitHub αντί για τα αποθετήρια της ίδιας της εγκατάστασης. Η προτεινόμενη διαδρομή προσθέτων δημιουργεί ένα αποθετήριο GitHub και έναν χώρο ανάπτυξης από το ίδιο καρφιτσωμένο πρότυπο που χρησιμοποιεί το Enterprise· η οθόνη DV18 δείχνει τη δημιουργία του room-bookings.
  2. Οι προτεινόμενες διαδρομές πακέτων τομέα και πλατφόρμας ανήκουν στο Enterprise. Στο Community δημιουργείτε πρόσθετα και δεξιότητες, καθώς και φακούς και ροές εργασιών πάνω σε όσα εκτελείτε.
  3. Τα πάσα του 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.mod replace που δείχνει εκτός του αποθετηρίου.

Τερματίζει με 0 όταν δεν υπάρχουν ευρήματα και με 1 όταν υπάρχουν. Ο κωδικός εξόδου 2 σημαίνει ότι αρνήθηκε να εκτελεστεί, επειδή η διαμόρφωσή της ήταν εσφαλμένη ή δεν σάρωσε τίποτα. Το πακέτο διεπαφής δεν δημοσιεύεται σε μητρώο. Διατηρείτε ένα αντίγραφο του μεταγλωττισμένου πακέτου, καρφιτσωμένο σε επίπεδο byte, μέσα στο αποθετήριό σας ως τοπικό πακέτο file:, με καρφίτσωμα SHA256SUMS και έναν έλεγχο στη ροή σας (pipeline) που απορρίπτει αντίγραφο που διαφέρει. Επειδή το αντίγραφο βρίσκεται μέσα στο αποθετήριο, η πύλη το αποδέχεται.

Δύο μεγάλα πλαίσια το ένα δίπλα στο άλλο. Το αριστερό πλαίσιο φέρει την ετικέτα "Community (Apache-2.0)" και περιέχει μικρότερα πλαίσια για "Υπηρεσίες", "Plugin SDK" και "@adverant/nexus-spi". Το δεξί πλαίσιο φέρει την ετικέτα "Enterprise module (κλειστό)" και περιέχει "RouteModule", "ScreenModule" και "GrantCheck". Ένα συμπαγές βέλος διασχίζει τη γραμμή, από το δεξί πλαίσιο μόνο προς το "@adverant/nexus-spi", με την ετικέτα "μεταγλώττιση με βάση". Δύο διακεκομμένα βέλη από το δεξί πλαίσιο προς τις "Υπηρεσίες" και το "Plugin SDK" είναι διαγραμμένα και φέρουν την ετικέτα "πύλη γραμμής άδειας: εύρημα".
Η γραμμή αδειοδότησης μεταξύ Community και μιας μονάδας Enterprise.

Δομήσεις ανά έκδοση

Αν η επέκτασή σας διανέμεται σε πελάτες και των δύο εκδόσεων, τη δημιουργείτε μία φορά ανά έκδοση, και κάθε δημιουργία γίνεται στο δικό της συντεθειμένο δέντρο. Η σύνθεση ενός δέντρου σημαίνει ότι λαμβάνονται μόνο τα αρχεία που ανήκουν στη συγκεκριμένη έκδοση. Η εξαγωγή της ίδιας της 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 εκδότη
Publisher cluster
Το δικό του εικονικό cluster ενός εκδότη στο Adverant cloud, μόνο με δείγματα δεδομένων. Ακολουθήστε τη ζωντανή ροή στο επάνω μέρος: το IDE φτάνει στο 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. Ενημερώστε τον διαχειριστή να σταματήσει εκεί και να επικοινωνήσει μαζί σας· υπάρχει διακόπτης μη αυστηρής λειτουργίας, και δεν πρέπει να τον χρησιμοποιήσει ποτέ.

Τρεις κανόνες στήριξαν την παράδοσή μας:

  1. Το έμπιστο κλειδί μεταφέρεται χωριστά από το bundle. Στέλνουμε το δημόσιο κλειδί και το SHA-256 του bundle από διαφορετική οδό από τα μέσα, ώστε ένα bundle να μην μπορεί να εγγυηθεί για τον εαυτό του.
  2. Τίποτα στο bundle δεν επιτρέπεται να χρειάζεται το δίκτυο κατά την εγκατάσταση. Καμία λήψη πακέτων, καμία λήψη μοντέλων, καμία κλήση αδειοδότησης. Αν το πρόσθετο χρειάζεται μοντέλο, ο δικός του διακομιστής μοντέλων του πελάτη το παρέχει μέσω του AI (τεχνητή νοημοσύνη) Provider Router.
  3. Μετά την επαλήθευση, ο διαχειριστής εισάγει την έκδοση μέσω των δικών καναλιών εκδόσεων της εγκατάστασης, ακριβώς όπως θα έκανε ένας συνδεδεμένος πελάτης. Το bundle είναι ο τρόπος με τον οποίο φτάνουν τα bytes, όχι τρόπος παράκαμψης των πυλών προώθησης.

Η εργασία σε απομονωμένα περιβάλλοντα είναι πιο αργή, και αυτό δεν διορθώνεται από τη δική μας πλευρά. Ένα λανθασμένο byte κοστίζει ένα νέο σύνολο μέσων και ακόμη ένα ταξίδι, γι' αυτό επαληθεύουμε οι ίδιοι το bundle σε καθαρό μηχάνημα με την ίδια εντολή πριν φύγει από το κτίριο.

Πακέτα αποστολής Nexus Edge

Το Nexus Edge είναι ένα μικρότερο Nexus που εκτελείται σε δορυφόρους και drones, σε υπολογιστές αποστολής που διατηρούνται χωριστά από τον υπολογιστή πτήσης. Είναι ένα πρόσθετο με άδεια ανά πλατφόρμα ή στόλο. Αυτό που αλλάζει από τη μία αποστολή στην άλλη είναι το πακέτο αποστολής, και η κατασκευή τους αποτελεί σημαντικό μέρος της δουλειάς μου.

Ένα πακέτο αποστολής περιέχει ό,τι χρειάζεται το ωφέλιμο φορτίο για μία αποστολή. Μαζί με τα μοντέλα και τους προσαρμογείς του, περιλαμβάνει την οντολογία με έναν αρχικό γράφο, βήματα πρακτόρων, κανόνες ειδοποιήσεων, τις προτεραιότητες για το τι κατεβαίνει πρώτο, έναν πίνακα τοποθέτησης που ορίζει ποιος υπολογιστής εκτελεί τι, τα υποβαθμισμένα βήματα στα οποία μπορεί να μεταπέσει η πλατφόρμα όταν ένας υπολογιστής αστοχεί, και τις περιπτώσεις ελέγχου που πρέπει να περάσει επί του σκάφους.

Κατασκευή πακέτου αποστολής
Κατασκευή πακέτου αποστολής
Κατασκευή του Maritime watch 1.5 από το 1.4. Προσέξτε τις περιπτώσεις ελέγχου επί του σκάφους (48, όλες πρέπει να περάσουν) και τον πίνακα τοποθέτησης, ο οποίος ορίζει τι εκτελείται σε καθεμία από τις δύο πλακέτες GPU (μονάδα επεξεργασίας γραφικών) και στην πλακέτα CPU (κεντρική μονάδα επεξεργασίας) σε κάθε υποβαθμισμένο βήμα.

Τα πακέτα κατασκευάζονται και υπογράφονται στο έδαφος. Ορισμένοι πρακτικοί κανόνες από τις δικές μας κατασκευές:

  • Διατηρείτε σταθερά τα μεγάλα μέρη. Το Maritime watch 1.5 πρόσθεσε έναν προσαρμογέα εντοπισμού πλοίων και δύο κανόνες ειδοποιήσεων· το γλωσσικό μοντέλο και η οντολογία δεν άλλαξαν, οπότε το πακέτο ήταν 412 MB αντί για 9.8 GB. Η άνω ζεύξη είναι στενή, και τα βασικά μοντέλα φορτώνονται πριν από την εκτόξευση.
  • Χρησιμοποιείτε ένα μοντέλο ενσωμάτωσης για ολόκληρη την οικογένεια αποστολών, τόσο στο έδαφος όσο και στο ωφέλιμο φορτίο, ώστε οι αλλαγές του γράφου που κατεβαίνουν να μπορούν να συγχωνευθούν με τον γράφο εδάφους.
  • Το ωφέλιμο φορτίο δεν στέλνει ποτέ εντολή στα συστήματα πτήσης. Στέλνει τυποποιημένα αιτήματα μέσω του επόπτη στον υπολογιστή πτήσης, ο οποίος απαντά σε καθένα με αιτιολογία.
  • Κάθε τύπος υλικού χρειάζεται τον δικό του έλεγχο του πακέτου. Η εγκατάσταση ενός πακέτου που δεν έχει ελεγχθεί για το υλικό μιας συσκευής απορρίπτεται με PACK_NOT_CHECKED_FOR_HARDWARE.
Υπογραφή και αποστολή πακέτου
Υπογραφή και αποστολή πακέτου
Έκδοση του Maritime watch 1.5 στο CORR-3. Απαιτούνται δύο από τρεις υπογραφές, ώστε ένα κλεμμένο κλειδί να μην μπορεί να εκδώσει πακέτο, και το σχέδιο δείχνει ότι το πακέτο ενεργοποιείται μόνο αφού περάσουν οι 48 έλεγχοί του επί του σκάφους.

Η έκδοση απαιτεί δύο από τρεις υπογραφές. Η δική μας και της 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, Σενάρια κατασκευής, περιέχει μια συνταγή για κάθε γραμμή παραπάνω.