Blank white background with no objects or features visible.

تحية إلى منطقة أوروبا والشرق الأوسط وأفريقيا! توسع TrueFoundry نطاق حضورها في هذه المنطقة الحيوية. اقرأ المزيد ←

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

By TrueFoundry

Updated: November 16, 2026

Published: July 2, 2026

دعنا نناقش كيفية استضافة لوحات 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
Accessing Github Page for Helm Chart
  • قم بتعيين اسم للـ token وحدد تاريخ انتهاء الصلاحية. في الوقت الحالي، أستخدم 7 أيام وبعدها سيصبح الـ token غير صالحة للاستخدام.
  • في Repository Access، حدد Only select repositories واختر مستودع github الخاص بنا الذي نعمل عليه
Access token for Hem Chart
  • في قسم 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 بسيط جدًا. فلنفهمه سريعًا

  1. name — اسم الـ pipeline
  2. on — شرط تشغيل الـ pipeline، وهنا نحدد تشغيله مع كل push إلى الفرع main.
  3. jobs — المهمة الفعلية التي تحتوي على كود الـ pipeline. وتحقق من أذونات write في المحتويات التي منحناها بالفعل
  4. steps تُحدد خطوات الـ pipeline. حيث تكمن الخطوة الأولى في استخدام actions/checkout@v3 . من الناحية المثالية، إذا كنت تنشئ الـ pipeline، فإنك ستقوم أولاً بعمل checkout للكود. بدلاً من كتابة كود الـ checkout، يوفر GitHub إمكانية action والتي يمكن استخدامها مباشرة بدلاً من كتابة الكود.
  5. في الخطوة الثانية، نقوم بتشغيل الأوامر لتهيئة git. وبالمثل، في الخطوة الثالثة نستخدم إجراء azure/setup-helm الذي سيقوم بإعداد helm من أجلنا.
  6. في الخطوة الأخيرة، نستخدم helm/chart-releaser-action لإصدار helm chart. وللإصدار، نحتاج إلى الـ secret token الذي أنشأناه بالفعل ومررناه في الـ pipeline عبر اسم الـ token HELM_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 الخاص بنا بنجاح أم لا

  • أنشئ minikube cluster
  • شغّل الأمر أدناه

# 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 تُسهّل رحلة دورة الحياة الكاملة لنقل نماذج تعلم الآلة من مرحلة التطوير إلى الإنتاج. وتأخذ في الاعتبار جميع نقاط الألم طوال رحلة دورة حياة تعلم الآلة لتوفير السهولة والراحة أثناء بناء النماذج.

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

November 5, 2025
|
5 min read

إقامة البيانات في عصر الذكاء الاصطناعي الوكيل: كيف تُمكّن بوابات الذكاء الاصطناعي من تحقيق التوسع السيادي والامتثال

October 5, 2023
|
5 min read

<Webinar> عرض الذكاء الاصطناعي التوليدي للمؤسسات

Best Fine Tuning Tools for Model Training
May 3, 2024
|
5 min read

أفضل 6 أدوات ضبط دقيق (Fine-Tuning) لتدريب النماذج في عام 2026

May 25, 2023
|
5 min read

نماذج LLMs المفتوحة المصدر: تبنّها أو واجه اندثار أعمالك

November 17, 2026
|
5 min read

شرح قيود Claude Code (إصدار 2026)

No items found.
Guide to Langgraph vs Langchain
November 16, 2026
|
5 min read

مقارنة بين LangChain وLangGraph: أيهما الأفضل لك؟

مقارنة
A detailed guide on Claude Fable 5
November 16, 2026
|
5 min read

كلود فيبل 5: واجهة برمجة التطبيقات، المعايير، التسعير وكيفية استخدامه

الهندسة والمنتج
openrouter vs litellm
November 17, 2026
|
5 min read

LiteLLM مقابل OpenRouter: أيهما الأنسب لك؟

مقارنة
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.
Take a quick product tour
Start Product Tour
Product Tour