hashicorp/dashboard-init

Consul-Kubernetes演示注册容器

镜像概述和主要用途

该Docker镜像是HashiCorp Consul与Kubernetes集成教程的演示容器，主要用作初始化容器（init container），在Kubernetes环境中实现服务向HashiCorp Consul的注册功能。其核心价值在于帮助用户理解和演示如何在Kubernetes集群中通过初始化容器机制完成Consul服务注册流程。

核心功能和特性

• 初始化容器模式：遵循Kubernetes init container规范，确保服务注册操作在主应用容器启动前执行
• Consul服务注册：实现与HashiCorp Consul的交互逻辑，完成服务元数据（名称、端口、地址等）的注册
• Kubernetes元数据集成：能够从Kubernetes环境获取Pod IP、服务端口等必要元数据
• 轻量级设计：专注于服务注册核心逻辑，镜像体积小，适合作为辅助容器运行

使用场景和适用范围

• 教程与学习环境：用于Consul与Kubernetes集成的入门教学，演示服务注册流程
• 开发测试验证：在本地或测试Kubernetes集群中验证Consul服务发现功能
• 云原生技术实践：帮助开发者理解初始化容器在服务网格配置中的应用模式

适用对象包括云原生开发者、DevOps工程师及需要学习Consul与Kubernetes集成的技术人员。

使用方法和配置说明

代码获取

镜像相关源代码及完整示例可从GitHub仓库获取：
https://github.com/hashicorp/demo-consul-101/tree/master/k8s

Docker运行示例

bash
docker run --rm \
  -e CONSUL_HTTP_ADDR=consul-server:8500 \
  -e SERVICE_NAME=demo-service \
  -e SERVICE_PORT=8080 \
  -e POD_IP=172.17.0.2 \
  hashicorp/demo-consul-101-k8s:latest

Kubernetes部署示例

Pod配置（含初始化容器）

yaml
apiVersion: v1
kind: Pod
metadata:
  name: consul-demo-pod
spec:
  initContainers:
  - name: consul-register
    image: hashicorp/demo-consul-101-k8s:latest
    env:
    - name: CONSUL_HTTP_ADDR
      value: "consul-agent:8500"  # Consul代理服务地址（Kubernetes内部服务名）
    - name: SERVICE_NAME
      value: "demo-app"           # 服务名称
    - name: SERVICE_PORT
      value: "8080"               # 服务监听端口
    - name: POD_IP
      valueFrom:
        fieldRef:
          fieldPath: status.podIP  # 从Kubernetes获取Pod IP
  containers:
  - name: main-app
    image: nginx:alpine
    ports:
    - containerPort: 8080

配置参数说明

注：实际参数以GitHub仓库最新代码定义为准，使用前请参考官方示例配置。