hashicorp/counting-init

HashiCorp Consul 计数服务注册初始化容器

镜像概述和主要用途

本镜像为演示容器，专为"Consul与Kubernetes集成"教程设计。作为初始化容器(Init Container)，其主要用途是在主应用启动前，向HashiCorp Consul服务网格注册计数服务，简化Kubernetes环境中Consul服务注册流程。

代码仓库地址：https://github.com/hashicorp/demo-consul-101/tree/master/k8s

核心功能和特性

核心功能

• 初始化容器特性：遵循Kubernetes Init Container规范，在主应用容器启动前执行服务注册操作
• Consul服务注册：与HashiCorp Consul集成，自动完成计数服务的注册流程
• 计数服务适配：专为计数服务设计，提供预设的服务注册配置模板

主要特性

• 轻量级设计，专注于服务注册单一职责
• 简化Consul服务注册流程，降低Kubernetes与Consul集成门槛
• 与官方Consul教程深度结合，提供开箱即用的演示体验

使用场景和适用范围

适用场景

• Consul与Kubernetes集成的学习和演示环境
• 服务网格入门教程中的服务注册示例
• 初始化容器(Init Container)在Kubernetes中的实践教学

适用范围

• 用户群体：Kubernetes和Consul初学者、开发者、技术讲师
• 环境限制：仅用于学习和演示目的，不适合生产环境部署
• 集成对象：HashiCorp Consul服务网格、Kubernetes集群、计数服务应用

使用方法和配置说明

前置要求

• 运行中的Kubernetes集群
• 已部署的HashiCorp Consul集群（可参考官方教程部署）
• 网络连通性：确保容器能够访问Consul服务地址

基本使用方式

该镜像主要作为Kubernetes Pod中的Init Container使用，典型配置示例如下：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: counting-service-pod
spec:
  initContainers:
  - name: consul-register
    image: [镜像名称]  # 实际使用时替换为该演示镜像的名称
    env:
    - name: CONSUL_HTTP_ADDR
      value: "consul-server:8500"  # Consul服务地址
    - name: SERVICE_NAME
      value: "counting-service"    # 服务名称
    - name: SERVICE_PORT
      value: "9001"                # 服务端口
  containers:
  - name: counting-service
    image: [计数服务镜像]  # 主应用容器
    ports:
    - containerPort: 9001

配置参数说明

注意事项

• 该镜像为演示性质，未包含生产环境所需的安全配置（如TLS加密、认证等）
• 服务注册逻辑已预配置为计数服务场景，如需注册其他服务需修改源码
• 完整使用流程和详细教程请参考代码仓库中的官方文档

代码获取与自定义

如需修改或扩展功能，可从GitHub仓库获取源代码进行自定义构建：

bash
git clone https://github.com/hashicorp/demo-consul-101.git
cd demo-consul-101/k8s
# 根据需求修改代码后重新构建镜像