Using Cloudflare as a DNS provider for Lokomotive

Introduction

This guide explains how to use Cloudflare as a DNS provider for a Lokomotive cluster.

Prerequisites

The following are required:

  • A Cloudflare account with a hosted DNS zone.
  • A Cloudflare API token is required. This token will be used by the Lokomotive tooling to create DNS records on Cloudflare on your behalf.

The token needs to have the following permissions:

  • Zone.Zone - read
  • Zone.DNS - edit

Steps

Step 1: Configure Cloudflare as the DNS provider

In your cluster configuration file, configure Cloudflare as the DNS provider:

cluster "packet" {
  cluster_name = "my-cluster"
  ...
  dns {
    zone     = "example.com"
    provider = "cloudflare"
  }
  ...
}

Step 2: Deploy the cluster

Set your Cloudflare API token in the CLOUDFLARE_API_TOKEN environment variable:

export CLOUDFLARE_API_TOKEN=6IgMwujC2q92AvSgOJ60aCQD5uo9sA

Deploy the cluster:

lokoctl cluster apply

Additional resources

For full information about how to deploy a Lokomotive cluster, refer to the configuration reference or to one of the quickstart guides .