HelixGitpx (Helix Git Proxy eXtended) — гэта федэраваны проксі Git, які захоўвае адзіную крыніцу праўды, адлюстроўваючы яе на мностве Git-хостаў вышэйшага ўзроўню, і вырашае непазбежныя канфлікты з дапамогай палітык і патокаў, асістававаных AI. Праект дасягнуў версіі v1.0.0 GA.

HelixGitpx — гэта федэраваны проксі Git, які адлюстроўвае адзіную крыніцу праўды на дзясятках Git-хостаў — GitHub, GitLab, Gitea, Bitbucket, Azure DevOps, AWS CodeCommit і іншых — і вырашае праблемы сінхранізацыі з дапамогай палітык і патокаў, асістававаных AI. Выпушчаны ў версіі v1.0.0 GA.

HelixGitpx — "Helix Git Proxy eXtended" — гэта федэраваны проксі Git, які захоўвае адзіную крыніцу праўды, адлюстроўваючы яе на мностве Git-хостаў вышэйшага ўзроўню, і вырашае канфлікты, якія непазбежна ўзнікаюць, калі адзін і той жа рэпазіторый існуе ў некалькіх месцах. Спіс падтрымоўваных хостаў нагадвае карту ўсяго экасістэмы Git: GitHub, GitLab, GitFlic, GitVerse, Gitea, Gitee, Bitbucket, Azure DevOps, AWS CodeCommit, Forgejo, SourceHut і звычайны Git праз HTTPS. У той час як наіўнае git push на дзясятак аддаленых рэпазіторыяў можа альбо праваліцца, альбо, што горш, дазволіць люстэркам ціха разысціся, HelixGitpx уступае ў гульню з патокамі вырашэння канфліктаў на аснове палітык і асістававаных AI механізмаў, якія вяртаюць разыходжанні да адзінай аўтарытэтнай крыніцы.

Праект знаходзіцца на версіі v1.0.0 GA, з этапнымі мэтамі ад m1-foundation да m8-ga, пазначанымі тэгамі — поўны шлях ад заснавання да агульнай даступнасці. Ён распрацаваны як тры ўзроўні аднаго прадукту: Go-монарэпа (платформа плюс васямнаццаць сэрвісаў, генератары кода і інструменты для стварэння каркаса), Angular-вяб-дадатак на 19 + Nx і Kotlin-Multiplatform + Compose-кліенцкія абалонкі, якія дастаўляюць натыўны досвед на Android, iOS і дэсктоп з агульнага кода. Дастаўка платформы цалкам натыўная для Kubernetes — Helm-чарты, дадаткі Argo CD, накладкі Kustomize, SQL і палітыкі OPA — з канвеерамі CI, якія запускаюцца толькі праз выразнае дыспетчаванне, каб нічога не выйшла выпадкова. Публічная дакументацыя прадстаўлена сайтам на Docusaurus (docs.helixgitpx.io) разам з маркетынгавым сайтам на Astro (helixgitpx.io).

Кіраванне строгае і заснаванае на канстытуцыйных прынцыпах, і гэта не проста фармальнасць, а важная асаблівасць: апорным дакументам з’яўляецца праектны Constitution, артыкул II якога патрабуе сямітыпавую матрыцу тэставання з 100%-ным пакрыццём *па кожным тыпе для кожнага закранутага модуля*, прычым макеты дазволеныя толькі ў юніт-тэстах, і ні адзін тэст не можа быць прапушчаны. Аднаразовы верыфікатар правярае ўсе артэфакты разам з go vet і go test па ўсім працоўным прасторы, і кожны push распаўсюджваецца на ўсе настроеныя хосты вышэйшага ўзроўню — такім чынам, "люстэркі сінхранізаваны" з’яўляецца нешта, што сістэма забяспечвае пры кожным каміце, а не нешта, пра што павінен памятаць чалавек.

Захаванне аўтэнтычнасці рэпазіторыя на мностве Git-хостаў — для рэзервавання, суверэнітэту ці доступу да рэгіянальных платформаў — з’яўляецца няўстойлівым і ручным працэсам, а разыходжанне люстэркаў цяжка выправіць. HelixGitpx быў створаны, каб зрабіць сінхранізацыю з некалькімі хостамі вышэйшага ўзроўню першакласнай магчымасцю, якая ўсведамляе канфлікты.

Змест

Гэта ператварае "адпраўку на шмат аддаленых сховішчаў і спадзяванне на лепшае" — крохкі ручны статус-кво — у кіраваную федэрацыю з адзінай аўтарытэтнай крыніцай праўды і аўтаматызаваным вырашэннем канфліктаў на аснове палітык і AI. І робіць гэта на незвычайна шырокім спектры хостаў, наўмысна ўключаючы рэгіянальныя платформы (GitFlic, GitVerse, Gitee), якія большасць інструментаў ціха ігнаруе. Такім чынам, рэзерваванне, суверэнітэт даных і дасягальнасць у гэтых экасістэмах перастаюць быць цяжарам абслугоўвання і становяцца адзінай магчымасцю, якую трэба наладзіць адзін раз.

