Rancher元数据服务

使用 Rancher 的元数据服务，你能在任意 Rancher 所管理的何容器内部来查询到关于容器所管理的网络和的相关信息。 元数据可以涉及到容器自身、所在服务或者堆栈，以及容器所允许的主机，等等。元数据默认格式是 JSON 。

容器可以通过以下几种方式在 Rancher 管理的网络上启动。

• 通过图形界面 UI, 一个服务/容器 被启动时使用了 Managed 网络参数。默认情况下，服务网络已经被设置为 Managed 。
• 通过 Rancher-Compose 命令行，一个服务/容器，当没有被设置为网络模式 (net)，在Rancher 管理的网络上被启动。
• 当用 docker 原生命令 启动容器, 如果你在 docker run 命令中加入标签io.rancher.container.network=true ，这样容器就加入了 Rancher 的管理网络。

注意: 元数据服务对于Rancher 的系统容器是不可用的，如：Network Agent 和 LB Agent 容器。

如何获取到元数据

在 Rancher 的图形界面上，您能从容器的下拉菜单 Execute Shell 上进入到容器的命令行。下拉菜单在鼠标滑过容器的时候可以出现。

你可以使用 curl 命令来过去元数据。

# 如果 curl 没有安装，安装它
$ apt-get install curl
# curl 命令可以返回纯文本的相应结果
$ curl http://rancher-metadata/<version>/<path>

访问路径依赖于你想访问什么样元数据和想得到的相应结果的格式。

元数据的版本

在 curl 命令里，我们强烈建议使用一个的定的版本，而不总是使用 latest。

注意: 我们对 latest 版本会持续更改，不同版本返回的数据可能不同，因此可能会影响到您的代码的兼容性。

元数据服务的版本是基于日期的。

版本的差异

V1 vs. V2

当使用路径 /services/<service-name>/containers 或 </stacks/<stack-name>/services/<service-name>/containers 查看容器元数据信息时，V1 返回容器的名称，而 V2 返回所有容器对象。元数据服务的 V2 版本可以提供更多信息。

实例

在 Rancher 中，有一个堆栈名为 foostack ，它包含一个由三个容器组成的名为 barservice 的服务。

# 使用 V1 返回的只是服务的容器名称
$ curl --header 'Accept: application/json' 'http://rancher-metadata/2015-07-25/services/barservice/containers'
["foostack_barservice_1", "foostack_barservice_2", "foostack_barservice_1"]

# 使用 V2 返回的是服务中所有容器对象
$ curl --header 'Accept: application/json' 'http://rancher-metadata/2015-12-19/services/barservice/containers'
[{"create_index":1, "health_state":null,"host_uuid":...
...
# 服务里所有容器的元数据清单
...
...}]

# 使用 V2, 你能详细查看某个特定容器对象
$ curl --header 'Accept: application/json' 'http://rancher-metadata/2015-12-19/services/barservice/containers/foostack_barservice_1'
[{"create_index":1, "health_state":null,"host_uuid":...
...
# 服务里所有容器的详细信息清单
...
...}]

# 使用 /stacks/<服务-名称>, 你能详细查看服务和容器

# 使用 V1 只能返回服务中容器的名称 
$ curl --header 'Accept: application/json' 'http://rancher-metadata/2015-07-25/stacks/foostack/services/barservice/containers'
["foostack_barservice_1", "foostack_barservice_2", "foostack_barservice_1"]

# 使用 V2 能返回服务中所有容器对象详情清单
$ curl --header 'Accept: application/json' 'http://rancher-metadata/2015-12-19/stacks/foostack/services/barservice/containers'
[{"create_index":1, "health_state":null,"host_uuid":...
...
# 服务里所有容器的详细信息清单
...
...}]

纯文本 vs JSON 格式

元数据信息能返回成纯文本合作和 JSON 格式。基于你怎样使用元数据的需求，你能选择任意格式。

纯文本

在执行 curl 命令时，您会从所请求的路径中获得纯文本。你可以从路径的最顶级开始查询，根据返回的可用的键值信息继续向下层访问，直到元数据服务返回了您想查询的数据。

$ curl 'http://rancher-metadata/2015-12-19/self/container'
create_index
health_state
host_uuid
hostname
ips/
labels/
name
ports/
primary_ip
service_name
stack_name
start_count
uuid
$ curl 'http://rancher-metadata/2015-12-19/self/container/name'
# 注意: Curl 不能换行，因此最后一行的返回值和命令提示符出现在同一行行。
Default_Example_1$root@<container_id>
$ curl 'http://rancher-metadata/2015-12-19/self/container/label/io.rancher.stack.name'
Default$root@<container_id>
# 数组可以通过索引号和名称来返回值
$ curl 'http://rancher-metadata/2015-12-19/services'
0=Example
# 你可以在路径中使用索引号或者名称
$ curl 'http://rancher-metadata/2015-12-19/services/0'
$ curl 'http://rancher-metadata/2015-12-19/services/Example'

JSON

把 Accept: application/json 添加在 curl 命令的请求标记中，可以返回 JSON 格式的数据。

$ curl --header 'Accept: application/json' 'http://rancher-metadata/2015-12-19/self/container' 
$ curl --header 'Accept: application/json' 'http://rancher-metadata/2015-12-19/self/stack' 
# 返回某个堆栈总其它服务的元数据
$ curl --header 'Accept: application/json' 'http://rancher-metadata/2015-12-19/services/<service-name>'

元数据字段

容器

服务

堆栈

主机

给服务添加用户元数据

Rancher 可以让用户给服务增加自己的元数据。目前，这个功能只能通过 rancher-compose 来实现，并且元数据需要是 rancher-compose.yml 文件的一部分。在 metadata 键里， yaml 将被解析为 JSON 格式用于元数据服务。

rancher-compose.yml 示例

service:
  # Scale of service
  scale: 3
  # User added metadata
  metadata:
    example:
      name: hello
      value: world
    example2:
      foo: bar

在这个服务启动之后，你可以通过元数据服务找到这个信息在 .../self/service/metadata 或者.../services/<service_id>/metadata 中。

JSON 查询

$ curl --header 'Accept: application/json' 'http://rancher-metadata/latest/self/service/metadata'
{"example":{"name":"hello","value":"world"},"example2":{"foo":"bar"}}

Plaintext 查询

$ curl 'http://rancher-metadata/latest/self/service/metadata'
example/
$ curl 'http://rancher-metadata/latest/self/service/metadata/example'
name
value
$ curl 'http://rancher-metadata/latest/self/service/metadata/example/name'
# Note: Curl will not provide a new line, so single values will be on same line as the command prompt
hello$root@<container_id>

Rancher中文手册目录

• Rancher概述
• Rancher快速安装指南
• Rancher安装
  • Rancher单节点服务器安装
  • Rancher安装多节点高可用(HA)
  • Rancher SSL证书基本配置
  • Rancher实现无联网访状态问
• Rancher基础服务
  • Rancher基础服务 健康检查
  • Rancher实现的内部DNS基础服务
  • Rancher使用Route53做外部DNS
  • Rancher元数据服务
• 系统配置
  • Rancher系统配置API&Keys使用
  • Rancher系统配置添加镜像仓库
• Rancher中使用Docker原生命令行
• Rancher中的标签和调度服务
• Rancher实现添加\删除公有云主机
•  Rancher目录
  • 在Rancher部署Kubernetes
  • 在Rancher使用Swarm
  • 通过创建数据容器升级Rancher
  • 通过启动时使用绑定挂载升级Rancher