v2.1

v2.1
v2.0
v1.0
Express
  1. Release Notes
  1. 产品介绍
  1. 安装指南
    1. 安装说明
    1. 在 Linux 快速安装 KubeSphere
    1. 安装可插拔的功能组件
    1. 集群高可用配置安装
    1. 在 Kubernetes 安装 KubeSphere
    1. 相关工具与插件
    1. 认证与安全
    1. 运维指南
  1. 快速入门
  1. 管理员指南
    1. 多租户管理
    1. 平台管理
    1. 基础设施
    1. 监控中心
    1. 平台设置
    1. 工具箱
    1. 通用配置
    1. FAQ
  1. 用户指南
    1. 应用
    1. 工作负载
    1. 存储
    1. 网络与服务
    1. 监控告警
    1. 配置中心
    1. 项目设置
    1. DevOps 工程
  1. 开发者指南
    1. Helm 应用开发
  1. API 文档
  1. 常见问题
  1. 附录
KubeSphere®️ 2019 All Rights Reserved.

集群参数配置编辑此页面

用户在获取 Installer 并解压至目标安装机器后,如果需要修改网络、组件版本等集群配置相关参数,可参考以下说明进行修改,本文档对 Installer 中的安装配置文件 conf/common.yaml 进行说明,简单介绍每一个字段的意义。

参数说明:

common.yaml 配置文件参数释义(点击展开)
######################### Kubernetes #########################
kube_version: v1.15.5 # Kubernetes 版本号
etcd_version: v3.2.18  # etcd 版本号

#Etcd periodic backup time (Specify a period in minutes)
etcd_backup_period: 30 # etcd 备份的周期,默认为 30 分钟
keep_backup_number: 5  # 默认保留最近 5 次备份的数据
etcd_backup_dir: "/var/backups/kube_etcd" # 默认备份的目录为 "/var/backups/kube_etcd"

# 镜像仓库的 mirror 仓库,可以加快镜像下载 (国外地区下载可将此参数注释)
docker_registry_mirrors:
  - https://docker.mirrors.ustc.edu.cn
  - https://registry.docker-cn.com
  - https://mirror.aliyuncs.com

ks_image_pull_policy: IfNotPresent # 平台的镜像拉取策略,默认 IfNotPresent,表示优先使用本地镜像,还支持 Always (尝试重新下载镜像) 和 Never (仅使用本地镜像)
kube_network_plugin: calico # 默认的网络插件(支持 Calico、Flannel)

# Kubernetes internal network for services, unused block of space.
kube_service_addresses: 10.233.0.0/18 # Service 网络 IP 地址段(需要是未被使用的地址段)

# internal network. When used, it will assign IP
# addresses from this range to individual pods.
# This network must be unused in your network infrastructure!
kube_pods_subnet: 10.233.64.0/18 # Pod 网络 IP 地址段(需要是未被使用的地址段)

# Kube-proxy proxyMode configuration.
# Can be ipvs, iptables
kube_proxy_mode: ipvs # kube-proxy 模式默认 ipvs (支持 ipvs, iptables)

# Configure the amount of pods able to run on single node
# default is equal to application default
kubelet_max_pods: 110 # 单个节点默认的 Pod 数量上限

# Enable nodelocal dns cache
enable_nodelocaldns: true # 见下方表格


## HA(Highly Available) loadbalancer example config
## apiserver_loadbalancer_domain_name: "lb.kubesphere.local"
#loadbalancer_apiserver: # 外部的负载均衡器配置项,用于高可用部署,当高可用部署时需取消注释
#  address: 192.168.0.10 # 外部负载均衡器地址,例如阿里云 SLB、AWS NLB、青云 QingCloud 负载均衡器
#  port: 6443 # 外部负载均衡器端口

#Docker periodic cleaning time (Can be reboot/yearly/annually/monthly/weekly/daily/hourly)
periodic_cleaning_time: weekly # Docker 自动清理镜像的周期,默认每周

######################### KubeSphere #########################

# Version of KubeSphere
ks_version: v2.1.0  

# KubeSphere console port, range 30000-32767,
# but 30180/30280/30380 are reserved for internal service
console_port: 30880 # KubeSphere 控制台默认端口

#CommonComponent
mysql_volume_size: 20Gi # MySQL 存储卷大小
minio_volume_size: 20Gi # Minio 存储卷大小
etcd_volume_size: 20Gi  # etcd 存储卷大小
openldap_volume_size: 2Gi # openldap 存储卷大小
redis_volume_size: 2Gi # MySQL 存储卷大小


# Monitoring
prometheus_replica: 2 #	Prometheus 副本数,默认 2,两个副本的 Prometheus 分别负责不同数据源的监控,同时保证高可用
prometheus_memory_request: 400Mi # Prometheus 内存请求大小
prometheus_volume_size: 20Gi # 	Prometheus 存储卷大小
grafana_enabled: true # 是否额外安装 grafana,若需要自定义监控则开启


## Container Engine Acceleration
## Use nvidia gpu acceleration in containers
# nvidia_accelerator_enabled: true # 安装是否开启 Nvidia GPU 加速,安装支持 GPU 节点,也支持 CPU 与 GPU 的混合部署
# nvidia_gpu_nodes: # hosts.ini 中要开启 GPU 加速的节点名称,目前仅支持 Ubuntu 16.04
#   - kube-gpu-001  # 例如这里设置节点名为 kube-gpu-001 的机器为 GPU 节点,若有多个 GPU 节点则在其下方继续添加


参数对照表

参数 含义
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 仓库,可以加快镜像下载 (国外地区下载可将此参数注释)
enable_nodelocaldns 通过在集群节点上以 Deamonset 的方式运行 DNS 缓存代理来提高集群的 DNS 性能,参考 Nodelocal DNS cache
etcd_backup_period 默认备份的周期为 30 分钟
keep_backup_number 默认保留最近 5 次备份的数据
etcd_backup_dir 默认备份的目录为 "/var/backups/kube_etcd"
nvidia_accelerator_enabled 是否开启 Nvidia GPU 加速
nvidia_gpu_nodes hosts.ini 中要开启 GPU 加速的节点名称(列表),参考以下配置示例

GPU 节点配置示例

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

 nvidia_accelerator_enabled: true
 nvidia_gpu_nodes:
   - node2