一个微服务应用程序，允许用户为他们最喜欢的表情符号(emoji)投票，并跟踪排行榜上收到的投票。愿最好的 emoji 获胜。
该应用程序由以下 3 个服务组成：
emojivoto-web：Web 前端和 REST API
- https://github.com/BuoyantIO/emojivoto/tree/main/emojivoto-web
emojivoto-emoji-svc：用于查找和列出 emoji 的 gRPC API
- https://github.com/BuoyantIO/emojivoto/tree/main/emojivoto-emoji-svc
emojivoto-voting-svc：用于投票和排行榜的 gRPC API
- https://github.com/BuoyantIO/emojivoto/blob/main/emojivoto-voting-svc
实战
腾讯云 K8S 集群实战 Service Mesh—Linkerd2 & Traefik2 部署 emojivoto 应用
运行
在 Minikube 中
使用 Linkerd2 服务网格将应用程序部署到 Minikube。
1.安装 linkerd CLI
- curl https://run.linkerd.io/install | sh
2.安装 Linkerd2
- linkerd install | kubectl apply -f -
3.查看仪表盘!
- linkerd dashboard
4.Inject, Deploy, and Enjoy
- kubectl kustomize kustomize/deployment | \
- linkerd inject - | \
- kubectl apply -f -
5.使用应用程序!
- minikube -n emojivoto service web-svc
在 docker-compose 中
也可以使用 docker-compose(不带 Linkerd2)运行应用程序。
构建并运行：
- make deploy-to-docker-compose
Web 应用程序将在 docker 主机的端口 8080 上运行。
通过 URL
独立部署到现有集群：
- kubectl apply -k github.com/BuoyantIO/emojivoto/kustomize/deployment
生成一些流量
VoteBot 服务可以为你带来一些流量。它对表情符号“随机”投票如下:
- 15% 的选票投给 🍩
- 不给 🍩 投票时，它会随机选择一个表情符号
如果您使用上述 instructions(部署说明) 运行应用程序，则 VoteBot 将已部署，并将开始向投票端点发送流量。
如果您想手动运行机器人：
- export WEB_HOST=localhost:8080 # replace with your web location
- go run emojivoto-web/cmd/vote-bot/main.go
发布新版本
要构建和推送 multi-arch docker 镜像：
1.更新 common.mk 中的标签名称
2.创建 Buildx 构建器实例
- docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
- docker buildx create --name=multiarch-builder --driver=docker-container --use
- docker buildx inspect multiarch-builder --bootstrap
3.构建 & 推送 multi-arch docker 镜像到 hub.docker.com
- docker login
- make multi-arch
4.更新：
- docker-compose.yml
- kustomize/deployment/emoji.yml
- kustomize/deployment/vote-bot.yml
- kustomize/deployment/voting.yml
- kustomize/deployment/web.yml
5.分发到 Linkerd website repo
- kubectl kustomize kustomize/deployment > ../website/run.linkerd.io/public/emojivoto.yml
- kubectl kustomize kustomize/daemonset > ../website/run.linkerd.io/public/emojivoto-daemonset.yml
- kubectl kustomize kustomize/statefulset > ../website/run.linkerd.io/public/emojivoto-statefulset.yml
Prometheus 指标
默认情况下，投票服务在端口 8801 上公开有关当前投票计数的 Prometheus 指标。
这可以通过取消设置 PROM_PORT 环境变量来禁用。
本地开发
Emojivoto webapp
这个应用程序是用 React 编写的，并使用 webpack 打包。使用以下命令运行 emojivoto go services 并在前端进行开发。
设置 proto 文件，构建应用程序
- make build
启动投票服务
- GRPC_PORT=8081 go run emojivoto-voting-svc/cmd/server.go
[在单独的终端窗口中] 启动 emoji 服务
- GRPC_PORT=8082 go run emojivoto-emoji-svc/cmd/server.go
[在单独的终端窗口中] 捆绑前端资源
- cd emojivoto-web/webapp
- yarn install
- yarn webpack # one time asset-bundling OR
- yarn webpack-dev-server --port 8083 # bundle/serve reloading assets
[在单独的终端窗口中] 启动 Web 服务
- export WEB_PORT=8080
- export VOTINGSVC_HOST=localhost:8081
- export EMOJISVC_HOST=localhost:8082
- # if you ran yarn webpack
- export INDEX_BUNDLE=emojivoto-web/webapp/dist/index_bundle.js
- # if you ran yarn webpack-dev-server
- export WEBPACK_DEV_SERVER=http://localhost:8083
- # start the webserver
- go run emojivoto-web/cmd/server.go
[可选] 启动投票机器人以自动生成流量。
- export WEB_HOST=localhost:8080
- go run emojivoto-web/cmd/vote-bot/main.go
查看 emojivoto
- open http://localhost:8080
测试 Linkerd 服务配置文件
Service Profiles 是 Linkerd 的一个特性， 它提供了每条路由的功能，如遥测(telemetry)、超时(timeouts)和重试(retries)。 Emojivoto 应用程序旨在通过以下说明展示服务配置文件。
Service Profiles：https://linkerd.io/2/features/service-profiles
从 .proto 文件生成 ServiceProfile 定义
emoji 和 voting 服务是具有 Protocol Buffers (protobuf) definition 文件的 gRPC 应用程序。这些 .proto 文件可用作 linkerd profile 命令的输入， 以创建 ServiceProfile definition yaml 文件。Linkerd Service Profile 文档 概述了创建 yaml 文件所需的步骤，这些是您可以从该存储库的根目录使用的命令：
- linkerd profile --proto proto/Emoji.proto emoji-svc -n emojivoto
- linkerd profile --proto proto/Voting.proto voting-svc -n emojivoto
Protocol Buffers (protobuf)：https://developers.google.com/protocol-buffers
gRPC：https://grpc.io
Linkerd Service Profile 文档：https://linkerd.io/2/tasks/setting-up-service-profiles/#protobuf
这些命令中的每一个都会输出 yaml，您可以将其写入文件或管道， 直接将其写入 kubectl apply。例如：
- 写入文件：
- linkerd profile --proto proto/Emoji.proto emoji-svc -n emojivoto > emoji
- -sp.yaml
- 直接 apply：
- linkerd profile --proto proto/Voting.proto voting-svc -n emojivoto | \
- kubectl apply -f -
为 Web 部署生成 ServiceProfile 定义
emojivoto 的 web-svc 部署是一个由 Go server 托管的 React 应用程序。我们可以使用 linkerd profile auto creation，使用以下命令为 web-svc 生成 ServiceProfile 资源：
- linkerd profile -n emojivoto web-svc --tap deploy/web --tap-duration 10s | \
- kubectl apply -f -
现在为所有服务生成了服务配置文件，您可以在 Linkerd Dashboard 上或使用 linkerd routes 命令观察每个服务的每条路由指标
- linkerd -n emojivoto routes deploy/web-svc --to svc/emoji-svc
linkerd profile auto creation
- https://linkerd.io/2/tasks/setting-up-service-profiles/#auto-creation
Linkerd Dashboard
- https://linkerd.io/2/features/dashboard
