Skip to content

Commit e6ea6d5

Browse files
authored
Merge pull request quarkusio#34157 from iocanel/doc-local-kubernetes-deployment
Add summary section for local kubernetes
2 parents 778ffaf + 7280f6f commit e6ea6d5

File tree

1 file changed

+20
-2
lines changed

1 file changed

+20
-2
lines changed

docs/src/main/asciidoc/deploying-to-kubernetes.adoc

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -960,7 +960,25 @@ quarkus.kubernetes.rbac.cluster-role-bindings.my-cluster-role-binding.role-name=
960960
<1> In this example, the cluster role "my-cluster-role" will be generated with the specified policy rules.
961961
<2> The name of the ClusterRole resource to use. Role resources are namespace-based and hence not allowed in ClusterRoleBinding resources.
962962

963-
=== Deploying to Minikube
963+
=== Deploying to local Kubernetes
964+
965+
When deploying to local Kubernetes environments, users often perform minor changes to their manifests that simplify the development process.
966+
The most common changes are:
967+
968+
- Setting `imagePullPolicy` to `IfNotPresent`
969+
- Using `NodePort` as `Service` type
970+
971+
Quarkus provides extensions that among others set these options by default.
972+
Such extensions are:
973+
974+
- quarkus-minikube
975+
- quarkus-kind
976+
977+
If the list of extensions does not match the tool you are using (e.g. Docker Desktop, microk8s etc) then it is suggested to use the `quarkus-minikube` extension.
978+
as its defaults should be reasonable for most environments.
979+
980+
981+
==== Deploying to Minikube
964982

965983
https://github.com/kubernetes/minikube[Minikube] is quite popular when a Kubernetes cluster is needed for development purposes. To make the deployment to Minikube
966984
experience as frictionless as possible, Quarkus provides the `quarkus-minikube` extension. This extension can be added to a project like so:
@@ -1008,7 +1026,7 @@ only. When deploying to production, consider using the vanilla Kubernetes manife
10081026
NOTE: If the assumptions the Minikube extension makes don't fit your workflow, nothing prevents you from using the regular Kubernetes extension to generate Kubernetes manifests
10091027
and apply those to your Minikube cluster.
10101028

1011-
=== Deploying to Kind
1029+
==== Deploying to Kind
10121030
https://kind.sigs.k8s.io/[Kind] is another popular tool used as a Kubernetes cluster for development purposes. To make the deployment to Kind
10131031
experience as frictionless as possible, Quarkus provides the `quarkus-kind` extension. This extension can be added to a project like so:
10141032

0 commit comments

Comments
 (0)