Autors: Kristijan Sekereš

Atlassian Connect atbalsts beidzas 2027. gada 31. janvārī: pielāgotu Jira un Confluence lietotņu pārcelšana uz Forge

viens sarkans puzles gabaliņš starp zaļiem

2027. gada 31. janvārī Atlassian beidz atbalstīt Connect, ietvaru, uz kura veidota lielākā daļa vecāko Jira un Confluence Cloud lietotņu. No šīs dienas Atlassian, kā tas norāda, „will only address critical security vulnerabilities in Connect“, un privāta lietotne, kas joprojām darbojas uz Connect, „will no longer be supported and may stop working properly“.

Ja visas jūsu vietnes lietotnes nākušas no Atlassian Marketplace, tas ir jūsu piegādātāju darbs, un lielākā daļa to jau ir izdarījuši: Atlassian 2026. gada augustā ziņoja, ka „over 95% of paid app seats have been migrated to Forge“.

Šis raksts ir par otru gadījumu. Jūsu uzņēmumam ir Jira vai Confluence lietotne, ko kāds izveidoja tieši jums: iekšējais izstrādātājs, darbuzņēmējs, partneris. Tā tika instalēta ar saiti, nevis nopirkta. Neviens ārpus jūsu uzņēmuma to nepārcels, un cilvēks, kurš to uzrakstīja, var būt jau aizgājis.

Ko nozīmē atbalsta beigas un ko tās nenozīmē

Publicēta izslēgšanas datuma nav. Atlassian nav teicis, ka Connect lietotnes pārstās darboties 2027. gada 1. februārī, un tā sākotnējā paziņojumā par laika grafiku teikts, ka „customers who have Connect apps installed won't lose access to the app“.

Neuztveriet to kā drošību. Mainās tas, ka Atlassian vairs neviens par Connect nerūpējas:

  • Tiek labotas tikai kritiskas drošības ievainojamības. Nekritiskās kļūdas paliek.
  • „Connect feature deprecations will happen with little notice.“
  • Atlassian atbalsts „will not be able to fix issues caused by that legacy technology“.
  • Paša Atlassian vārdiem: „Connect will not remain in a steady state after end of support. Breakages will increase and compatibility gaps will widen.“

Tātad risks pieaug pakāpeniski, nevis kā kritiens no klints. Ticams kļūmes scenārijs: Jira maina kādu lapu, Connect panelis vairs neattēlojas, un nav neviena, kam iesniegt pieteikumu. Ja šī lietotne ir daļa no finanšu apstiprināšanas procesa vai klientiem paredzēta apkalpošanas dienesta, par to uzzināsiet no cilvēkiem, kuri no tās ir atkarīgi.

Kas jau ir noticis

Janvāra datums ir pēdējais solis secībā, kas sākās 2025. gadā.

  • 2025. gada septembrī: Marketplace pārstāja pieņemt jaunas Connect lietotnes.
  • 2026. gada 31. martā: atjauninājumi tika iesaldēti. Atlassian norādījumos par pielāgotām lietotnēm tas teikts tieši: pēc šī datuma „you'll no longer be able to push updates to Connect apps“. Kodu savā serverī jūs joprojām varat mainīt, bet tas, ko lietotne deklarē Jira vai Confluence (tās moduļi, tvērumi un tīmekļa āķi), ir nemainīgs.
  • 2026. gada martā: laika grafikā bija arī teikts, ka „the ability to install new Connect private apps via Connected Apps will become unavailable“. Uzskatiet atinstalēšanu par neatgriezenisku: nenoņemiet privātu Connect lietotni tikai tāpēc, lai redzētu, kas salūzt.
  • 2026. gada augustā: Atlassian pārcēla atbalsta beigas no 2026. gada decembra uz 2027. gada 31. janvāri. Tas ir viens papildu mēnesis. Nerēķinieties ar vēl vienu.
  • Tagad: Atlassian ievieš brīdinājumus Atlassian Administration, kur privātās lietotnes, kas joprojām darbojas uz Connect, ir „marked with the LEGACY status“.

Kā atrast savas privātās lietotnes

