Emoji.voto，Linkerd 服务网格(service mesh)的示例应用程序

一个微服务应用程序，允许用户为他们最喜欢的表情符号(emoji)投票，并跟踪排行榜上收到的投票。愿最好的 emoji 获胜。

该应用程序由以下 3 个服务组成：

emojivoto-web：Web 前端和 REST API
emojivoto-emoji-svc：用于查找和列出 emoji 的 gRPC API
emojivoto-voting-svc：用于投票和排行榜的 gRPC API

实战

腾讯云 K8S 集群实战 Service Mesh—Linkerd2 & Traefik2 部署 emojivoto 应用

运行

在 Minikube 中

使用 Linkerd2 服务网格将应用程序部署到 Minikube。

安装 linkerd CLI

curl https://run.linkerd.io/install | sh

安装 Linkerd2
```
linkerd install | kubectl apply -f -
```
查看仪表盘！
```
linkerd dashboard
```

Inject, Deploy, and Enjoy

kubectl kustomize kustomize/deployment | \

    linkerd inject - | \

    kubectl apply -f -

使用应用程序！
```
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 镜像：

更新 common.mk 中的标签名称

创建 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

构建 & 推送 multi-arch docker 镜像到 hub.docker.com
```
docker login

make multi-arch
```
更新：
- docker-compose.yml
- kustomize/deployment/emoji.yml
- kustomize/deployment/vote-bot.yml
- kustomize/deployment/voting.yml
- kustomize/deployment/web.yml

分发到 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 应用程序旨在通过以下说明展示服务配置文件。

从 `.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

这些命令中的每一个都会输出 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