How to use DigitalOcean Blueprints

Install Terraform

Head to the Terraform install page and follow the instructions for your platform.

You can validate your local Terraform installation by running:

$ terraform -v 
Terraform v1.5.7
...

Create DigitalOcean API token

Head to the Applications & API page and create new personal access token (PAT) by clicking the Generate New Token button. Make sure to check Write scope for the token, as Terraform needs it to create new resources. After creating the token, make sure to save it as it disappears forever if you close the page. If you lost the token, delete it and create a new one.

Set up a blueprint

Clone this repository to the machine where Terraform is installed:

$ git clone https://github.com/digitalocean/marketplace-blueprints.git

Head to the blueprint you are interested in, for this example we will use ELK:

$ cd marketplace-blueprints/blueprints/elk/

Define your variables

Edit variables.tf file and specify your API token like this:

variable "do_token" {
  default = "dop_v1_your_beautiful_token_here"
}

(Optional but Recommended) Use SSH keys to deploy your Droplets instead of passwords. You can retrieve your list of SSH Key IDs using doctl.

Retrieve your SSH Key IDs:

doctl compute ssh-key list

Specify which SSH keys to use:

variable "ssh_key_ids" {
  default = [123, 456, 789] # Replace these numbers with actual SSH key IDs
  type = list(number)
}

(Optional but Recommended) Specify the region you want your Droplets to deploy:

variable "region" {
  default = "nyc3"
}

We are almost there, now initialize the Terraform project by running:

$ terraform init

Finally, after project is initialized, run the Terraform apply to spin the blueprint:

$ terraform apply

It can take few minutes to spin the droplets and some blueprints require extra time after the creation to finish the configuration.

Marketplace Blueprints

This repository contains blueprints for Solution Stacks applications listed in our Marketplace.

Blueprint is the Terraform-based configuration and source code DigitalOcean uses to create Solution Stacks applications.

• Docs
• Blueprint template
• Blueprint generator
• Blueprint examples

How to create and publish your application

Check out our contributing guide to learn how to create and publish your blueprint!