Sāciet Atlassian Administration, lapā Connected Apps. Viss, kas apzīmēts ar LEGACY, darbojas uz Connect. Atlassian kontrolsaraksts privātas lietotnes atpazīšanai: ja lielākā daļa no šiem punktiem atbilst, tās pārcelšana ir jūsu ziņā:

  • instalēta ar tiešu saiti vai izstrādātāja režīmā, nevis no Marketplace;
  • nav redzama Marketplace meklēšanā;
  • avota kodu uztur jūsu organizācija;
  • nav licencēšanas informācijas, un instalāciju sarakstā ir tikai jūsu organizācija;
  • tās Connected Apps lapā nav saistīto saišu sānjoslas (Marketplace lietotnēm tāda ir).

Atlassian piebilst īkšķa likumu: pielāgota mākoņa lietotne, kas izveidota pirms vairāk nekā pieciem gadiem, visticamāk, ir Connect lietotne, un Connect lietotnes tiek mitinātas ārpus Atlassian, „typically on a service like Heroku, AWS, Azure, or Google Cloud Platform“. Lietotnes saite View app details rāda, kas ir izstrādātājs, ciktāl tas zināms Atlassian.

Katrai lietotnei pierakstiet piecas lietas, pirms kāds pieskaras kodam:

  1. Ko tā dara un kas to izmanto, ar teikumu, ko atpazītu uzņēmuma vadītājs.
  2. Kur ir avota kods. Jūsu kontrolēts repozitorijs, darbuzņēmēja klēpjdators vai nekur.
  3. Kur tā darbojas un kura konts maksā par mitināšanu. Ja serveris atrodas bijušā darbuzņēmēja mākoņa kontā, tas ir risks jau šodien, nevis janvārī.
  4. Deskriptors. Katra Connect lietotne kādā URL nodrošina failu atlassian-connect.json. Tajā uzskaitīti visi lietotnes izmantotie moduļi, tvērumi un tīmekļa āķi, tāpēc tā ir uzticamākā inventarizācija, kādu iegūsiet.
  5. Kādus datus tā glabā un kur: savā datubāzē vai rekvizītos, kas saglabāti pie Jira pieteikumiem un Confluence lapām.

Izlemiet, pirms sākat izstrādi

Ne katra privātā lietotne ir pelnījusi migrāciju. Atlassian pats iesaka pārbaudīt, vai kāda iebūvēta Jira vai Confluence funkcija tagad nedara to pašu, un migrēt tikai to, kas organizācijai joprojām vajadzīgs. Vecas lietotnes bieži aizpildīja robu, ko produkts kopš tā laika ir aizvēris.

Katrai lietotnei ir viena no trim atbildēm: migrēt, aizstāt ar ko atbalstītu vai izņemt no lietošanas. Izņemšana no lietošanas ir pilnīgi leģitīms iznākums. Atlassian iesaka, ja atsakāties no lietotnes, informēt tās lietotājus un ieplānot noņemšanu pirms 2027. gada 31. janvāra, nevis ļaut tai sabojāties pašai.

Ko ietver pāreja uz Forge

Forge nav Connect ar jaunu nosaukumu. Atšķiras mitināšanas modelis, drošības modelis un lietotāja saskarnes modelis, tāpēc Atlassian pat vienkāršu lietotņu īpašniekiem iesaka koncepcijas pārbaudi sākt laikus.

Mitināšana

Connect lietotne ir tīmekļa serviss, ko darbināt jūs. Forge lietotne darbojas Atlassian infrastruktūrā kā funkcijas ar stingriem ierobežojumiem: 25 sekundes funkcijai, ko izsauc lietotājs, līdz 900 sekundēm asinhroniem notikumiem un plānotiem palaidējiem. Connect lietotnei, kas veic desmit minūšu sinhronizāciju, kamēr lietotājs gaida, šis darbs jāpārceļ uz asinhroniem notikumiem, un viss, kas ilgst vairāk par piecpadsmit minūtēm, jāsadala soļos. Ierobežoti ir arī izejošie izsaukumi: jebkurš domēns, kas nav deklarēts lietotnes manifestā, tiek noraidīts.

Esošās aizmugursistēmas saglabāšana

Forge Remote ļauj Forge lietotnei izsaukt citur mitinātus servisus, ļauj jūsu serverim pārbaudīt, vai pieprasījums tiešām nāk no Forge, un dod jūsu aizmugursistēmai marķierus Atlassian API izsaukšanai. Privātai lietotnei ar gadiem uzkrātu biznesa loģiku serverī tas bieži ir īsākais ceļš: lietotāja saskarne un integrācijas punkti pāriet uz Forge, loģika paliek, kur bija.

