Cliente Java do Kubernetes

Cliente Java para a API do kubernetes.

Versionamento do cliente

O cliente Java usa Versionamento Semântico. Incrementamos o número da versão principal sempre que regeneramos o cliente para uma nova versão de lançamento do Kubernetes (veja a tabela abaixo). Sempre que fazemos isso, novas APIs são adicionadas e possivelmente mudanças que quebram a compatibilidade nos Stubs da API do Kubernetes gerados. Ao atualizar uma versão principal, esteja preparado para possíveis mudanças que quebrem a compatibilidade.

Instalação

Para instalar a biblioteca do cliente Java em seu repositório Maven local, simplesmente execute:

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

Consulte a documentação oficial para mais informações.

Usuários Maven

Adicione esta dependência ao POM do seu projeto:

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

Usuários Gradle

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

Outros

Primeiro, gere o JAR executando:

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

Em seguida, instale manualmente os seguintes JARs:

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

Exemplo

Preparamos alguns exemplos para casos de uso comuns, mostrados abaixo:

• Configuração:
  • InClusterClientExample: Configure um cliente enquanto executa dentro do cluster Kubernetes.
  • KubeConfigFileClientExample: Configure um cliente para acessar um cluster Kubernetes a partir de fora.
• Básico:
  • SimpleExample: Exemplo mínimo simples de como usar o cliente.
  • ProtoExample: Solicitar/receber payloads no protocolo de serialização protobuf.
  • (5.0.0+) PatchExample: Aplique patch em objetos de recurso em vários formatos de patch suportados, equivalente a kubectl patch.
  • FluentExample: Construa recursos arbitrários em um estilo fluente de construtor.
  • YamlExample: Forma sugerida de carregar ou despejar recursos em YAML.
• Streaming:
  • WatchExample: Inscreva-se em eventos de watch de determinados recursos, equivalente a kubectl get <resource> -w.
  • LogsExample: Obtenha logs de contêineres em execução, equivalente a kubectl logs.
  • ExecExample: Estabeleça uma sessão "exec" com contêineres em execução, equivalente a kubectl exec.
  • PortForwardExample: Mapeia uma porta local para uma porta no pod, equivalente a kubectl port-forward.
  • AttachExample: Anexe a um processo já em execução dentro de um contêiner existente, equivalente a kubectl attach.
  • CopyExample: Copie arquivos e diretórios para e de contêineres, equivalente a kubectl cp.
  • WebSocketsExample: Estabeleça uma sessão arbitrária de web-socket para determinados recursos.
• Avançado: (NOTA: O exemplo a seguir requer o módulo client-java-extended)
  • (5.0.0+) InformerExample: Construa um informer que lista e assiste recursos e reflete as notificações em um cache local.
  • (5.0.0+) PagerExample: Suporte à Paginação (apenas para a solicitação de listagem) para aliviar a carga do lado do servidor/congestionamento de rede.
  • (6.0.0+) ControllerExample: Construa um controlador reconciliando o estado do mundo observando um ou vários recursos.
  • (6.0.0+) LeaderElectionExample: Utilitários de eleição de líder para ajudar a implementar controladores de alta disponibilidade (HA).
  • (9.0.0+) SpringIntegrationControllerExample: Construindo um controlador Kubernetes baseado na injeção de beans do framework Spring.
  • (9.0.0+) GenericKubernetesClientExample: Construa uma interface de cliente genérica para qualquer tipo Kubernetes, incluindo CRDs.

listar todos os 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;