لوحات Helm Charts على ArtifactHub عبر الاستضافة على GitHub Pages

Built for Speed: ~10ms Latency, Even Under Load
Blazingly fast way to build, track and deploy your models!
- Handles 350+ RPS on just 1 vCPU — no tuning needed
- Production-ready with full enterprise support
دعنا نناقش كيفية استضافة لوحات helm charts الخاصة بنا على GitHub Pages والسماح للأخرين باستخدام لوحاتنا على ArtifactHub. قبل فهم العملية، سنحاول فهم هذه المصطلحات بأبسط صورة ممكنة
ما هي Helm Chart
تُعد Helm charts هي الطريقة التي تقوم من خلالها بإنشاء قوالب (templatize) لموارد Kubernetes التي تريد نشرها. إذا كنت ترغب في إنشاء ресурс Kubernetes في عدة مجموعات (clusters) متعددة (أو حتى في نفس المجموعات) بقيم مختلفة، فإنك تقوم بإنشاء قالب للموارد وتجميعه في حزمة. تُعرف هذه الحزمة باسم helm chart.
GitHub Pages
تُعد GitHub Pages ميزة من GitHub تتيح لك إنشاء موقع إلكتروني أو صفحة ويب مستضافة على خوادم GitHub. إذا كان لديك ملف index.html بسيط، يمكنك استضافة ملف HTML هذا باستخدام اسم النطاق الموفَّر من GitHub والذي يكون عمومًا بالتنسيق username.github.io . إنها طريقة لشرح عملك أو عرض مشاريعك عبر الإنترنت دون الحاجة إلى خدمة استضافة ويب منفصلة. في حالتنا، سنقوم باستضافة لوحات helm charts الخاصة بنا على GitHub Pages.
ArtifactHub
تُعد ArtifactHub منصة قائمة على الويب تعمل كستودع مركزي لمختلف التوزيعات البرمجية مثل helm charts و OPA وغيرها. بمجرد إنشاء helm chart الخاصة بنا واستضافتها على GitHub Pages، سنجعلها قابلة للاكتشاف للمجتمع من خلال عرضها على ArtifactHub.
لا تقوم ArtifactHub باستضافة Helm charts نفسها، بل تعمل كجل سجل (registry) لمستودعات Helm chart. يمكن للمطورين نشر Helm charts الخاصة بهم إلى مستودعهم المفضل، مثل GitHub أو GitLab أو Bitbucket، ثم تسجيل مستودعهم مع ArtifactHub.
استضافة Helm Charts عبر GitHub Pages
الآن سنرى كيف يمكننا الاستفادة من ميزات Pages في GitHub لاستضافة helm charts الخاصة بتطبيقنا. في هذا المثال، سأستخدم نمونه من helm charts، ولكن يمكنك أيضًا استخدام helm charts المخصصة الخاصة بك بنفس الطريقة
الخطوة 1: إنشاء عينة من helm chart
سنبدأ بإنشاء عينة من helm chart
helm create sample-nginx
الخطوة 2: إنشاء مستودع GitHub
سنقوم بإنشاء مستودع GitHub عام حيث سنستضيف اللوحات.
- قم بإنشاء مستودع GitHub
- تأكد من أنه عام (public)
- أنشئ دليلًا باسم
chartsوالذي سيحتوي على helm chart الخاصة بك - دليل
chartsيكون في المستوى الجذر (root level) للمستودع الخاص بك - ادفع (Push) اللوحات الخاصة بك إلى فرع
mainفي المستودع
$ tree .
.
├── README.md
└── charts
└── sample-nginx
├── Chart.yaml
├── charts
├── templates
│ ├── NOTES.txt
│ ├── _helpers.tpl
│ ├── deployment.yaml
│ ├── hpa.yaml
│ ├── ingress.yaml
│ ├── service.yaml
│ ├── serviceaccount.yaml
│ └── tests
│ └── test-connection.yaml
└── values.yaml
لقد أنشأنا مستودعًا وتمت استضافته هنا:
الخطوة 3: إنشاء GitHub Access token
بمجرد أن تصبح charts الخاصة بنا في الفرع main، نحتاج إلى إنشاء pipeline يمكنه إنشاء GitHub release. وسيقوم GitHub release هذا بدوره بنشر charts الخاصة بنا. لهذا، نحتاج إلى إنشاء token بمجموعة محددة من permissions والتي سيتم استخدامها بعد ذلك في الـ pipeline الخاص بنا لإصدار charts.
- انقر على ملفك الشخصي في GitHub في الزاوية العلوية اليمنى
- انتقل إلى Settings.
- انتقل إلى Developer Settings في الخيار الأخير في اللوحة اليسرى.
- انتقل إلى Personal Access tokens وحدد Fine-grained tokens.
- انقر على Generate new token

