IdħolIbbukkja laqgħa informattiva

Kapitlu 2.28

Ir-rilaxx tal-estensjoni tiegħek

Kif plugin jew pakkett imur minn binja approvata għall-unitajiet li jħaddmuh, u kif jerġa' jitneħħa. Verżjonijiet, reviżjoni tar-rilaxx, kanali u installazzjonijiet, iffirmar, approvazzjonijiet tal-bidla, ir-rekord tal-identità tat-twassil, migrazzjonijiet, treġġigħ lura u l-irtirar ta' verżjoni.

Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

18 minuti qari

Cold chain 0.4.0 kien l-ewwel rilaxx tagħna li talab aktar minn dak ta' qablu. Żied il-bgħit tal-posta u indirizz estern wieħed, għall-allerti tar-reefers. Il-build kien aħdar, it-testijiet għaddew fuq it-tliet fergħat sintetiċi kollha, u xorta baqa' fl-ispazju tal-iżvilupp għal jumejn waqt li żewġ persuni qraw x'kien qed jitlob u t-tielet approvat l-indirizz. Hekk huwa maħsub li jinħass ir-rilaxx fuq Nexus: il-kodiċi huwa l-parti l-faċli, u l-evidenza u l-approvazzjonijiet huma r-rilaxx.

Dan il-kapitlu jkopri dak kollu li hemm bejn build aħdar u verżjoni li taħdem għal kull unità, u l-modi kif tmorru lura. Il-mogħdija tal-promozzjoni nnifisha, mill-ispazju tal-iżvilupp għall-istaging, għal unità pilota u għall-unitajiet kollha, hija introdotta fil-kapitlu 2.24, Il-bini ta' vertikali personalizzat minn tarf sa tarf, u mhux se nirrepeti l-gradi tagħha hawnhekk. Regola waħda tifforma dan kollu. L-iskjerament isir biss permezz tal-kanali tar-rilaxx tal-installazzjoni. M'hemm l-ebda bieb tal-ġenb għal soluzzjoni urġenti, u ħadd ma jeditja b'idejh immaġni li qed taħdem.

Verżjonijiet

Tliet numri tal-verżjoni jiċċaqilqu f'rilaxx ta' pakkett, u jaqbel li żżommuhom separati f'moħħkom.

Xiex Fejn jinsab Eżempju Regola
Il-plugin version f'nexus.manifest.json 0.4.0 Verżjoni semantika; suffiss ta' qabel ir-rilaxx bħal -rc.1 huwa permess
Il-pakkett version f'pack.json 0.4.0 Jiċċaqlaq mal-lentijiet, il-kliem u l-clusters tal-pakkett
Il-mudell tal-għarfien Il-verżjoni proprja tal-mudell 1.3 sa 1.4 Jiċċaqlaq biss permezz ta' talba għal bidla fil-graff

Build tal-iżvilupp iġorr suffiss, 0.4.0-dev, sakemm jasal fl-istaging. Żommu l-verżjonijiet tal-plugin u tal-pakkett ugwali meta jinħarġu flimkien; dan jiffranka argument f'kull reviżjoni tar-rilaxx dwar għal liema numru tappartjeni l-evidenza.

Żewġ verżjonijiet oħra huma ffissati aktar milli magħżula. Il-verżjoni tal-mudell tal-pakkett (domain-pack@1.6.0 għal Cold chain) tiġi ffissata meta jsir il-pakkett u tiċċaqlaq biss bħala bidla riveduta. L-SDK (software development kit) jiġi installat f'verżjoni eżatta, qatt f'firxa, sabiex l-istess build jagħti l-istess riżultat ix-xahar ta' wara:

npm install --save-exact @adverant-nexus/plugin-sdk@2.50.0

Il-ħiliet tal-Skills Engine għandhom ukoll verżjonijiet, u jġibu ruħhom b'mod differenti. Kull verżjoni ppubblikata hija fissa, u live, canary u shadow huma tikketti fuq il-verżjonijiet. Il-qlib lura jċaqlaq tikketta, u l-eżekuzzjonijiet li diġà jkunu għaddejjin jispiċċaw fuq il-verżjoni li bdew biha.

Qabel ma titlob reviżjoni: il-manifest

