Consul与Kubernetes演示服务镜像文档

1. 镜像概述

1.1 基本信息

本镜像为HashiCorp Consul与Kubernetes集成教程的演示容器，用于展示在Kubernetes环境中使用Consul进行服务发现与服务通信的基础流程。镜像源代码托管于GitHub：[***]

1.2 主要用途

• 作为Consul与Kubernetes集成教程的实践载体，帮助开发者理解服务网格、服务发现机制
• 演示如何通过Consul实现跨服务通信
• 提供可运行的示例，验证Consul在Kubernetes环境中的配置与功能

2. 核心功能与特性

2.1 核心功能

• 服务发现：通过Consul服务发现机制定位后端计数服务（counting service）
• 跨服务通信：向后端计数服务发起请求并获取数字数据
• Consul集成：演示Consul在Kubernetes环境中的基础配置与服务注册流程

2.2 技术特性

• 轻量级设计，专注于演示核心流程，无冗余依赖
• 与Consul官方工具链兼容（如Consul Agent、Consul Connect）
• 支持Kubernetes原生部署（Deployment/StatefulSet）

3. 使用场景与适用范围

3.1 目标用户

• 学***Consul与Kubernetes集成的开发人员
• 参与HashiCorp Consul 101教程的学员
• 需要实践服务发现或服务网格技术的运维/开发工程师

3.2 典型场景

• 本地开发环境验证Consul服务发现流程
• 教程演示：通过该服务展示"前端服务→Consul→后端服务"的通信链路
• 基础服务网格概念教学：作为服务间通信的最小化示例

4. 使用方法与配置说明

4.1 前置条件

• Kubernetes集群（1.19+推荐）
• Consul已部署至Kubernetes集群（可通过Consul Helm Chart部署）
• kubectl命令行工具配置完成
• Git环境（用于获取源代码）

4.2 环境准备

4.2.1 获取源代码

git clone [***]
cd demo-consul-101/k8s

4.2.2 构建镜像（可选）

若需本地修改代码后重新构建：

docker build -t demo-consul-service:local -f Dockerfile .

4.3 部署至Kubernetes

4.3.1 基础部署

通过Kubernetes YAML配置部署服务（仓库中已提供示例配置文件）：

# 部署演示服务
kubectl apply -f demo-service.yaml

# 部署后端计数服务（依赖组件）
kubectl apply -f counting-service.yaml

4.3.2 验证部署

# 检查Pod状态
kubectl get pods -l app=demo-consul-service

# 查看服务日志（验证与后端服务通信）
kubectl logs -l app=demo-consul-service --tail=100

4.4 核心配置参数

4.4.1 环境变量配置

4.4.2 配置示例（Kubernetes Deployment片段）

spec:
  containers:
  - name: demo-consul-service
    image: hashicorp/demo-consul-service:latest  # 实际镜像名以仓库为准
    ports:
    - containerPort: 8080
    env:
    - name: BACKEND_SERVICE_NAME
      value: "counting-service"
    - name: CONSUL_HTTP_ADDR
      value: "consul-server:8500"

5. 部署方案示例

5.1 Kubernetes Deployment完整配置

apiVersion: apps/v1
kind: Deployment
metadata:
  name: demo-consul-service
  labels:
    app: demo-consul-service
spec:
  replicas: 1
  selector:
    matchLabels:
      app: demo-consul-service
  template:
    metadata:
      labels:
        app: demo-consul-service
      annotations:
        consul.hashicorp.com/connect-inject: "true"  # 启用Consul Connect注入（如需）
    spec:
      containers:
      - name: demo-consul-service
        image: hashicorp/demo-consul-service:latest
        ports:
        - containerPort: 8080
        env:
        - name: BACKEND_SERVICE_NAME
          value: "counting-service"
        - name: CONSUL_HTTP_ADDR
          value: "consul-server:8500"
        resources:
          requests:
            cpu: "100m"
            memory: "64Mi"

5.2 服务暴露配置（Kubernetes Service）

apiVersion: v1
kind: Service
metadata:
  name: demo-consul-service
spec:
  selector:
    app: demo-consul-service
  ports:
  - port: 80
    targetPort: 8080
  type: ClusterIP  # 仅集群内部访问，外部访问可改用NodePort/Load***

6. 代码与资源链接

• 源代码仓库：[***]
• Consul官方文档：[***]
• Consul Helm Chart：[***]