bretfisher/wordsmith-words

Kubernetes Wordsmith Demo

镜像概述和主要用途

Wordsmith是DockerCon EU 2017上展示的演示项目，当时Docker宣布其平台即将支持Kubernetes。该演示应用通过三个容器协同运行，展示了多容器应用在Kubernetes环境中的部署和运行方式。

核心功能和特性

该应用由以下三个容器组成：

• db：基于Postgres的数据库容器，用于存储单词数据
• words：Java REST API服务容器，从数据库读取单词并提供API接口
• web：Go语言编写的Web应用容器，调用words API并将单词组合成句子

使用场景和适用范围

• 演示Docker平台与Kubernetes的集成能力
• 学习多容器应用的编排和部署
• 展示Docker Compose文件在Kubernetes环境中的应用
• 作为Kubernetes入门学习的示例项目

详细使用方法和配置说明

构建

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

bash
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将wordsmith应用部署到本地Kubernetes集群。

首先使用docker version检查Docker当前使用的编排器（Kubernetes或Docker Swarm），Docker for Mac支持同时运行两种编排器：

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

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

使用compose文件将应用作为stack部署到Kubernetes：

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

Docker for Mac包含kubectl命令行工具，可直接操作Kubernetes集群。检查服务状态，应看到类似以下输出：

bash
$ 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运行状态，应看到数据库和web组件各1个pod，以及5个words API pod（compose文件中指定的副本数）：

bash
$ kubectl get pods
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

然后访问http://localhost:8080即可查看应用。每次刷新页面，都会看到由API调用生成的不同句子。

使用Kubernetes Manifest部署

也可使用Kubernetes manifest将相同应用部署到Kubernetes。该文件以Kubernetes的部署、服务和pod规范描述了相同的应用。

首先移除之前的Kubernetes stack：

bash
docker stack rm wordsmith

或者可以保留Docker stack部署，在新的Kubernetes命名空间中创建第二个部署。

使用kubectl应用manifest：

bash
kubectl apply -f kube-deployment.yml

现在访问http://localhost:8081即可看到相同的应用。