[camel-k] 01/01: Ref #4150: Add the installation guide for Docker Desktop

[nf...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

nfilotto pushed a commit to branch 4150/how-to-use-docker-desktop
in repository https://gitbox.apache.org/repos/asf/camel-k.git

commit 83648690caf2859d72318a0e4ff3faee2a348b2e
Author: Nicolas Filotto <nf...@talend.com>
AuthorDate: Fri Mar 24 17:41:12 2023 +0100

    Ref #4150: Add the installation guide for Docker Desktop
---
 docs/modules/ROOT/nav.adoc                         |  1 +
 .../ROOT/pages/installation/installation.adoc      |  3 ++-
 .../installation/platform/docker-desktop.adoc      | 31 ++++++++++++++++++++++
 .../ROOT/pages/installation/registry/registry.adoc |  3 ++-
 4 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc
index 85df328d1..5615c3d8c 100644
--- a/docs/modules/ROOT/nav.adoc
+++ b/docs/modules/ROOT/nav.adoc
@@ -1,6 +1,7 @@
 * xref:installation/installation.adoc[Installation]
 ** Kubernetes Platform
 *** xref:installation/platform/minikube.adoc[Minikube]
+*** xref:installation/platform/docker-desktop.adoc[Docker Desktop]
 *** xref:installation/platform/crc.adoc[CRC]
 *** xref:installation/platform/digitalocean.adoc[DigitalOcean]
 *** xref:installation/platform/gke.adoc[GKE]
diff --git a/docs/modules/ROOT/pages/installation/installation.adoc b/docs/modules/ROOT/pages/installation/installation.adoc
index 1c0b95de0..694bbb5b4 100644
--- a/docs/modules/ROOT/pages/installation/installation.adoc
+++ b/docs/modules/ROOT/pages/installation/installation.adoc
@@ -55,7 +55,7 @@ Camel K is also available in Operator Hub:
 $ kubectl create -f https://operatorhub.io/install/camel-k.yaml
 ```
 
-You will need to OLM framework to be propely installed in your cluster. More instructions on the https://operatorhub.io/operator/camel-k[Camel K Operator Hub] page.
+You will need to OLM framework to be properly installed in your cluster. More instructions on the https://operatorhub.io/operator/camel-k[Camel K Operator Hub] page.
 
 As an alternative, you can also use the `kamel` CLI to perform the same installation:
 
@@ -90,6 +90,7 @@ Camel K installation is usually straightforward, but for certain cluster types y
 
 - xref:installation/platform/openshift.adoc[OpenShift]
 - xref:installation/platform/minikube.adoc[Minikube]
+- xref:installation/platform/docker-desktop.adoc[Docker Desktop]
 - xref:installation/platform/kind.adoc[Kind]
 - xref:installation/platform/crc.adoc[Red Hat CodeReady Containers (CRC)]
 - xref:installation/platform/gke.adoc[Google Kubernetes Engine (GKE)]
diff --git a/docs/modules/ROOT/pages/installation/platform/docker-desktop.adoc b/docs/modules/ROOT/pages/installation/platform/docker-desktop.adoc
new file mode 100644
index 000000000..f922b31bd
--- /dev/null
+++ b/docs/modules/ROOT/pages/installation/platform/docker-desktop.adoc
@@ -0,0 +1,31 @@
+[[installation-on-docker-desktop]]
+= Installing Camel K on Docker Desktop
+
+You can run Camel K integrations on plain Kubernetes using Docker Desktop, for that an external registry is needed and Kubernetes must be enabled.
+
+First, enable Kubernetes by following the instructions in the https://docs.docker.com/desktop/kubernetes/#enable-kubernetes[official documentation page].
+
+Once Kubernetes is up and running, a registry can be started locally using the command:
+```
+docker run -d -p 5000:5000 --restart=always --name registry registry:2
+```
+
+As it is meant for development purpose only, the registry has not been configured to be secured. To allow Kubernetes to pull images from
+our unsecured registry, the address `host.docker.internal:5000` (corresponding to the address of the registry from a container
+https://docs.docker.com/desktop/networking/#i-want-to-connect-from-a-container-to-a-service-on-the-host[see for more details]) needs to be
+added to the `insecure-registries` by following the instructions in the https://docs.docker.com/registry/insecure/#deploy-a-plain-http-registry[official documentation page].
+
+
+An example of `daemon.json` with the expected configuration:
+```
+{
+    "insecure-registries": ["host.docker.internal:5000"]
+}
+```
+
+Once the configuration changed, the Docker daemon must be restarted to take the modification into account.
+
+Finally, you can install the Camel-K operator with insecure registry properly configured thanks to the next command:
+```
+kamel install --registry host.docker.internal:5000 --registry-insecure true
+```
diff --git a/docs/modules/ROOT/pages/installation/registry/registry.adoc b/docs/modules/ROOT/pages/installation/registry/registry.adoc
index 3482c9097..ace777087 100644
--- a/docs/modules/ROOT/pages/installation/registry/registry.adoc
+++ b/docs/modules/ROOT/pages/installation/registry/registry.adoc
@@ -7,8 +7,9 @@ A **default registry** is present in all the following supported installations:
 
 * **OpenShift**: all OpenShift installations (including CRC and real clusters) provide an internal container registry that is used for the S2I (source to image)
   feature. Camel K is able to leverage that registry.
-* **Minikube**: Minikube comes with a "registry addon" that can be enabled upon installation (see xref:installation/platform/minikube.adoc[install guide for Minikube ]). Camel K automatically detects the address of the registry and configures
+* **Minikube**: Minikube comes with a "registry addon" that can be enabled upon installation (see xref:installation/platform/minikube.adoc[install guide for Minikube]). Camel K automatically detects the address of the registry and configures
   it on the `IntegrationPlatform` when using the CLI (on `kamel install`).
+* **Docker Desktop**: Docker provides an https://github.com/distribution/distribution[open source Docker Registry] that can be started upon installation (see xref:installation/platform/docker-desktop.adoc[install guide for Docker Desktop]).
 
 Other platforms do not provide a default container registry and need to be configured accordingly.