Deploy a sample application

Learn how to deploy a sample application on the Konvoy cluster

After you have a basic Konvoy cluster installed and ready to use, you might want to test operations by deploying a simple, sample application. This task is optional and is only intended to demonstrate the basic steps for deploying applications in a production environment. If you are configuring the Konvoy cluster for a production deployment, you can use this section to learn the deployment process. However, deploying applications on a production cluster typically involves more planning and custom configuration than covered in this example.

This tutorial demonstrates how you can deploy a simple application that connects to the mongo service. The sample application used in this tutorial is a condensed form of the Kubernetes sample guestbook application.

Before you begin

You must have a Konvoy cluster running.

To deploy the sample application

  1. Deploy the MongoDB pods and service by running the following commands:

    kubectl apply -f
    kubectl apply -f
  2. Deploy the web app frontend by running the following command:

    kubectl apply -f
  3. Confirm that there are three frontend replicas running:

    kubectl get pods -l -l
  4. Apply the frontend Service:

    kubectl apply -f
  5. Configure the front end service to use a cloud load balancer:

    cat << EOF | kubectl apply -f -
    apiVersion: v1
    kind: Service
      name: frontend
      labels: guestbook frontend
      type: LoadBalancer
      - port: 80
      selector: guestbook frontend
  6. View the frontend service via the LoadBalancer by running the following command to get the IP address for the frontend Service:

    kubectl get service frontend
  7. Copy the external IP address, and load the page in your browser to view your guestbook.

    The service properties provide the name of the load balancer. You can connect to the application by accessing that load balancer address in your web browser. Because this sample deployment creates a cloud load balancer, you should keep in mind that creating the load balancer can take up to a few minutes. You also might experience a slight delay before it is running properly due to DNS propagation and synchronization.

  8. Remove the sample application by running the following commands:

    kubectl delete deployment -l
    kubectl delete service -l
    kubectl delete deployment -l
    kubectl delete service -l

    WARNING: This step is required because the sample deployment attaches a cloud provider load balancer to the Konvoy cluster. Therefore, you must delete the sample application before tearing down the cluster.

  9. Optional: Tear down the cluster by running the following command:

    konvoy down

    This command destroys the Kubernetes cluster and the infrastructure it runs on.