- قم بتعيين اسم للـ token وحدد تاريخ انتهاء الصلاحية. في الوقت الحالي، أستخدم 7 أيام وبعدها سيصبح الـ token غير صالحة للاستخدام.
- في Repository Access، حدد Only select repositories واختر مستودع github الخاص بنا الذي نعمل عليه

- في قسم permissions، نحتاج فقط إلى استخدام Repository permissions.
- في هذا التحديد، نحتاج إلى
Read and writeلـContents

- في النظرة العامة (overview)، يجب أن نمتلك فقط هذه الأذونات
- بمجرد إنتاج الـ token، احتفظ به في مكان آمن معك للخطوة التالية.
الخطوة 4: إعداد GitHub Pages
يمكننا استخدام GitHub Pages لاستضافة موقعنا الإلكتروني مباشرة على GitHub (بشكل ثابت/static).
- لنقم بإنشاء فرع آخر في المستودع باسم
gh-pagesوتأكد من تسمية الفرع بـgh-pagesفقط. - في هذا الفرع، احذف كل شيء وأنشئ فقط ملفًا بسيطًا باسم
index.htmlلاختبار الاستضافة. وقم بدفع (Push) تغييراتك إلى GitHub.
<!DOCTYPE html>
<html>
<head>
<title>Sample charts</title>
<style>
.chart {
width: 400px;
height: 300px;
margin: 20px;
border: 1px solid #ccc;
box-shadow: 2px 2px 5px #ccc;
display: inline-block;
vertical-align: top;
padding: 10px;
box-sizing: border-box;
font-size: 14px;
line-height: 1.5;
}
.chart h3 {
margin-top: 0;
font-size: 18px;
font-weight: bold;
}
.chart p {
margin: 0;
}
</style>
</head>
<body>
<h1>Sample charts</h1>
<div class="chart">
<h3>Chart 1</h3>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer euismod diam et purus hendrerit mollis.</p>
<!-- add your chart code here -->
</div>
<div class="chart">
<h3>Chart 2</h3>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer euismod diam et purus hendrerit mollis.</p>
<!-- add your chart code here -->
</div>
<div class="chart">
<h3>Chart 3</h3>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer euismod diam et purus hendrerit mollis.</p>
<!-- add your chart code here -->
</div>
</body>
</html>
- انتقل إلى Settings تحت اسم المستودع الخاص بك وانقر على Pages في اللوحة اليسرى.

- في قسم Build and deployment، اختر الفرع
gh-pagesوانتظر لبعض الوقت حتى يقوم GitHub بمعالجته. بمجرد الانتهاء، ستحصل على URL في نفس النافذة. والنقر عليه سيظهر لكindex.htmlالذي أنشأناه. - انقر هنا للتحقق من index.html الخاص بنا — https://dunefro.github.io/sample-charts/
- الآن بدلاً من استضافة ملف HTML هذا، سنقوم باستضافة helm charts الخاصة بنا.
الخطوة 5: إنشاء pipeline في GitHub Actions
في الخطوات السابقة، ناقشنا أنبوب العمليات (pipeline) الذي سيستخدم رمز الوصول (Access token) لإنشاء إصدار على GitHub Release. يمكنك اختيار أي أداة تفضلها لأداء هذه المهمة، ولكنني سأختار GitHub Actions لذلك. تعد GitHub Actions أداة أخرى مدعومة بشكل أصلي في GitHub لتنفيذ مهام CI/CD.
قبل إنشاء الـ pipeline، سنقوم بإنشاء متغير سري (secret variable) لتمرير الـ token الذي أنشأناه في المهمة السابقة.
- انتقل إلى المستودع الخاص بك وانقر على Settings تحت اسم المستودع الخاص بك

