Skip to content

Latest commit

 

History

History
98 lines (67 loc) · 3.04 KB

README_kubernetes.md

File metadata and controls

98 lines (67 loc) · 3.04 KB
Raw

Deploy to IBM Cloud Kubernetes Service

Follow these instructions to deploy this application to a Kubernetes cluster and connect it with a Cloudant database.

Download

git clone https://github.com/IBM-Cloud/get-started-java
cd get-started-java
mvn clean install

Build Docker Image

  1. Find your container registry namespace by running ibmcloud cr namespaces. If you don't have any, create one using ibmcloud cr namespace-add <name>

  2. Identify your Container Registry by running ibmcloud cr info (Ex: registry.ng.bluemix.net)

  3. Build and tag (-t)the docker image by running the command below replacing REGISTRY and NAMESPACE with he appropriate values.

    docker build . -t <REGISTRY>/<NAMESPACE>/myapp:v1.0.0

    Example: docker build . -t registry.ng.bluemix.net/mynamespace/myapp:v1.0.0

  4. Push the docker image to your Container Registry on IBM Cloud

    docker push <REGISTRY>/<NAMESPACE>/myapp:v1.0.0

Deploy

Create a Kubernetes cluster

  1. Creating a Kubernetes cluster in IBM Cloud.
  2. Follow the instructions in the Access tab to set up your kubectl cli.

Create a Cloudant Database

  1. Go to the Catalog and create a new Cloudant database instance.

  2. Choose Legacy and IAM for Authentication

  3. Create new credentials under Service Credentials and copy value of the url field.

  4. Create a Kubernetes secret with your Cloudant credentials.

kubectl create secret generic cloudant --from-literal=url=<URL>

Example:

kubectl create secret generic cloudant --from-literal=url=https://username:[email protected]

Create the deployment

  1. Replace <REGISTRY> and <NAMESPACE> with the appropriate values in kubernetes/deployment.yaml
  2. Create a deployment:
kubectl create -f kubernetes/deployment.yaml

  • Paid Cluster: Expose the service using an External IP and Loadbalancer

    kubectl expose deployment get-started-java --type LoadBalancer --port 9080 --target-port 9080

  • Free Cluster: Use the Worker IP and NodePort

    kubectl expose deployment get-started-java --type NodePort --port 9080 --target-port 9080

Access the application

Verify STATUS of pod is RUNNING

kubectl get pods -l app=get-started-java

Standard (Paid) Cluster:

  1. Identify your LoadBalancer Ingress IP using kubectl get service get-started-java
  2. Access your application at t http://<EXTERNAL-IP>:9080/GetStartedJava

Free Cluster:

  1. Identify your Worker Public IP using ibmcloud cs workers YOUR_CLUSTER_NAME
  2. Identify the Node Port using kubectl describe service get-started-java
  3. Access your application at http://<WORKER-PUBLIC-IP>:<NODE-PORT>/GetStartedJava

Clean Up

kubectl delete deployment,service -l app=get-started-java
kubectl delete secret cloudant