hapkecom/info-server

info-server - 用于测试Docker和Kubernetes环境的简单HTTP服务器

概述

本项目旨在提供一个轻量的HTTP服务器，可部署到Docker或Kubernetes环境中。访问运行中的服务器时，它会返回Docker容器或Kubernetes pod的相关信息，帮助验证环境部署和服务访问是否正常。

核心功能

服务器响应包含以下内容：

• MESSAGE文件的内容（可在构建镜像前修改，或通过容器内的/MESSAGE路径调整），用于区分不同镜像部署，验证访问是否正确。
• 时间戳（显示上一次请求的时间，用于确认结果新鲜度）。
• VERSION文件的内容（包含镜像版本标签，需在部署前设置）。
• 运行容器/pod的主机名和Kubernetes命名空间，验证部署正确性。
• 可选的MongoDB访问检查（默认目标为mongo:27017），用于测试同一K8s命名空间内服务的可达性。
• 容器/pod内所有环境变量的排序列表。

配置说明

• ./MESSAGE：可放置自定义ASCII消息。
• ./VERSION：设置镜像版本标签。
• ./info-config.sh：包含少量配置项。
• ./kubernetes-configurations/*：Kubernetes部署示例文件。

部署示例

Docker本地构建与运行

1. 本地构建镜像：

   bash
   sudo ./docker-build.sh
   

2. 运行本地构建的镜像：

   bash
   sudo docker run -d -p 8080:8080 info-server
   

推送到远程仓库

修改docker-releaseAndPush2Repo.sh中的DOCKERREPO变量，确保本地Docker有权限访问远程仓库后执行：

bash
./docker-releaseAndPush2Repo.sh

Docker直接部署

使用预构建镜像运行：

bash
sudo docker run -d -p 8080:8080 hapkecom/info-server

Kubernetes部署

1. 创建命名空间（可选）：

   bash
   export NAMESPACE=my-namespace
   kubectl create namespace $NAMESPACE
   

2. 部署info-server：

   bash
   kubectl --namespace $NAMESPACE apply -f kubernetes-configurations/info-server-kubernetes.yaml
   

3. （可选）部署MongoDB服务（用于测试服务访问）：

   bash
   kubectl --namespace $NAMESPACE apply -f kubernetes-configurations/mongo-kubernetes.yaml
   

4. 访问服务：
   • 远程K8s环境：获取外部IP和端口后访问

     bash
     kubectl get services --namespace $NAMESPACE | egrep -e "(info-server|EXTERNAL-IP|PORT)"
     curl http://[EXTERNAL-IP]:[PORT]/
     

   • Minikube本地环境：

     bash
     minikube service --namespace $NAMESPACE info-server
     

5. 清理（可选）：

   bash
   kubectl delete namespace $NAMESPACE
   

其他测试用Docker镜像推荐

• HTTP回声服务器（Go编写）：
  • Docker仓库：https://hub.docker.com/r/jmalloc/echo-server/
  • 源码仓库：https://github.com/jmalloc/echo-server

未来计划

• 扩展为回声服务器功能。

版权信息

Copyright (c) 2018 by hapke.com

• 源码：https://github.com/hapkecom/info-server
• Docker镜像：https://hub.docker.com/r/hapkecom/info-server/
• 许可证：GPL版本3（详见LICENSE文件）