rancher CLI构建、升级rancher cattle应用栈

rancher官方文档参考：https://rancher.com/docs/rancher/v1.6/zh/cli/

 

前言

为什么要用到rancher CLI，比较实际的应用场景就是：jenkins持续集成时，编译代码并制作镜像，将docker镜像上传到私服后。需要命令直接触发rancher构建应用。

 

Rancher命令行界面

Rancher的命令行界面（CLI）是用来管理Rancher Server的工具。 使用此工具，你可以管理你的环境，主机，应用，服务和容器。

 

生成访问密钥（token）

添加API key，生成的access key、secret key要复制保存下来。

如下是rancher的访问地址

 

下载rancher CLI

二进制文件可以直接从UI下载。 该链接可以在UI中的页脚右侧找到。 我们有Windows，Mac和Linux的二进制文件。 你还可以查看我们CLI的发布页面 ，你可以从该页面直接下载二进制文件。

 

安装

我用的Linux主机是centos7，准备开始安装。

# 解压
$ tar -zxvf rancher-linux-amd64-v0.6.14.tar.gz

# 添加rancher命令
$  mv rancher-v0.6.14/rancher /usr/bin/rancher

# 删除
$ rm -rf rancher-v0.6.14/

 

rancher CLI：配置rancher server参数

使用rancher config，分别配置rancher_url，access key，secret key

选择默认的操作环境，就可以看到该环境下运行的应用了

 

CLI命令

查看默认环境下，应用列表

rancher ps       #查看用户应用列表

rancher ps -c    #指定-c，查看环境中的所有容器

rancher ps nginx    #用nginx过滤应用列表

查看所有环境

rancher env ls

 

不基于config的CLI操作

需要在rancher后，加4个基本参数

rancher --url http://192.168.56.102:8090 --access-key 804BCC0A55FAD042726F --secret-key 4ng66ccsCKgtJURFCWP7WFXAC4SZuLvcDmMUudim --env esign-dev ps    #等同与配置了config的rancher ps

效果如下图：

 

使用docker-compose文件，启动简单的rancher服务

要开始向Rancher添加服务时，你可以创建一个简单的docker-compose.yml文件，以及可选的rancher-compose.yml文件。 如果没有rancher-compose.yml文件，则所有服务的数量将默认为1。

docker-compose.yml示例：

version: '2'
services:
 service1:    #服务名称
  image: nginx
  ports:
   - "9999:80"

rancher-compose示例：

version: '2'
services:
 service1:
  scale: 2      #表示构建2个容器副本

构建应用

# -d 后台运行
# -s 指定应用栈名称
# --force-upgrade 应用栈不存在，构建应用栈并启动容器服务；应用栈存在，滚动升级容器服务
rancher --url http://192.168.56.102:8090 --access-key 804BCC0A55FAD042726F --secret-key 4ng66ccsCKgtJURFCWP7WFXAC4SZuLvcDmMUudim --env esign-dev up -d --force-upgrade -s myapp -f ./docker-compose.yml --rancher-file ./rancher-compose.yml

rancher构建完成

访问测试

 

升级rancher应用

 

与构建时使用同一个命令

 rancher --url http://192.168.56.102:8090 --access-key 804BCC0A55FAD042726F --secret-key 4ng66ccsCKgtJURFCWP7WFXAC4SZuLvcDmMUudim --env esign-dev up -d --force-upgrade -s myapp -f ./docker-compose.yml --rancher-file ./rancher-compose.yml

查看更新效果：不需要点击升级完成，运行的就已经是最新服务了（可自行验证）。