Rancher Chart

本Chart基于 https://github.com/rancher/server-chart 修改，不支持LetsEncrypt、cert-manager提供证书，需手动通过Secret导入证书(导入方法见脚本结尾), 默认开启审计日志功能.

一、生成自签名证书或重命名权威认证证书

• 仓库根目录有一键创建自签名证书脚本，会自动创建cacerts.pem、tls.key、tls.crt；

--ssl-domain: 生成ssl证书需要的主域名，如不指定则默认为www.rancher.local，如果是ip访问服务，则可忽略；
--ssl-trusted-ip: 一般ssl证书只信任域名的访问请求，有时候需要使用ip去访问server，那么需要给ssl证书添加扩展IP，多个IP用逗号隔开；
--ssl-trusted-domain: 如果想多个域名访问，则添加扩展域名（TRUSTED_DOMAIN）,多个TRUSTED_DOMAIN用逗号隔开；
--ssl-size: ssl加密位数，默认2048；
--ssl-date: ssl有效期，默认10年；
--ca-date: ca有效期，默认10年；
--ssl-cn: 国家代码(2个字母的代号),默认CN；
使用示例:
./create_self-signed-cert.sh --ssl-domain=www.test.com --ssl-trusted-domain=www.test2.com \
--ssl-trusted-ip=1.1.1.1,2.2.2.2,3.3.3.3 --ssl-size=2048 --ssl-date=3650

• 如果使用权威认证证书，需要重命名crt和key为tls.crt和tls.key。

二、部署架构

1、内部ingress域名访问

通过集群内安装的ingress服务，使用七层域名转发来访问rancher server，请求流量将转发到rancher server容器的80端口。

• 把服务证书和CA证书作为密文导入K8S

指定K8S配置文件路径
kubeconfig=

kubectl --kubeconfig=$kubeconfig create namespace cattle-system;
kubectl --kubeconfig=$kubeconfig -n cattle-system \
  create secret tls tls-rancher-ingress --cert=./tls.crt --key=./tls.key;
kubectl --kubeconfig=$kubeconfig -n cattle-system \
  create secret generic tls-ca --from-file=cacerts.pem;

kubectl --kubeconfig=$kubeconfig -n kube-system create serviceaccount tiller;
kubectl --kubeconfig=$kubeconfig create clusterrolebinding tiller \
  --clusterrole cluster-admin --serviceaccount=kube-system:tiller;

helm_version=`helm version |grep Client | awk -F""\" '{print $2}'`;
helm --kubeconfig=$kubeconfig init --skip-refresh --service-account tiller \
  --tiller-image registry.cn-shanghai.aliyuncs.com/rancher/tiller:$helm_version;

• 安装

git clone -b v2.2.5 https://gitee.com/rancher/server-chart.git

kubeconfig=xxx.yml
helm install --kubeconfig=$kubeconfig \
    --name rancher \
    --namespace cattle-system \
    --set rancherImage=rancher/rancher \
    --set privateRegistry=true \
    --set registryAddress=registry.cn-shanghai.aliyuncs.com \
    --set busyboxImage=rancher/busybox \
    --set hostname=<修改为自己的域名> \
    --set privateCA=true \
    server-chart/rancher

注意:

1. 通过--kubeconfig=指定kubectl配置文件;
2. 如果使用权威ssl证书，则去除--set privateCA=true;
3. 如果为离线安装，设置--set privateRegistry=true使用私有仓库，再使用--set registryAddress=指定离线私有仓库地址，注意不要添加协议头（http或者https）;
4. 如果镜像名非标准rancher镜像名，可通过--set rancherImage=指定镜像名称，不要指定镜像版本，系统会根据chart版本自动获取镜像版本;
5. 默认自动获取chart版本号作为Rancher镜像版本号，如果想指定镜像版本号，可通过配置--set rancherImageTag=v2.2.5来指定;

2、主机NodePort访问(主机IP+端口)

有的场景需要使用IP去直接访问rancher server, 因为ingress默认不支持IP访问，所以这里禁用ingress。通过NodePort把rancher server容器端口映射到宿主机的端口上，这个时候rancher server容器作为ssl终止，请求流量转发到rancher server容器的443端口。

• 把服务证书和CA证书作为密文导入K8S

指定K8S配置文件路径
kubeconfig=

kubectl --kubeconfig=$kubeconfig create namespace cattle-system;
kubectl --kubeconfig=$kubeconfig -n cattle-system \
  create secret tls tls-rancher-ingress --cert=./tls.crt --key=./tls.key;
