用户在获取 installer 并解压至目标安装机器后,如果需要查看或修改存储、网络、组件版本、可选安装项 (如 GitLab、Harbor)、外部负载均衡器、Jenkins、邮件服务器等配置参数时,可参考以下说明进行修改,本文档对 installer 中的安装配置文件 conf/vars.yml 进行说明,简单介绍每一个字段的意义。

负载均衡器插件与 QingCloud CSI 配置

配置文件 conf/vars.yml 中的前 9 项 qingcloud 开头的配置项是与 QingCloud 云平台负载均衡器插件和 QingCloud CSI 块存储插件相关的公共配置参数,第 10、11 项是启用安装 QingCloud 负载均衡器插件和私有网络配置,释义分别在 安装负载均衡器插件存储配置说明 - QingCloud 云平台块存储

存储相关配置

Installer 默认使用 local 类型的存储方便 all-in-one 模式进行安装,若使用 Multi-node 进行安装,则需要配置持久化存储作为存储服务端再执行安装,在 conf/vars.yml 支持配置 QingCloud CSI、Ceph RBD、NFS Client、NeonSAN CSI、GlusterFS 等,存储配置相关参数释义请参考 存储配置说明

集群组件相关配置

参数说明:

参数 含义
ks_version KubeSphere 版本号
kube_version Kubernetes 版本号
etcd_version etcd 版本号
openpitrix_version OpenPitrix 版本号
ks_image_pull_policy 默认 IfNotPresent,表示优先使用本地镜像,还支持 Always (尝试重新下载镜像) 和 Never (仅使用本地镜像)
kube_network_plugin 默认的网络插件(支持 Calico、Flannel)
kube_service_addresses Service 网络 IP 地址段(未被使用的地址段)
kube_pods_subnet Pod 网络 IP 地址段(未被使用的地址段)
kube_proxy_mode kube-proxy 模式默认 ipvs (支持 ipvs, iptables)
kubelet_max_pods 单台机器默认 Pod 数量
dns_mode DNS 模式,建议 coredns
console_port KubeSphere 控制台访问端口(默认 30880)
disableMultiLogin 禁止同一用户多点登录,默认 true 即禁用
loadbalancer_apiserver.address 外部负载均衡器地址
loadbalancer_apiserver.port 外部负载均衡器端口
apiserver_loadbalancer_domain_name 负载均衡器域名,默认 lb.kubesphere.local
periodic_cleaning_time weekly,Docker 自动清理镜像的周期
docker_registry_mirrors 默认 Docker 镜像仓库的 mirror 仓库,可以加快镜像下载 (国外地区下载可将此参数注释)
etcd_backup_period 默认备份的周期为 30 分钟
keep_backup_number 默认保留最近 5 次备份的数据
etcd_backup_dir 默认备份的目录为 “/var/backups/kube_etcd”
prometheus_memory_size Prometheus 内存请求大小
prometheus_volume_size Prometheus 存储空间大小
keep_log_days 集群内置的 Elasticsearch 中日志保留时间,默认是 7 天
kibana_enable 是否部署 Kibana (默认 false)
elasticsearch_volume_size Elasticsearch 存储空间
EMAIL_SMTP_HOST SMTP 邮件服务器地址
EMAIL_SMTP_PORT SMTP 邮件服务器端口
EMAIL_FROM_ADDR 发件人邮箱地址
EMAIL_FROM_NAME 通知邮件名称
EMAIL_FROM_PASS 密码
EMAIL_USE_SSL 是否开启 SSL 配置
jenkins_memory_lim Jenkins 内存限制
jenkins_memory_req Jenkins 内存请求
Java_Opts jvm 启动参数
JenkinsLocationUrl jenkins 域名
harbor_enable 是否安装 Harbor
harbor_domain Harbor 域名
gitlab_enable 是否部署 GitLab
gitlab_hosts_domain GitLab 域名
sonarqube_enable 是否集成并开启 SonarQube,默认安装内置的 SonarQube
sonar_server_url 对接已有的外部 SonarQube 地址(如需集成安装则取消注释)
sonar_server_token 对接已有 SonarQube token(如需集成安装则取消注释)
nvidia_accelerator_enabled 是否开启 Nvidia GPU 加速
nvidia_gpu_nodes hosts.ini 中要开启 GPU 加速的节点名称(列表),参考以下配置示例

GPU 节点配置示例

注意,在安装前可对 GPU 节点在 vars.yml 文件中进行设置,例如在 hosts.ini 文件配置的两台工作节点 node1 是 CPU 节点, node2 是 GPU 节点,那么在 vars.yml 仅需要在该处填写 node2,注意 “-“ 前面需缩进两格。

  1. nvidia_accelerator_enabled: true
  2. nvidia_gpu_nodes:
  3. - node2