Il-paġna Manifest u permessi tqabbel dak li jiddikjara dan ir-rilaxx ma' dak tar-rilaxx ta' qablu: l-ambiti tiegħu, il-ħażniet tiegħu, l-indirizzi esterni tiegħu u l-profil tas-sandbox tiegħu. Aqrawha qabel ma titolbu lil xi ħadd jirrevedi, għax tgħidilkom eżattament x'se jintalbu jaċċettaw ir-reviżuri.

Manifest u permessi
Manifest u permessi
Dak li jiddikjara Cold chain 0.4.0 meta mqabbel ma' 0.3.2. Innotaw iż-żewġ linji mmarkati bħala twessigħ, il-bgħit tal-posta u indirizz estern wieħed, u l-pjanċa li tgħid li r-rilaxx mhux se jiċċaqlaq lil hinn mill-ispazju tal-iżvilupp sakemm żewġ reviżuri jaċċettawhom.

Rilaxx li jitlob aktar milli ddikjara qabel il-manifest tiegħu jinżamm fejn hu, b'MANIFEST_SCOPE_WIDENED, sakemm żewġ reviżuri jaċċettaw il-manifest usa'. Indirizz estern jeħtieġ ukoll l-approvazzjoni ta' min hu responsabbli mill-indirizzi esterni għand il-klijent; dik l-approvazzjoni tingħata għal terminu fiss, u tagħna kienet għal 12-il xahar. Għandkom żewġ modi kif tipproċedu: tneħħu l-linji, jew titolbu reviżjoni. Il-paġna toffri ż-żewġ buttuni.

Kull linja f'dik il-paġna hija infurzata waqt l-eżekuzzjoni, mhux biss riveduta. Kull sejħa ta' għodda tiġi ċċekkjata mal-ambiti ddikjarati, indirizz estern jiġi mblukkat sakemm ma jkunx elenkat, u l-profil tas-sandbox ma jippermetti l-ebda netwerk ieħor. Plugin li jipprova jilħaq xi ħaġa li ma ddikjarax jiġi rrifjutat, u l-unika soluzzjoni hija rilaxx ġdid li jiddikjaraha.

Reviżjoni tar-rilaxx

Il-paġna Reviżjoni tar-rilaxx tpoġġi l-evidenza għal rilaxx wieħed f'tabella waħda, għal reviżur li mhuwiex l-awtur.

Reviżjoni tar-rilaxx
Reviżjoni tar-rilaxx
Il-perspettiva ta' reviżur ieħor ta' Cold chain 0.4.0, bit-tabella tal-evidenza, id-differenza fl-ambiti u l-kummenti. Innotaw il-pjanċa fuq il-lemin: l-awtur ma jistax japprova r-rilaxx tiegħu stess.
Evidenza X'uriet għal 0.4.0
Testijiet 66 minn 66, fuq tliet fergħat sintetiċi
Kontrolli tal-kwalità Id-dokumentazzjoni u l-kodiċi jaqblu
Politika Kull lenti biss tidjieq; il-kampi personali mitfija awtomatikament
Firem L-immaġni u l-pakkett iffirmati mill-pipeline
Differenza fl-ambiti Iżżid il-bgħit tal-posta u indirizz estern wieħed, bl-approvazzjoni tiegħu
Kompatibbiltà Il-verżjoni tal-pjattaforma u l-verżjoni tal-pakkett bażi li ġie ttestjat magħhom
Bidla fil-mudell Il-prova simulata tat-talba għal bidla fil-graff: 1,284 rabta msemmija mill-ġdid, xejn imneħħi

Taħt it-tabella hemm il-kummenti dwar il-bidla u l-provenjenza: liema pipeline bnieh, minn liema bidla, id-digest tal-immaġni u l-mudell. Ir-reviżuri japprovaw bil-passkey tagħhom. Żewġ reviżuri li mhumiex l-awtur japprovaw, u mbagħad il-pipeline iċċaqlaq ir-rilaxx għall-istaging. L-awtur qatt ma jgħodd bħala reviżur, u tentattiv jiġi rrifjutat b'NEEDS_SECOND_PERSON. Talba għal reviżjoni tiskadi wara 3 ijiem.