kubectl --kubeconfig=$kubeconfig -n cattle-system \
  create secret generic tls-ca --from-file=cacerts.pem;

kubectl --kubeconfig=$kubeconfig -n kube-system create serviceaccount tiller;
kubectl --kubeconfig=$kubeconfig create clusterrolebinding tiller \
  --clusterrole cluster-admin --serviceaccount=kube-system:tiller;

helm_version=`helm version |grep Client | awk -F""\" '{print $2}'`
helm --kubeconfig=$kubeconfig init --skip-refresh --service-account tiller \
  --tiller-image registry.cn-shanghai.aliyuncs.com/rancher/tiller:$helm_version;

• 安装

git clone -b v2.2.5 https://gitee.com/rancher/server-chart.git

kubeconfig=xxx.yml
helm install --kubeconfig=$kubeconfig \
  --name rancher \
  --namespace cattle-system \
  --set rancherImage=rancher/rancher \
  --set privateRegistry=true \
  --set registryAddress=registry.cn-shanghai.aliyuncs.com \
  --set busyboxImage=rancher/busybox \
  --set service.type=NodePort \
  --set service.ports.nodePort=30303  \
  --set privateCA=true \
  server-chart/rancher

注意:

1. 通过--kubeconfig=指定kubectl配置文件;
2. 如果使用权威ssl证书，则去除--set privateCA=true;
3. 如果为离线安装，设置--set privateRegistry=true使用私有仓库，再使用--set registryAddress=指定离线私有仓库地址，注意不要添加协议头（http或者https）;
4. 如果镜像名非标准rancher镜像名，可通过--set rancherImage=指定镜像名称，不要指定镜像版本，系统会根据chart版本自动获取镜像版本;
5. 默认自动获取chart版本号作为Rancher镜像版本号，如果想指定镜像版本号，可通过配置--set rancherImageTag=v2.2.5来指定;

3、外部七层负载均衡器+主机NodePort方式运行(禁用内部ingress转发)

有的场景，外部有七层负载均衡器作为ssl终止，一般使用是把负载均衡器的443端口代理到内部服务的80端口上。为了保证网络转发性能，这里禁用了内置的ingress服务，以NodePort方式把rancher server容器80端口映射到宿主机端口上。外部七层负载均衡器443端口直接代理到Rancher的NodePort端口,请求流量转发到rancher server容器的80端口。

• 把服务证书放在外部负载均衡器上，比如nginx；

• 把CA证书作为密文导入K8S

指定K8S配置文件路径
kubeconfig=

kubectl --kubeconfig=$kubeconfig create namespace cattle-system;
kubectl --kubeconfig=$kubeconfig -n cattle-system \
  create secret generic tls-ca --from-file=cacerts.pem;

kubectl --kubeconfig=$kubeconfig -n kube-system create serviceaccount tiller;
kubectl --kubeconfig=$kubeconfig create clusterrolebinding tiller \
  --clusterrole cluster-admin --serviceaccount=kube-system:tiller;

helm_version=`helm version |grep Client | awk -F""\" '{print $2}'`;
helm --kubeconfig=$kubeconfig init --skip-refresh --service-account tiller \
  --tiller-image registry.cn-shanghai.aliyuncs.com/rancher/tiller:$helm_version;

• 安装

git clone -b v2.2.5 https://gitee.com/rancher/server-chart.git

kubeconfig=xxx.yml
helm install --kubeconfig=$kubeconfig \
    --name rancher \
    --namespace cattle-system \
    --set rancherImage=rancher/rancher \
    --set privateRegistry=true \
    --set registryAddress=registry.cn-shanghai.aliyuncs.com \
    --set busyboxImage=rancher/busybox \
    --set service.type=NodePort \
    --set service.ports.nodePort=30303 \
    --set tls=external \
    --set privateCA=true \
    server-chart/rancher

注意:

1. 通过--kubeconfig=指定kubectl配置文件;
2. 如果使用权威ssl证书，则去除--set privateCA=true;
3. 如果为离线安装，设置--set privateRegistry=true使用私有仓库，再使用--set registryAddress=指定离线私有仓库地址，注意不要添加协议头（http或者https）;
4. 如果镜像名非标准rancher镜像名，可通过--set rancherImage=指定镜像名称，不要指定镜像版本，系统会根据chart版本自动获取镜像版本;
5. 默认自动获取chart版本号作为Rancher镜像版本号，如果想指定镜像版本号，可通过配置--set rancherImageTag=v2.2.5来指定;