nmajorov/guestbook

镜像概述

本镜像为Kubernetes官方示例项目guestbook-go的克隆版本，原项目位于https://github.com/kubernetes/examples/tree/master/guestbook-go，旨在提供一个轻量级容器化应用示例，用于演示Kubernetes部署基础Web应用的标准流程和配置方法。

核心功能与特性

• 功能一致性：完整复刻原guestbook-go项目核心功能，包括Web留言板界面、用户留言提交/展示、基础数据管理等操作
• 技术栈匹配：基于Go语言开发，沿用原项目轻量级架构，使用标准库处理HTTP请求与数据交互
• 容器化优化：内置容器化运行配置，支持Docker环境直接部署，无需额外编译步骤
• 依赖兼容性：保留原项目对Redis数据库的依赖设计，支持通过环境变量配置后端存储连接

使用场景与适用范围

• Kubernetes学习：供开发者实践Kubernetes基础部署流程，理解Pod、Service、Deployment等资源的配置关系
• 容器化教学：作为简单Web应用案例，用于演示容器构建、端口映射、环境变量注入等基础操作
• 演示环境：快速搭建可交互的Web应用实例，展示容器化应用的实际运行效果
• 开发测试：作为基础模板验证Kubernetes网络策略、服务发现、外部依赖连接等功能

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 可访问的Redis服务实例（用于存储留言数据，可通过容器或外部服务部署）

基础使用流程

1. 拉取镜像

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/guestbook-go-clone:[版本标签]  # 需替换为实际镜像地址和标签

2. 启动Redis服务（可选）

若本地无Redis服务，可先启动Redis容器：

bash
docker run -d --name redis-master -p 6379:6379 docker.xuanyuan.run/redis:alpine

3. 运行应用容器

bash
docker run -d \
  --name guestbook-go \
  -p 8080:8080 \
  -e REDIS_MASTER_SERVICE_HOST=127.0.0.1 \  # 若Redis在容器内，需使用容器IP或通过--link连接
  -e REDIS_MASTER_SERVICE_PORT=6379 \
  -e PORT=8080 \
  [镜像仓库地址]/guestbook-go-clone:[版本标签]

4. 访问应用

通过浏览器或curl访问http://localhost:8080即可打开留言板界面

关键配置参数

Kubernetes部署示例

参考原项目Kubernetes配置，修改镜像地址后部署：

yaml
# deployment.yaml示例
apiVersion: apps/v1
kind: Deployment
metadata:
  name: guestbook-go
spec:
  replicas: 3
  selector:
    matchLabels:
      app: guestbook-go
  template:
    metadata:
      labels:
        app: guestbook-go
    spec:
      containers:
      - name: guestbook-go
        image: docker.xuanyuan.run/[镜像仓库地址]/guestbook-go-clone:[版本标签]
        ports:
        - containerPort: 8080
        env:
        - name: REDIS_MASTER_SERVICE_HOST
          value: "redis-master"
        - name: REDIS_MASTER_SERVICE_PORT
          value: "6379"

应用配置：

bash
kubectl apply -f deployment.yaml

注意事项

• 本镜像功能与原Kubernetes示例项目完全一致，原项目文档中的部署最佳实践同样适用
• 生产环境使用需补充健康检查、资源限制、安全上下文等配置
• Redis服务不可用时，应用将无法正常存储留言数据，但可维持基本Web界面访问
• 如需自定义应用行为，可基于本镜像二次构建，修改原项目代码后重新打包