- انتقل إلى Secrets and Variables في اللوحة اليسرى وانقر على Actions
- انقر على New Repository Secret وقم بلصق الـ token

يمكن الآن استخدام هذا الـ token في الـ pipeline لدفع الإصدارات (push releases).
الآن سنقوم بإنشاء GitHub Action pipeline
- أنشئ دليلاً
.github/workflowsفي المستوى الرئيسي (root level) للمستودع الخاص بك في الفرعmain. - هذا الدليل هو الدليل الافتراضي الذي نحتفظ فيه بجميع pipelines الخاصة بـ CI/CD لـ GitHub Actions لتشغيلها.
- أنشئ ملفًا باسم
release.yamlداخل الدليل المذكور أعلاه. - انقل وانسخ المحتوى التالي
name: Release Charts
on:
push:
branches:
- main
jobs:
release:
permissions:
contents: write # to push chart release and create a release (helm/chart-releaser-action)
runs-on: ubuntu-latest
steps:
- name: Checkout Code
uses: actions/checkout@v3
with:
fetch-depth: 0
- name: Configure Git
run: |
git config user.name "$GITHUB_ACTOR"
git config user.email "$GITHUB_ACTOR@users.noreply.github.com"
- name: Set up Helm
uses: azure/setup-helm@v3.5
with:
version: v3.9.2
- name: Run chart-releaser
uses: helm/chart-releaser-action@v1.5.0
env:
CR_TOKEN: "${{ secrets.HELM_RELEASE_TOKEN }}"
هذا الـ pipeline بسيط جدًا. فلنفهمه سريعًا
name— اسم الـ pipelineon— شرط تشغيل الـ pipeline، وهنا نحدد تشغيله مع كل push إلى الفرعmain.jobs— المهمة الفعلية التي تحتوي على كود الـ pipeline. وتحقق من أذوناتwriteفي المحتويات التي منحناها بالفعلstepsتُحدد خطوات الـ pipeline. حيث تكمن الخطوة الأولى في استخدامactions/checkout@v3. من الناحية المثالية، إذا كنت تنشئ الـ pipeline، فإنك ستقوم أولاً بعمل checkout للكود. بدلاً من كتابة كود الـ checkout، يوفر GitHub إمكانيةactionوالتي يمكن استخدامها مباشرة بدلاً من كتابة الكود.- في الخطوة الثانية، نقوم بتشغيل الأوامر لتهيئة git. وبالمثل، في الخطوة الثالثة نستخدم إجراء
azure/setup-helmالذي سيقوم بإعداد helm من أجلنا. - في الخطوة الأخيرة، نستخدم
helm/chart-releaser-actionلإصدار helm chart. وللإصدار، نحتاج إلى الـ secret token الذي أنشأناه بالفعل ومررناه في الـ pipeline عبر اسم الـ tokenHELM_RELEASE_TOKEN. سيقوم هذا الإجراء أيضًا بإنشاءindex.yamlفي الفرعgh-pagesمما يجعل صفحة GitHub تعمل كـ static registry لـ helm charts.
الخطوة 6 : تشغيل الـ pipeline والتحقق مما إذا تم إنشاء الإصدارات أم لا
الآن سنجري تغييرًا صغيرًا جدًا في ملف README.md الخاص بالمستودع في الفرع main حتى يتم تشغيل الـ pipeline. عندما قمت بدفع التغييرات (pushed the changes)، تمكنت من رؤية نقطة برتقالية صغيرة تشير إلى أن الـ pipeline قيد التشغيل