Kompromiss: Forge Remote var padarīt lietotni neatbilstošu Atlassian programmai Runs on Atlassian. Iekšējam rīkam tas ir mazāk svarīgi, taču jūsu drošības komandai tas jāpieņem apzināti.

Autentifikācija un atļaujas

Connect lietotnes autentificējas ar JWT, kas parakstīts ar koplietojamu noslēpumu. Forge to aizstāj ar OAuth 2.0 tvērumiem, kas deklarēti manifestā, un attālinātām aizmugursistēmām ar Forge Invocation Token, ko jūsu serveris validē JWT vietā.

Katrs autentificētais Jira vai Confluence API izsaukums pēc tam tiek veikts vai nu kā asUser, ar lietotnes lietotāja atļaujām, vai kā asApp, kas Atlassian vārdiem darbojas „regardless of who uses the app“. Katra izsaukuma izskatīšana un apzināta izvēle ir svarīgākā drošības pārbaude visā migrācijā.

Viena atšķirība komandas bieži pārsteidz. Connect moduļi pēc noklusējuma tiek attēloti arī nelicencētiem un anonīmiem lietotājiem; Forge moduļi ne, ja vien manifests to neatļauj ar unlicensedAccess. Ja jūsu lietotne kaut ko rāda apkalpošanas dienesta klientiem vai anonīmiem Confluence lasītājiem, pārbaudiet šo ceļu atsevišķi.

Lietotāja saskarne

Connect lapas ir iframe, kas sazinās ar Jira vai Confluence caur Atlassian JavaScript API. Forge piedāvā divas iespējas:

  • UI Kit: uz React balstīts ietvars, kas attēlo vietējos Atlassian komponentus. Ātri un vienveidīgi, taču jūs būvējat no Atlassian komponentiem: pielāgots HTML var nedarboties, un vienīgie statiskie resursi, ko tas pieņem, ir attēli.
  • Custom UI: jūsu pašu HTML, CSS un JavaScript iframe, kas sazinās ar produktu caur @forge/bridge.

Esoša iframe saskarne parasti ar vismazākajām izmaiņām pāriet uz Custom UI. Nelielus paneļus un iestatījumu ekrānus bieži ir ātrāk pārtaisīt UI Kit.

Dati

Šeit migrācijas noiet greizi. Forge ir sava mitinātā krātuve: atslēgas un vērtības krātuve, pielāgotu entītiju krātuve, Forge SQL un objektu krātuve priekšskatījuma versijā. Dati ir nodalīti pa instalācijām un tiek glabāti tajā pašā atrašanās vietā kā attiecīgā Jira vai Confluence vietne, tāpēc datu rezidence tiek nodrošināta bez papildu konfigurācijas.

Ko tas nozīmē privātai lietotnei:

  • Datus Connect lietotnes pašas datubāzē vai nu pārceļ uz Forge krātuvi ar vienreizēju migrācijas uzdevumu, vai atstāj, kur tie ir, un piekļūst tiem caur Forge Remote.
  • Visu, ko Connect lietotne glabāja Atlassian pusē ar savu lietotnes atslēgu, vajadzētu eksportēt, kamēr vecā lietotne vēl darbojas. Laikus pārbaudiet, vai jaunā lietotne to spēj nolasīt; nepieņemiet to kā pašsaprotamu.
  • Forge pēc atinstalēšanas mitinātos datus glabā 28 dienas, taču atkārtota instalēšana tos automātiski neatjauno.

Uzrakstiet migrāciju kā atkārtojamu skriptu ar skaitļiem, ko varat pārbaudīt, izmēģiniet to testa vietnē un saglabājiet eksportu.

Pakāpeniskais ceļš un kāpēc tas, visticamāk, nav jūsu

Atlassian Connect lietotnēm izveidoja saudzīgāku ceļu: pakāpeniski pāriet uz Forge, saglabāt esošās instalācijas, pārvērst deskriptoru Forge manifestā un pārcelt pa vienai moduļu grupai, ar iebūvētu datu migrāciju dažiem moduļiem, piemēram, makro, pielāgotajiem laukiem un darbplūsmas validatoriem.

Āķis ir ceļveža pirmajā rindkopā: „The incremental adoption of Forge is only available for Confluence and Jira Connect apps that are already listed on Marketplace.“

Privātai lietotnei plānojiet jaunu Forge lietotni. Jūs to izvietojat ražošanas vidē, kopīgojat ar savu vietni, izmantojot instalēšanas saiti no izstrādātāja konsoles, darbināt to līdzās vecajai Connect lietotnei, kamēr dati tiek migrēti un lietotāji testē, un tad noņemat Connect lietotni.