Шырыня апстрымаў — дзясятак з лішнім Git-хостаў, ад GitHub і GitLab да рэгіянальных платформаў накшталт GitFlic, GitVerse і Gitee, усе аб’яднаныя за адным проксі.
Вырашэнне канфліктаў на аснове палітык і AI — разыходжанні ўзгадняюцца рухавіком палітык і рэзольверам AI, а не чалавекам, які ўручную параўноўвае люстэркі.
Федэрацыя з адзінай крыніцай праўды — мадэль адпраўкі на ўсе апстрымы, дзе адно аўтарытэтнае сховішча з’яўляецца праўдай, а кожны хост — люстэркам, якое падтрымліваецца ў сінхронным стане.
Дакладнае тэсціраванне з прымусовым выкананнем правілаў — сем тыпаў тэстаў з 100%-ным пакрыццём кожнага тыпу без выключэнняў, правераных адным скрыптам зялёнай сюіты, а не на веры.

Разыходжанні і канфлікты паміж шматлікімі апстрымамі. Адно і тое ж сховішча, якое існуе ў дзясятку месцаў, пачынае разыходзіцца, калі два хосты прымаюць розныя змены. Вырашана з дапамогай працэсаў вырашэння канфліктаў на аснове палітык і AI, замацаваных за адзінай крыніцай праўды, а таксама сінхранізаванай адпраўкі на ўсе апстрымы, якая падтрымлівае канвергенцыю кожнага люстэрка да гэтай адзінай праўды.
Аднастайная падтрымка рознастайных Git-хостаў. Кожны хост мае сваю аўтэнтыфікацыю, асаблівасці і API. Вырашана з дапамогай канфігурацыйных скрыптаў для кожнага апстрыма ў каталогу Upstreams/ і ўзроўню платформы, які абстрагуе гэтыя адрозненні, так што дадаванне новага хоста — гэта пытанне канфігурацыі, а не перапісу кода.
Доказ карэктнасці перад кожным зліццём. Вырашана з дапамогай абавязковай матрыцы з сямі тыпаў тэстаў і аднаразовага бар’ера verify-everything.sh, які запускае поўны набор праверак — і чыста спыняецца, калі кластар недаступны, так што карэктнасць можна даказаць як лакальна, так і ў CI.

Монарэпа Go — асноўны проксі і рухавік федэрацыі: платформа плюс 18 сэрвісаў, генерацыя кода і шаблоны, якія захоўваюцца ў адным сховішчы, каб увесь рухавік збіраўся і тэставаўся як адзінае цэлае.
Angular 19 + Nx — вэб-дадатак з Nx, які забяспечвае структуру зборкі/кэшавання монарэпы, неабходную для вялікага фронтэнда.
Kotlin Multiplatform + Compose — натыўныя абалонкі для Android, iOS і настольных прылад, створаныя з адной агульнай кодовай базы, так што тры платформы не азначаюць трох рэалізацый.
Kubernetes + Helm + Argo CD + Kustomize — хмарная дастаўка: Helm пакуе рэліз, Kustomize адаптуе яго для кожнага асяроддзя, а Argo CD узгадняе стан кластара з Git праз GitOps, каб стан кластара адпавядаў Git.
OPA (Rego) — палітыкі як код для вырашэння канфліктаў і кантролю доступу, што робіць рашэнні аб аўтарызацыі дэкларатыўнымі і падсправаздачнымі.
Docusaurus — сайт публічнай дакументацыі (docs.helixgitpx.io); Astro — маркетынгавы сайт (helixgitpx.io), кожны інструмент падыбраны пад тып зместу.
mise — зафіксаваны, узнаўляльны інструментальны ланцужок, каб кожны ўдзельнік і CI-ранер збіралі праект на аднолькавых версіях.

Змест

Статус: адпраўлена. У файле README праекта абвешчана версія v1.0.0 GA з пазнакамі ад m1-foundation да m8-ga. («v1.0.0 GA» — гэта заява самага праекта з README.)
Ліцэнзія: павінна быць вызначана. У справаздачах GitHub і API пазначана MIT, у той час як раздзел License у файле README паказвае Apache-2.0 (код) / CC-BY-SA-4.0 (дакументацыя) — перад публікацыяй трэба звярыць з фактычным файлам LICENSE.
Спасылкі на дакументацыю (docs.helixgitpx.io) і маркетынг (helixgitpx.io) пададзены згодна з README і не былі незалежна правераны — статус даступнасці НЕПАЦВЕРДЖАНЫ.

Прыярытэтны ўзровень: Helix-асноўны.

HelixGitpx shippedlicense: TBD

Source

Зводка

Кароткае апісанне

Падрабязнае апісанне

Навошта мы яго стварылі

Чаму гэта змяняе правілы гульні

Што новага

Галоўныя тэхнічныя выклікі і як мы іх пераадолелі

Тэхнічны стэк

Заўвагі аб статусе і сумленнасці