Kubernetes

يُربط Kubernetes عبر وكيل Polylane، المثبَّت في عنقودك بواسطة Helm. يوثّق الوكيل مرة واحدة بمفتاح API من Polylane محصور في cloud_accounts:write، ويسجّل العنقود، ويفتح Cloudflare Tunnel صادراً. لا يوجد kubeconfig تلصقه ولا منافذ واردة تفتحها، ولا تغادر بيانات اعتماد عنقودك العنقود أبداً.

الإعداد

1. ابدأ تدفق ربط Kubernetes في Polylane. ينشئ مفتاح API لك.
2. شغّل أمر Helm المعروض في التدفق:

helm install polylane oci://ghcr.io/coreplanelabs/charts/polylane-k8s \
  --namespace polylane --create-namespace \
  --set polylane.apiKey=<API_KEY> \
  --set config.cluster_name=<your cluster name>

3. يسجّل الوكيل نفسه ويظهر عنقودك في Polylane، عادةً في أقل من دقيقة. ثم يزامن Polylane أحمال العمل والخدمات وموارد العنقود الأخرى لديك.

لتثبيتات الإنتاج، فضّل apiKey.existingSecret (سرّ Kubernetes منشأ مسبقاً) على تمرير المفتاح في سطر الأوامر.

الأذونات

يعمل الوكيل بـ RBAC للقراءة فقط يمنح get وlist وwatch. لا يجري Polylane إلا استدعاءات Kubernetes API للقراءة فقط.

استكشاف الأخطاء

إذا لم يظهر العنقود، فافحص حاوية pod الوكيل: kubectl -n polylane get pods وkubectl -n polylane logs -l app.kubernetes.io/name=polylane-k8s -c agent.

الفصل

ألغِ تثبيت الإصدار بـ helm uninstall polylane --namespace polylane، وافصل العنقود في Polylane، ثم ألغِ مفتاح API للوكيل تحت Settings → API keys.

اتصال Kubernetes مصمَّم أصلاً على شكل pipeline: يُثبَّت الوكيل بواسطة Helm ويسجّل العنقود بنفسه، فبعد حصولك على مفتاح API لا تبقى أي خطوة في وحدة التحكم.

المتطلبات الأساسية

• مفتاح API من Polylane بنطاق cloud_accounts:write، مخزَّن كسرّ في pipeline. انظر مفاتيح API وOAuth. ينشئ التدفق الموجّه هذا المفتاح لك؛ ويعمل مفتاح تنشئه بنفسك بالطريقة نفسها.
• Helm وبيانات اعتماد للعنقود المستهدف في المهمة.

تثبيت الوكيل

helm upgrade --install polylane oci://ghcr.io/coreplanelabs/charts/polylane-k8s \
  --namespace polylane --create-namespace \
  --set polylane.apiKey=$POLYLANE_API_KEY \
  --set config.cluster_name=<your cluster name>

يبقي helm upgrade --install المهمة قابلة لإعادة التشغيل، والتسجيل idempotent لكل عنقود، فلا يكرر تكرار pipeline الاتصال أبداً. لتثبيتات الإنتاج، فضّل apiKey.existingSecret (سرّ Kubernetes منشأ مسبقاً) على تمرير المفتاح في سطر الأوامر.

يسجّل الوكيل نفسه ويظهر العنقود في Polylane، عادةً في أقل من دقيقة. وإن لم يحدث ذلك، فافحص حاوية pod الوكيل: kubectl -n polylane get pods وkubectl -n polylane logs -l app.kubernetes.io/name=polylane-k8s -c agent.

الفصل

ألغِ تثبيت الإصدار بـ helm uninstall polylane --namespace polylane، وافصل العنقود في Polylane، ثم ألغِ مفتاح API للوكيل تحت Settings → API keys.