我来分析 Kubernetes 测试镜像中 hostname.go 的源码。这个文件位于 test/images/busybox/hostname.go，是一个简单的 HTTP 服务，用于返回容器的主机名。

源码概览

/*
Copyright 2015 The Kubernetes Authors.

Licensed under the Apache License, Version 2.0 (the "License");
...
*/

package main

import (
    "fmt"
    "net/http"
    "os"
)

func main() {
    // 获取主机名
    hostname, err := os.Hostname()
    if err != nil {
        panic(err)
    }
    
    // 定义 HTTP 处理函数
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "hostname: %s\n", hostname)
    })
    
    // 启动 HTTP 服务器
    http.ListenAndServe(":9376", nil)
}

详细分析

1. 代码功能

这是一个极简的 HTTP 服务器，核心功能：

• 获取运行容器的主机名（通常是 Pod 名称）
• 在 9376 端口提供 HTTP 服务
• 对任何请求返回包含主机名的响应

2. 设计目的

这个镜像主要用于 Kubernetes 测试场景：

# 典型使用场景
# 1. 作为测试 Pod 运行
kubectl run test-pod --image=busybox:1.29 --command -- /bin/sh -c "while true; do sleep 3600; done"

# 2. 验证服务发现
kubectl expose pod test-pod --port=9376 --target-port=9376

# 3. 测试 Ingress 或负载均衡
curl http://test-pod:9376/
# 输出: hostname: test-pod-xxxxx

3. 技术细节

端口选择：9376

• 不是常用端口（80、8080、443），避免冲突
• 在 Kubernetes 测试套件中约定俗成的测试端口

os.Hostname() 的行为

hostname, err := os.Hostname()

• 在容器环境中返回 Pod 的 hostname
• 通常等于 Pod 名称（如果未显式设置）
• 错误处理简单直接：出错时 panic

HTTP 处理函数

http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "hostname: %s\n", hostname)
})

• 注册根路径处理函数
• 忽略请求路径、方法、参数
• 总是返回相同内容（静态响应）

4. 在 Kubernetes 测试中的应用

这个镜像常用于：

测试 1：验证 Pod 间通信

apiVersion: v1
kind: Pod
metadata:
  name: hostname-test
spec:
  containers:
  - name: busybox
    image: busybox:1.29
    command: ["/bin/sh", "-c"]
    args: ["/hostname"]
    ports:
    - containerPort: 9376

测试 2：验证 Service 负载均衡

# 创建多副本 Deployment
kubectl create deployment hostname-test --image=busybox:1.29 --replicas=3 -- /hostname

# 创建 Service
kubectl expose deployment hostname-test --port=80 --target-port=9376

# 多次请求应返回不同主机名（负载均衡）
for i in {1..10}; do curl -s http://hostname-test/; done

5. 源码特点

特性	说明
简洁性	仅 20 行代码，易于理解
单一职责	只返回主机名，无其他逻辑
无依赖	仅使用 Go 标准库
确定性	相同输入永远返回相同输出

6. 与其他测试镜像的对比

Kubernetes 测试镜像目录结构：

test/images/
├── busybox/
│   ├── hostname.go      # 返回主机名
│   └── Dockerfile
├── agnhost/              # 多功能测试镜像（替代 busybox）
│   ├── hostname.go       # 类似功能但更复杂
│   └── netexec.go        # 网络测试工具
└── ...

7. 改进版本（agnhost）

在较新版本中，Kubernetes 使用 agnhost 替代简单的 busybox 镜像，提供更多功能：

// agnhost 中的 hostname 模块
func hostnameHandler(w http.ResponseWriter, r *http.Request) {
    name, err := os.Hostname()
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    
    // 支持自定义格式
    if r.URL.Query().Get("format") == "json" {
        json.NewEncoder(w).Encode(map[string]string{
            "hostname": name,
        })
        return
    }
    
    fmt.Fprintf(w, "%s", name)
}

8. 实际使用示例

# 在 Kubernetes 集群中测试
# 1. 创建测试 Pod
kubectl run test-hostname --image=busybox:1.29 --restart=Never -- /hostname

# 2. 端口转发
kubectl port-forward test-hostname 9376:9376

# 3. 本地测试
curl http://localhost:9376/
# 输出: hostname: test-hostname

# 4. 进入容器验证
kubectl exec -it test-hostname -- cat /etc/hostname
# 输出: test-hostname

总结

这个简单的程序体现了 Kubernetes 测试哲学：

• 最小化：只做一件事，做好一件事
• 可预测：行为简单明确，便于自动化测试
• 无状态：不依赖外部资源，易于在 CI/CD 中运行
• 容器原生：利用容器特性（hostname 即 Pod 标识）

虽然功能简单，但它在 Kubernetes 的网络测试、服务发现验证、负载均衡测试中发挥着重要作用。