Pārejas ceļveži joprojām noder moduļu atbilstības dēļ, tāpat kā saraksts ar Connect iespējām, kas Forge nav pieejamas: vairāki Jira Service Management moduļi un mobilās lietotnes atbalsts ir atzīmēti kā neplānoti, un jiraReports joprojām tiek izskatīts. Pirmajā nedēļā salīdziniet savu deskriptoru ar šo sarakstu. Robs tajā maina arhitektūru.

Plāns atpakaļ no 2027. gada 31. janvāra

No 2026. gada oktobra sākuma ir atlikušas aptuveni septiņpadsmit nedēļas, un decembris visiem ir īss. Plāns, kas iztur:

  1. Šonedēļ: uzskaitiet katru LEGACY lietotni ar iepriekš minētajiem pieciem faktiem. Pārliecinieties, kas kontrolē avota kodu un mitināšanas kontu.
  2. Līdz oktobra vidum: katrai lietotnei izlemiet: migrēt, aizstāt vai izņemt no lietošanas. Informējiet lietotājus par visu, kas tiks izņemts.
  3. Līdz oktobra beigām: Forge koncepcijas pārbaude grūtākajai daļai grūtākajā lietotnē. Parasti tas ir modulis bez tieša Forge ekvivalenta vai tas, kurā ir visvairāk datu.
  4. Novembrī: izstrāde un datu migrācijas palaišana testa vietnē vairāk nekā vienu reizi.
  5. Decembra sākumā: instalējiet Forge lietotni līdzās Connect lietotnei, migrējiet datu kopiju un ļaujiet cilvēkiem, kuri to izmanto katru dienu, to pārbaudīt.
  6. 2027. gada janvārī: galīgā migrācija, lietotāju pārcelšana un Connect lietotnes noņemšana tikai pēc tam, kad jaunā kādu laiku darbojusies bez kļūmēm.

Viens panelis, kas nolasa Jira datus un neko neglabā, ir neliels darbs. Lietotnei ar savu datubāzi, darbplūsmas noteikumiem un saitēm uz citām sistēmām vajadzīga katra no šīm nedēļām.

Ja termiņu nokavējat, nekas no Atlassian publicētā neliecina, ka lietotne tajā dienā pārstās darboties. Taču tad jūs darbināt biznesa procesu uz platformas, kuras īpašnieks to vairs nelabo. Uzskatiet šo laiku par aizņemtu un pabeidziet pāreju.

Ja sākotnējā izstrādātāja vairs nav

Atlassian šo gadījumu aplūko tieši. Ja nevarat noteikt sākotnējo lietotnes īpašnieku vai sazināties ar viņu, vai jums vairs nav izstrādes kapacitātes, tas iesaka piesaistīt Solution Partner. Tikpat skaidri teikts, ka bez avota koda „it may be necessary to rebuild on Forge from scratch“.

Pat bez avota koda jūs nesākat akli. Deskriptorā uzskaitīts viss, kam lietotne pieslēdzas, tās darbību var novērot testa vietnē, un, ja serveri apmaksā jūsu uzņēmums, varat redzēt, kas tur faktiski ir izvietots. Pārbūve no šīm daļām ir lēnāka nekā pārnešana, taču tās apjoms ir zināms.

Kur saņemt palīdzību

Mēs pārņemam kodu, ko neviens no pašreizējās komandas nav rakstījis, noskaidrojam, ko tas patiesībā dara, un pārceļam to: Connect lietotnes gadījumā tas nozīmē deskriptora un servera izpēti, Forge lietotnes izstrādi un datu migrācijas uzrakstīšanu un izmēģināšanu. Parasti tas sākas ar mūsu mantoto sistēmu uzturēšanas darbu, un, ja jums ir izstrādātāji, bet nepietiekami daudz, personāla papildināšana uz projekta laiku pievieno cilvēkus jūsu komandai. Pastāstiet, ko lietotne dara un kur tā darbojas: rakstiet uz office@c9group.dev.

Platformu migrācija

Jauni ceļveži un noteikumu izmaiņas e-pastā

Kad mainās kāds noteikums, pārceļas termiņš vai publicējam jaunu ceļvedi, nosūtām to e-pastā.

Vispirms nosūtām apstiprinājuma saiti. Atrakstīties varat jebkurā laikā. Privātuma politika