Stateless Application Using a Deployment in Python

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-py-nginx
$ cd pulumi-examples/kubernetes-py-nginx

A version of the Kubernetes Stateless Application Deployment example that uses Pulumi. This example deploys a replicated Nginx server to a Kubernetes cluster, using Python and no YAML.

There is an interactive Tutorial available for this example. If this is your first time using Pulumi for Kubernetes, we recommend starting there.

Pre-Requisites#

Running the App#

After cloning this repo, cd into this directory and create a new stack, a logical deployment target that we’ll deploy into:

    $ pulumi stack init dev

Now to perform the deployment, simply run pulumi up. It will first show you a preview of what will take place. After confirming, the deployment will take place in approximately 20 seconds:

    $ pulumi up -y
    Previewing update (dev):
        Type                           Name                     Plan
    +   pulumi:pulumi:Stack            kubernetes-py-nginx-dev  create
    +   └─ kubernetes:apps:Deployment  nginx-deployment         create

    Resources:
        + 2 to create

    Do you want to perform this update? yes
    Updating (dev):
        Type                           Name                     Status
    +   pulumi:pulumi:Stack            kubernetes-py-nginx-dev  created
    +   └─ kubernetes:apps:Deployment  nginx-deployment         created

    Outputs:
        nginx: "nginx-deployment-ts0qpwi9"

    Resources:
        + 2 created

    Duration: 10s

This deployment is now running, and you can run commands like kubectl get pods to see the application’s resources.

The stack’s replica count is configurable. By default, it will scale up to three instances, but we can easily change that to five, by running the pulumi config command followed by another pulumi up:

    $ pulumi config set replicas 5
    $ pulumi up -y
    Previewing update (dev):
        Type                           Name                     Plan       Info
        pulumi:pulumi:Stack            kubernetes-py-nginx-dev
    ~   └─ kubernetes:apps:Deployment  nginx-deployment         update     [diff: ~spec]

    Resources:
        ~ 1 to update
        1 unchanged

    Updating (dev):
        Type                           Name                     Status      Info
        pulumi:pulumi:Stack            kubernetes-py-nginx-dev
    ~   └─ kubernetes:apps:Deployment  nginx-deployment         updated     [diff: ~spec]

    Outputs:
        nginx: "nginx-deployment-ts0qpwi9"

    Resources:
        ~ 1 updated
        1 unchanged

    Duration: 15s

After we’re done, we can tear down all resources, including removing our stack, with a couple commands:

    $ pulumi destroy --yes
    $ pulumi stack rm --yes

Stateless Application Using a Deployment

Pre-Requisites#

Running the App#

Related

kubernetes-python

Azure Kubernetes Service (AKS): Hello World

The infrastructure as code platform for any cloud.