Kubernetes-Java-Client

Java-Client für die kubernetes-API.

Client-Versionierung

Der Java-Client verwendet Semantic Versioning. Wir erhöhen die Hauptversionsnummer immer dann, wenn wir den Client für eine neue Kubernetes-Release-Version neu generieren (siehe Tabelle unten). Dabei werden neue APIs hinzugefügt und es kann möglicherweise zu Breaking Changes in den generierten Kubernetes-API- Stubs kommen. Wenn Sie eine Hauptversion aktualisieren, seien Sie auf mögliche Breaking Changes vorbereitet.

Installation

Um die Java-Client-Bibliothek in Ihrem lokalen Maven-Repository zu installieren, führen Sie einfach Folgendes aus:

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

Weitere Informationen finden Sie in der offiziellen Dokumentation.

Maven-Benutzer

Fügen Sie diese Abhängigkeit zur POM-Datei Ihres Projekts hinzu:

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

Gradle-Benutzer

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

Andere

Erzeugen Sie zunächst das JAR, indem Sie Folgendes ausführen:

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

Installieren Sie dann manuell die folgenden JARs:

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

Beispiel

Wir haben einige Beispiele für häufige Anwendungsfälle vorbereitet, die unten aufgeführt sind:

• Konfiguration:
  • InClusterClientExample: Konfigurieren Sie einen Client, während Sie innerhalb des Kubernetes-Clusters laufen.
  • KubeConfigFileClientExample: Konfigurieren Sie einen Client, um von außen auf einen Kubernetes-Cluster zuzugreifen.
• Grundlagen:
  • SimpleExample: Einfachstes Minimalbeispiel für die Verwendung des Clients.
  • ProtoExample: Payloads im Protobuf-Serialisierungsprotokoll anfordern/empfangen.
  • (5.0.0+) PatchExample: Ressourcenobjekte in verschiedenen unterstützten Patch-Formaten patchen, gleichbedeutend mit kubectl patch.
  • FluentExample: Beliebige Ressourcen im Fluent-Builder-Stil erstellen.
  • YamlExample: Empfohlene Methode zum Laden oder Speichern von Ressourcen in YAML.
• Streaming:
  • WatchExample: Watch-Ereignisse von bestimmten Ressourcen abonnieren, gleichbedeutend mit kubectl get <resource> -w.
  • LogsExample: Logs von laufenden Containern abrufen, gleichbedeutend mit kubectl logs.
  • ExecExample: Eine "exec"-Sitzung mit laufenden Containern aufbauen, gleichbedeutend mit kubectl exec.
  • PortForwardExample: Bildet einen lokalen Port auf einen Port des Pods ab, gleichbedeutend mit kubectl port-forward.
  • AttachExample: An einen Prozess anhängen, der bereits in einem vorhandenen Container läuft, gleichbedeutend mit kubectl attach.
  • CopyExample: Kopiert Dateien und Verzeichnisse von und zu Containern, gleichbedeutend mit kubectl cp.
  • WebSocketsExample: Eine beliebige WebSocket-Sitzung zu bestimmten Ressourcen aufbauen.
• Fortgeschritten: (HINWEIS: Das folgende Beispiel erfordert das Modul client-java-extended）
  • (5.0.0+) InformerExample: Einen Informer aufbauen, der Ressourcen per List-Watch überwacht und die Benachrichtigungen in einem lokalen Cache widerspiegelt.
  • (5.0.0+) PagerExample: Unterstützt Pagination (nur für die List-Anfrage), um serverseitige Last/Netzwerküberlastung zu verringern.
  • (6.0.0+) ControllerExample: Einen Controller aufbauen, der den Zustand der Welt durch List-Watching einer oder mehrerer Ressourcen abgleicht.
  • (6.0.0+) LeaderElectionExample: Leader-Election-Hilfsprogramme zur Implementierung von HA-Controllern.
  • (9.0.0+) SpringIntegrationControllerExample: Einen Kubernetes-Controller auf Basis der Bean-Injektion des Spring-Frameworks erstellen.
  • (9.0.0+) GenericKubernetesClientExample: Eine generische Client-Schnittstelle für beliebige Kubernetes-Typen, einschließlich CRDs, erstellen.

alle Pods auflisten: