HashiCorp Consul 在 Kubernetes 中的 DNS 请求解析指南

最新推荐文章于 2025-06-24 17:04:49 发布

谭勇牧Queen

最新推荐文章于 2025-06-24 17:04:49 发布

阅读量285

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00726/article/details/148360920

HashiCorp Consul 在 Kubernetes 中的 DNS 请求解析指南

consul Consul is a distributed, highly available, and data center aware solution to connect and configure applications across dynamic, distributed infrastructure. 项目地址: https://gitcode.com/gh_mirrors/con/consul

前言

在现代微服务架构中，服务发现是核心组件之一。HashiCorp Consul 提供了强大的服务发现功能，其中 DNS 接口是最简单易用的方式之一。本文将详细介绍如何在 Kubernetes 环境中配置 Consul 的 DNS 解析，使您能够使用 <service-name>.service.consul 格式查询 Consul 中的服务。

核心概念

Consul DNS 服务

Consul 提供了一个 DNS 服务接口，允许通过标准的 DNS 查询来发现服务。在 Kubernetes 中，我们需要将这个 DNS 服务与集群的 DNS 系统（KubeDNS 或 CoreDNS）集成。

两种集成方式

Stub-domain 配置：适用于 KubeDNS
Proxy 配置：适用于 CoreDNS

准备工作

获取 Consul DNS 服务的 ClusterIP

首先需要确定 Consul DNS 服务的 ClusterIP：

kubectl get svc consul-dns --output jsonpath='{.spec.clusterIP}'

输出示例：

10.35.240.78

记下这个 IP 地址，后续配置会用到。

注意：如果您使用了非默认的 Helm 发布名称，服务名称会是 <release-name>-consul-dns。

KubeDNS 配置方法

配置步骤

设置环境变量：

export CONSUL_DNS_IP=10.35.240.78  # 替换为您的实际IP

创建 ConfigMap：

cat <<EOF | kubectl apply --filename -
apiVersion: v1
kind: ConfigMap
metadata:
  labels:
    addonmanager.kubernetes.io/mode: EnsureExists
  name: kube-dns
  namespace: kube-system
data:
  stubDomains: |
    {"consul": ["$CONSUL_DNS_IP"]}
EOF

验证配置：

kubectl get configmap kube-dns --namespace kube-system --output yaml

注意事项

此配置只能指向静态 IP
如果 Consul DNS 服务的 ClusterIP 变更，必须更新此配置
如需使用非 .consul 域，请相应修改配置

CoreDNS 配置方法

配置步骤

编辑 CoreDNS 的 ConfigMap：

kubectl edit configmap coredns --namespace kube-system

添加以下配置块（注意替换 IP 地址）：

consul {
  errors
  cache 30
  forward . 10.35.240.78  # 替换为您的实际IP
}

配置说明

errors：记录错误日志
cache 30：启用30秒的DNS缓存
forward：指定转发到Consul DNS服务的IP

OpenShift 环境特殊配置

OpenShift 使用 CoreDNS 作为默认 DNS 服务，但配置方式略有不同：

获取 Consul DNS 服务的 ClusterIP：

oc get svc consul-dns --namespace consul --output jsonpath='{.spec.clusterIP}'

编辑 DNS Operator 配置：

oc edit dns.operator/default

添加以下配置：

spec:
  servers:
  - name: consul-server
    zones:
    - consul
    forwardPlugin:
      policy: Random
      upstreams:
      - 172.30.186.254  # 替换为您的实际IP

验证DNS配置

测试方法

创建测试Job：

apiVersion: batch/v1
kind: Job
metadata:
  name: dns-test
spec:
  template:
    spec:
      containers:
        - name: dns
          image: anubhavmishra/tiny-tools
          command: ['dig', 'consul.service.consul']
      restartPolicy: Never
  backoffLimit: 4

应用并检查结果：

kubectl apply -f dns-test.yaml
kubectl get pods --show-all | grep dns-test
kubectl logs <pod-name>

预期结果

成功查询应返回类似以下输出，包含 Consul 服务的IP地址：

;; ANSWER SECTION:
consul.service.consul. 0 IN A 10.36.2.23
consul.service.consul. 0 IN A 10.36.4.12
consul.service.consul. 0 IN A 10.36.0.11

高级配置建议

服务同步：如需直接使用 <service-name>（不带 .service.consul 后缀）解析服务，需启用 Consul 到 Kubernetes 的服务同步功能。
多集群场景：在多集群环境中，可以考虑使用 Consul 的 WAN 联合功能，使 DNS 查询可以跨集群工作。
性能优化：对于大规模部署，适当调整 DNS 缓存时间可以提高性能。