Deploying a Sample Nginx App on a Cluster Using Kubectl
Having created a Kubernetes cluster using Container Engine for Kubernetes, you'll typically want to try it out by deploying an application on the nodes in the cluster. For convenience, the Cluster page includes a Getting Started tab that makes it easy to view and copy the commands to:
- download the kubeconfig configuration file for the cluster
- download and deploy a sample Nginx application using the Kubernetes command line tool kubectl from the instructions in a manifest file
- start the Kubernetes Dashboard to view the deployed application running on nodes in the cluster
To deploy the sample nginx application:
If you haven't already done so, follow the steps to download the cluster's kubeconfig configuration file and set the KUBECONFIG environment variable to point to the file. Note that you must download your own kubeconfig file. You cannot access a cluster using a kubeconfig file that a different user downloaded. See Downloading a Kubeconfig File to Enable Cluster Access.
In a terminal window, deploy the sample Nginx application by entering
kubectl create -f https://k8s.io/examples/application/deployment.yaml
If the command fails to connect to
https://k8s.io/examples/application/deployment.yaml , go to the url in a browser and download the manifest file
deployment.yaml to a local directory. Repeat the
kubectl create command and specify the local location of the
Use the Kubernetes Dashboard or kubectl to confirm that the sample application has deployed successfully. For example:
kubectl proxy to start the Kubernetes Dashboard.
- Open a browser and go to
http://localhost:8001/api/v1/namespaces/kube-system/services/https:kubernetes-dashboard:/proxy/ to display the Kubernetes Dashboard.
- Click Overview to see the applications deployed on the cluster.
You can see the Nginx sample application has been deployed as two pods, on two nodes in the cluster.