Client Java pour Kubernetes

Client Java pour l'API kubernetes.

Versionnement du client

Le client Java utilise le Semantic Versioning. Nous incrémentons le numéro de version majeure à chaque fois que nous régénérons le client pour une nouvelle version de Kubernetes (voir le tableau ci-dessous). À chaque fois, de nouvelles API sont ajoutées et des changements potentiellement cassants peuvent survenir dans les stubs d'API Kubernetes générés. Lorsque vous passez à une version majeure supérieure, soyez prêt à faire face à d'éventuelles ruptures de compatibilité.

Installation

Pour installer la bibliothèque du client Java dans votre dépôt Maven local, exécutez simplement :

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

Reportez-vous à la documentation officielle pour plus d'informations.

Utilisateurs de Maven

Ajoutez cette dépendance au POM de votre projet :

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

Utilisateurs de Gradle

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

Autres

Commencez par générer le JAR en exécutant :

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

Installez ensuite manuellement les JAR suivants :

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

Exemple

Nous avons préparé quelques exemples pour des cas d'utilisation courants, présentés ci-dessous :

• Configuration :
  • InClusterClientExample: Configuration d'un client s'exécutant à l'intérieur du cluster Kubernetes.
  • KubeConfigFileClientExample: Configuration d'un client pour accéder à un cluster Kubernetes depuis l'extérieur.
• Notions de base :
  • SimpleExample: Exemple minimal simple d'utilisation du client.
  • ProtoExample: Envoi/réception de payloads en protocole de sérialisation protobuf.
  • (5.0.0+) PatchExample: Applique un patch aux objets de ressources dans différents formats de patch pris en charge, équivaut à kubectl patch.
  • FluentExample: Construit des ressources arbitraires dans un style de builder fluent.
  • YamlExample: Méthode recommandée pour charger ou décharger une ressource en Yaml.
• Streaming :
  • WatchExample: S'abonner aux événements watch de certaines ressources, équivaut à kubectl get <resource> -w.
  • LogsExample: Récupérer les logs des conteneurs en cours d'exécution, équivaut à kubectl logs.
  • ExecExample: Établir une session « exec » avec des conteneurs en cours d'exécution, équivaut à kubectl exec.
  • PortForwardExample: Fait correspondre un port local à un port du pod, équivaut à kubectl port-forward.
  • AttachExample: S'attache à un processus déjà en cours d'exécution dans un conteneur existant, équivaut à kubectl attach.
  • CopyExample: Copie des fichiers et des répertoires depuis et vers des conteneurs, équivaut à kubectl cp.
  • WebSocketsExample: Établit une session web-socket arbitraire vers certaines ressources.
• Avancé : (REMARQUE : L'exemple suivant nécessite le module client-java-extended）
  • (5.0.0+) InformerExample: Construit un informer qui liste et surveille les ressources et reflète les notifications dans un cache local.
  • (5.0.0+) PagerExample: Prend en charge la pagination (uniquement pour les requêtes de liste) afin d'alléger les charges côté serveur / la congestion du réseau.
  • (6.0.0+) ControllerExample: Construit un contrôleur qui réconcilie l'état du monde en listant et surveillant une ou plusieurs ressources.
  • (6.0.0+) LeaderElectionExample: Utilitaires d'élection de leader pour aider à implémenter des contrôleurs HA.
  • (9.0.0+) SpringIntegrationControllerExample: Construction d'un contrôleur Kubernetes basé sur l'injection de beans du framework Spring.
  • (9.0.0+) GenericKubernetesClientExample: Construit une interface client générique pour tout type Kubernetes, y compris les CRD.

lister tous les pods :