Wieġbu l-mistoqsijiet tar-reviżuri fil-kummenti, mhux f'tieqa taċ-chat. Matul ir-reviżjoni tagħna, l-uffiċjal tal-konformità tagħna staqsa għaliex l-ammont tat-talba kien ikklassifikat bħala kummerċjali, u t-tieni reviżur talab il-pjan ta' rollback għall-bidla fil-mudell. Iż-żewġ tweġibiet issa huma parti mir-rekord tar-rilaxx, li huwa fejn se jħares ir-reviżur li jmiss.

Approvazzjonijiet tal-politika tal-bidla

Ir-reviżjoni tar-rilaxx tkopri r-rilaxx kollu kemm hu. Il-blokk changePolicy fil-manifest imur lil hinn: jgħid liema klassijiet ta' bidliet fl-elementi skjerabbli tal-plugin tagħkom jeħtieġu approvazzjoni, u minn kemm-il persuna.

"changePolicy": {
  "enabled": true,
  "classes": ["website", "bff", "migration"],
  "approvals": { "website": 1, "bff": 1, "migration": 2 }
}

It-tliet klassijiet huma website (l-applikazzjoni web), bff (il-backend għall-frontend) u migration (migrazzjoni tad-database). Kull klassi msemmija f'classes għandu jkollha l-għadd tagħha f'approvals, minn 1 sa 10. Klassi li tħallu barra mhix regolata, u l-iskema ġġegħelkom tiktbu dan bħala għażla aktar milli tilħquh b'omissjoni. Aħna nitolbu żewġ approvazzjonijiet għall-migrazzjonijiet għax migrazzjoni hija l-unika bidla li huwa diffiċli li titreġġa' lura.

L-approvazzjonijiet jingħaddu f'persuni distinti, u min jipproponi qatt ma jkun wieħed minnhom. Ir-regoli li jsostnu dan ta' min tkunu tafuhom, għax kull waħda għandha rifjut:

  • Approvazzjoni mill-persuna li pproponiet il-bidla tiġi rrifjutata b'TRUST_APPROVAL_SELF_APPROVAL.
  • Persuna li ma tistax tagħmel bidla ta' dik il-klassi xejn tiġi rrifjutata b'CHANGE_CLASS_NOT_PERMITTED.
  • Meta xi commit fil-bidla jkun iffirmat bl-identità tal-aġent tal-organizzazzjoni, il-kworum ikun il-minimu tas-soltu flimkien ma' wieħed, u l-vot tal-aġent innifsu ma jgħoddx.
  • Kull approvazzjoni tirreġistra d-diff u l-head li rat. Jekk il-bidla tiċċaqlaq wara l-aħħar approvazzjoni, l-għaqda tagħha tiġi rrifjutata b'HASH_MISMATCH, u l-approvazzjonijiet iridu jinġabru mill-ġdid għall-kontenut il-ġdid.

Dik it-tielet regola hija importanti jekk tibnu b'għodda tal-ikkowdjar bl-IA (intelliġenza artifiċjali), kif jiddeskrivi l-kapitlu 2.26, Il-bini b'għodod tal-ikkowdjar bl-IA. Xogħol miktub minn aġent jeħtieġ approvazzjoni umana waħda aktar minn xogħol miktub minn persuna. Ippjanaw għal dan.

Iffirmar u verifika

Kull immaġni u pakkett huma ffirmati mill-pipeline li bniethom, u immaġni ffirmata hija wieħed mill-gradi għall-istaging. Spazju tal-iżvilupp iħaddem biss immaġnijiet iffirmati mill-bidu. Fuq Enterprise, amministratur jissettja kull namespace jew biex jirreġistra l-immaġnijiet mhux iffirmati jew biex jirrifjutahom, u jċaqlaq in-namespaces għar-rifjut wieħed wieħed, sabiex il-produzzjoni tispiċċa tħaddem biss immaġnijiet li l-pipeline bena u ffirma. L-iffirmar huwa parti mill-build, mhux xi ħaġa li żżidu qabel rilaxx.

Ir-regola li tgħaddi minn dan kollu hija li firma li tfalli hija rifjut, qatt twissija. Kontroll li jirċievi SIG_INVALID jieqaf. Ma jerġax lura għall-verżjoni mhux iffirmata u ma jkomplix b'nota f'log, għax twissija f'log tal-build hija approvazzjoni għal kull min ma qrahiex.

