提示

离线安装版本针对有 Kubernetes 集群但无外网访问权限的使用场景。
该版本不建议用于生产环境,离线安装包大小约为 1 GB ,下载过程需保证网络的连通性。
Kubernetes 集群建议资源配置要求:8 Cores 16 GB,K8s 集群版本参照兼容性列表

准备工作

  • 有该集群的 admin 操作权限(注意 ~/.kube 目录下有正确的集群 config 文件)
  • 如果集群有多个节点,需保证每个节点的 ssh 登录用户名 (USERNAME) 一致
  • 确保集群的 CRI 离线安装 - 图1 (opens new window)(容器运行时接口)是 Docker(目前暂不支持 Containerd)。
  • 确保集群有默认的 Storage Class (如果没有需要手动创建两个至少 20Gi 的 PV)

安装流程

  1. 在有外网联通的机器上,下载离线安装包。目前仅支持v1.3.0 版本。
  1. curl -O https://resources.koderover.com/dist/zadig-airgapped-v1.3.0.tar.gz
  2. tar xvf zadig-airgapped.tar.gz && cd zadig-airgapped
  1. 根据参数列表,设置安装所需要的参数。 其中 USERNAMENODES 参数是必填项。
  1. export USERNAME=<Kubernetes 工作节点统一用户名>
  2. export NODES=<Kubernetes 工作节点 IP,用空格隔开>
  1. 执行以下安装命令。注意:命令会多次执行 ssh/scp 命令,所以需相关人员输入密码
  1. bash air-gapped-install.sh
  1. 根据提示访问 Zadig 系统验证安装结果

参数列表

参数名默认值必填说明
USERNAMEtrueKubernetes 工作节点统一用户名
NODEStrueKubernetes 工作节点 IP,用空格隔开
NAMESPACEzadigfalseKubernetes 命名空间
IP和 DOMAIN 二选一Kubernetes 集群任一节点的外网 IP 地址,用于访问 Zadig 系统
PORT使用 IP 访问必填30000 - 32767 任一端口
DOMAIN和 IP 二选一访问 Zadig 系统域名
NGINX_INGRESS_SERVICE_TYPENodePortfalse安装脚本自动安装的 Ingress Controller Service 类型为 NodePort, 可配置为: LoadBalancer
INGRESS_CLASSfalse若集群内已经配置了 Nginx Ingress 控制器,则设置这个变量为该控制器的名称
STORAGE_SIZE20Gifalse内置数据库和对象存储各自的数据存储大小
INSECURE_REGISTRYfalse若需要使用一个 HTTP 协议的 Registry,则设置该变量为 Registry 的地址 ,如 10.0.0.1:5000
STORAGE_CLASSfalse若集群内支持持久存储卷,可以设置该变量,避免 Zadig 的数据库服务重启后数据丢失
MONGO_URIfalseZadig 业务数据存储,若不配置,使用安装脚本中内置的单节点 MongoDB
MONGO_DBfalse数据库名称
ENCRYPTION_KEYfalse用于数据加密解密,由安装过程生成 ENCRYPTION_KEY,第一次安装后请保存 ENCRYPTION_KEY,重装系统时需设置 ENCRYPTION_KEY,才能保证之前的数据可以被正确解密