Type '/' to Search

»Deploy Clients

This topic provides information about deploying Consul clients associated with the Consul servers managed in HashiCorp Cloud Platform (HCP).

»Prerequisites

We recommend creating the following compontents prior to creating Consul clusters:

  • A HashiCorp virtual network (HVN)
  • A peering connection or transit gateway attachment
  • Routes for directing network traffic between the HVN and a target connection
  • A Consul server cluster

The procedure for creating and configuring HVNs, connections, and routes is specific to the infrastructure environment. Refer to the following sections for instructions for your environment:

»Download the Client Configuration

You can download an archived folder that contains the necessary files to join your client agents to the cluster. The archive includes a default client configuration and certificate. Both should be considered secrets and should be kept in a secure location.

  1. If you have not already done so, log into the HashiCorp Cloud Platform and click Consul under the Services sidebar menu.
  2. Click on a cluster in the ID column and choose Download to install Client Agents from the Access Consul menu.

You can now use the files to deploy clients to your connected infrastrastructure environment.

»Deploy Clients to AWS

You can deploy Consul clients to the following AWS runtime solutions operating in the virtual private cloud (VPC) that you connected.

»Amazon Elastic Kubernetes Service (EKS)

EKS is the managed Kubernetes service for AWS. Consul clients can be installed and connected to the HCP Consul cluster using Consul’s helm chart. Refer to the following tutorial for instructions on how to deploy clients to EKS: Connect an Elastic Kubernetes Service Cluster to HCP Consul.

»Amazon EC2

EC2 is the virtual machine service for AWS. Refer to the following tutorial for isntructions on how to deploy clients to EC2: Connect a Consul Client to HCP Consul.

»Amazon Elastic Container Service (ECS)

ECS is the native container orchestration platform for AWS. Use Terraform to complete the installation of Consul clients on ECS nodes. Refer to the following tutorial for instructions: Serverless Consul service mesh with ECS and HCP.