> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gorbit.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Kubernetes

> نشر Gorbit باستخدام Helm

<Tip>
  راجع [دليل الموارد](/deployment/getting_started/resourcing) قبل البدء.
</Tip>

## الدليل

حزمة Gorbit Helm تجمع جميع الخدمات المطلوبة (API، web، PostgreSQL، Vespa، إلخ) في نشر واحد.
بشكل افتراضي، سيتم إنشاء وحدات تخزين دائمة للخدمات ذات الحالة (مثل PostgreSQL، Vespa).

<Steps>
  <Step title="إضافة مستودع Gorbit Helm">
    ```bash theme={null}
    helm repo add gorbit https://gorbit-dot-app.github.io/gorbit/
    helm repo update
    helm search repo gorbit
    ```
  </Step>

  <Step title="تثبيت Gorbit">
    التثبيت في مساحة اسم خاصة (موصى به):

    ```bash theme={null}
    kubectl create namespace gorbit
    helm install gorbit gorbit/gorbit -n gorbit
    ```

    سيقوم هذا بسحب أحدث حزمة Gorbit ونشر جميع التبعيات.
  </Step>

  <Step title="التحقق من التثبيت">
    ```bash theme={null}
    helm list -n gorbit
    kubectl get pods -n gorbit
    ```

    انتظر حتى تكون جميع Pods في حالة `Running` قبل الوصول إلى Gorbit.
  </Step>

  <Step title="الوصول إلى Gorbit">
    بشكل افتراضي، يعرض الحزمة Gorbit عبر خدمة Kubernetes. للاختبار المحلي، يمكنك استخدام port-forward:

    ```bash theme={null}
    kubectl -n gorbit port-forward service/gorbit-nginx 8080:80
    ```

    ثم افتح [http://localhost:8080](http://localhost:8080).
  </Step>

  <Step title="تكوين Gorbit">
    قم بتكوين نشرك عن طريق تعديل ملف `values.yaml` في مجلد `gorbit/deployment/helm/charts/gorbit`.

    ستحتاج إلى إعادة تشغيل Gorbit بعد تغيير أي متغيرات في `values.yaml`.

    ```bash theme={null}
    helm upgrade gorbit gorbit/gorbit -n gorbit -f deployment/helm/charts/gorbit/values.yaml
    ```
  </Step>
</Steps>

راجع [Helm chart README](https://github.com/gorbit-dot-app/gorbit/tree/main/deployment/helm)
للخيارات المتقدمة مثل التشغيل كمستخدم غير root والاختبار باستخدام Kind.

## Next Steps

<CardGroup cols={2}>
  <Card title="Configure Authentication" icon="shield-check" href="/deployment/authentication/basic">
    Set up authentication for your Gorbit deployment with OAuth, OIDC, or SAML.
  </Card>

  <Card title="More Gorbit Configuration Options" icon="gear" href="/deployment/configuration/configuration">
    Learn about all available configuration options for your Gorbit deployment.
  </Card>
</CardGroup>