bretfisher/wordsmith-web

Kubernetes Wordsmith 演示应用

Wordsmith 是 DockerCon EU 2017 上展示的演示项目，当时 Docker 宣布其平台将支持 Kubernetes。该演示应用由三个容器组成：

• db - Postgres 数据库，用于存储单词
• words - Java REST API，提供从数据库读取的单词
• web - Go Web 应用，调用 API 并将单词组合成句子

!在 Docker for Mac 上的 Kubernetes 中运行的 Wordsmith 应用

核心功能与特性

• 多容器架构：由数据库、API 服务和 Web 应用组成的微服务架构
• 跨编排支持：可通过 Docker Compose 或 Kubernetes 清单部署到 Kubernetes
• 动态内容生成：每次刷新网页会展示由 API 调用生成的不同句子

使用场景

作为演示如何在 Kubernetes 上部署复杂多容器应用的示例，适用于学习 Docker 与 Kubernetes 集成、多服务应用编排的开发者。

构建方法

构建和运行应用的唯一要求是 Docker。克隆仓库后，使用 Docker Compose 构建所有镜像：

cd k8s-wordsmith-demo

docker-compose build

或者可以使用 docker-compose pull 从 Docker Hub 拉取预构建镜像。

作为 Docker Stack 部署

最新版本的 Docker for Mac 内置了 Kubernetes。Docker 允许使用简单的 Docker Compose 文件格式将复杂应用部署到 Kubernetes，可通过 docker-compose.yml 将应用部署到本地 Kubernetes 集群。

部署步骤

1. 检查 Docker 编排器：

   docker version -f '{{ .Client.Orchestrator }}'
   

   可通过 DOCKER_ORCHESTRATOR 环境变量切换编排器（设置为 kubernetes 或 swarm）。

2. 部署应用到 Kubernetes：

   export DOCKER_ORCHESTRATOR=kubernetes
   docker stack deploy wordsmith -c docker-compose.yml
   

3. 验证部署：

   • 检查服务状态：

     kubectl get svc
     

     预期输出类似：

     NAME         TYPE           CLUSTER-IP       EXTERNAL-IP   PORT(S)          AGE
     db           ClusterIP      None             <none>        55555/TCP        2m
     kubernetes   ClusterIP      10.96.0.1        <none>        443/TCP          38d
     web          LoadBalancer   10.107.215.211   <pending>     8080:30220/TCP   2m
     words        ClusterIP      None             <none>        55555/TCP        2m
     

   • 检查 Pod 状态：

     kubectl get pods
     

     预期看到数据库和 Web 组件各 1 个 Pod，以及 5 个 words API Pod（compose 文件中指定的副本数）：

     NAME                   READY     STATUS    RESTARTS   AGE
     db-8678676c79-h2d99    1/1       Running   0          1m
     web-5d6bfbbd8b-6zbl8   1/1       Running   0          1m
     words-858f6678-6c8kk   1/1       Running   0          1m
     words-858f6678-7bqbv   1/1       Running   0          1m
     words-858f6678-fjdws   1/1       Running   0          1m
     words-858f6678-rrr8c   1/1       Running   0          1m
     words-858f6678-x9zqh   1/1       Running   0          1m
     

4. 访问应用：浏览 http://localhost:8080，每次刷新页面会显示不同的生成句子。

使用 Kubernetes 清单部署

可通过 Kubernetes 清单 部署相同应用，该清单用 Kubernetes 的部署、服务和 Pod 规范描述了应用。

部署步骤

1. 移除现有 Kubernetes stack（可选）：

   docker stack rm wordsmith
   

   或者保留现有部署，在新的 Kubernetes 命名空间中创建第二个部署。

2. 应用 Kubernetes 清单：

   kubectl apply -f kube-deployment.yml
   

3. 访问应用：浏览 http://localhost:8081，将看到与之前相同的网站。