Skip to content

Latest commit

 

History

History
66 lines (42 loc) · 2.6 KB

README.md

File metadata and controls

66 lines (42 loc) · 2.6 KB
Raw

Stage 3

Stage 3 of the bootstrap procedure is responsible for setting up any use-case specific extensions your Demeter cluster wants to provider. These are the resources that end-users (aka: developers, dApps) will consume from your cluster, such as: hosting workers, blockchain indexers / RPCs, database engines, etc.

Dependencies

  • Stage 2 completed
  • Terraform CLI
  • Kubernetes configuration

Procedure

Define your Terraform backend

Add a backend.tf file in the stage1 directory and include your particular backend configuration. If you run bin/bootstrap-cloud the backend.tf should be automatically generated. For example AWS S3 backend configuration:

terraform {
  backend "s3" {
    bucket = "mybucket"
    key    = "path/to/my/key"
    region = "us-east-1"
  }
}

Tip

You can skip this step and Terraform by default will use a local state backend which stores the data in the current folder. This is an easy and good approach for local development or testing, but it doesn't scale easily for production environments.

Initialize Terraform

Initialize the stage2 module by running the init command from stage2 directory:

terraform init

Make sure that terraform command completed successfully and there're no error reports in the terminal output.

Define Variable Values

Specify the correct values for the required stage2 variables by modifying the env.auto.tfvars file.

The following variables are required:

  • k8s_context: The name of the k8s context as defined in the kube config file. This should match the context created during the stage0 setup of your k8s cluster.
  • cluster_name: An alphanumeric string that uniquely identifies your cluster within the set of connected cluster that conform the fabric.

Tip

There are other variables available that you can use to tailor the installation but they have reasonable defaults. Check the variables.tf file for the definition of each. If you want to override the default value, add the corresponding line to env.auto.tfvars specifying the adjusted value.

Apply Terraform

Apply the required changes for stage2 by running the apply command from stage2 directory.

terraform apply

The output will show you the planned changes before applying them. Answer 'yes' in the confirmation step to continue with the process.

The execution of the command might take a while depending on the specific cluster. Make sure that terraform command completed successfully and there're no error reports in the terminal output.

Next Steps

You're done with cluster provisioning! You can start using your Demeter instance.