L-istess regola tapplika għal dak kollu li tgħaddu fuq midja. Bundle issiġillat għal klijent air-gapped jiġi vverifikat mal-ċavetta pubblika tagħkom qabel ma jinfetaħ xi ħaġa, u l-kapitlu 2.25, Il-bini għal kull edizzjoni, juri l-kmand.

Identità tat-twassil

Plugin jitwassal permezz ta' diversi affarijiet li kull waħda għandha isem: ir-repożitorji tiegħu, ċavetta tal-iffirmar, namespace tal-iskjerament, prefiss tar-reġistru, skema tad-database, sett ta' dominji u politika tal-bidliet. Kwalunkwe waħda minnhom hija post fejn żewġ plugins jistgħu jaħbtu, jew plugin wieħed jista' jitbiegħed. L-identità tal-kunsinna hija rekord iffirmat wieħed għal kull plugin li jżommhom kollha, sabiex kull kontroll fuq il-mogħdija tar-rilaxx jaqra l-istess tweġiba u jirrifjuta meta ma jkunx hemm qbil.

Intom tikkontribwixxu l-parti tagħkom permezz tal-manifest u xejn aktar: schema, db, domains, changePolicy u l-URL tar-repożitorju. Il-pjattaforma tlesti r-rekord bil-bqija u tiffirmah. Qatt ma ssemmu n-namespace, il-prefiss tar-reġistru jew iċ-ċavetta tal-iffirmar tagħkom stess. Dawn jiġu assenjati lilkom, u manifest li jipprova jiddikjarahom ikun qed jagħmel pretensjoni li mbagħad il-kontrolli jkollhom ma jemmnuhiex.

Ir-rekord iffirmat iżomm ħdax-il kamp: is-slug tal-plugin, l-organizzazzjoni sid, l-organizzazzjoni li tibnih, ir-repożitorji tiegħu, l-isem taċ-ċavetta tal-iffirmar tiegħu, in-namespace tal-iskjerament tiegħu, il-prefiss tar-reġistru tiegħu, l-iskema tad-database tiegħu, id-dominji tiegħu, il-politika tal-bidliet tiegħu, u lista qasira ta' ismijiet ta' immaġnijiet eqdem li uża qabel ma kien jeżisti l-prefiss tar-reġistru tiegħu. Dik l-aħħar lista tista' biss tiċkien. Peress li hija ffirmata, firma ġdida tista' tneħħi entrata u xejn ma jista' jżid waħda bil-moħbi. Il-firma hija Ed25519 fuq il-forma JSON kanonika standard ta' dawk il-ħdax-il kamp, sabiex rekord b'"Tomás" jew "Sinéad" fih jiġi vverifikat bl-istess mod kullimkien.

Meta rilaxx ma jaqbilx mar-rekord tiegħu, jirbaħ l-ewwel rifjut:

Kodiċi Meta HTTP
DELIVERY_IDENTITY_MISSING M'hemm l-ebda rekord għall-plugin 403
DELIVERY_PATH_REFUSED Push ta' immaġni barra mill-prefiss tar-reġistru li mhuwiex fil-lista ffirmata tal-ismijiet eqdem 403
NAMESPACE_MISMATCH Skjerament immirat lejn namespace ieħor 403
IMAGE_NAME_COLLISION Isem ta' immaġni li plugin ieħor diġà jippretendi 409
CHANGE_CLASS_NOT_PERMITTED Klassi ta' bidla li l-politika ma tirregolax 403

IMAGE_NAME_COLLISION huwa dak li jissorprendi lin-nies. Agħżlu isem ieħor, u qatt terġgħu tużaw wieħed: isem ta' immaġni kondiviż ifisser li l-promozzjoni ta' plugin wieħed tista' ċċaqlaq il-pods ta' plugin ieħor.

Migrazzjonijiet, ikkommettuti u b'ambitu definit

Migrazzjoni tinħareġ ġewwa l-immaġni tal-plugin tagħkom u taħdem qabel ma tibda l-verżjoni l-ġdida, permezz tal-uniku runner tal-migrazzjonijiet tal-SDK, nexus-migrate. Ma tiktbux applikatur tagħkom stess. Qabel ma xi rilaxx ikun jista' jiċċaqlaq, l-istess runner japplika l-migrazzjonijiet tagħkom fajl fajl fuq database temporanja, sabiex migrazzjoni li tfalli, tfalli hemmhekk. Il-build shadow tal-mudell isejjaħ ir-runner darba għal kull fajl, f'ordni, u jirreġistra kull fajl kif se tagħmel il-produzzjoni.

