需求
任何支持 Docker 1.10.3 的 Linux 发行版。其中 RancherOS,Ubuntu,RHEL/CentOS 7 经过了更多的测试
1GB 内存
MySQL 服务,并且设置 max_connections > 150
启动 Rancher 服务器
在安装了 Docker 的服务器上可以很简单的使用命令启动 Rancher 服务器。
$ sudo docker run -d --restart=always -p 8080:8080 rancher/server
Rancher UI
Rancher 的 UI 和 API 默认工作在 8080 端口。Docker 镜像下载后,还需要 1-2 分钟才可以成功启动并显示页面。
访问以下地址:http://:8080,这里是指运行 Rancher 服务器的主机用于网络访问的IP地址。
一旦 UI 处于启动和运行状态,就可以开始 添加主机 。主机添加到 Rancher 服务器中后,您可以开始添加服务 或 使用 Rancher catalog 启动模板。
开启活动目录或 OpenLDAP 支持(TLS)
为了开启 Rancher 活动目录或 OpenLDAP 支持(TLS),Rancher Server 容器在启动时需要加载证书。您需要在运行 Rancher Server 的 Linux 主机上保存证书。
启动 Rancher 服务器并使用绑定挂载卷的方式加载证书,证书在容器中 必须 使用ca.crt命名。
$ sudo docker run -d --restart=always -p 8080:8080 \
-v /dir_that_contains_the_cert/cert.crt:/ca.crt rancher/server
您可以通过检查 Rancher 服务器容器日志确认 ca.crt 是否已经成功的传递给了 Rancher 服务器。
$ docker logs
在日志的开始,会提示证书 ca.crt 已经添加。
DEFAULT_CATTLE_RANCHER_COMPOSE_WINDOWS_URL=https://releases.rancher.com/compose/beta/latest/rancher-compose-windows-386.zip
Adding ca.crt to Certs.
Updating certificates in /etc/ssl/certs... 1 added, 0 removed; done.
Running hooks in /etc/ca-certificates/update.d....
done.
done.[BOOTSTRAP] Starting Cattle
绑定挂载 MYSQL 卷
如果你想将容器内数据库持久化在主机上,可以在启动 Rancher 服务容器时,绑定并挂载 MySQL 数据卷。
$ sudo docker run -d -v :/var/lib/mysql --restart=always -p 8080:8080 rancher/server
使用这个命令,数据库将持久化保存在主机上。如果您已有一个 Rancher 服务器容器,请参照我们的 升级文档 。
使用外部数据库
如果您更希望使用外部的数据库运行 Rancher 服务器,请参照如下操作连接 Rancher 到数据库。您需要一个已经创建好的数据库,但是不需要创建任何数据库对象,Rancher 将会自动创建所有相关的数据库对象。
Rancher 服务器需要使用以下环境变量,并通过 docker run 命令启动 Rancher 服务器来连接外部数据库。
CATTLE_DB_CATTLE_MYSQL_HOST: 数据库实例的主机名或IP地址
CATTLE_DB_CATTLE_MYSQL_PORT: 3306
CATTLE_DB_CATTLE_MYSQL_NAME: 数据库名
CATTLE_DB_CATTLE_USERNAME: 用户名
CATTLE_DB_CATTLE_PASSWORD: 密码
注意:
数据库名和用户名必须已经存在,Rancher 不会去创建数据库。
这是一个用于创建数据库和用户的 SQL 命令。
sql CREATE DATABASE IF NOT EXISTS cattle COLLATE = ‘utf8_general_ci’ CHARACTER SET = ‘utf8’; GRANT ALL ON cattle.* TO ‘cattle’@’%’ IDENTIFIED BY ‘cattle’; GRANT ALL ON cattle.* TO ‘cattle’@’localhost’ IDENTIFIED BY ‘cattle’;
以上命令创建了名为 ‘cattle’ 的数据库,创建了用户名为 ‘cattle’ 的用户。
创建了数据库和用户后,使用环境变量参数,并启动 Rancher 服务器。
$ sudo docker run -d --restart=always -p 8080:8080 \
-e CATTLE_DB_CATTLE_MYSQL_HOST= \
-e CATTLE_DB_CATTLE_MYSQL_PORT= \
-e CATTLE_DB_CATTLE_MYSQL_NAME= \
-e CATTLE_DB_CATTLE_USERNAME= \
-e CATTLE_DB_CATTLE_PASSWORD= \
rancher/server
使用 HTTP 代理环境变量
为了使用 HTTP 代理,需要修改 Docker 服务支持代理。在 Rancher 服务器启动前,编辑/etc/defalut/docker文件指定您的代理并重新启动 Docker 服务。
$ sudo vi /etc/default/docker
在这个文件中编辑 #export http_proxy="http://127.0.0.1:3128/" 指向您的代理。保存修改并重新启动Docker 服务,每个操作系统重启 Docker 服务的方式是不同的。
注意:
如果您使用 systemd 运行 Docker ,请参照 Docker 文档 配置 HTTP 代理。
为了加载 Rancher catalog ,需要在启动 Rancher 服务器时加载 HTTP 代理的环境变量信息。
$ sudo docker run -d \
-e http_proxy= \
-e https_proxy= \
-e no_proxy="localhost,127.0.0.1" \
--restart=always -p 8080:8080 rancher/server
如果不使用 Rancher catalog ,则使用正常方式运行启动 Rancher Server 命令。