Pulumi

Pulumi is a multi-language infrastructure as code (IaC) tool. Pulumi is open source and makes it easy to deploy cloud infrastructure.

Pulumi is available for a variety of operating systems and Linux distributions. In this guide, you’ll learn how to install Pulumi on Linux.

Install Pulumi

Run the following command to download and install Pulumi on Linux:

    

        
        
curl -fsSL https://get.pulumi.com | sh

    

The installer output is similar to:

    

        
        === Installing Pulumi v3.232.0 ===
+ Downloading https://github.com/pulumi/pulumi/releases/download/v3.232.0/pulumi-v3.232.0-linux-arm64.tar.gz...
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
100  129M  100  129M    0     0  11.1M      0  0:00:11  0:00:11 --:--:-- 11.1M
+ Extracting to /home/ubuntu/.pulumi/bin
+ Adding $HOME/.pulumi/bin to $PATH in /home/ubuntu/.bashrc

=== Pulumi is now installed! 🍹 ===
+ Please restart your shell or add /home/ubuntu/.pulumi/bin to your $PATH
+ Get started with Pulumi: https://www.pulumi.com/docs/quickstart

        
    

The installer updates $HOME/.bashrc to setup the environment. Start a new shell or run the following command:

    

        
        
source $HOME/.bashrc

    

Confirm pulumi is now in the search path:

    

        
        
which pulumi

    

    

        
        /usr/local/bin/pulumi

        
    

Print the version:

    

        
        
pulumi version

    

    

        
        v3.232.0

        
    

Verify Pulumi installation with an example

Pulumi keeps your projects and state information in Pulumi Cloud, making it easy to access them from anywhere. If you want to use Pulumi Cloud, see app.pulumi.com .

It’s not necessary to use Pulumi Cloud to get started. You can store project information on your local computer.

The following is an example to try out Pulumi. The example uses Docker to pull a container image from Docker Hub to your local machine using Python.

To run the example, you need to install Docker. For instructions, see the Docker install guide .

You also need Python. Make sure you have python and pip installed.

For Ubuntu 22.04 on Arm, you can run the following commands to install:

    

        
        
sudo apt install python-is-python3 -y
sudo apt install python3-pip -y

    

Create a new directory for the example:

    

        
        
mkdir pulumi-test ; cd pulumi-test

    

Log in to your local machine, a shortcut to use ~/.pulumi to store project data.

    

        
        
pulumi login --local

    

For the example, you need to create 3 files:

• Python required package list in requirements.txt
• Pulumi project information in Pulumi.yaml
• Python code in __main__.py

Use a text editor to copy the code below to a file named requirements.txt.

    

        
        pulumi>=3.0.0
pulumi-docker>=4.0.0

        
    

Use a text editor to copy the lines below to a file named Pulumi.yaml

    

        
        
name: alpine-pull
runtime: python
description: A pulumi application pull the alpine image

    

Use a text editor to copy the lines below to a file named __main__.py

    

        
        
import pulumi
import pulumi_docker as docker

# Pull the latest Alpine image:
image = docker.RemoteImage("alpineImage", name="alpine:latest", keep_locally=True)

# Print the digest:
pulumi.export('digest', image.repo_digest)

    

With the three files created, install the required Python packages:

    

        
        
pip install -r requirements.txt

    

Run the Python script to pull the container image:

    

        
        
pulumi up

    

There are 4 prompts to respond to:

1. Confirm you want to create a new stack. Press return

2. Enter a name for the stack.

3. When prompted, enter a passphrase for the stack twice.

4. Answer yes to the final question to create the stack.

The output of pulumi up is similar to:

    

        
        Please choose a stack, or create a new one:  [Use arrows to move, type to filterPlease choose a stack, or create a new one: <create a new stack>
Please enter your desired stack name: test1
Created stack 'test1'
Enter your passphrase to protect config/secrets:
Re-enter your passphrase to confirm:
Previewing update (test1):
     Type                         Name               Plan
 +   pulumi:pulumi:Stack          alpine-pull-test1  create
 +   └─ docker:index:RemoteImage  alpineImage        create


Outputs:
    digest: output<string>

Resources:
    + 2 to create

Do you want to perform this update? yes
Updating (test1):
     Type                         Name               Status
 +   pulumi:pulumi:Stack          alpine-pull-test1  created (0.07s)
 +   └─ docker:index:RemoteImage  alpineImage        created (0.03s)


Outputs:
    digest: "alpine@sha256:7144f7bab3d4c2648d7e59409f15ec52a18006a128c733fcff20d3a4a54ba44a"

Resources:
    + 2 created

Duration: 1s

        
    

After the Python script runs, you have the container on your machine. Confirm this using the docker images command:

    

        
        
docker images

    

The output is similar to:

    

        
        REPOSITORY   TAG       IMAGE ID       CREATED      SIZE
alpine       latest    f6648c04cd6c   2 days ago   7.66MB

        
    

You are now ready to use Pulumi on your Linux machine.