Ir-regoli tar-runner huma dawk li l-gates jiċċekkjaw, miktuba bħala kodiċi:

  1. Jikkonnettja bħala r-rwol migrator tal-iskema tagħkom u jħaddem kull fajl bħala s-sid tal-iskema. Kwalunkwe login ieħor, l-ewwel nett superuser, jiġi rrifjutat. Fajl li jipprova jaqleb ir-rwol waħdu jiġi rrifjutat qabel ma jaħdem xejn.
  2. Il-fajl tat-tenancy, innumerat 0, qatt ma jiġi editjat wara li jkun ġie applikat. Bidla fit-tenancy jkollha l-fajl ta' reviżjoni tagħha, 000_tenancy_r<N>.sql, li nexus-tenancy render --revision <N> jiktbu għalikom.
  3. Normalment ir-runner ikun sid it-transazzjoni ta' kull fajl u jirrifjuta BEGIN jew COMMIT ġewwaha. Fajl li jamministra t-transazzjonijiet tiegħu stess jiddikjara li jaħdem għal kull dikjarazzjoni, u mbagħad kull BEGIN li jiftaħ għandu jkollu qabil.
  4. Iżomm reġistru, ringiela waħda għal kull fajl, bis-SHA-256 tal-fajl u kif ħadem. Fajl applikat qatt ma jinbidel f'postu; bidla hija fajl ġdid innumerat.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-tenancy render --manifest nexus.manifest.json --revision 2 --out migrations/000_tenancy_r2.sql

Scoped ifisser li kull tabella ġdida ġġorr organization_id, owner_user_id u business_unit_id, flimkien mal-kolonna marker is_demo sakemm gates/demo-exempt.json ma jeżentax it-tabella b'raġuni, b'ċavetta primarja li tibda bl-organizzazzjoni u ċwievet barranin li jġorruha, u s-sigurtà fil-livell tar-ringiela imposta fuqha. Il-kontroll migrations-are-scoped jiċċekkja dawk ir-regoli fuq kull fajl, u migrations-commit-what-they-open jgħodd li kull fajl jagħmel commit ta' dak li jiftaħ. It-tieni kontroll jeżisti għax darba migrazzjoni li għamlet rollback bil-moħbi ħarġet b'0, u t-tabella li suppost ħolqot qatt ma eżistiet.

Fajl ieħor jappartjeni għal kull rilaxx. scripts/ci/required-env jistampa l-varjabbli tal-ambjent li s-servizz tagħkom jeħtieġ biex jibda, bħala array JSON meħud mill-config loader tagħkom. Il-mogħdija tar-rilaxx tħaddmu u tirrifjuta rilaxx li l-iskjerament tiegħu ma jissettjax kull waħda minnhom, sabiex varjabbli nieqsa tinqabad qabel ir-rilaxx, mhux minn pod li ma jibdiex.

node scripts/ci/required-env

Ir-rilaxx tal-ħiliet

Iż-żewġ tipi ta' ħiliet jaslu għand in-nies b'rotot differenti, għalhekk irrilaxxawhom b'mod differenti.

Ħila tal-manifest, ringiela tipizzata fil-skills[] tal-plugin tagħkom, tinħareġ mal-plugin u tgħaddi mill-istess promozzjoni bħall-bqija tiegħu. L-onboarding jissinkronizza s-sett kollu tal-ħiliet mar-reġistru f'kull rilaxx. Ħallu ħila barra mis-sett u tiġi diżattivata, u fuq Enterprise sinkronizzazzjoni b'ħila ħażina waħda ma tieħu l-ebda waħda minnhom, sabiex il-verżjoni ta' qabel tibqa' taħdem aktar milli nofs il-ġdida.

