在本地运行
本指南将引导您完成在本地下载和运行Linkerd所需的步骤。
要在本地运行Linkerd,必须安装Java 8。您可以通过运行来检查Java版本:
$ java -version
java version "1.8.0_66"
Linkerd适用于Oracle和OpenJDK。如果需要安装Java 8,可以下载其中一个。
下载和安装
首先,下载Linkerd的最新二进制版本。
下载完发布后,将其解压缩:
tar -xzf linkerd-1.6.3.tgz
cd linkerd-1.6.3
该版本将包含以下文件:
config/linkerd.yaml
- 配置文件定义路由器,服务器,协议和端口disco/
- 基于文件的服务发现配置docs/
- 文件linkerd-1.6.3-exec
- Linkerd可执行文件logs/
- 写入链接器日志的默认位置
运行
解压缩版本后,您可以使用启动和停止Linkerd linkerd-1.6.3-exec
。
要启动Linkerd,请运行:
./linkerd-1.6.3-exec config/linkerd.yaml
确保它有效
您可以通过发送一些HTTP流量来验证Linkerd的工作原理。开箱即用,Linkerd配置为侦听端口4140,并将Host
标头设置为“web”的任何HTTP呼叫路由到侦听端口9999的服务。
您可以通过在端口9999上运行简单服务来测试它:
echo 'It works!' > index.html
python -m SimpleHTTPServer 9999
这将是我们的目标服务器,并将响应任何具有友好响应的HTTP请求。我们可以通过连接到Linkerd并指定适当的主机头来将流量发送到此目的地:
$ curl -H "Host: web" http://localhost:4140/
It works!
因为我们已经要求Linkerd代理“web”主机,我们的请求将被路由到端口9999上的服务器,并且响应被代理到客户端。有用!
请注意,如果您未提供与其中一个可路由服务的名称匹配的Host标头,则Linkerd将使请求失败:
$ curl -I -H "Host: foo" http://localhost:4140/
HTTP/1.1 502 Bad Gateway
当然,命名服务还不止于此!在下一节中,我们将看到指定上面使用的服务信息的位置。
基于文件的服务发现
在Linkerd附带的配置下,它在需要解析服务端点时首先看到的是disco/
目录。(有关此简单基于文件的服务发现系统如何工作的详细信息,请参阅配置指南。)使用此配置,Linkerd查找名称与目标的具体名称相对应的文件,并且它希望这些文件包含换行符分隔的文件表格中的地址列表host port
。
默认配置如下所示:
$ head disco/*
==> disco/thrift-buffered <==
127.0.0.1 9997
==> disco/thrift-framed <==
127.0.0.1 9998
==> disco/web <==
127.0.0.1 9999
正如您所看到的,有一个名为“web”的目标,它由一个地址127.0.0.1 9999
支持127.0.0.1 9998
,以及一个由它支持的thrift框架目标,以及一个由它支持的thrift缓冲目标 127.0.0.1 9997
。请注意,与所有服务发现端点一样,Linkerd会监视此目录以进行更改,因此可以随时添加,删除和编辑文件 - 无需重新启动。
Linkerd附带的路由配置非常简单,并直接路由到此目录中指定的具体名称。换句话说,如上所述,向Linkerd询问“web”服务将导致它连接到disco/web
文件中的一个端点。
此路由配置适用于演示基本功能,但Linkerd具有更多功能,包括多个服务发现端点,每请求路由规则,调试代理注入,服务故障转移等。
---官方文档翻译