Exposing a deployment with a public IP address

This example lives in the pulumi/examples repository. Check out just this directory to use it:

$ git clone --filter=blob:none --sparse https://github.com/pulumi/examples pulumi-examples
$ git -C pulumi-examples sparse-checkout set kubernetes-go-exposed-deployment
$ cd pulumi-examples/kubernetes-go-exposed-deployment

Deploys nginx to a Kubernetes cluster, and publicly exposes it to the Internet with an IP address, using a Kubernetes Service.

In the gif below we see the experience of deploying this example with pulumi up. Notice that Pulumi has an inherent notion of “done-ness” — Pulumi waits for the IP address to be allocated to the Service. Because this example uses the Pulumi concept of stack exports to report this IP address, in this example we are also able to use curl to reach the nginx server.

Prerequisites#

1. Install Pulumi
2. Configure Kubernetes
3. Install Go

Deploying the example#

1. Create a new stack:

   pulumi stack init exposed-deployment-dev

2. This example will attempt to expose the nginx deployment to the Internet with a Service of type LoadBalancer. Since minikube does not support LoadBalancer, the 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>

3. Install dependencies:

   go mod download

4. Deploy the stack:

   pulumi up

   Updating stack 'exposed-deployment-dev'
   Performing changes:
   
        Type                           Name                                       Status      Info
    +   pulumi:pulumi:Stack            exposed-deployment-exposed-deployment-dev  created     1 warning
    +   ├─ kubernetes:apps:Deployment  nginx                                      created
    +   └─ kubernetes:core:Service     nginx                                      created     2 info messages
   
   Diagnostics:
     kubernetes:core:Service: nginx
       info: ✅ Service 'nginx-rn6uipeg' successfully created endpoint objects
   
       info: ✅ Service has been allocated an IP
   
   ---outputs:---
   frontendIp: "35.226.79.225"
   
   info: 3 changes performed:
       + 3 resources created
   Update duration: 46.555593397s

5. The nginx service was allocated a public IP, in this case 35.226.79.225, exported as the stack output frontendIp. Use curl and grep to retrieve the <title> of the site:

   curl -sL $(pulumi stack output frontendIp) | grep "<title>"

   <title>Welcome to nginx!</title>

   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.

Cleaning up#

Once you’re finished experimenting, you can destroy your stack and remove it to avoid incurring any additional cost:

pulumi destroy
pulumi stack rm

Next steps#

Now that nginx is deployed and exposed to the internet with an IP, try playing around with the example!

If we change the nginx image to nginx:1.16-alpine, we can run pulumi preview --diff and see this change reported to us:

Notice also that if you provide an image that does not exist, Pulumi will report errors as it sees them. You should see something similar in principle to this: