Zadig v1.18.0 文档
  • 快速入门

    • 什么是 Zadig
    • 核心概念
    • 快速安装
    • 第一个项目
    • 接入准备
  • 安装与配置

    • 安装简介
    • All in One 模式
    • 使用 Sealos 一键安装
    • 基于 Helm 命令安装
    • 基于现有 Kubernetes 安装
    • 本地安装
    • 兼容性列表
  • 最佳实践
  • 项目

    • 项目

      • 项目介绍
      • K8s YAML 项目
      • K8s Helm Chart 项目
      • K8s 托管项目
      • 主机项目
      • 权限管理
    • 工作流

      • 简介
      • 产品工作流
      • 自定义工作流
      • 工作流任务
      • 工作流审批
      • 工作流通知
      • 工作流触发器
    • 环境

      • K8s YAML 环境
      • K8s Helm Chart 环境
      • K8s 托管环境
      • 主机环境
      • 服务详情
    • 服务

      • 简介
      • K8s YAML 测试服务
      • K8s Helm Chart 服务
      • K8s 托管服务
      • 服务组件
      • 服务变量
      • 主机服务
    • 构建
    • 测试
    • 代码扫描
  • 模板库

    • K8s YAML 模板
    • Helm Chart 模板
    • Dockerfile 模板
    • 构建模板
  • 工作流

    • 工作流的触发
    • 工作流的构建缓存
    • 工作流任务的并发运行
    • 工作流的镜像版本回退
    • 工作流的变量传递
  • 环境

    • 环境的负载均衡
    • 配置多套环境
    • 自测联调环境
  • 测试中心

    • 测试中心
    • 测试工具实践
    • Apipost 测试平台接入
    • Apifox 测试平台接入
  • 交付中心

    • 交付物追踪
  • 数据视图

    • 数据概览
    • 效能洞察
  • 仪表盘

    • 仪表盘
  • 集成管理

    • 账号系统

      • LDAP
      • OAuth 2.0
      • GitHub
    • 项目管理
    • 代码源

      • 简介
      • GitLab 集成
      • GitHub 集成
      • Gerrit 集成
      • Gitee 公有云集成
      • 其他代码源集成
    • CI/CD 工具
    • 代码扫描
    • 镜像仓库
    • 对象存储
    • Helm 仓库
    • Kubernetes 集群
    • 主机管理
    • 其他系统
    • 软件包管理
    • 自定义镜像管理
  • 系统设置

    • 系统配置
    • 用户管理
    • 公告管理
    • 操作日志
    • 通知设置
  • 账号设置

    • 偏好设置
  • 开发者中心

    • OpenAPI 开发文档

      • API 调用方式
      • 交付中心
      • 工作流
      • 效能洞察
    • 外部系统接入开发文档

      • 自定义账号系统
      • 自定义工作流任务
    • VS Code Toolkit 插件

      • 使用指南
  • 常见问题

    • 产品使用 FAQ
    • 部署运维 FAQ
    • 集群故障 FAQ
    • 认证鉴权 FAQ
    • 诊断手册
  • 版本发布历史

    • Zadig Roadmap
    • v1.18.0 Release Notes
    • v1.17.0 Release Notes
    • v1.16.0 Release Notes
    • v1.15.0 Release Notes
    • v1.14.0 Release Notes
    • v1.13.0 Release Notes
    • v1.12.0 Release Notes
    • v1.11.0 Release Notes
    • v1.10.0 Release Notes
    • v1.9.0 Release Notes
    • v1.8.0 Release Notes
    • v1.7.1 Release Notes
    • v1.7.0 Release Notes
    • v1.6.0 Release Notes
    • v1.5.0 Release Notes
    • v1.4.0 Release Notes
    • v1.3.1 Release Notes
    • v1.3.0 Release Notes
    • v1.2.0 Release Notes
    • v1.1.0 Release Notes
    • v1.0.0 Release Notes
    • v1.0.0-rc.1 Release Notes
  • 术语表

    • 术语表

本文主要介绍 K8s Helm Chart 项目中的测试环境相关操作。

查看环境

环境创建完成后,点击不同的 Tab 即可切换到该环境的详情页面。

环境详情

环境的基本信息包括 K8s 集群,K8s 命名空间,更新时间,环境状态,镜像仓库,服务列表及 Chart 视图。

  • Chart 视图的介绍可参考文档:Chart 视图
  • 其他介绍可参考 K8s YAML 测试环境中的描述:查看环境

新建环境

提示

服务数量以及启动服务所需的资源会影响环境的创建时间,请耐心等待。

在项目中,点击新建环境按钮,选择测试环境后进入创建环境页面。

新建 Helm Chart 环境新建 Helm Chart 环境

基本信息

  • 环境名称:要创建的环境的名称,根据实际语义配置即可,比如:dev、pre-release。
  • 创建方式:支持新建和复制两种方式,复制环境可参考:复制环境。
  • 资源选择:
    • K8s 集群:选择创建环境时所使用的集群资源,其中本地集群指 Zadig 系统所在的集群。关于集群的集成可参考集群管理。
    • K8s 命名空间:不同的环境会使用独立的 Kubernetes 命名空间实现隔离。Zadig 系统创建命名空间的默认规则为 项目名-env-环境名,用户也可以自定义或者选择已有命名空间。
    • 镜像仓库:指定环境创建后所使用的镜像仓库,使用工作流构建部署服务,以及修改服务镜像,均会使用此处指定的镜像仓库。关于镜像仓库的集成可参考镜像仓库管理。
  • 服务选择:选择创建环境所包含的服务,默认为当前项目下的所有服务。

环境配置

在创建环境时为环境创建配置,说明如下:

  • 可创建多个 Ingress、ConfigMap、Secret、PVC 类型的配置
  • 支持直接粘贴或从代码库导入配置,支持的代码源请参考文档:代码源信息
  • 环境创建成功后,此处新建的配置即会在环境/集群中生效,也可以在环境创建完成后再管理环境配置,参考环境配置管理

新建 Helm Chart 环境配置

全局服务变量

点击展开全局服务变量,可修改 values 文件内容设置环境级别的变量值,支持 2 种方式:

  • 手动输入 YAML 文件的内容,内容详情即为要设置的变量信息。
  • 从指定代码库导入 values,支持的代码源请参考文档:代码源信息。

从代码库导入时如果打开自动同步开关,Zadig 会定时从代码库获取最新的 values 文件并将其自动更新到环境中。

从代码库导入 values

服务变量

可修改指定服务的 values 文件内容,配置服务级别的变量值,支持 3 种方式:

  • 手动输入 values 文件内容。
  • 从指定 GitHub/GitLab 代码库同步 values 文件。如果打开自动同步开关,Zadig 会定时从指定的代码库获取最新的 values 文件并将其自动更新到环境中。
  • 手动输入键值对,覆盖服务配置中的 values 文件内容。

从代码库导入 values

扩展知识

  1. 服务变量的设置只对单一服务生效。
  2. 全局服务变量的设置对当前环境的所有服务都生效。
  3. 如果既设置了全局服务变量,又设置了服务变量时,服务变量的优先级高于全局服务变量。

复制环境

参考 K8s YAML 环境中的描述:复制环境。

更新全局变量

点击基本操作中的更新全局变量,可修改全局服务变量,修改后对当前环境下的所有服务都生效,支持以下几种方式:

  • 手动输入 values 内容
  • 从代码库导入 values 文件,支持的代码库请参考:代码源信息

更新 Helm Chart 环境变量

管理服务

点击基本操作中的管理服务,可以对环境中的服务进行添加、更新、删除操作。

添加服务

点击 管理服务 -> 添加服务 选择要添加的服务,可按需修改其 values 内容。

添加 Helm Chart 服务添加 Helm Chart 服务

更新服务

点击管理服务 -> 更新服务 -> 选择要更新的服务,可按需修改其 values 内容 -> 点击确定即可对环境中的服务进行更新。如果不修改其 values 内容,则会使用服务配置中的 values 来修改该服务。

提示

如果服务加入环境后,镜像有做过更新(比如:使用工作流部署过服务镜像,或者在环境中手动切换过服务镜像),则服务镜像并不会基于 values 中的镜像信息更新。

更新 Helm Chart 服务

删除服务

点击管理服务 -> 删除服务 -> 选择要删除的服务 -> 点击确定即可将该服务从当前环境中删除。

删除 Helm Chart 服务

环境配置

为环境配置 Ingress、ConfigMap、Secret、PVC 资源,细节描述请阅读环境配置管理。

自测模式

参考文档:自测模式。

变更记录

点击右上角的图标可查看该环境的操作日志。

变更记录

Chart 视图

在服务列表左侧的 Chart 视图中可查看服务实例的 values 文件内容,点击左侧的更新按钮可对环境中的服务进行更新。

chart release 视图

若更新失败,服务会变为红色,可查看具体的失败原因。

chart release 视图

删除环境

点击基本操作 -> 更多 -> 删除环境按钮并输入环境名即可删除环境。当勾选同时删除环境对应的 K8s 命名空间和服务后:

  • 如果环境是基于新的 Namespace 创建的,则删除环境操作会删除环境对应的 Namespace 及其中由 Zadig 系统创建的资源。
  • 如果环境是基于已有 Namespace 创建的,则删除环境操作会删除 Namespace 中由 Zadig 系统创建的资源,但不会删除 Namespace。

删除 Helm Chart 环境

Prev
K8s YAML 环境
Next
K8s 托管环境