Ажиллагаа
Байршуулалт, ажиглалт, нөөцлөлт. ., stack/petronet ба
ажиллаж байгаа системээс уншиж бичигдсэн.
01Нэрнүүд, нэг хост
Хост бүр юу нээдгийг Байрлуулалт § Нэрнүүд
жагсаана: petronet.mn, admin., developer., monitoring., reports.,
backups., docs. — бүгд нэг frontend ба API, core-app-02 дээр,
edge core-nginx-01-ийн ард. Төхөөрөмжийн дөрвөн шугам
(desktop. / mobile. / kiosk. / pos.) ч мөн адил:
Байрлуулалт § Төхөөрөмжийн шугамууд.
Тусдаа нэр нь гоо зүйн биш: cookie нь hostname-аар хязгаарлагддаг тул тусдаа нэр нь тусдаа ambient authority гэсэн үг.
Консолын хаалга нь мөн платформын landing дизайнтай: нэвтрэх маягт нь hero дотор, доор нь эрхийн загвар ба impersonation-ий нөхцөлүүд. Session-гүй ирсэн хүн ард нь юу байгааг мэдэлгүй үлдэх ёсгүй — тэр хаяг юу болохыг хэлэх нь нууц задруулах биш, нэвтрэх шалгалт нь ард нь хэвээр байна.
02Байршуулалт
CI (ci.yml) ногоон болсны дараа:
text1ci.yml: backend ба frontend образ, тестийн хажуугаар → pending-tree-*2 ↓ ногоон бол publish: tree-* ба commit-ийн sha3deploy.yml ([self-hosted, core-dev]) → deploy@10.130.0.21:4 brand/copy.json хуулах → IMAGE_TAG=<sha> docker compose pull && up -d5 → эрүүл мэнд: 8220, 3220, https://petronet.mnХоёр зүйл зориуд:
- Хувилбар нь image дотор ldflags-аар шатаагдана. Тэгэхгүй бол систем
бүр өөрийн хувилбарыг мэдэхгүй болно — каталог
"platform": ">=1.шаардахад хариулах зүйлгүй.1. 0" - Образ tree-ээр дахин ашиглагдана. Ижил tree-тэй commit (жишээ нь merge) шинээр барихгүй, бэлэн образоо дахин тэмдэглэнэ.
Тохиргоо хостынх
Compose ба тогтмол тохиргоо erdenebatt/-ийн
stack/-д; нууц ба хостын утга нь
/-д (репод байхгүй). Deploy нь .env-д хүрэхгүй — зөвхөн
образын таг ба brand/-ийг солино. Шинэ тохиргоо нэмэх нь стекийн
compose-д мөр нэмэх; нууц бол .env-д.
Хоосон нууц чимээгүй өнгөрдөггүй. Заавал байх утгууд compose дээр
${X:?} хэлбэртэй — тавиагүй бол docker compose up асахаасаа өмнө унана.
03CI-ийн Windows worker
macOS, iOS, Android гурвыг GitHub-ийн үүлэн runner барина. Windows нь өөр: WinUI-ийн XamlCompiler ажиллуулахад Windows SDK ба Visual Studio Build Tools хэрэгтэй бөгөөд тэдгээрийн хувилбарыг өөрсдөө барихын тулд өөрийн төмөр дээр барина.
Одоогоор runner (petronet-win) бүртгэлгүй — Windows job дараалалд
хүлээгдэнэ. Доорх нь түүнийг дахин бүртгэх үеийн лавлагаа.
| Хост | Windows 11 Pro, 4 цөм, 16 ГБ |
| Хандалт | SSH (OpenSSH) |
| Runner | petronet-win11, шошго petronet-win |
| Байрлал | C:\actions-runner-petronet, сервис нь actions. |
| Сервисийн данс | NT AUTHORITY\NETWORK SERVICE — build хийхэд хангалттай, админ эрх хэрэггүй |
| Toolchain | .NET SDK 8.0.422 (C:\dotnet), git, VS Build Tools 2022: MSBuildTools + ManagedDesktopBuildTools + VCTools + Windows 11 SDK 26100 |
VCTools (MSVC) нь заавал. WinUI-ийн Microsoft.
нь VC\Tools\MSVC-г уншиж хамгийн сүүлийн хувилбарыг олдог — байхгүй бол
DirectoryNotFoundException шидэж build унана. dotnet SDK ганцаараа
хангалтгүй.
Тэр машин дээр хоёр дахь runner — eid-platform-mn-ийнх — зэрэгцэн
ажиллаж байгаа. Тиймээс job нь runs-on: [self-hosted, windows, petronet-win]
гэж ШОШГООР сонгоно: self-hosted дангаараа хоёр репогийн ажлыг хольж
явуулна.
Энэ репо хувийн (private), гэхдээ runner нь хуваалцсан төмөр. Fork-оос ирсэн PR (хувийн репог fork хийх эрхтэй хэн нэгний) workflow-г солиод тэр машин дээр дурын тушаал ажиллуулж чадах тул хамгаалалт хоёр давхар:
native-clients.-ийн windows job ньyml if:-ээр fork-ийн PR дээр огт ажиллахгүй (зөвхөн энэ репогийн салбарууд).- Репогийн Actions тохиргоо
all_— гаднын хүний PR бүр workflow ажиллахын өмнө зөвшөөрөл хүснэ.external_ contributors
Хоёуланг нь сулруулах нь тэр машиныг гаднын хүнд нээж өгнө. Хэрэв Windows-ийн
шалгалт fork-ийн PR дээр ч хэрэгтэй болвол зөв зам нь windows-latest руу
буцаах, runner-ийг нээх БИШ.
Runner дахин бүртгэх
Token хугацаа дуусах, эсвэл машин солигдох үед:
bash1gh api -X POST repos/gerege-systems/petronet-gerege-nexus/actions/runners/registration-token --jq .token2# дараа нь тэр машин дээр:3# C:\actions-runner-petronet\config.cmd --unattended --replace \4# --url https://github.com/gerege-systems/petronet-gerege-nexus \5# --token <TOKEN> --name petronet-win11 --labels petronet-win --runasserviceАжлын хавтас (_work) машин дээр үлддэг тул job бүрийн төгсгөлд
git clean -xdf хийнэ — үгүй бол гурван form factor-ийн build гаралт дискийг
хэдхэн долоо хоногт дүүргэнэ.
XAML-ийн алдааг хэрхэн УНШИХ вэ
dotnet build дээр WinUI-ийн XamlCompiler нь алдаатай XAML тулгарвал
чимээгүй 1 буцаана: stdout хоосон, output.json үүсэхгүй, MSBuild зөвхөн
MSB3073 ... гэж хэлнэ. Жинхэнэ мессежийг харах цорын ганц
зам нь компайлерыг MSBuild дотор ажиллуулах:
powershell1& "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\amd64\MSBuild.exe" `2 PetroNetDesktop.sln -p:Configuration=Release -p:FormFactor=Desktop -p:RestoreLockedMode=false -v:mamd64 хувилбарыг заавал: 32 битийн MSBuild нь RID-ыг win-x86 гэж
таамаглаад PlatformTarget=x64-тэй зөрж NETSDK1032 өгнө. Мөн -p:Platform
БҮҮ дамжуул — solution нь зөвхөн Any CPU тохиргоотой.
Энэ замаар олдсон нэг жишээ: XML коммент дотор давхар зураас (--) байж
болохгүй, тиймээс CSS-ийн --pn-blue мэтийн нэрийг .xaml комментод шууд
бичих нь бүх Windows build-ийг унагаана (WMC9999).
04Ажиглалт
Стекийн өөрийн Prometheus (stack/) — 15 секундээр,
15 хоног / 2 GB хадгална. Гурван зорилт: petronet-api, postgres-exporter
(9188), node-exporter.
| Хаана | Юу |
|---|---|
monitoring. | Ажиглалтын нүүр — нийтийн самбарууд руу заана |
monitoring. | Цөмийн мониторингийн апп, консолын session-оор (PROMETHEUS_URL) |
grafana. | Нийтийн гурван самбар: шатахууны урсгал, API тойм, дэд бүтэц |
Лог ба trace (Loki, Tempo) энэ стект байхгүй.
Хэмжүүр
Хэмжүүр бүр OpenTelemetry-ийн SDK-аар дамжиж, Prometheus exporter-ээр
/metrics дээр гарна. HTTP-ийнх нь semantic convention-ыг дагана:
text1http_server_request_duration_seconds{http_request_method,http_route,http_response_status_code}Хүсэлтийн тоо нь тусдаа counter биш — тэр гистограммын _count цуврал.
http. нь хаалттай олонлог. Танихгүй үйл үг
_OTHER болж нугалагдана: PROPFIND гэж дуудсан сканнер time series
үүсгэх ёсгүй.
Гадаад систем бүр нэг histogram-аар хэмжигдэнэ —
external_ — системийн нэр
нь мөн адил хаалттай олонлог, танихгүй нь other.
Шатахууны хэмжүүрүүд (fuel_*, petro_*, modules/) нь
улсын хэмжээнийх — тенантын шошгогүй.
Сэрэмжлүүлэг
Нөөцлөлтийн BackupStale дохио нь
backup_-ээс (pg-backup бичнэ).
05Өгөгдлийн сангийн role
Backend нь gerege_-аар холбогдоно (цөмийн 00115: SUPERUSER, BYPASSRLS,
CREATE эрхгүй). postgres-ээр холбогдвол RLS зөвхөн зөвлөмж болж, dbguard асах
бүрд ERROR бичдэг. Миграц (cmd/migrate: цөм, дараа нь petro — goose хүснэгт
goose_) эзэмшигч postgres-ээр ажиллаж, backend асахаас өмнө дуусна — gerege_ DDL хийж
чадахгүй тул модулийн миграцыг backend өөрөө хэрэгжүүлэхгүй.
Нууц үг нь .env-ийн API_; compose нь backend-ийн
DATABASE_URL-ийг түүгээр угсарна. Шалгах: логт
dbguard: the database login role is unprivileged, мөн
docker compose logs backend 2>&1 | grep -i "permission denied\|42501" хоосон.
06Нөөцлөлт
/, cron дээр өдөр бүр 03:15-д
(/, setup.sh тавина).
text1docker compose exec postgres pg_dumpall → gzip2 → restic-ээр Garage руу (backups/<hostname>, /data/petronet)3 → backup_last_success_timestamp_secondspg_dumpall нь role-уудыг сантай хамт авна — role-гүй сэргээсэн сан дээр
GRANT/POLICY унаж RLS эвдэрнэ. restic ба Garage-ийн түлхүүр
/-д (RESTIC_, AWS_,
AWS_). Лог: /.
Хэмжигдэхгүй нөөцлөлт нь нөөцлөлт байхгүйтэй бараг адил: cron-ий чимээгүй
бүтэлгүйтэл нь сэргээх өдрөө л илэрдэг — тиймээс BackupStale.
Сэргээлт
Нөөцлөлт нь сэргээгдэх хүртэл нөөцлөлт биш. Дараалал нь үргэлж ижил: dump → хаягдах кластер → шалгалт, ажиллаж байгаа руу биш.
restic-ээс сэргээх
Хостод restic суулгахгүй — pg-backup-ийн ашигладаг образ:
sh1cd /opt/petronet2R="-e RESTIC_REPOSITORY=s3:http://10.130.0.50:3900/backups/core-app-02 -e AWS_DEFAULT_REGION=garage"3RESTIC="docker run --rm --env-file backup.env $R restic/restic:0.19.1"4 5# 1. Snapshot-ууд6$RESTIC snapshots --host core-app-02 --path /data/petronet7 8# 2. Сэргээх (latest эсвэл тодорхой id)9mkdir -p ./restore10docker run --rm --env-file backup.env $R -v "$PWD/restore:/restore" \11 restic/restic:0.19.1 restore <snapshot-id> --target /restore12 13# 3. Хаягдах кластер14docker run -d --name pn_restore_check -e POSTGRES_PASSWORD=restore postgres:16-alpine15sleep 5 # эсвэл pg_isready хүлээх16gunzip -c restore/data/petronet/postgres.sql.gz \17 | docker exec -i pn_restore_check psql -U postgres -d postgres # «already exists» — хэвийнСэргээлтийг шалгах
sh1docker exec pn_restore_check psql -U postgres -d petronet -c \2 "select count(*) from information_schema.tables3 where table_schema in ('workspace','registry','operator')"4# RLS амьд эсэх: бодлогууд ирсэн, тенантын role байгаа5docker exec pn_restore_check psql -U postgres -d petronet -c \6 "select count(*) from pg_policies"7docker exec pn_restore_check psql -U postgres -d petronet -c \8 "select rolname from pg_roles where rolname = 'gerege_nexus_tenant'"9docker rm -f pn_restore_check && rm -rf ./restorepg_policies 0 эсвэл тенантын role алга бол dump бүтэн ачаалагдаагүй —
эхний алдааг psql-ийн гаралтаас хайна.
07Edge-ийн урхи
TLS ба vhost бүр edge core-nginx-01 дээр (stack/). Хоёр урхи
хариу 200 хэвээр байхад чимээгүй ажилладаг тул curl -I нь vhost
нэмсний дараах заавал хийх алхам.
add_header өв залгамжлахгүй. Хүү блок дотор НЭГ ч add_header байвал
дээд түвшнийхийг нь бүгдийг нь хаяна. Шийдэл нь бүх тогтвортой
add_header-ийг server түвшинд байлгах. CSP бол тогтвортой утга биш: Next.js
хүсэлт бүрд nonce үүсгэдэг тул тэр толгойг nginx өөрчлөлгүй нэвтрүүлнэ.
Certbot HTTP/2 бичдэггүй. http2 on; нь тусдаа заавар байх ёстой:
тэгвэл гэрчилгээ шинэчлэх бүрд алга болохгүй.
bash1curl -s -o /dev/null -w "http/%{http_version} %{http_code}\n" https://<нэр>/2curl -sI https://<нэр>/ | grep -iE 'content-security|strict-transport|x-frame'08Баримтын сайтыг шинэчлэх
docs. нь цөмийн docs апп (DOCS_HOST). Build үед
deploy/ нь docs/-д жагссан хуудсуудыг
content/docs руу байрлуулна; жагссан файл алга бол build унана. Тусдаа алхам
байхгүй — баримтын өөрчлөлт ч бусад шиг main руу merge хийгдэж гарна.
09Замын чиглүүлэгч (OSRM)
Цистерн баазаас ШТС рүү замд гарахад backend замыг OSRM-ээс асууж рейс дээр
хадгална (route_geom, route_, route_); нүүрний ба
/map-ийн зураг тэр замаар зурж, GPS ирээгүй үед цистернийг явсан хугацаагаар
нь зам дээр тооцоолон тавьдаг («≈» шошготой). OSRM нь стекийн osrm
үйлчилгээ (гадагш портгүй, backend OSRM_-оор ханддаг).
График нь репод байхгүй, /-д. setup.sh нь графикгүй үед
Geofabrik-ийн Монголын хандалтаас барина; шинэчлэх (сард нэг хангалттай):
text1OSRM_REFRESH=1 ./setup.sh && docker compose restart osrmГрафикгүй бол osrm контейнер унана, backend үүнийг шаарддаггүй: рейс хэвийн
бичигдэж, зураг бааз–ШТС хоёрыг шулуун тасархай шугамаар холбоно.
10Гараар хийгддэг зүйлс
Байршуулалт автомат; шинэ хост дээрх нэг удаагийн ажлыг (лавлах, OSRM-ийн
граф, нөөцлөлтийн cron) stack/ хийнэ. Үлдсэн нь:
/баopt/ petronet/. env backup.env— гараар (eID-ийн хос мөн)- eID-ийн mTLS клиентийн түлхүүр ба гэрчилгээ —
/opt/ petronet/ eid-client - Хостын дискэн дээрх хуучин Docker image-ийн цэвэрлэгээ — deploy бүр хоёр image нэмнэ ба тэдгээр нь өөрөө хэзээ ч явахгүй. Гарын авлага.
Дэлгэрэнгүй алхмуудыг Гарын авлага.