Client Java per Kubernetes

Client Java per l'API di kubernetes.

Versionamento del client

Il client Java utilizza il Semantic Versioning. Incrementiamo il numero di versione major ogni volta che rigeneriamo il client per una nuova versione di Kubernetes (vedi la tabella sotto). Ogni volta che lo facciamo, vengono aggiunte nuove API e possibilmente modifiche sostanziali (breaking changes) negli stub dell'API Kubernetes generati. Ogni volta che si aggiorna una versione major, bisogna essere preparati a potenziali modifiche sostanziali.

Installazione

Per installare la libreria del client Java nel tuo repository Maven locale, esegui semplicemente:

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

Fai riferimento alla documentazione ufficiale per maggiori informazioni.

Utenti Maven

Aggiungi questa dipendenza al POM del tuo progetto:

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

Utenti Gradle

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

Altri

Per prima cosa genera il JAR eseguendo:

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

Quindi installa manualmente i seguenti JAR:

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

Esempio

Abbiamo preparato alcuni esempi per i casi d'uso comuni, mostrati di seguito:

• Configurazione:
  • InClusterClientExample: Configura un client mentre si è in esecuzione all'interno del cluster Kubernetes.
  • KubeConfigFileClientExample: Configura un client per accedere a un cluster Kubernetes dall'esterno.
• Nozioni di base:
  • SimpleExample: Esempio minimo e semplice di come usare il client.
  • ProtoExample: Invia/ricevi payload nel protocollo di serializzazione protobuf.
  • (5.0.0+) PatchExample: Applica patch agli oggetti risorsa in vari formati supportati, equivalente a kubectl patch.
  • FluentExample: Costruisci risorse arbitrarie in stile fluent builder.
  • YamlExample: Metodo consigliato per caricare o esportare risorse in Yaml.
• Streaming:
  • WatchExample: Sottoscrivi gli eventi watch di determinate risorse, equivalente a kubectl get <resource> -w.
  • LogsExample: Recupera i log dai container in esecuzione, equivalente a kubectl logs.
  • ExecExample: Stabilisci una sessione "exec" con i container in esecuzione, equivalente a kubectl exec.
  • PortForwardExample: Mappa una porta locale su una porta del pod, equivalente a kubectl port-forward.
  • AttachExample: Agganciati a un processo già in esecuzione all'interno di un container esistente, equivalente a kubectl attach.
  • CopyExample: Copia file e directory da e verso i container, equivalente a kubectl cp.
  • WebSocketsExample: Stabilisci una sessione web-socket arbitraria verso determinate risorse.
• Avanzato: (NOTA: l'esempio seguente richiede il modulo client-java-extended）
  • (5.0.0+) InformerExample: Costruisci un informer che esegue list-watch delle risorse e riflette le notifiche in una cache locale.
  • (5.0.0+) PagerExample: Supporta la paginazione (solo per le richieste di list) per alleggerire i carichi lato server e la congestione di rete.
  • (6.0.0+) ControllerExample: Costruisci un controller che riconcilia lo stato del mondo eseguendo list-watch su una o più risorse.
  • (6.0.0+) LeaderElectionExample: Utilità di leader election per aiutare a implementare controller HA.
  • (9.0.0+) SpringIntegrationControllerExample: Costruisci un controller Kubernetes basato sull'iniezione dei bean del framework Spring.
  • (9.0.0+) GenericKubernetesClientExample: Costruisci un'interfaccia client generica per qualsiasi tipo Kubernetes, incluse le CRD.

elenca tutti i pod:

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;