Pulumi Complete Go Guide
Table of Contents
Introduction
In this guide, we cover the complete steps to deploy a virtual machine on the grid with Pulumi via Go.
To provide a uniform deployment method, we use Docker for this guide. It is optional but will greatly facilitate the deployment as the steps will be similar for Linux, MacOS and Windows.
This guide is useful to get you started quickly with Pulumi on the TFGrid.
Once you've successfully deployed a VM, you can try all the different Go examples within the pulumi-threefold repository. The examples are available in the subdirectory /examples/go/
.
Prerequisites
- A TFChain account
- TFT in your TFChain account
- Get Docker
Steps
-
Deploy a Docker Ubuntu container in interactive mode:
sudo docker run -it --net=host ubuntu:jammy /bin/bash
-
In Docker Ubuntu, deploy a VM with Pulumi. Make sure to add your
MNEMONIC
andSSH_KEY
below before running the script. For this deployment we usemain
as theNETWORK
. Change this if needed.# Install the prerequisites apt update && apt install -y curl git wget make # Install Pulumi curl -fsSL https://get.pulumi.com | sh export PATH=$PATH=:/root/.pulumi/bin # Clone the ThreeFold Pulumi repo git clone https://github.com/threefoldtech/pulumi-threefold.git cd pulumi-threefold/examples/go/virtual_machine # Prepare the Pulumi Go environment # Install Go wget https://go.dev/dl/go1.23.0.linux-amd64.tar.gz rm -rf /usr/local/go && tar -C /usr/local -xzf go1.23.0.linux-amd64.tar.gz export PATH=$PATH:/usr/local/go/bin # Export the variables export NETWORK="main" export SSH_KEY="<ADD_YOUR_SSH_PUBLIC_KEY>" export MNEMONIC="<ADD_YOUR_MNEMONIC>" # Start Pulumi make run
-
You can now SSH into the deployment from your local machine terminal
ssh root@VM_IP
-
To destroy the deployment, run the following line within the Docker Ubuntu terminal.
make destroy
Alternative to Make Commands
You can use direct Pulumi commands instead of the Make commands above.
- You can replace
make run
with:pulumi login --local pulumi up
- You can replace
make destroy
with:pulumi down pulumi stack rm <stack_name>
That being said, the Make commands run additional features. Feel free to explore the possibilities and consult the files within the repo for more information.