عميل جافا لـ Kubernetes

عميل جافا لواجهة برمجة تطبيقات kubernetes.

إصدارات العميل

يستخدم عميل جافا نظام الإصدارات الدلالية (Semantic Versioning). نقوم بزيادة رقم الإصدار الرئيسي كلما أعدنا توليد العميل لإصدار جديد من Kubernetes (انظر الجدول أدناه). وفي كل مرة نفعل ذلك، تُضاف واجهات برمجة تطبيقات جديدة وربما تغييرات جذرية في Stubs الخاصة بواجهة برمجة تطبيقات Kubernetes المولّدة. وكلما قمت بترقية إصدار رئيسي، كن مستعدًا لتغييرات جذرية محتملة.

التثبيت

لتثبيت مكتبة عميل جافا في مستودع Maven المحلي لديك، نفّذ فقط:

git clone --recursive https://github.com/kubernetes-client/java
cd java
mvn install

راجع التوثيق الرسمي لمزيد من المعلومات.

مستخدمو Maven

أضف هذا الاعتماد إلى ملف POM الخاص بمشروعك:

<dependency>
    <groupId>io.kubernetes</groupId>
    <artifactId>client-java</artifactId>
    <version>8.0.2</version>
</dependency>

مستخدمو Gradle

compile 'io.kubernetes:client-java:8.0.2'

طرق أخرى

أولًا، قم بتوليد ملف JAR بتنفيذ:

git clone --recursive https://github.com/kubernetes-client/java
cd java/kubernetes
mvn package

ثم قم بتثبيت ملفات JAR التالية يدويًا:

• target/client-java-api-8.0.3-SNAPSHOT.jar
• target/lib/*.jar

مثال

لقد أعددنا بعض الأمثلة لحالات الاستخدام الشائعة وهي موضحة أدناه:

• الإعداد:
  • InClusterClientExample: قم بإعداد عميل أثناء التشغيل داخل عنقود Kubernetes.
  • KubeConfigFileClientExample: قم بإعداد عميل للوصول إلى عنقود Kubernetes من الخارج.
• الأساسيات:
  • SimpleExample: مثال بسيط وأدنى لكيفية استخدام العميل.
  • ProtoExample: إرسال/استقبال الحمولات باستخدام بروتوكول تسلسل protobuf.
  • (5.0.0+) PatchExample: تصحيح كائنات الموارد في تنسيقات التصحيح المدعومة المختلفة، أي ما يعادل kubectl patch.
  • FluentExample: إنشاء مورد تعسفي بأسلوب البناء الانسيابي fluent builder.
  • YamlExample: الطريقة المقترحة لتحميل أو تفريغ الموارد بصيغة Yaml.
• البث:
  • WatchExample: الاشتراك في أحداث المراقبة من موارد معينة، أي ما يعادل kubectl get <resource> -w.
  • LogsExample: جلب السجلات من الحاويات قيد التشغيل، أي ما يعادل kubectl logs.
  • ExecExample: إنشاء جلسة "exec" مع الحاويات قيد التشغيل، أي ما يعادل kubectl exec.
  • PortForwardExample: تعيين منفذ محلي إلى منفذ على pod، أي ما يعادل kubectl port-forward.
  • AttachExample: الارتباط بعملية تعمل بالفعل داخل حاوية موجودة، أي ما يعادل kubectl attach.
  • CopyExample: نسخ الملفات والدلائل من وإلى الحاويات، أي ما يعادل kubectl cp.
  • WebSocketsExample: إنشاء جلسة web-socket تعسفية لموارد معينة.
• متقدم: (ملاحظة: يتطلب المثال التالي وحدة client-java-extended）
  • (5.0.0+) InformerExample: إنشاء informer يقوم بسرد ومراقبة الموارد ويعكس الإشعارات إلى ذاكرة تخزين مؤقت محلية.
  • (5.0.0+) PagerExample: دعم ترقيم الصفحات (لطلب القائمة فقط) لتخفيف الأحمال على الخادم/ازدحام الشبكة.
  • (6.0.0+) ControllerExample: إنشاء وحدة تحكم controller تعمل على مواءمة حالة العالم من خلال سرد ومراقبة مورد واحد أو عدة موارد.
  • (6.0.0+) LeaderElectionExample: أدوات انتخاب القائد للمساعدة في تنفيذ وحدات تحكم عالية التوفر HA.
  • (9.0.0+) SpringIntegrationControllerExample: بناء وحدة تحكم Kubernetes استنادًا إلى حقن الحبوب bean في إطار عمل spring.
  • (9.0.0+) GenericKubernetesClientExample: إنشاء واجهة عميل عامة لأي نوع من أنواع kubernetes، بما في ذلك CRDs.

سرد جميع الـ pods:

import io.kubernetes.client.openapi.ApiClient;
import io.kubernetes.client.openapi.ApiException;
import io.kubernetes.client.openapi.Configuration;
import io.kubernetes.client.openapi.apis.CoreV1Api;
import io.kubernetes.client.openapi.models.V1Pod;
import io.kubernetes.client.openapi.models.V1PodList;
import io.kubernetes.client.util.Config;

import java.io.IOException;

public class Example {
    public static void main(String[] args) throws IOException, ApiException{
        ApiClient client = Config.defaultClient();
        Configuration.setDefaultApiClient(client);

        CoreV1Api api = new CoreV1Api();
        V1PodList list = api.listPodForAllNamespaces(null, null, null, null, null, null, null, null, null);
        for (V1Pod item : list.getItems()) {
            System.out.println(item.getMetadata().getName());
        }
    }
}

مراقبة كائن namespace: