cilium/guestbook

Kubernetes留言板示例镜像（自定义版本）

镜像概述

本镜像为Kubernetes留言板（guestbook）示例的自定义版本，旨在官方PR（Pull Request）被接受前，提供一个可直接使用的留言板应用部署方案。该镜像基于经典的Kubernetes示例架构构建，可作为Kubernetes部署实践、应用功能演示的基础工具。

核心功能与特性

• 基础留言板功能：支持用户提交留言、查看历史留言列表，实现基本的前后端数据交互
• Kubernetes兼容架构：遵循Kubernetes示例应用设计规范，可与Kubernetes集群无缝集成
• 轻量级部署：镜像体积优化，适合快速部署和测试验证
• 临时过渡版本：作为官方PR审核期间的替代方案，功能与官方示例保持一致

使用场景

• Kubernetes初学者学习容器化应用部署流程
• 开发团队演示Kubernetes多组件应用协作模式
• PR审核期间的功能验证与临时环境搭建
• 留言板类简单Web应用的快速原型测试

使用方法与配置说明

前提条件

• 已安装Docker引擎
• 已配置Kubernetes集群（单节点或多节点均可）
• 已安装kubectl命令行工具并配置集群访问权限

部署示例

使用kubectl部署

1. 创建部署配置文件（guestbook-deployment.yaml）：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: guestbook
spec:
  replicas: 2
  selector:
    matchLabels:
      app: guestbook
  template:
    metadata:
      labels:
        app: guestbook
    spec:
      containers:
      - name: guestbook
        image: docker.xuanyuan.run/[镜像名称]  # 替换为实际镜像名称
        ports:
        - containerPort: 80
        resources:
          requests:
            cpu: "100m"
            memory: "128Mi"
          limits:
            cpu: "200m"
            memory: "256Mi"

2. 创建服务配置文件（guestbook-service.yaml）：

yaml
apiVersion: v1
kind: Service
metadata:
  name: guestbook
spec:
  selector:
    app: guestbook
  ports:
  - port: 80
    targetPort: 80
  type: NodePort  # 或根据需求使用LoadBalancer/ClusterIP

3. 执行部署命令：

bash
# 部署应用
kubectl apply -f guestbook-deployment.yaml

# 创建服务
kubectl apply -f guestbook-service.yaml

# 查看部署状态
kubectl get deployments
kubectl get pods
kubectl get services guestbook

4. 访问应用：
   • 获取NodePort服务端口：kubectl get service guestbook
   • 通过集群节点IP和端口访问：http://<node-ip>:<node-port>

配置说明

• 副本数调整：修改部署配置中的replicas字段可调整应用实例数量
• 资源限制：通过resources字段设置CPU和内存资源的请求与限制
• 服务类型：根据集群环境选择合适的服务类型（NodePort/Load***/ClusterIP）
• 镜像更新：当官方PR被接受后，可将配置文件中的镜像名称替换为官方版本

注意事项

• 本镜像为临时过渡版本，官方PR合并后建议迁移至官方镜像
• 生产环境使用需额外配置持久化存储、健康检查和安全策略
• 部署前确保Kubernetes集群网络插件正常运行，保障Pod间通信