Skip to content

Commit

Permalink
Docs updates for kind 0.8.1.
Browse files Browse the repository at this point in the history
  • Loading branch information
dgoodwin committed May 11, 2020
1 parent 8570cf5 commit ab24108
Showing 1 changed file with 6 additions and 16 deletions.
22 changes: 6 additions & 16 deletions docs/developing.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.

Expand Down

0 comments on commit ab24108

Please sign in to comment.