Cliente de Kubernetes para Java: Introducción a Fabric8
Introducción
El ecosistema de Kubernetes para desarrolladores Java está en pleno auge, ofreciendo una variedad de herramientas y recursos para interactuar con tu clúster. Si necesitas interactuar con el servidor de la API de Kubernetes, existen varias bibliotecas de cliente disponibles.
Como RedHatter, soy el responsable del mantenimiento del Fabric8 Kubernetes Client, una potente y ampliamente adoptada biblioteca de Java para trabajar con Kubernetes.
El Fabric8 Kubernetes Client es uno de los clientes Java más antiguos y establecidos para Kubernetes. A pesar de la aparición del cliente Java oficial de la CNCF, Fabric8 sigue siendo muy popular debido a su robusto conjunto de funciones, extensibilidad y API amigable para los desarrolladores.
Características principales del Fabric8 Kubernetes Client
El Fabric8 Kubernetes Client ofrece una amplia gama de funciones que lo convierten en una excelente opción para los desarrolladores de Java que trabajan con Kubernetes y lo distinguen de sus competidores.
- DSL rico: El cliente ofrece un Lenguaje Específico de Dominio (DSL) que simplifica las interacciones con la API de Kubernetes.
- Extensibilidad: Admite varias extensiones, incluidas las de Knative, Tekton e Istio.
- Cliente HTTP flexible: Desde la versión 6.0, los usuarios pueden configurar el cliente HTTP subyacente, lo que permite una mejor integración con las aplicaciones existentes.
- Soporte de Custom Resource: El cliente ofrece un excelente soporte para trabajar con Definiciones de Recursos Personalizados (CRDs).
- Compatibilidad nativa: Está diseñado para funcionar perfectamente en modo nativo, lo que lo convierte en una excelente opción para proyectos que utilizan frameworks como Quarkus.
Soporte integrado para Kubernetes y OpenShift
El Fabric8 Kubernetes Client ofrece soporte específico para Kubernetes y OpenShift.
| Clúster | Componente/Artefacto |
|---|---|
| Kubernetes | kubernetes-client |
| OpenShift | openshift-client |
Si bien el artefacto kubernetes-client es compatible con cualquier distribución de Kubernetes,
openshift-client proporciona capacidades adicionales específicas de OpenShift.
Extensiones para funcionalidades mejoradas
El Fabric8 Kubernetes Client también admite un creciente ecosistema de extensiones, permitiendo la integración perfecta con herramientas como Cert Manager, Istio, Tekton y muchas más:
Empezando con Fabric8 Kubernetes Client
Vamos a empezar configurando el Fabric8 Kubernetes Client en tu proyecto.
Cómo configurar Fabric8 Kubernetes Client en mi proyecto
Añadir Fabric8 a tu proyecto es sencillo.
Usa la siguiente dependencia para Maven:
<dependency>
<groupId>io.fabric8</groupId>
<artifactId>kubernetes-client</artifactId>
<version>7.1.0</version>
</dependency>O si tu proyecto está basado en Gradle:
dependencies {
implementation 'io.fabric8:kubernetes-client:7.1.0'
}Operaciones comunes con Fabric8 Kubernetes Client
El cliente Java de Fabric8 debería permitirte realizar al menos las mismas operaciones que puedes ejecutar con Kubectl o el cliente Go de Kubernetes.
En las siguientes secciones, encontrarás un resumen de las tareas más comunes (generalmente relacionadas con CRUD) que puedes realizar mientras usas el cliente Fabric8.
Recuperar una lista de recursos
El siguiente ejemplo devuelve una lista de Pods para el namespace especificado:
try (KubernetesClient kc = new KubernetesClientBuilder().build()) {
kc.pods().inNamespace("my-namespace").list().getItems()
.forEach(pod ->
System.out.printf("Pod %s%n", pod.getMetadata().getName()));
}Recuperar un recurso con un nombre dado
El siguiente ejemplo recupera un Pod con el nombre proporcionado del namespace especificado:
Pod pod = kc.pods().inNamespace("my-namespace").withName("my-pod").get();Crear un recurso
El siguiente ejemplo crea un ConfigMap en el namespace especificado:
kc.configMaps().inNamespace("my-namespace").resource(
new ConfigMapBuilder()
.withNewMetadata().withName("my-configmap").endMetadata()
.addToData("data-field", "data-value")
.build()
).create();Editar un recurso con un nombre dado
El siguiente ejemplo añade una anotación a un Pod con el nombre proporcionado del namespace especificado:
kc.pods().inNamespace("my-namespace").withName("my-pod")
.edit(p -> new PodBuilder(p)
.editMetadata().addToAnnotations("edited", "true").endMetadata().build());Eliminar un recurso con un nombre dado
El siguiente ejemplo elimina un Pod con el nombre proporcionado del namespace especificado y espera 10 segundos a que se complete la operación:
kc.pods().inNamespace("my-namespace").withName("my-pod").delete();
kc.pods().inNamespace("my-namespace").withName("my-pod")
.waitUntilCondition(Objects::isNull, 10, TimeUnit.SECONDS);Estos ejemplos demuestran la simplicidad y potencia del DSL fluido de Fabric8. Para más ejemplos, explora el cheatsheet oficial.
Conclusión
El Fabric8 Kubernetes Client es una herramienta completa para desarrolladores de Java que trabajan con Kubernetes. Sus características, extensiones y API amigable para los desarrolladores lo convierten en una excelente opción para gestionar recursos de Kubernetes de forma programática.
Sigue atento a más artículos donde profundizaré en operaciones avanzadas, integración con herramientas como el Mock Server y casos de uso del mundo real.
Mientras tanto, puedes explorar los siguientes recursos:
