github.com/projectcontour/contour@v1.28.2/site/content/docs/1.25/guides/kind.md (about)

     1  ---
     2  title: Creating a Contour-compatible kind cluster
     3  ---
     4  
     5  This guide walks through creating a kind (Kubernetes in Docker) cluster on your local machine that can be used for developing and testing Contour.
     6  
     7  # Prerequisites
     8  
     9  Download & install Docker and kind:
    10  
    11  - Docker [installation information](https://docs.docker.com/desktop/#download-and-install)  
    12  - kind [download and install instructions](https://kind.sigs.k8s.io/docs/user/quick-start/)
    13  
    14  # Kind configuration file  
    15  
    16  Create a kind configuration file locally.
    17  This file will instruct kind to create a cluster with one control plane node and one worker node, and to map ports 80 and 443 on your local machine to ports 80 and 443 on the worker node container.
    18  This will allow us to easily get traffic to Contour/Envoy running inside the kind cluster from our local machine.
    19  
    20  Copy the text below into the local yaml file `kind-config.yaml`:
    21  
    22  ```yaml
    23  kind: Cluster
    24  apiVersion: kind.x-k8s.io/v1alpha4
    25  nodes:
    26  - role: control-plane
    27  - role: worker
    28    extraPortMappings:
    29    - containerPort: 80
    30      hostPort: 80
    31      listenAddress: "0.0.0.0"  
    32    - containerPort: 443
    33      hostPort: 443
    34      listenAddress: "0.0.0.0"
    35  ```
    36  	    
    37  # Kubernetes cluster using kind  
    38  
    39  Create a kind cluster using the config file from above:
    40  
    41  ```yaml
    42  $ kind create cluster --config kind-config.yaml
    43  ```
    44  
    45  Verify the nodes are ready by running:  
    46  
    47  ```yaml
    48  $ kubectl get nodes
    49  ```  
    50  
    51  You should see 2 nodes listed with status **Ready**:  
    52  - kind-control-plane
    53  - kind-worker
    54  
    55  Congratulations, you have created your cluster environment. You're ready to install Contour.  
    56  
    57  _Note:_ When you are done with the cluster, you can delete it by running:
    58  ```yaml
    59  $ kind delete cluster
    60  ```
    61  
    62  # Next Steps
    63  See https://projectcontour.io/getting-started/ for how to install Contour into your kind cluster.