• Products
    Products
    Products
    • Terraform
    • Vault
    • Consul
    • Nomad
    • Vagrant
    • Packer
    Managed Services
    • Terraform Cloud
    • Consul Service on Azure
    Features
    • Sentinel
    Learn our products
    Unlocking the Cloud Operating ModelRead whitepaper
    Bringing Consul as a service to Azure with MicrosoftLearn more
  • Company
    Company
    Company
    • About Us
    • Jobs
    • Our Principles
    • Tao of HashiCorp
    • Press
    • Contact Us
    • HashiCorp Store
    We're hiring
    Join us to build industry-leading open source tools and enterprise productsView all open positions
    Announcing the HashiCorp StoreVisit the Store
  • Partners
    Partners
    Partners
    • Ecosystem
    • Resellers & System Integrators
    • Training Partners
    Product Integrations
    • Cloud Integrations
    • Technology Integrations
    Find a partnerBecome a partner
    Bringing Consul as a service to Azure with MicrosoftLearn more
  • Learn
    Learn
    Learn
    • Product Guides
    • Certifications
    • Resource Library
    • Blog
    • Training
    Docs
    • Terraform
    • Vault
    • Consul
    • Nomad
    • Vagrant
    • Packer
    • Sentinel
    Community
    • Overview
    • Forum
    • User Groups
    Events
    • All Events
    • HashiConf
    • HashiConf EU
    Learn our products
    Learn HashiCorp Vault with step-by-step guides.Get started with Vault
  • Support
  • Get Pricing
Blog
Announcing the HashiCorp Consul Helm Chart
Announcing the HashiCorp Consul Helm Chart

Announcing the HashiCorp Consul Helm Chart

Sep 12 2018|Mitchell Hashimoto

We're releasing HashiCorp Consul + Kubernetes features every week. This week we're releasing the official Consul Helm Chart for running and configuring Consul on Kubernetes.

Using the Helm chart, you can start a complete Consul cluster on Kubernetes in minutes. The Helm chart can setup and configure a Consul server cluster, client agents, or both. The Helm chart will also be the primary mechanism for setting up future Consul and Kubernetes features.

» Video

To learn more about the Consul Helm chart, watch the video below or scroll down to read more. The video below shows the Helm chart being used to install, reconfigure, and upgrade Consul.

» Running a Consul Cluster

The Helm chart can be used to setup Consul on Kubernetes in minutes.

The chart is currently available via the hashicorp/consul-helm GitHub repository. We plan on supporting official Helm repositories in the future. For now you must download or clone this repository to get started. After downloading the repository, please check out a tagged release:

$ git clone https://github.com/hashicorp/consul-helm.git
$ cd consul-helm/
$ git checkout v0.1.0 

Then, install the chart:

$ helm install .
...

In a few minutes, you'll have a three node server cluster deployed, bootstrapped, and joined with a Consul agent running on every Kubernetes node. Once the pods are up and ready, you can view the Consul UI by forwarding port 8500 from a server pod and opening your browser to http://localhost:8500/.

$ kubectl port-forward consul-server-0 8500:8500
...
Consul UI Running on K8S

The Helm chart is highly configurable. You can use the configuration to disable components, change the image used, expose the UI service, configure resource requirements, storage classes, and much much more. See the full reference documentation of available chart configuration options for more information.

For Consul Enterprise users, a custom image can be configured with the Helm chart. HashiCorp does not currently publish official Docker images for Consul Enterprise. We plan to do this, but in the mean time if you create custom Docker images in private repositories, you can configure the Helm chart to use those images.

» Running a Client-Only Cluster

In addition to deploying a full server cluster, the Helm chart can be used to deploy a client-only cluster. This is a common deployment pattern where the Consul servers are run outside of the Kubernetes cluster. The example configuration below enables this deployment model:

global:
  enabled: false

client:
  enabled: true
  join:
    - "provider=aws tag_key=... tag_value=..."

This configuration disables all Helm chart components by default, then explicitly enables only clients. The join configuration then uses cloud auto-join to discover and join pre-existing Consul server agents.

The Helm chart supports dozens of configuration options. See the full reference documentation of available chart configuration options for more information.

» Next

The Consul Helm chart provides a single package for installing, configuring, and upgrading Consul on Kubernetes, as well as future Consul + Kubernetes components. The Helm chart is available now on GitHub. To learn more, see the Helm Chart documentation or the documentation on Running Consul on Kubernetes.

We have more exciting Consul + Kubernetes integrations being released in the coming weeks. Please read the Consul and Kubernetes announcement blog post to learn more.

  • Facebook
  • Twitter
  • LinkedIn
Cloud Adoption

Unlocking the Cloud Operating Model

Read Whitepaper ›

Latest Resources

Slide 1 of 10
  • FAQ

    How Do I Decompose Monolithic Terraform Configurations?

    Terraform
    How Do I Decompose Monolithic Terraform Configurations? Image
  • Demo

    Clean Up Your Secrets & Credential Management: First Steps With HashiCorp Vault

    Vault
    Clean Up Your Secrets & Credential Management: First Steps With HashiCorp Vault Image
  • Webinar

    VCS + Terraform Cloud: Azure DevOps, GitLab, GitHub & Bitbucket

    Terraform
    VCS + Terraform Cloud: Azure DevOps, GitLab, GitHub & Bitbucket Image
  • Presentation

    DevOps for Purchased Applications (COTS)

    Terraform
    Packer
    DevOps for Purchased Applications (COTS) Image
  • Presentation

    Secure Cloud API Access with HashiCorp Vault

    Vault
    AWS
    Secure Cloud API Access with HashiCorp Vault Image
  • FAQ

    How Do I Rightsize My Vault Cluster Count?

    Vault
    How Do I Rightsize My Vault Cluster Count? Image
  • Article

    SysAdvent Day 8 - Going Nomad in a Kubernetes World

    Nomad
    SysAdvent Day 8 - Going Nomad in a Kubernetes World Image
  • Case Study

    How Monzo's Security Team Handles Secrets With HashiCorp Vault

    Vault
    How Monzo's Security Team Handles Secrets With HashiCorp Vault Image
  • Guide

    Microservices with Spring Boot, Spring Cloud Gateway and Consul Cluster

    Consul
    Microservices with Spring Boot, Spring Cloud Gateway and Consul Cluster Image
  • Guide

    Securing Bare Metal with Service Mesh

    Consul
    Vault
    Terraform
    Securing Bare Metal with Service Mesh Image
View All
  • ProvisionMulti-Cloud Infrastructure
  • SecureMulti-Cloud Secrets
  • ConnectMulti-Cloud Services
  • RunMulti-Cloud Applications
Products
  • Terraform
  • Vault
  • Consul
  • Nomad
  • Vagrant
  • Packer
  • SentinelNew
Resources
  • Blog
  • CommunityNew
  • Events
  • Integrations
  • Library
  • Partners
  • Podcast
  • Support
  • Training
Company
  • About Us
  • JobsWe're Hiring
  • Press Center
  • Brand
  • Contact Us
  • System Status
  • Cookie Manager
  • Terms of Use
  • Security
  • Privacy
stdin: is not a tty