Kubernetes Java Client

Java-клиент для API kubernetes.

Версионирование клиента

Java-клиент использует семантическое версионирование. Мы увеличиваем номер основной версии каждый раз, когда перегенерируем клиент для новой версии релиза Kubernetes (см. таблицу ниже). При этом добавляются новые API и возможны критические изменения в сгенерированных заглушках Kubernetes API. При обновлении основной версии будьте готовы к потенциальным критическим изменениям.

Установка

Чтобы установить библиотеку Java-клиента в ваш локальный репозиторий 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: Изменение (patch) объектов ресурсов в различных поддерживаемых форматах, аналогично kubectl patch.
  • FluentExample: Создание произвольных ресурсов в стиле fluent builder.
  • YamlExample: Рекомендуемый способ загрузки или выгрузки ресурсов в YAML.
• Потоковая передача:
  • WatchExample: Подписка на watch-события определённых ресурсов, аналогично kubectl get <resource> -w.
  • LogsExample: Получение логов из запущенных контейнеров, аналогично kubectl logs.
  • ExecExample: Установка сеанса "exec" с запущенными контейнерами, аналогично kubectl exec.
  • PortForwardExample: Проброс локального порта на порт пода, аналогично kubectl port-forward.
  • AttachExample: Подключение к процессу, уже запущенному внутри существующего контейнера, аналогично kubectl attach.
  • CopyExample: Копирование файлов и каталогов в контейнеры и из них, аналогично kubectl cp.
  • WebSocketsExample: Установка произвольного web-socket сеанса с определёнными ресурсами.
• Продвинутый уровень: (ПРИМЕЧАНИЕ: следующий пример требует модуль client-java-extended）
  • (5.0.0+) InformerExample: Создание informer, который выполняет list-watch ресурсов и отражает уведомления в локальном кэше.
  • (5.0.0+) PagerExample: Поддержка постраничной выгрузки (только для list-запросов) для снижения нагрузки на сервер/сеть.
  • (6.0.0+) ControllerExample: Создание контроллера, который приводит состояние мира к желаемому (reconcile) путём list-watch одного или нескольких ресурсов.
  • (6.0.0+) LeaderElectionExample: Утилиты выбора лидера (leader election) для реализации отказоустойчивых контроллеров.
  • (9.0.0+) SpringIntegrationControllerExample: Создание kubernetes-контроллера на основе внедрения bean-компонентов Spring framework.
  • (9.0.0+) GenericKubernetesClientExample: Создание универсального клиентского интерфейса для любых типов kubernetes, включая CRD.

список всех подов:

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;