diff --git a/docs/developing.md b/docs/developing.md index 6ce8741581a..979fbaf2503 100644 --- a/docs/developing.md +++ b/docs/developing.md @@ -67,17 +67,11 @@ git clone https://github.com/openshift/hive.git ## Deploying with Kubernetes In Docker (kind) -[Kind](https://github.com/kubernetes-sigs/kind) can be used as a lightweight development environment for deploying and testing Hive. Currently, we support 0.5.1 version of Kind. The following instructions cover creating an insecure local registry (allowing for dramatically faster push/pull), and configuring your host OS, as well as the kind cluster to access it. This approch runs Hive in a container as you would in production, giving you the best coverage for manual testing. +[Kind](https://github.com/kubernetes-sigs/kind) can be used as a lightweight development environment for deploying and testing Hive. Currently, we support 0.8.1 version of Kind. The following instructions cover creating an insecure local registry (allowing for dramatically faster push/pull), and configuring your host OS, as well as the kind cluster to access it. This approch runs Hive in a container as you would in production, giving you the best coverage for manual testing. This approach requires [Docker](https://docs.docker.com/install). At present we do not have kind working with podman. -Deploy a local insecure registry container, and configure your host docker daemon to be able to use it: - -```bash -./hack/create-insecure-registry.sh -``` - -Create a kind cluster named 'hive' to deploy to. You can create as many kind clusters as you need.: +Create a local insecure registry (if one does not already exist) and then a kind cluster named 'hive' to deploy to. You can create as many kind clusters as you need and you have sufficient RAM. ```bash ./hack/create-kind-cluster.sh hive @@ -87,16 +81,12 @@ Create a kind cluster named 'hive' to deploy to. You can create as many kind clu ```bash $ docker ps -CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES -2756e565065a kindest/node:v1.15.3 "/usr/local/bin/entr…" 29 hours ago Up 29 hours 40393/tcp, 127.0.0.1:40393->6443/tcp hive-control-plane -1dc8a3c59d84 registry:2 "/entrypoint.sh /etc…" 2 weeks ago Up 8 days 0.0.0.0:5000->5000/tcp registry +CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES +ffddd07cd9e1 kindest/node:v1.18.2 "/usr/local/bin/entr…" 32 minutes ago Up 32 minutes 127.0.0.1:36933->6443/tcp hive-control-plane +8060ab7c8116 registry:2 "/entrypoint.sh /etc…" 2 days ago Up 2 days 0.0.0.0:5000->5000/tcp kind-registry ``` -Configure kubectl/oc to talk to your new cluster: - -```bash -export KUBECONFIG="$(kind get kubeconfig-path --name="hive")" -``` +You should now have a `kind-hive` context in your kubeconfig and set to current. **NOTE:** If you do not have `cfssljson` and `cfssl` installed, run the following command to install, otherwise, ignore this.