Add configuration / guide notes on running the test network on Rancher

Signed-off-by: Josh Kneubuhl <jkneubuh@us.ibm.com>
This commit is contained in:
Josh Kneubuhl 2022-05-02 16:22:24 -04:00 committed by Dave Enyeart
parent 551250636d
commit 9ca1cc7c63
2 changed files with 32 additions and 2 deletions

View file

@ -25,11 +25,11 @@ _Fabric, Ahoy!_
## Quickstart ## Quickstart
Create a local Kubernetes cluster: Create a KIND Kubernetes:
```shell ```shell
./network kind ./network kind
``` ```
For environments with Rancher / k3s + mobyd: Or for environments running [Rancher k3s](docs/KUBERNETES.md#rancher-desktop-and-k3s):
```shell ```shell
export TEST_NETWORK_CLUSTER_RUNTIME=k3s export TEST_NETWORK_CLUSTER_RUNTIME=k3s

View file

@ -69,6 +69,36 @@ or:
$ kind delete cluster $ kind delete cluster
``` ```
## Rancher Desktop and k3s
In addition to KIND, the Kube Test Network runs on the k3s Kubernetes provided by [Rancher Desktop](https://rancherdesktop.io).
To run natively on k3s, skip the creation of a KIND cluster and:
1. In Rancher's Kubernetes Settings:
1. Disable Traefik
2. Select the dockerd (moby) container runtime
3. Increase Memory allocation to 8 GRAM
4. Increase CPU allocation to 8 CPU
2. Reset Kubernetes
3. Initialize the Nginx ingress and cert-manager:
```shell
export TEST_NETWORK_CLUSTER_RUNTIME=k3s
./network cluster-init
```
- containerd is also a viable runtime. When building images for chaincode-as-a-service, the `--namespace k8s.io`
argument must be applied to the `nerdctl` CLI.
- For use with containerd:
```shell
export CONTAINER_CLI=nerdctl
```
## Test Network Structure ## Test Network Structure
To emulate a more realistic example of multi-party collaboration, the test network To emulate a more realistic example of multi-party collaboration, the test network