Átvizsgált forrású hotfix munkafolyamat

Az átvizsgált forrású deployment a kiválasztott snapshotot futtatja, nem a munkamásolat minden szerkesztését. Hotfix publikálása előtt olvasd el a forrásválasztást.

Hatókörített publikálás

A hatókörített backend production build a közös backend artifact volume-ra ír. Használj átvizsgált snapshotot a szükséges forrásszerződéssel. Őrizz meg visszaállítható forrás- és adatmentést, valamint a többi szolgáltatás volume-jait.

Egyetlen szolgáltatás publikálásához ne másolj át egy teljes, piszkos munkamásolatot, ne írd át a forrásmanifestet, és ne változtasd meg a forrásgyökeret teljes újradeploymenthez. Az automatikus séma- és kliensgenerálás kívül esik a csak forrásra vonatkozó hotfixen. A normál újraindítás és a hatókörített újraindítás nem építi újra az éles artifacteket. Teljes production-kiadáshoz használd a bash restartDevServers.sh --prod parancsot. Ez önmagában nem futtat sémainicializálást. Csak forrásra vonatkozó, hatókörített kiadáshoz használd az alábbi eljárást.

A hatókörített újraindítás a mentett módot folytatja. Nem épít, és nem választ automatikusan fejlesztői módot.

Előkészített szolgáltatáshoz, kompatibilis függőségekkel és sémával, valamint azonosított, átvizsgált forrással:

1. Futtasd a bash devServerAttach.sh parancsot, és válaszd ki csak a célzott szolgáltatást.
2. Ha az alkalmazása aktív, a Ctrl+C billentyűkombinációval térj vissza a szolgáltatás shelljéhez. Ha munka maradt, ott használd a stop parancsot.
3. A shellben írd be a prod parancsot. Ez elutasítja a már futó jobokat. Build-engedélyezett szolgáltatásnál az attach-felügyelő leállítja a konténert, felépíti a szolgáltatás artifactjait, majd a build eredménye után elindítja.
4. Ellenőrizd a build sikerességét, a szolgáltatás készenlétét és az érintett felhasználói műveletet.
5. Válj le a Ctrl+P, majd a Ctrl+Q billentyűkkel.

Sikertelen build esetén a szolgáltatás shellje a hibás kimenetet nem indítja el. A prod újrapróbálkozása előtt hárítsd el az okot. Ne következtess a publikálásra csak a konténer Up állapotából.

Alternatívaként egy már leállított, előkészített szolgáltatáskonténer használhatja a bash devstack.sh --prod start SERVICE parancsot. Ez elutasítja a már futó konténert. Ne állítsd le az egész stacket csak ennek az előfeltételnek a teljesítéséhez. A backend szolgáltatások build-je közös backend artifact volume-ot használ, ezért az átvizsgált forrásnak kompatibilisnek kell lennie a többi backend szolgáltatással.

A production-dokumentáció ezt az eljárást a docs szolgáltatással használhatja. Buildje a build/site mappát hozza létre. A fejlesztői dokumentáció a forrást figyelő npm start folyamatot használja.

A local search hash csak a docs/en és docs/hu mappát olvassa. A privát AgentStuffs fájlok nem kerülnek a publikált tartalomba vagy a search bemenetébe. A docs build beállításakor őrizd meg ezt a határt; a privát artifactek célútvonala a konténerben hiányozhat.

Összehangolt forráskiadás

A célzott start, a célzott restart és a szolgáltatás shelljének prod parancsa a beállított forrásgyökeret használja. Nem törlik a forrás rögzítését. Egy régebbi snapshot sikeres buildje nem igazolja az újabb checkout-módosítások működését.

Használj összehangolt kiadást, ha a kiválasztott forrás több szolgáltatást, függőséget vagy sémát érint. Nézd át a teljes kiválasztott revíziót a korábbi javításokkal együtt. Az életciklus-parancsokat az eredeti deployment gyökeréből futtasd.

1. Őrizd meg a kiválasztott snapshotot, a visszaállítható mentéseket, a volume-okat, az adatokat, valamint a jogosultsági és titkosítási kulcsokat.
2. Csak a kiválasztott deploymentet állítsd le a bash stopDevServer.sh paranccsal. Forrásváltás előtt ellenőrizd, hogy az alkalmazás adatot író folyamatai leálltak.
3. Csak az ECS_APPLICATION_SOURCE_ROOT értékét módosítsd a deployment gyökerében lévő .env fájlban az átnézett forrásra. Az ECS_APPLICATION_SOURCE_ROOT=. az aktuális checkoutot választja. A credentialöket és minden más beállítást hagyj változatlanul.
4. Indítsd a szokásos teljes production startot: bash startDevServers.sh --prod. Ez az alkalmazás indítása előtt inicializálást és production buildeket futtat.
5. Ellenőrizd a kiválasztott forrást, a buildek eredményét, a készenlétet és az érintett böngészős műveleteket, az újratöltést is. Az acceptance eredményét a tényleges forráshoz rögzítsd.

A forrásválasztás nem hoz létre snapshotot, és nem módosítja a meglévőt. Őrizd meg a meglévő sémamappingeket, táblákat, kulcsokat és foreign key műveleteket a backend és a BFF sémájában is. Ha a sémaellenőrzés destruktív változást jelez, állj meg, és javítsd a mappingeket vagy a migrációt. Ne adj hozzá --accept-data-loss vagy --force-reset kapcsolót. Ne reseteld az adatokat, és ne törölj volume-okat.

A teljes bash restartDevServers.sh --prod újraépíti a production artifacteket, de nem futtat sémainicializálást. Ha az összehangolt kiadáshoz inicializálás kell, használd a fenti teljes startot. Őrizd meg a többi deploymentet és a megosztott proxyt.

Generált UI-eszközök engedélyezése

A szolgáltató eszközregisztrációja nem ad jogosultságot. A célzott csoport Agent tool access (ügynök-eszközhozzáférés) beállításához explicit displayOpenUI és displayMarkdown jogosultság kell. A meglévő jogosultságokat őrizd meg. A kanonikus Admin-mentés ellenőrzi a hívót, és naplózza a módosítást.

Az AGENT_TOOL_GRANT_REQUIRED ellenőrzést tartsd meg. A Complexity-csevegési jogosultság és az aktív futás- vagy csevegőeszköz-kiválasztás külön követelmény marad.

Publikálás után ellenőrizd a szolgáltatás készenlétét és az érintett felhasználói műveletet. Önmagában a forrásfájl módosítása nem bizonyítja, hogy a futó kód megváltozott.

Az opcionális egyedi React-nézetek aktiválása előtt olvasd el a custom runtime setupját.