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

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