Skip to content

Latest commit

 

History

History
60 lines (40 loc) · 2.06 KB

CreateUnmanagedCluster.md

File metadata and controls

60 lines (40 loc) · 2.06 KB

Create and Test an Unmanaged Cluster Using Kind

Installing TCE does not create Kubernetes clusters. Rather, it installs the Tanzu CLI and several plugins that enable you to create clusters and manage packages in clusters.

Create a cluster:

tanzu unmanaged-cluster create tceworkshop --port-map '80:80,443:443'

This will create a single node unmanaged Kubernetes cluster using Kind (Kubernetes in Docker) on your local workstation. Unmanaged clusters are suitable for short-lived experimentation and learning (such as this workshop). They also start very quickly. This cluster will have the following characteristics:

  • Ports 80 and 443 are exposed on your workstation to allow easier access to workloads deployed on the cluster
  • The kapp controller will be installed to support Tanzu package management
  • The cluster will have the package catalog for Tanzu configured

Unmanaged clusters are not suitable for production workloads. For production workloads, TCE can create "managed clusters" in a variety of cloud based environments, on vSphere, and even on Docker on your workstation if you so desire.

Once the cluster is up, kubectl should be configured to connect to it. You can test this by running the following:

kubectl get nodes

You should see a single node named something like tceworkshop-control-plane.

Test Your Cluster

You can deploy a test image with the following command:

kubectl run kuard --restart=Never --image=gcr.io/kuar-demo/kuard-amd64:blue

Once the pod is running, enter the following command to access it:

kubectl port-forward kuard 8080:8080

Now you should be able to access the pod in a browser at http://localhost:8080

If you don't have a browser on the system, you can also hit the main page with curl:

curl http://localhost:8080

Assuming all this works, then enter ctrl-c to stop the port forward, then enter the following command to delete the pod:

kubectl delete pod kuard

Next (Explore the Cluster) ->