Consul入门03 －注册服务

最新推荐文章于 2022-06-19 15:16:36 发布

zl1zl2zl3

最新推荐文章于 2022-06-19 15:16:36 发布

阅读量482

点赞数

分类专栏： consul hashicorp 文章标签： consul

hashicorp 同时被 2 个专栏收录

30 篇文章 2 订阅

订阅专栏

consul

26 篇文章 3 订阅

订阅专栏

在前面的步骤，我们运行了第一个代理，看到了集群的成员，并且查询了节点信息。在这篇指南里，我们将注册我们第一个服务并且查询这个服务。

定义一个服务

一个服务能够通过提供一个服务定义或者调用适当的HTTP API来注册。

服务定义是最通用的注册服务方法，那么我们将使用这种方法来注册服务。我们将建构一个代理配置，前面的步骤已经描述过。

首先，为Consul配置创建一个目录。Consul装载配置目录中所有的配置文件，通常在Unix系统中惯例是建立以名为 /etc/consul.d 的目录（ .d 后缀暗示这个目录包含了一些配置文件的集合）。

$ sudo mkdir /etc/consul.d

下一步，我们将创建一个服务定义配置文件。我们假设我们有一个名为“web"服务，它运行在80端口。另外我们为它设置一个标记，那么我们就可以通过它来查询到这个服务：

$ echo '{"service": {"name": "web", "tags": ["rails"], "port": 80}}' \
    >/etc/consul.d/web.json

现在，我们重启代理，并提供配置目录参数：

$ consul agent -dev -config-dir /etc/consul.d
==> Starting Consul agent...
...
    [INFO] agent: Synced service 'web'
...

你会注意到在输出中"synced service 'web'"。这意味着代理已经从配置文件中装载了该服务定义，并且已经成功注册该服务到服务目录中。

如果你想注册多个服务，你可以在Consul配置目录中创建多个服务定义文件。

查询服务

一旦代理启动并且服务已经同步，我们就可以使用DNS或者HTTP API来查询服务了。

DNS API

让我们首先使用DNS API查询我们的服务。对于DNS API，服务的DNS名称是 NAME.service.consul 。默认所有的DNS名称都是在 consul 名称空间下，当然这个是可配置的。service 子域名告诉Consul我们正在查询服务，并且 NAME 就是要查询的服务的名称。

对于我们注册的web服务，对应的查询设置就是 web.service.consul ：

$ dig @127.0.0.1 -p 8600 web.service.consul
...

;; QUESTION SECTION:
;web.service.consul.        IN  A

;; ANSWER SECTION:
web.service.consul. 0   IN  A   172.20.20.11

你可以看到，一个带了节点的IP地址的 A 记录被返回了，它就是可用的服务。 A 记录只能包含IP地址。

你也可以使用DNS API来获取完整的地址/端口的 SRV 记录：

$ dig @127.0.0.1 -p 8600 web.service.consul SRV
...

;; QUESTION SECTION:
;web.service.consul.        IN  SRV

;; ANSWER SECTION:
web.service.consul. 0   IN  SRV 1 1 80 Armons-MacBook-Air.node.dc1.consul.

;; ADDITIONAL SECTION:
Armons-MacBook-Air.node.dc1.consul. 0 IN A  172.20.20.11

SRV 记录显示了web服务证运行在节点 Armons-MacBook-Air.node.dc1.consul. 的80端口上。额外的部分和 A 记录返回的内容一样。

最后，我们可以使用DNS API基于标记来过滤服务，基于标记的服务查询的格式是 TAG.NAME.service.consul 。在下面的例子里，我们请求Consul查询所有含"rails"标记的web服务。我们得到了我们注册的带有该标记的服务的响应：

$ dig @127.0.0.1 -p 8600 rails.web.service.consul
...

;; QUESTION SECTION:
;rails.web.service.consul.      IN  A

;; ANSWER SECTION:
rails.web.service.consul.   0   IN  A   172.20.20.11

HTTP API

除了DNS API，HTTP API也可以用于服务查询：

$ curl http://localhost:8500/v1/catalog/service/web
[{"Node":"Armons-MacBook-Air","Address":"172.20.20.11","ServiceID":"web", \
    "ServiceName":"web","ServiceTags":["rails"],"ServicePort":80}]

该目录API返回了指定节点以及指定的服务信息。就像我们马上要看到了健康检测，通常我们的查询只是查询那些健康的实例，这些实例都是通过了健康检测的。这也是DNS在底层做的事情。下面的查询只查询健康的实例：

$ curl 'http://localhost:8500/v1/health/service/web?passing'
[{"Node":"Armons-MacBook-Air","Address":"172.20.20.11","Service":{ \
    "ID":"web", "Service":"web", "Tags":["rails"],"Port":80}, "Checks": ...}]