The English version of quarkus.io is the official project site. Translated sites are community supported on a best-effort basis.

Servicios de desarrollo para Kubernetes

Dev Services for Kubernetes automatically starts a Kubernetes API server in dev mode and when running tests. So you don’t have to start a Kubernetes cluster manually. The application is configured automatically.

Activación y desactivación de los servicios de desarrollo para Kubernetes

Dev Services para Kubernetes se activa automáticamente a menos que:

  • quarkus.kubernetes-client.devservices.enabled se establece en false

  • el master-url está configurado

  • se encuentra un archivo de configuración de Kube válido y quarkus.kubernetes-client.devservices.override-kubeconfig no está configurado como true

  • incluye la dependencia quarkus-test-kubernetes-client

Dev Services for Kubernetes relies on Docker to start the API server. If your environment does not support Docker, you will need to start the Kubernetes cluster manually, or connect to an already running Kubernetes cluster. You can configure the Kubernetes cluster access using either a Kube config file or the various properties available in the KubernetesClientBuildConfig class.

Clúster compartido

Most of the time you need to share the cluster between applications. Dev Services for Kubernetes implements a service discovery mechanism for your multiple Quarkus applications running in dev mode to share a single cluster.

Dev Services for Kubernetes inicia el contenedor con la etiqueta quarkus-dev-service-kubernetes que se utiliza para identificar el contenedor.

If you need multiple (shared) clusters, you can configure the quarkus.kubernetes-client.devservices.service-name configuration property and indicate the cluster name. It looks for a container with the name defined, or starts a new one if none can be found. The default service name is kubernetes.

Sharing is enabled by default in dev mode, but disabled in test mode. You can disable the sharing with quarkus.kubernetes-client.devservices.shared=false.

Configuración del clúster

Dev Services for Kubernetes provides three different flavors of Kubernetes cluster. Each flavor supports different Kubernetes API versions. You can configure the flavor and version using the quarkus.kubernetes-client.devservices.flavor and quarkus.kubernetes-client.devservices.api-version properties:

quarkus.kubernetes-client.devservices.flavor=api-only # k3s or kind
quarkus.kubernetes-client.devservices.api-version=1.22

api-only sólo inicia un servidor API Kubernetes. Si necesita un clúster Kubernetes con todas las funciones que puede girar Pods, puede utilizar k3s o kind. Tenga en cuenta que ambos requieren para ejecutar en modo privilegiado Docker.

Si no se define api-version, se utilizará la versión más reciente para el tipo dado. De lo contrario, la versión debe coincidir con una versión soportada por el sabor dado.