当前位置：首页 > news >正文

10分钟上手Consul-k8s：从安装到服务注册的快速入门教程

news 2026/7/30 20:43:23

10分钟上手Consul-k8s：从安装到服务注册的快速入门教程

【免费下载链接】consul-k8sFirst-class support for Consul Service Mesh on Kubernetes项目地址: https://gitcode.com/gh_mirrors/co/consul-k8s

Consul-k8s是HashiCorp提供的在Kubernetes上实现服务网格的解决方案，它将Consul的服务发现、配置管理和分段能力与Kubernetes无缝集成。本教程将帮助你在10分钟内完成从安装到服务注册的全流程，轻松上手这个强大的服务网格工具。

准备工作

在开始之前，请确保你的环境满足以下要求：

已安装Kubernetes集群（1.21+版本）
已安装kubectl命令行工具并配置好集群访问
已安装Helm 3

安装Consul-k8s

克隆项目仓库

首先，克隆Consul-k8s项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/co/consul-k8s cd consul-k8s

使用Helm安装

Consul-k8s提供了Helm Chart以便快速部署。执行以下命令添加Helm仓库并安装Consul：

# 添加Consul Helm仓库 helm repo add hashicorp https://helm.releases.hashicorp.com # 创建命名空间 kubectl create namespace consul # 安装Consul-k8s helm install consul hashicorp/consul --namespace consul --set global.name=consul

安装完成后，可以使用以下命令检查Consul组件是否正常运行：

kubectl get pods -n consul

Consul-k8s核心架构

Consul-k8s的核心架构基于Kubernetes的Gateway API，它提供了一套现代化的API用于在Kubernetes中部署L4和L7路由。

这个架构设计具有以下特点：

通用性：适用于各种不同的流量管理场景
表达性：能够精确描述复杂的路由规则
可扩展性：支持自定义资源和策略
角色导向：区分基础设施提供者、集群操作员和应用开发者的职责

服务注册与发现

Consul-k8s自动实现服务注册与发现，无需手动配置。当你在Kubernetes中部署应用时，Consul会自动将其注册到服务网格中。

部署示例服务

让我们部署一个简单的示例服务来演示服务注册功能：

kubectl apply -f charts/demo/templates/products-api.yaml kubectl apply -f charts/demo/templates/public-api.yaml

这些YAML文件定义了两个服务：products-api和public-api，它们会自动注册到Consul服务网格中。

查看已注册服务

使用Consul CLI查看已注册的服务：

# 安装Consul CLI curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add - sudo apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main" sudo apt-get update && sudo apt-get install consul # 查看服务 consul catalog services

配置服务路由

Consul-k8s使用Gateway API来配置服务路由。下面我们来配置一个简单的HTTP路由。

创建Gateway资源

apiVersion: networking.x-k8s.io/v1alpha1 kind: Gateway metadata: name: prod-web spec: gatewayClassName: consul listeners: - protocol: HTTP port: 80 routes: namespaces: from: All selector: matchLabels: gateway: prod-web

创建HTTPRoute资源

apiVersion: networking.x-k8s.io/v1alpha1 kind: HTTPRoute metadata: name: public-api-route labels: gateway: prod-web spec: hostnames: - "api.example.com" rules: - matches: - path: type: Prefix value: /public forwardTo: - serviceName: public-api port: 8080

应用这些配置后，流量将按照以下路径进行路由：

测试服务访问

现在，我们可以测试服务是否能够通过Consul服务网格正常访问：

# 启动端口转发 kubectl port-forward -n consul service/consul-ingress-gateway 8080:80 # 测试访问 curl -H "Host: api.example.com" http://localhost:8080/public/health

如果一切正常，你应该能看到服务返回的健康检查结果。