mirror of https://github.com/status-im/consul.git
79 lines
4.7 KiB
Markdown
79 lines
4.7 KiB
Markdown
|
---
|
||
|
|
layout: 'docs'
|
||
|
|
page_title: 'Kubernetes'
|
||
|
|
sidebar_current: 'docs-platform-k8s-index'
|
||
|
|
description: |-
|
||
|
|
Consul has many integrations with Kubernetes. You can deploy Consul to Kubernetes using the Helm chart, sync services between Consul and Kubernetes, automatically secure Pod communication with Connect, and more. This section documents the official integrations between Consul and Kubernetes.
|
||
|
|
---
|
||
|
|
|
||
|
|
# Kubernetes
|
||
|
|
|
||
|
|
Consul has many integrations with Kubernetes. You can deploy Consul
|
||
|
|
to Kubernetes using the Helm chart, sync services between Consul and
|
||
|
|
Kubernetes, run Consul Connect Service Mesh, and more.
|
||
|
|
This section documents the official integrations between Consul and Kubernetes.
|
||
|
|
|
||
|
|
## Use Cases
|
||
|
|
|
||
|
|
**Running a Consul server cluster:** The Consul server cluster can run directly
|
||
|
|
on Kubernetes. This can be used by both nodes within Kubernetes as well as
|
||
|
|
nodes external to Kubernetes, as long as they can communicate to the server
|
||
|
|
nodes via the network.
|
||
|
|
|
||
|
|
**Running Consul clients:** Consul clients can run as pods on every node
|
||
|
|
and expose the Consul API to running pods. This enables many Consul tools
|
||
|
|
such as envconsul, consul-template, and more to work on Kubernetes since a
|
||
|
|
local agent is available. This will also register each Kubernetes node with
|
||
|
|
the Consul catalog for full visibility into your infrastructure.
|
||
|
|
|
||
|
|
**Consul Connect Service Mesh:**
|
||
|
|
Consul can automatically inject the [Consul Connect](/docs/connect/index.html)
|
||
|
|
sidecar into pods so that they can accept and establish encrypted
|
||
|
|
and authorized network connections via mutual TLS. And because Connect
|
||
|
|
can run anywhere, pods can also communicate with external services (and
|
||
|
|
vice versa) over a fully encrypted connection.
|
||
|
|
|
||
|
|
**Service sync to enable Kubernetes and non-Kubernetes services to communicate:**
|
||
|
|
Consul can sync Kubernetes services with its own service registry. This allows
|
||
|
|
Kubernetes services to use native Kubernetes service discovery to discover
|
||
|
|
and connect to external services registered in Consul, and for external services
|
||
|
|
to use Consul service discovery to discover and connect to Kubernetes services.
|
||
|
|
|
||
|
|
**And more!** Consul can run directly on Kubernetes, so in addition to the
|
||
|
|
native integrations provided by Consul itself, any other tool built for
|
||
|
|
Kubernetes can choose to leverage Consul.
|
||
|
|
|
||
|
|
## Getting Started With Consul and Kubernetes
|
||
|
|
|
||
|
|
There are several ways to try Consul with Kubernetes in different environments.
|
||
|
|
|
||
|
|
Guides
|
||
|
|
|
||
|
|
- The [Getting Started with Consul Service Mesh track](https://learn.hashicorp.com/consul/gs-consul-service-mesh/understand-consul-service-mesh?utm_source=WEBSITE&utm_medium=WEB_IO&utm_offer=ARTICLE_PAGE&utm_content=DOCS)
|
||
|
|
walks you through installing Consul as service mesh for Kubernetes using the Helm
|
||
|
|
chart, deploying services in the service mesh, and using intentions to secure service
|
||
|
|
communications.
|
||
|
|
|
||
|
|
- The [Consul and minikube guide](https://learn.hashicorp.com/consul/
|
||
|
|
getting-started-k8s/minikube?utm_source=consul.io&utm_medium=docs) is a quick walk through of how to deploy Consul with the official Helm chart on a local instance of Minikube.
|
||
|
|
|
||
|
|
- The [Deploying Consul with Kubernetes guide](https://learn.hashicorp.com/
|
||
|
|
consul/getting-started-k8s/minikube?utm_source=consul.io&utm_medium=docs)
|
||
|
|
walks you through deploying Consul on Kubernetes with the official Helm chart and can be applied to any Kubernetes installation type.
|
||
|
|
|
||
|
|
- Review production best practices and cloud-specific configurations for deploying Consul on managed Kubernetes runtimes.
|
||
|
|
|
||
|
|
- The [Kubernetes on Azure (AKS) guide](https://learn.hashicorp.com/consul/
|
||
|
|
getting-started-k8s/azure-k8s?utm_source=consul.io&utm_medium=docs) is a complete walk through on how to deploy Consul on AKS.
|
||
|
|
- The [Kubernetes on AWS (EKS) guide](https://learn.hashicorp.com/consul/kubernetes/aws-k8s?utm_source=consul.io&utm_medium=docs) is a complete walk through on how to deploy Consul on EKS.
|
||
|
|
- The [Kubernetes on Google Cloud (GKE) guide](https://learn.hashicorp.com/consul/kubernetes/google-cloud-k8s?utm_source=consul.io&utm_medium=docs) is a complete walk through on how to deploy Consul on GKE.
|
||
|
|
|
||
|
|
- The [Consul and Kubernetes Reference Architecture](https://learn.hashicorp.com/consul/day-1-operations/kubernetes-reference?utm_source=consul.io&utm_medium=docs) guide provides recommended practices for production.
|
||
|
|
|
||
|
|
- The [Consul and Kubernetes Deployment](https://learn.hashicorp.com/consul/day-1-operations/kubernetes-deployment-guide?utm_source=consul.io&utm_medium=docs) guide covers the necessary steps to install and configure a new Consul cluster on Kubernetes in production.
|
||
|
|
|
||
|
|
Documentation
|
||
|
|
|
||
|
|
- [Installing Consul](/docs/platform/k8s/run.html) covers how to install Consul using the Helm chart.
|
||
|
|
- [Helm Chart Reference](/docs/platform/k8s/helm.html) describes the different options for configuring the Helm chart.
|