跳到主要内容
版本:v2.7

Docker 安装高级选项

自定义 CA 证书

如需 Rancher 在验证服务时使用 CA 根证书,请在启动 Rancher 容器时共享包含 CA 根证书的目录。

使用命令示例来启动挂载了私有 CA 证书的 Rancher 容器。

  • 卷标志 (-v) 应指定包含 CA 根证书的主机目录。
  • 环境变量标志 (-e) 与 SSL_CERT_DIR 和目录共同声明一个环境变量,该变量指定容器内挂载了 CA 根证书的目录位置。
  • 你可使用 -e KEY=VALUE--env KEY=VALUE将环境变量传给 Rancher 容器。
  • 你可使用 -v host-source-directory:container-destination-directory--volume host-source-directory:container-destination-directory在容器内挂载主机目录。

在以下示例将位于 /host/certs 主机目录中的 CA 证书,挂载到 Rancher 容器内的 /container/certs 上。

特权访问是必须的。

docker run -d --restart=unless-stopped \
-p 80:80 -p 443:443 \
-v /host/certs:/container/certs \
-e SSL_CERT_DIR="/container/certs" \
--privileged \
rancher/rancher:latest

API 审计日志

API 审计日志记录了通过 Rancher Server 进行的所有用户和系统事务。

默认情况下,API 审计日志会写入到 Rancher 容器内的 /var/log/auditlog。你可将此目录共享为卷,并设置 AUDIT_LEVEL 以启用日志。

有关更多信息和选项,请参见 API 审计日志

特权访问是必须的。

docker run -d --restart=unless-stopped \
-p 80:80 -p 443:443 \
-v /var/log/rancher/auditlog:/var/log/auditlog \
-e AUDIT_LEVEL=1 \
--privileged \
rancher/rancher:latest

TLS 设置

如需使用不同的 TLS 配置,你可使用 CATTLE_TLS_MIN_VERSIONCATTLE_TLS_CIPHERS 环境变量。例如,将 TLS 1.0 设为可接受的最低 TLS 版本,如下:

docker run -d --restart=unless-stopped \
-p 80:80 -p 443:443 \
-e CATTLE_TLS_MIN_VERSION="1.0" \
--privileged \
rancher/rancher:latest

特权访问是必须的。

参见 TLS 设置了解更多信息和选项。

离线环境

如果要访问此页面以完成离线安装,在运行安装命令时,你必须把私有镜像仓库的 URL 添加到 Server 标志前面。例如,将带有私有镜像仓库 URL 的 <REGISTRY.DOMAIN.COM:PORT> 添加到 rancher/rancher:latest 前面。

示例

 <REGISTRY.DOMAIN.COM:PORT>/rancher/rancher:latest

持久化数据

Rancher 使用 etcd 作为数据存储。如果 Rancher 是使用 Docker 安装的,Rancher 会使用嵌入式 etcd。持久化数据位于容器的 /var/lib/rancher 路径中。

你可以将主机卷挂载到该位置,来将数据保留在运行它的主机上:

docker run -d --restart=unless-stopped \
-p 80:80 -p 443:443 \
-v /opt/rancher:/var/lib/rancher \
--privileged \
rancher/rancher:latest

特权访问是必须的。

在同一个节点中运行 rancher/rancherrancher/rancher-agent

如需使用单个节点运行 Rancher 并将同一个节点添加到集群,你必须调整映射给 rancher/rancher 容器的主机端口。

如果将节点添加到集群中,节点将部署使用端口 80 和 443 的 NGINX Ingress Controller。而这将与我们建议用于暴露 rancher/rancher 容器的默认端口冲突。

请知悉我们不建议将此设置用于生产环境,这种方式仅用来方便进行开发/演示。

如需更改主机端口映射,将 -p 80:80 -p 443:443 替换为 -p 8080:80 -p 8443:443

docker run -d --restart=unless-stopped \
-p 8080:80 -p 8443:443 \
--privileged \
rancher/rancher:latest

特权访问是必须的。