- انتقل إلى Actions تحت اسم المستودع والتحقق من الـ pipelines قيد التشغيل.
- بمجرد انتهاء الـ pipeline، يمكننا الانتقال إلى الفرع
gh-pagesوالتحقق مما إذا تم إنشاءindex.yamlأم لا. index.yamlهي طريقة يتمكن من خلالها helm من التعرف على أي موقع ويب مستضاف بشكل ثابت كـ helm registry.- بمجرد انتهاء الـ pipeline، سيتم تشغيل pipeline آخر تلقائيًا باسم
pages build and deploymentوالذي يتم إنشاؤه تلقائيًا بواسطة GitHub لاستضافة التغييرات التي نجريها فيgh-pages branchمما يجعلindex.yamlمتاحًا للعامة. — https://dunefro.github.io/sample-charts/index.yaml - يمكننا الانتقال والتحقق من الإصدارات في GitHub لملاحظة أن helm chart الخاص بنا قد تم إصداره في صفحة Releases. — https://github.com/dunefro/sample-charts/releases
الخطوة 7 : تأكيد الإصدار عن طريق نشره في minikube cluster
لاختبار ما إذا تم إنشاء helm registry الخاص بنا بنجاح أم لا
- أنشئ
minikubecluster - شغّل الأمر أدناه
# add the repo
helm repo add sample-charts https://dunefro.github.io/sample-charts/
helm repo update
# install the charts
helm upgrade --install test-nginx sample-charts/sample-nginx
# check pods
$ kubectl get pods
NAME READY STATUS RESTARTS AGE
test-nginx-sample-nginx-b95bb4f46-tbppn 1/1 Running 0 30s
الـ charts الخاصة بنا تعمل بشكل ممتاز.
إعداد ArtifactHub
الآن سنحاول معرفة كيفية إعداد حساب على ArtifactHub حتى نتمكن من عرض helm charts الخاصة بنا للمجتمع. قد تجد أيضًا بعض المخططات المجتمعية الأخرى مثل
الخطوة 1 : إنشاء حساب على ArtifactHub وإنشاء مستودع
الآن أصبحت مخططاتنا مستضافة. نحتاج إلى التأكد من إمكانية استخدامها من قبل المطورين الآخرين عبر ArtifactHub.
- انتقل إلى https://artifcathub.io وقم بالتسجيل.
- بعد ذلك، انقر على ملفك الشخصي من أيقونة الزاوية العلوية اليسرى ثم انقر على Control panel.
- انقر على + Add Repostiory وأضف تفاصيل المستودع. تأكد من استخدام الـ URL الذي تمت استضافة مخططاتك عليه في GitHub pages.

- الآن انتظر واسترخِ. سيقوم ArtifactHub بسحب التفاصيل تلقائيًا باستخدام
index.yamlالمستضاف في صفحاتنا
الخطوة 2 : التحقق من المستودع الخاص بك
يمكننا رؤية مستودعنا أثناء إنشائه، وبمجرد أن يتمكن ArtifactHub من سحب البيانات، سيبدأ أيضًا في الظهور في عمليات البحث. الآن نريد تطبيق شارة الناشر المعتمد (verified publisher tag) بشيء مثل هذا

لهذا نحتاج إلى إضافة ملف artifacthub-repo.yml في الفرع gh-pages كملف بيانات وصفية (metadata file) والذي سيتم قراءته بواسطة ArtifactHub، وبالتالي التحقق من أننا المالك للـ registry.
- انسخ الـ ID من المستودع الذي أنشأناه.
- أنشئ ملفًا باسم
artifacthub-repo.ymlفي الفرعgh-pagesبالمحتويات التالية
repositoryID: 67d52f16-b102-4661-bfa5-9e6694587e24
owners: # (optional, used to claim repository ownership)
- name: Vedant Pareek
email: dunefro@gmail.com
- قم بتحديث الـ version للمخطط الخاص بك حتى يستطيع كل من ArtifactHub و GitHub Actions التقاطه.
- انتظر لبعض الوقت لكي يقوم ArtifactHub بإجراء الفحص على الـ registry.
هذه هي نفس الطريقة التي استخدمناها لاستضافة helm charts العامة الخاصة بنا في Truefoundry. يُعد TrueFoundry منصة MLOps و LLMOps تُسهّل رحلة دورة الحياة الكاملة لنقل نماذج تعلم الآلة من مرحلة التطوير إلى الإنتاج. وتأخذ في الاعتبار جميع نقاط الألم طوال رحلة دورة حياة تعلم الآلة لتوفير السهولة والراحة أثناء بناء النماذج.
TrueFoundry AI Gateway delivers ~3–4 ms latency, handles 350+ RPS on 1 vCPU, scales horizontally with ease, and is production-ready, while LiteLLM suffers from high latency, struggles beyond moderate RPS, lacks built-in scaling, and is best for light or prototype workloads.



















.webp)




.webp)
.webp)
.png)

.png)
.png)
.png)
.png)
.png)
.webp)
.webp)