Skill tal-Skills Engine tiġi ppubblikata mil-librerija. Fuq Enterprise, waħda li żżid għodda tal-kitba tistenna li żewġ persuni msemmija japprovawha bil-passkeys tagħhom, u min jipproponiha ma jistax ikun wieħed minnhom. Verżjoni approvata mbagħad taħdem f'shadow, imbagħad f'canary għal unità waħda wara gates imsemmija, imbagħad għal kulħadd, u tieqaf waħedha jekk gate ma jintlaħaqx. Jekk il-plugin tiegħek u skill tal-Skills Engine jiddependu fuq xulxin, ippubblikaw l-ewwel is-skill u ħalluha tasal għal kulħadd qabel ma r-rilaxx tal-plugin li jsejħilha joħroġ mill-pilota.

Kanali u installazzjonijiet

Ladarba rilaxx ikun għadda mill-pilota u wasal għand l-unitajiet kollha, jiġi offrut fuq kanal, u kull unità tagħżel il-kanal tagħha. L-amministratur tagħha jaqbel ma' kull ċaqliqa. Il-paġna Kanali u installazzjonijiet turi liema unitajiet iħaddmu liema verżjoni, bir-rati ta' żbalji bħala għadd biss: taraw kif timxi l-estensjoni tagħkom, qatt x'għamel xi ħadd biha.

Kanali u installazzjonijiet
Kanali u installazzjonijiet
Liema unitajiet iħaddmu liema verżjoni ta' carrier-sync, b'roll-back miftuħ għal unità waħda. Innutaw x'jgħid il-modal li jinbidel, x'jibqa', u li jeħtieġ it-tieni persuna, l-amministratur tal-unità nnifisha.

Il-plugin carrier-sync tagħna jħaddem tliet verżjonijiet fl-istess ħin, u dan huwa normali. Il-biċċa l-kbira tal-unitajiet huma fuq ir-rilaxx kurrenti, unità waħda tibqa' fuq verżjoni eqdem fuq kanal miżmum sa data ddikjarata, u release candidate qiegħed fuq kanal li ħadd għadu ma għażlu. Tiġġilduhx; unità li teħtieġ stabbiltà għal awditu għandha dritt għaliha.

Il-logs u l-metriċi tal-estensjoni tiegħek

Il-paġna tal-logs u l-metriċi għall-pakkett tagħkom hija marbuta mal-workloads tagħkom stess, fl-unitajiet fejn tistgħu tħarsu. Tistgħu tiffiltraw skont l-unità u l-ambjent, u taraw għadd, ħinijiet u stati.

Il-logs u l-metriċi tal-pakkett tagħkom
Il-logs u l-metriċi tal-pakkett tagħkom
Il-logs u l-metriċi ta' Cold chain stess, iffiltrati għall-pilota ta' Rotterdam. Ħarsu lejn il-linji tal-log: il-persuna li rrappurtat excursion hija moħbija, u t-test tan-nota tat-talba qatt ma jiġi rreġistrat fil-log.

Il-oqsma personali jiġu sostitwiti qabel ma tinkiteb linja, u l-kontenut tal-klijenti bħat-test tat-talbiet, il-posta jew il-kontenut tad-dokumenti qatt ma jinkiteb fil-logs. Il-logs jinżammu 14-il jum. L-organizzazzjoni tiġi stabbilita mill-gateway, qatt mill-query tagħkom, għalhekk query li ssemmi organizzazzjoni oħra tiġi rrifjutata b'TENANT_BOUNDARY. L-assistent fid-dock jista' jaqra l-istess logs magħkom, u dawn biss: meta staqsejtu għaliex ir-rekords tal-excursions waslu tard filgħodu waħda, intraċċa 18-il minuta ta' tentattivi mill-ġdid għal qari doppju mill-provvista tal-elettriku ta' moll wieħed.

Treġġigħ lura

Hemm żewġ tipi ta' rollback, u t-tnejn huma bidliet riveduti aktar milli swiċċijiet.

Ir-rollback ta' ambjent juża l-verżjoni ta' qabel. Kull ambjent iżommha għal 30 jum. Ir-rollback jiġi ppreparat bħala bidla fir-rilaxx, juri minn qabel x'se jagħmel u jeħtieġ it-tieni persuna; ladarba jiġi approvat, il-pipeline jagħmel ir-rollback f'madwar minuta. Kull rollback jitkejjel fil-ħin, u hekk ukoll kull eżerċizzju, għalhekk ipprattikaw wieħed qabel ma jkollkom bżonnu. Ir-rollback ta' unità waħda juża l-paġna Kanali u installazzjonijiet. Il-modal tar-roll-back jgħid x'jinbidel (dik l-unità terġa' tħaddem il-verżjoni eqdem, u r-rata ta' żbalji tagħha tiġi osservata għal siegħa), x'jibqa' (l-unitajiet l-oħra, u s-settings u r-rekords tal-unità), ir-raġuni, u min hi t-tieni persuna: l-amministratur ta' dik l-unità.

