buoyantio/booksapp

Buoyant Books App

这是一个使用Sinatra、ActiveRecord和ActiveResource构建的分布式（微服务）Ruby示例应用，旨在展示Linkerd 2.0的多种价值，包括调试、可观测性和监控。应用中的部分服务会周期性失败，这是故意设计的，用于演示Linkerd 2.0的调试和监控能力。

该应用由以下四个服务组成：

• webapp.rb
• authors.rb
• books.rb
• traffic/main.go（演示流量生成器，使用Go编写）

!Books Application Topology

在Kubernetes中运行

你可以使用Linkerd 2.0服务网格将应用部署到Kubernetes。

1. 安装linkerd CLI

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

2. 安装Linkerd控制平面

   bash
   linkerd install | kubectl apply -f -
   

3. 注入并部署应用

   bash
   curl https://run.linkerd.io/booksapp.yml | linkerd inject - | kubectl apply -f -
   

4. 使用应用

   bash
   kubectl port-forward svc/webapp 7000
   open "http://localhost:7000"
   

5. 查看Linkerd仪表盘

   bash
   linkerd dashboard
   

!Linkerd Dashboard

使用MySQL运行

默认的booksapp配置使用SQLite。也可以使用k8s/目录中的配置，以MySQL作为后端运行应用。MySQL配置使用单独的Pod作为存储后端，允许每个应用部署运行多个副本。

1. 首先安装MySQL后端

   bash
   kubectl apply -f k8s/mysql-backend.yml
   

2. 验证mysql-init作业是否成功完成

   bash
   kubectl get po
   NAME                    READY     STATUS      RESTARTS   AGE
   mysql-9bd5bcfdf-7jb2s   1/1       Running     0          3m
   mysql-init-29nxv        0/1       Completed   0          3m
   

3. 按照上述步骤安装Linkerd；安装配置为使用MySQL的应用

   bash
   linkerd install | kubectl apply -f -
   linkerd inject k8s/mysql-app.yml | kubectl apply -f -
   

4. 使用应用

   bash
   kubectl port-forward svc/webapp 7000
   open "http://localhost:7000"
   

部署混沌猴子

该仓库包含一个混沌猴子脚本，每10秒随机杀死一个Pod。它旨在与Kubernetes/MySQL配置一起运行。要部署，请运行： bash kubectl apply -f k8s/mysql-chaos.yml

服务配置文件

为了记录每条路由的指标，你可以基于Swagger规范为webapp、books和authors服务创建服务配置文件： bash linkerd profile --open-api swagger/webapp.swagger webapp | kubectl apply -f - linkerd profile --open-api swagger/books.swagger books | kubectl apply -f - linkerd profile --open-api swagger/authors.swagger authors | kubectl apply -f -

然后你可以查看每个服务的路由数据： bash linkerd routes webapp bash linkerd routes books bash linkerd routes authors

流量分割

你可以使用修改版的booksapp来演示流量分割。

1. 安装booksapp-trafficsplit.yml，其中包含MySQL后端、不引入FAILURE_RATE的修改版booksapp.yml、名为authors-clone的第二个authors服务，以及两个流量分割配置。Linkerd已注入到booksapp和authors-clone中。

   bash
   kubectl apply -f booksapp-trafficsplit.yml
   

2. 验证default命名空间中是否存在两个流量分割

   bash
   kubectl get ts
   

3. 给应用1-2分钟开始发送流量。

4. 运行watch linkerd stat ts验证流量分割是否工作。你应该看到以下结果：一个流量分割在authors和authors-clone之间按50/50分配流量，另一个在webapp和不存在的webapp-clone之间按100/0分配流量（你可以在第二个服务创建前就在两个服务之间创建分割）。

   NAME            APEX      LEAF            WEIGHT   SUCCESS      RPS   LATENCY_P50   LATENCY_P95   LATENCY_P99
   authors-split   authors   authors           500m   100.00%   3.1rps           8ms          29ms          37ms
   authors-split   authors   authors-clone     500m   100.00%   3.5rps           8ms          23ms          37ms
   webapp-split    webapp    webapp               1   100.00%   7.3rps          26ms          74ms          95ms
   webapp-split    webapp    webapp-clone         0         -        -             -             -             -
   

5. 完成后，删除应用

   bash
   kubectl delete -f booksapp-trafficsplit.yml
   

本地运行

你也可以在本地运行应用进行开发。

1. 创建、迁移并填充数据库

   bash
   bundle install
   bundle exec rake db:create
   bundle exec rake db:migrate
   bundle exec rake db:seed
   

2. 启动web应用

   bash
   bundle exec rake dev:webapp
   

3. 启动authors应用

   bash
   bundle exec rake dev:authors
   

4. 启动books应用

   bash
   bundle exec rake dev:books
   

5. 打开网站

   bash
   open "http://localhost:7000"
   

!Books App

管理

Docker

该应用使用的所有Docker镜像已公开发布，无需手动构建。如果要本地构建镜像，请按照以下说明操作：

1. 构建buoyantio/booksapp镜像

   bash
   docker build -t buoyantio/booksapp:latest .
   

2. 构建buoyantio/booksapp-traffic镜像

   bash
   docker build -t buoyantio/booksapp-traffic:latest traffic