Deployment Examples

Table of Contents


Pulumi is an infrastructure as code platform that allows you to use familiar programming languages and tools to build, deploy, and manage cloud infrastructure.

We present here the basic steps to test the examples within the ThreeFold Pulumi plugin repository. Once you've set the plugin and exported the necessary variables, the deployment process from one example to another is very similar.

Please note that the Pulumi plugin for ThreeFold Grid is not yet officially published. We look forward to your feedback on this project.


There are a few things to set up before exploring Pulumi. Since we will be using the examples in the ThreeFold Pulumi repository, we must clone the repository before going further.

  • Install Pulumi on your machine
  • Clone the Pulumi-ThreeFold repository
    • git clone
  • Change directory
    • cd ./pulumi-threefold

Set the Environment Variables

You can export the environment variables before deploying workloads.

  • Export the network (dev, qa, test, main). Note that we are using the dev network by default.
    • export NETWORK="Enter the network"
  • Export your mnemonics.
    • export MNEMONIC="Enter the mnemonics"
  • Export the SSH_KEY (public key).
    • export SSH_KEY="Enter the public Key"

Test the Plugin

Once you've properly set the prerequisites, you can test many of the examples by simply going into the proper repository and running make run.

The different examples that work simply by running make run are the following:

  • virtual_machine
  • kubernetes
  • network
  • zdb
  • gateway_name

We give an example with virtual_machine.

  • Go to the directory virtual_machine
    • cd examples/virtual_machine
  • Deploy the Pulumi workload with make
    • make run

Note: To test gateway_fqdn, you will have to update the fqdn in Pulumi.yaml and create an A record for your domain pointing to the gateway IP.

Destroy the Deployment

You can destroy your Pulumi deployment at any time with the following make command:

make destroy

Questions and Feedback

If you have any questions, you can ask the ThreeFold community for help on the ThreeFold Forum or on the ThreeFold Grid Tester Community on Telegram.

Last change: 2024-02-27