Darbas su keliais saugyklomis
Šiame puslapyje
Pamoka atnaujinta 2026 m. lapkričio 3 d. remiantis Codex Cloud dokumentacija: kelios saugyklos dabar veikia kartu „Codex Cloud“ aplinkoje (senas adresas codex.openai.com nebėra pagrindinis įėjimo taškas). Šaltinis: Codex Cloud.
Išskirstytų architektūrų sudėtingumo valdymas
Šiuolaikiniai projektai dažnai apima kelias saugyklas: „frontend“, „backend“, bendrinamą biblioteką, mokėjimų servisą. Kiekviena jų turi savo gyvavimo ciklą, CI konvejerį ir prižiūrėtojus. Tokia schema veikia puikiai – tol, kol pokytis peržengia saugyklų ribas. Būtent čia „Codex“ keičia taisykles: jis gali dirbti su keliomis saugyklomis vienu metu.
Tikroji tarpusavyje susijusių pokyčių kaina
Įsivaizduokite įprastą užduotį: „backend“ saugykloje pridedate lauką į API atsakymą. Tada turite atnaujinti API klientą „frontend“ saugykloje, bendrinamus tipus bendrojoje saugykloje, dokumentaciją dokumentų saugykloje ir integracinius testus e2e saugykloje. Atskirai nė viena iš šių keturių užduočių nėra sudėtinga. Kartu jos reiškia keturis konteksto perjungimus, keturias šakas, keturis „pull request“ ir keturias galimybes vieną jų pamiršti. Praktikoje dokumentacija arba e2e testai praleidžiami, o problema išlenda po trijų savaičių kaip klaida, kurios niekas nesieja su tuo pradiniu pakeitimu.
Kelių saugyklų koordinavimas
„Codex Cloud“ aplinkoje galima sujungti kelias GitHub saugyklas: jas pasirenkate kurdami aplinką, „Codex“ nustato jų priklausomybes ir įrankius, o kiekviena toje aplinkoje paleista užduotis veikia visoje saugyklų aibėje. Tada savo užklausoje aprašote pokytį kaip visumą, o ne kaip atskirus fragmentus:
"In the backend repo (api-service):
- Add a GET /api/v2/products endpoint with pagination
In the frontend repo (web-app):
- Update the API client to use the new endpoint
- Add pagination to the ProductList component"
„Codex“ pritaiko pakeitimus kiekvienoje saugykloje ir atidaro suderintus „pull request“. Bendrinamo tipo platinimas vyksta pagal tą pačią logiką, tik reikia aiškiai nurodyti vieną papildomą reikalavimą: patikrinti, ar kompiliacija pavyksta visose paveiktose saugyklose. Be šios instrukcijos klaidą tipe mobiliųjų programėlių saugyklos CI aptiksite tik po dviejų valandų, kai visa kita jau bus sulieta.
"The Product type in shared-types/src/product.ts has been
modified (added tags: string[] field).
Update all usages in:
- api-service: routes and services that use Product
- web-app: components that display a Product
- mobile-app: screens that display a Product
Ensure each repo compiles without errors."
AGENTS.md konfigūravimas monorepo
Jei jūsų projektas yra monorepo („Turborepo“, „Nx“, „Lerna“), logika apsiverčia: paketai dalijasi vienu failų medžiu, o AGENTS.md failų hierarchija nusako skirtumus tarp jų. Šakninis failas aprašo bendrą struktūrą ir taisykles, galiojančias visur:
# AGENTS.md (monorepo root)
## Structure
Turborepo monorepo with the following packages:
- packages/api — Fastify backend
- packages/web — Next.js frontend
- packages/shared — Shared types and utilities
- packages/e2e — Playwright end-to-end tests
## Rules
- Changes to packages/shared MUST be followed by a build
of all dependent packages
- Global build command: `turbo run build`
- Global test command: `turbo run test`
Kiekvienas subpojektas šį pagrindą papildo savo konvencijomis, niekada nekartodamas to, kas jau yra šakniniame faile:
# packages/api/AGENTS.md
## Backend API
- Framework: Fastify
- Validation: Zod (schemas in src/schemas/)
- Types from packages/shared are imported via @myorg/shared
- Every new route requires a test in __tests__/
Du orientaciniai tarpusavyje susiję darbo procesai
Pirmasis apima funkciją, apimančią visą grandinę. Atkreipkite dėmesį į ketvirtąją instrukciją: nuorodos tarp „pull request“ gali atrodyti nebūtinos, tačiau būtent jos leidžia „frontend“ saugyklos recenzentui suprasti, kodėl egzistuoja šis mygtukas, neieškant atitinkamo „backend“ PR.
"New feature: favorites system.
1. shared-types: Add the Favorite type
2. api-service: CRUD /api/favorites with auth
3. web-app: Heart button on product cards
4. Create a PR in each repo with links
to the other repos' PRs in the description"
Antrasis apima versijuoto API migravimą. Čia žingsnių eiliškumas nėra tik formalumas: jis garantuoja, kad joks klientas neliks įstrigęs migracijos viduryje – v2 jau veikia, o v1 vis dar gyvas visą vartotojų migracijos langą.
"API v1 /users is deprecated. Create v2:
1. api-service: Add v2 routes with the new format
2. api-service: Mark v1 routes as deprecated (header)
3. web-app: Migrate all calls from v1 to v2
4. mobile-app: Migrate all calls from v1 to v2
5. docs: Update the API documentation"
Ko „Codex“ už tave negali padaryti
„Codex“ dirba su kiekviena saugykla atskirai, izoliuotose smėlio dėžėse. Jis negali vienu metu paleisti dviejų saugyklų: pavyzdžiui, negalite vienu metu paleisti „backend“ ir „frontend“ tikram integraciniam testui atlikti. Tarp saugyklų vykdomiems testams seka lieka rankinė:
- Sulieti individualius PR
- Paleisti integracinius testus iš savo CI/CD konvejerio
- Naudoti „Codex“ nustatytoms problemoms ištaisyti
Kitaip tariant, „Codex“ garantuoja parašyto kodo nuoseklumą, bet niekada – veikiančios sistemos nuoseklumą. Jūsų CI/CD lieka galutiniu arbitru, o atsargumas diktuoja, kad neturėtumėte diegti suderintų PR serijos, kol jis nepaskelbė savo verdikto.
Svarbiausi punktai
- „Codex“ gali kurti suderintus PR keliose saugyklose
- Bendrinami tipai yra idealus atvejis darbui su keliomis saugyklomis
- Konfigūruokite AGENTS.md kiekviename monorepo pakete
- Tarp saugyklų vykdomi integraciniai testai vis tiek turi būti patikrinti CI/CD
- Dokumentuokite tarpusavio priklausomybes faile AGENTS.md