datawire/hello-world

Hello World Docker镜像文档

一、镜像概述

Hello World是一个轻量级的Docker镜像，主要用于测试和演示目的。该镜像基于Python和Flask框架构建，提供简单的HTTP服务（返回"Hello, world!"响应），可用于验证Docker部署流程、本地开发环境配置及Kubernetes服务部署等场景。本镜像在Telepresence文档及OpenShift博客中被引用，作为本地开发与容器化部署集成的示例。

二、核心功能与特性

1. 轻量级设计：基于python:3-alpine基础镜像，镜像体积小，资源占用低
2. 简单HTTP服务：通过Flask框架实现基础Web服务，根路径(/)返回"Hello, world!"
3. 标准化端口：默认暴露8000端口，便于网络访问与端口映射
4. 易于构建部署：提供简洁的Dockerfile，支持快速构建和本地/容器化运行
5. 跨环境兼容：支持本地Python环境运行、Docker容器部署及Kubernetes集群部署

三、使用场景与适用范围

1. Docker部署测试：验证Docker镜像构建、容器运行、端口映射等基础流程
2. 本地开发验证：快速搭建简单Web服务，测试本地开发环境配置
3. Kubernetes入门演示：作为基础服务示例，演示Kubernetes的Deployment和Service创建流程
4. Telepresence工具集成：配合Telepresence工具，演示本地开发与远程Kubernetes集群的联调场景

四、使用方法与配置说明

4.1 本地环境运行

在无Docker环境时，可直接通过Python虚拟环境运行服务：

shell
# 创建并激活Python虚拟环境
python3 -m venv venv
source ./venv/bin/activate  # Linux/macOS
# 或 .\venv\Scripts\activate (Windows)

# 安装依赖
pip install -qr requirements.txt

# 启动服务
python3 server.py

服务启动后，控制台将输出类似以下日志，可通过http://localhost:8000访问：

 * Serving Flask app "server" (lazy loading)
 * Environment: production
   WARNING: Do not use the development server in a production environment.
   Use a production WSGI server instead.
 * Debug mode: on
 * Running on http://0.0.0.0:8000/ (Press CTRL+C to quit)

4.2 构建Docker镜像

通过以下命令构建本地Docker镜像：

shell
docker build -t datawire/hello-world .

构建过程日志示例：

Sending build context to Docker daemon  20.99kB
Step 1/7 : FROM python:3-alpine
 ---> a93594ce93e7
Step 2/7 : WORKDIR /usr/src/app
 ---> Running in 99c72d9f80c6
Removing intermediate container 99c72d9f80c6
 ---> ae6cf20413de
Step 3/7 : EXPOSE 8000
 ---> Running in 5feb111b3909
Removing intermediate container 5feb111b3909
 ---> b02c0d3d44cb
Step 4/7 : COPY requirements.txt .
 ---> f78be477ef4c
Step 5/7 : RUN pip install -qr requirements.txt
 ---> Running in 81044c1a701a
Removing intermediate container 81044c1a701a
 ---> f34572dbcf4a
Step 6/7 : COPY server.py .
 ---> 49185ab473c5
Step 7/7 : CMD ["python3", "./server.py"]
 ---> Running in 2446171f3946
Removing intermediate container 2446171f3946
 ---> 7d692d619894
Successfully built 7d692d619894
Successfully tagged datawire/hello-world:latest

4.3 Docker容器部署

4.3.1 构建镜像（见4.2节）

4.3.2 启动容器

通过docker run命令启动容器，映射本地端口8000到容器端口8000：

shell
docker run --rm -it -p 8000:8000 datawire/hello-world

• 参数说明：
  • --rm：容器退出后自动删除
  • -it：交互式终端模式，便于查看日志
  • -p 8000:8000：端口映射（本地端口:容器端口）

服务启动后，可通过http://localhost:8000访问，容器日志输出与本地运行一致。

4.4 Kubernetes集群部署

4.4.1 前提条件

• 已安装kubectl并配置集群访问权限
• 镜像已推送至Kubernetes集群可访问的仓库（或使用本地镜像，需配置imagePullPolicy: Never）

4.4.2 部署步骤

1. 创建Deployment和Service

shell
# 创建Deployment（部署服务）和Service（暴露访问入口）
kubectl run hello-world --image=datawire/hello-world --port=8000 --expose

• --image：指定镜像（需替换为实际镜像地址）
• --port=8000：容器端口
• --expose：自动创建ClusterIP类型的Service，暴露服务

2. 验证部署状态

shell
# 查看Deployment状态
kubectl get deploy -l run=hello-world

# 查看Pod状态
kubectl get po -l run=hello-world

# 查看Service信息（获取ClusterIP）
kubectl get svc hello-world

3. 集群内访问测试

通过临时Pod访问服务（需集群内有可执行curl的镜像，如fedora）：

shell
kubectl run curl-from-cluster -it --rm --image=fedora --restart=Never -- curl hello-world:8000

成功访问后，将返回Hello, world!。

4. 查看服务日志

shell
# 获取Pod名称（替换<POD_NAME>）
kubectl logs <POD_NAME>

五、配置参数说明

5.1 镜像默认配置

• 基础镜像：python:3-alpine
• 工作目录：/usr/src/app
• 暴露端口：8000（Dockerfile中通过EXPOSE 8000声明）
• 启动命令：["python3", "./server.py"]（通过CMD指定）

5.2 可调整参数

本镜像无额外环境变量或配置文件，主要通过运行时参数（如端口映射、镜像名称）调整部署行为，具体见4.3.2和4.4.2节。

六、许可证

本镜像基于Apache 2.0许可证开源，详情参见LICENSE文件。