components

Kubernetes Guestbook (with Components)

A version of the Kubernetes Guestbook application using Pulumi. Unlike the straight port of the original YAML, this variant leverages real code to eliminate boilerplate. A ServiceDeployment class is used that combines the common pattern of deploying a container image using a Kubernetes Deployment, and then scaling it using a Service.

Running the App

Follow the steps in Pulumi Installation and Kubernetes Setup to get Pulumi working with Kubernetes.

Install dependencies:

npm install

Create a new stack:

$ pulumi stack init
Enter a stack name: guestbook

This example will attempt to expose the Guestbook application to the Internet with a Service of type LoadBalancer. Since minikube does not support LoadBalancer, the Guestbook application already knows to use type ClusterIP instead; all you need to do is to tell it whether you're deploying to minikube:

pulumi config set isMinikube <value>

Perform the deployment:

$ pulumi up
Previewing update (guestbook):

     Type                                Name                      Plan       
 +   pulumi:pulumi:Stack                 guestbook-easy-guestbook  create     
 +   ├─ k8sjs:service:ServiceDeployment  frontend                  create     
 +   │  ├─ kubernetes:apps:Deployment    frontend                  create     
 +   │  └─ kubernetes:core:Service       frontend                  create     
 +   ├─ k8sjs:service:ServiceDeployment  redis-replica             create     
 +   │  ├─ kubernetes:apps:Deployment    redis-replica             create     
 +   │  └─ kubernetes:core:Service       redis-replica             create     
 +   └─ k8sjs:service:ServiceDeployment  redis-master              create     
 +      ├─ kubernetes:apps:Deployment    redis-master              create     
 +      └─ kubernetes:core:Service       redis-master              create     
 
Resources:
    + 10 to create

Do you want to perform this update? yes
Updating (guestbook):

     Type                                Name                      Status      
 +   pulumi:pulumi:Stack                 guestbook-easy-guestbook  created     
 +   ├─ k8sjs:service:ServiceDeployment  redis-master              created     
 +   │  ├─ kubernetes:apps:Deployment    redis-master              created     
 +   │  └─ kubernetes:core:Service       redis-master              created     
 +   ├─ k8sjs:service:ServiceDeployment  frontend                  created     
 +   │  ├─ kubernetes:apps:Deployment    frontend                  created     
 +   │  └─ kubernetes:core:Service       frontend                  created     
 +   └─ k8sjs:service:ServiceDeployment  redis-replica             created     
 +      ├─ kubernetes:apps:Deployment    redis-replica             created     
 +      └─ kubernetes:core:Service       redis-replica             created     
 
Outputs:
    frontendIp: "10.105.48.30"

Resources:
    + 10 created

Duration: 21s

Permalink: https://app.pulumi.com/acmecorp/k8sjs-guestbook/updates/1

And finally - open the application in your browser to see the running application. If you're running macOS you can simply run:

open $(pulumi stack output frontendIp)

Note: minikube does not support type LoadBalancer; if you are deploying to minikube, make sure to run kubectl port-forward svc/frontend 8080:80 to forward the cluster port to the local machine and access the service via localhost:8080.