Is-settings u r-rekords jinżammu matul rollback, għalhekk ippjanaw kull rilaxx fuq is-suppożizzjoni li l-verżjoni ta' qablu tista' terġa' taħdem fuq id-data li kitbet dik il-ġdida. Din hija r-raġuni prattika biex il-migrazzjonijiet jinżammu addittivi fi ħdan rilaxx li tistgħu tagħmlulu rollback, u r-raġuni għaliex nitolbu lil żewġ persuni japprovaw kull waħda. Bidla fil-mudell hija l-istess: reviżur jista', u għandu, jitlob il-pjan tar-rollback ta' talba għal bidla fil-graph qabel ma japprovaha.

Is-skills jagħmlu rollback b'mod aktar ġentili. Iċ-ċaqliq tat-tikketta live lura għal verżjoni preċedenti huwa pass wieħed, u r-runs li diġà għaddejjin jispiċċaw fuq il-verżjoni li bdew biha.

L-irtirar ta' verżjoni

Rilaxx, ladarba jsir, qatt ma jiġi editjat. Verżjoni li m'għandhiex tibqa' tintuża tiġi rtirata, u soluzzjoni toħroġ bħala numru ta' verżjoni ġdid. Il-kanali tar-rilaxx tal-SDK innifsu jsegwu l-istess drawwa: verżjoni ħażina tal-SDK titneħħa, qatt ma tiġi sostitwita b'kontenut differenti taħt l-istess numru. Ikkupjawha, għaliex numru ta' verżjoni li jista' jfisser żewġ builds differenti jagħmel kull biċċa evidenza dwaru bla valur.

L-irtirar ta' plugin jew pakkett iwaqqaf installazzjonijiet ġodda. L-unitajiet iżommu l-verżjoni li jħaddmu sakemm jiċċaqilqu, għalhekk l-irtirar huwa sinjal u skadenza, mhux swiċċ biex jintfa. Għidu lill-amministraturi tal-unitajiet għal liema verżjoni għandhom jiċċaqilqu u sa meta.

L-irtirar ta' skill isegwi l-istess idea b'pass ieħor. Il-Skills Engine jiċċaqlaq kull min għadu jsejħilha għal sostitut wara li jħaddem il-każijiet tas-sostitut, iwaqqaf runs ġodda, u jżomm il-verżjonijiet, il-każijiet u r-rekords issiġillati tar-runs, sabiex is-skill tkun tista' tinġieb lura jekk is-sostitut jirriżulta ħażin.

Lista ta' kontroll għar-rilaxx

Din hija l-lista li naqraw qabel kull rilaxx ta' Cold chain. Hija qasira għaliex il-pjattaforma tiċċekkja l-biċċa l-kbira tagħha għalina.

  1. Il-verżjonijiet jaqblu: il-manifest, pack.json, u l-mudell tal-għarfien jekk inbidel.
  2. Kull gate huwa aħdar lokalment, minn bidu nadif, u kull test ġdid intwera li jfalli l-ewwel.
  3. Il-paġna Manifest u permessi ma turi l-ebda twessigħ, jew it-twessigħ huwa dak li ridna u r-reviżuri jafu għaliex.
  4. Kull migrazzjoni hija fajl ġdid innumerat, b'ambitu definit, u applikat mingħajr problemi fuq database temporanja.
  5. scripts/ci/required-env jelenka kull varjabbli li s-servizz jeħtieġ, u l-deployment jistabbilixxi kull waħda.
  6. Il-pjan tar-rollback huwa miktub fil-bidla, inkluż għal kwalunkwe bidla fil-mudell.
  7. Żewġ reviżuri li mhumiex l-awtur huma disponibbli din il-ġimgħa.

L-aħħar punt jidher trivjali. Huwa dak li ttardja aktar mir-rilaxxi tagħna mill-gates kollha flimkien.