etoews/hello-kubernetes

Hello Kubernetes

这是一个基于Python和Flask的简单Web服务镜像，用于在Docker、Kubernetes或OpenShift环境中快速验证集群运行状态，是新集群部署后的入门测试工具。该镜像基于nicolaka/netshoot（一款Docker/Kubernetes网络调试工具集合）构建，内置丰富的网络工具，可用于排查容器及集群网络问题。

核心功能

1. 提供基础Web服务，返回Hello信息，验证集群服务可达性
2. 集成netshoot的网络调试工具集（如ping、traceroute、curl等），支持网络问题排查
3. 支持Docker、Kubernetes、OpenShift等主流容器编排平台

使用场景

1. 新集群部署后，快速验证容器运行和网络连通性
2. 排查容器间通信、集群内外网络访问等问题
3. 作为容器化入门学习的示例镜像

配置说明与部署示例

本地运行

bash
python -m venv venv
source venv/bin/activate
pip install --requirement requirements.txt

export FLASK_APP="app.py"
export FLASK_ENV="development"
export FLASK_RUN_HOST="0.0.0.0"
flask run

curl -s http://localhost:5000/

Docker部署

本地构建并运行

bash
docker build -t hello-kubernetes .
docker run -it --rm \
  --name hello \
  --publish 5000:5000 \
  hello-kubernetes

curl -s http://localhost:5000/

使用DockerHub镜像运行

bash
docker run -it --rm \
  --name hello \
  --publish 5000:5000 \
  docker.io/etoews/hello-kubernetes:latest

curl -s http://localhost:5000/

Docker容器调试

bash
docker exec -it hello bash

Kubernetes部署

本地Kubernetes运行（使用DockerHub镜像）

bash
kubectl create namespace world
kubectl apply -f manifests/kubernetes/deployment.yaml -n world
kubectl apply -f manifests/kubernetes/service.yaml -n world

watch kubectl get all -n world

curl -s http://localhost:5000/

kubectl delete namespace world

说明：在Docker Desktop Kubernetes环境中使用type: LoadBalancer可直接访问服务。

远程Kubernetes运行（使用DockerHub镜像）

bash
kubectl create namespace world
kubectl apply -f manifests/kubernetes/deployment.yaml -n world
kubectl apply -f manifests/kubernetes/service.yaml -n world

watch kubectl get all -n world

hello_host=$(kubectl get service hello -o jsonpath="{.status.loadBalancer.ingress[*].hostname}" -n world)
curl -s http://${hello_host}:5000/

kubectl delete namespace world

说明：删除命名空间时会同时清理背后的负载均衡实例（如EKS的ELB），需等待几分钟完成。

Kubernetes网络调试

参考https://hub.docker.com/r/nicolaka/netshoot%E4%BA%86%E8%A7%A3%E5%86%85%E7%BD%AE%E5%B7%A5%E5%85%B7%E3%80%82

bash
hello_pod_0=$(kubectl get pods -o jsonpath="{.items[0].metadata.name}" -n world)
kubectl exec -it ${hello_pod_0} -n world bash
curl -s https://icanhazip.com

OpenShift部署

OpenShift 4远程运行（使用DockerHub镜像）

bash
oc new-project world

oc process -o yaml -f manifests/openshift4/deployment.yaml \
  --param IMAGE='docker.io/etoews/hello-kubernetes:latest' \
  | oc apply -f -
oc apply -f manifests/openshift4/service.yaml
oc apply -f manifests/openshift4/route.yaml

watch oc get all

hello_host=$(oc get route hello --no-headers -o=custom-columns=HOST:.spec.host)
curl http://${hello_host}/

oc delete project world

OpenShift 4远程构建并运行

bash
oc new-project world

oc apply -f manifests/openshift4/imagestream.yaml
oc apply -f manifests/openshift4/buildconfig.yaml

oc start-build hello  
watch oc get all

oc process -o yaml -f manifests/openshift4/deployment.yaml \
  --param IMAGE='image-registry.openshift-image-registry.svc:5000/world/hello:latest' \
  | oc apply -f -
oc apply -f manifests/openshift4/service.yaml
oc apply -f manifests/openshift4/route.yaml

watch oc get all

hello_host=$(oc get route hello --no-headers -o=custom-columns=HOST:.spec.host)
curl http://${hello_host}/

oc delete project world

OpenShift 4网络调试

参考https://hub.docker.com/r/nicolaka/netshoot%E4%BA%86%E8%A7%A3%E5%86%85%E7%BD%AE%E5%B7%A5%E5%85%B7%E3%80%82

bash
hello_pod_0=$(oc get pods --selector app=hello -o jsonpath="{.items[0].metadata.name}")
oc rsh ${hello_pod_0}
curl -s https://icanhazip.com

运行指定版本

使用GitHub提交哈希作为镜像标签运行特定版本：

bash
docker run -it --rm \
  --name hello \
  --publish 5000:5000 \
  docker.io/etoews/hello-kubernetes:b262b385143f***d5dbe201b999ded7782087a

curl -s http://localhost:5000/