云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载在 TerminusOlares生态中开发上架应用时密码、API 端点、功能开关等配置项不应硬编码在 Helm 模板里而应通过OlaresManifest.yaml的envs字段做声明式定义。部署时由 app-service 负责解析取值并注入values.yaml的.Values.olaresEnv开发者只需在模板中以{{ .Values.olaresEnv.envName }}消费。读完本篇你将掌握变量来源系统变量/用户变量、valueFrom映射机制、全部声明字段的语义与校验行为以及系统/用户两级环境变量的完整可用清单并理解 app-service 在集群侧如何完成取值 → 注入 → 变更重启的闭环。声明式环境变量的整体流程envs是OlaresManifest.yaml中的一组顶层条目用于向安装/管理界面暴露应用的配置参数。其工作链路可以概括为三步声明开发者在OlaresManifest.yaml的envs列表中声明每个变量名称、默认值、类型、校验规则等解析注入应用部署时app-service 从集群中的AppEnv资源读取各变量的当前值写入 Helm values 的olaresEnv键下。对应源码见 helm_utils.go 中的 addEnvironmentVariables它从集群读取AppEnv并填充olaresEnv键该键名由常量OlaresEnvHelmValuesKey olaresEnv定义constants.go模板消费Helm 模板中通过{{ .Values.olaresEnv.envName }}引用最终值。一个典型的注入结果如下# app-service 在部署时注入 values.yaml olaresEnv: APP_CDN_ENDPOINT: https://cdn.olares.com需要注意命名规范envName必须匹配^[A-Za-z][A-Za-z0-9_]*$实现见 env_utils.go。此外自apiVersion: v3起应用本地变量名不允许使用OLARES_USER前缀——该命名空间保留给用户级变量只能通过valueFrom.envName引用。这一规则由 validateV3Envs 在清单校验阶段强制执行并有对应测试覆盖envs_test.go、v3_envs_test.go。变量来源系统变量与用户变量声明式变量的取值可以来自应用之外、由系统统一管理的外部配置分为两级系统变量System variables在 Olares 集群级别定义的环境变量系统安装时设定或由管理员集中管理对集群内所有用户共享用户变量User variables在 Olares 用户级别定义的环境变量各用户独立管理同一集群内互相隔离。应用不能直接修改这两级变量。要在应用中使用它们必须通过valueFrom字段把外部变量映射为自己的应用变量。从源码结构看系统/用户变量以SystemEnv/UserEnv资源保存在集群中app-service 的AppEnvController会 watch 这些变化并同步到每个应用的AppEnv上appenv_controller.go同步触发依赖注解appenv.bytetrade.io/sync-triggered-by见 constants.go这正是外部变量变了、应用无需重装即可感知的底层机制。通过 valueFrom 映射环境变量系统变量与用户变量使用同一套valueFrom映射机制。以下示例演示把系统变量OLARES_SYSTEM_CDN_SERVICE映射为应用变量APP_CDN_ENDPOINT第 1 步在OlaresManifest.yaml中声明应用变量并设置valueFrom.envName指向源变量。# 将系统变量 OLARES_SYSTEM_CDN_SERVICE 映射为应用变量 APP_CDN_ENDPOINT olaresManifest.version: 0.10.0 olaresManifest.type: app envs: - envName: APP_CDN_ENDPOINT required: true applyOnChange: true valueFrom: envName: OLARES_SYSTEM_CDN_SERVICE第 2 步在 Helm 模板中通过.Values.olaresEnv.envName引用该应用变量。# 在容器环境变量中使用 APP_CDN_ENDPOINT env: - name: CDN_ENDPOINT value: {{ .Values.olaresEnv.APP_CDN_ENDPOINT }}部署时app-service 解析被引用的变量并把最终值注入values.yaml# app-service 在部署时注入 values.yaml olaresEnv: APP_CDN_ENDPOINT: https://cdn.olares.com关于valueFrom的关键语义一旦设置当前变量会继承被引用变量的全部字段type、editable、regex等而当前变量上本地定义的这些字段一律被忽略default和options在valueFrom存在时不生效。这与源码中的类型定义一致——ValueFrom、EnvVarSpec、AppEnvVar均为上游 API 的别名types.go校验与解析共享同一套具体类型。仓库中的测试数据也展示了真实的valueFrom用法例如 testdata/full_manifest/OlaresManifest.yaml 中同时声明了options、remoteOptions、regex与valueFrom的完整条目。另外oac.Lint的图表扫描会对apiVersion: v3应用执行反向检查模板或values.yaml中出现OLARES_USER*字面量会直接报错提示必须声明envs[].envName并引用.Values.olaresEnv.envNamechartscan.go 中 checkV3OLARESUserInChart测试见 v3_envs_test.go。声明字段详解每个envs条目支持以下字段。envName注入values.yaml的变量名模板中以{{ .Values.olaresEnv.envName }}引用。default变量的默认值由开发者在编写清单时提供用户不可修改。仅当用户未提供值、且没有通过valueFrom取值时使用。valueFrom将该变量映射到一个系统或用户环境变量。设置后会继承被引用变量的所有字段type、editable、regex等当前变量上本地的同类字段被忽略default与options不再生效。# 将应用变量 APP_CDN_ENDPOINT 映射到系统变量 OLARES_SYSTEM_CDN_SERVICE envs: - envName: APP_CDN_ENDPOINT required: true applyOnChange: true valueFrom: envName: OLARES_SYSTEM_CDN_SERVICErequired布尔值。为true时该变量必须有值才能继续安装若未设置default用户会被要求手动填写。安装后该值不允许被置为空。editable布尔值。为true时该变量在安装后仍允许修改。applyOnChange布尔值。为true时修改该变量会自动重启所有使用它的应用或组件为false时变更只在应用升级或重装后生效手动停止/启动应用不会触发。从源码看applyOnChange对应的变更在集群侧体现为AppEnv.NeedApply标记AppEnvController在同步新值后置位随后触发一次 Helm upgrade 重新渲染工作负载应用处于 Stopped 且无workloadReplicas声明时会延迟应用待应用再次运行或升级时生效appenv_controller.go。type期望的取值类型在值被接受前用于校验。支持的类型int、bool、url、ip、domain、email、string、password。regex值必须匹配的正则表达式。校验失败时该值无法设置可能导致安装或升级失败。options将变量限制为固定的候选值列表系统会向用户展示选择界面。title是 UI 上显示的文案value是内部实际存储的值。# 下拉列表title 用于界面展示value 为内部存储值 envs: - envName: VERSION options: - title: Windows 11 Pro value: iso/Win11_24H2_English_x64.iso - title: Windows 7 Ultimate value: iso/win7_sp1_x64_1.isoremoteOptions从远程 URL 加载选项列表替代内联的options。响应体必须是与options相同格式的 JSON 编码数组。# 安装时从远程 URL 拉取选项列表 envs: - envName: VERSION remoteOptions: https://app.cdn.olares.com/appstore/windows/version_options.jsondescription变量的用途及有效取值的人类可读说明会显示在 Olares 管理界面中。可用变量参考系统环境变量以下集群级变量可通过valueFrom引用变量类型默认值可编辑必填说明OLARES_SYSTEM_REMOTE_SERVICEurlhttps://api.olares.com是是Olares 远程服务端点如 Market、Olares Space。OLARES_SYSTEM_CDN_SERVICEurlhttps://cdn.olares.com是是系统资源的 CDN 端点。OLARES_SYSTEM_DOCKERHUB_SERVICEurl无是否Docker Hub 镜像或加速端点。OLARES_SYSTEM_ROOT_PATHstring/olares否是Olares 根目录路径。OLARES_SYSTEM_ROOTFS_TYPEstringfs否是Olares 文件系统类型。OLARES_SYSTEM_CUDA_VERSIONstring无否否宿主机的 CUDA 版本。用户环境变量所有用户级变量均可由用户自行编辑按用途分组如下。用户信息变量类型默认值说明OLARES_USER_EMAILstring无用户邮箱地址。OLARES_USER_USERNAMEstring无用户名。OLARES_USER_PASSWORDpassword无用户密码。OLARES_USER_TIMEZONEstring无用户时区例如Asia/Shanghai。SMTP 设置变量类型默认值说明OLARES_USER_SMTP_ENABLEDbool无是否启用 SMTP。OLARES_USER_SMTP_SERVERdomain无SMTP 服务器域名。OLARES_USER_SMTP_PORTint无SMTP 端口通常为465或587。OLARES_USER_SMTP_USERNAMEstring无SMTP 用户名。OLARES_USER_SMTP_PASSWORDpassword无SMTP 密码或授权码。OLARES_USER_SMTP_FROM_ADDRESSemail无发件人邮箱。OLARES_USER_SMTP_SECUREbooltrue是否使用安全协议。OLARES_USER_SMTP_USE_TLSbool无是否使用 TLS。OLARES_USER_SMTP_USE_SSLbool无是否使用 SSL。OLARES_USER_SMTP_SECURITY_PROTOCOLSstring无安全协议允许值tls、ssl、starttls、none。镜像与代理端点变量类型默认值说明OLARES_USER_HUGGINGFACE_SERVICEurlhttps://huggingface.co/Hugging Face 服务地址。OLARES_USER_HUGGINGFACE_TOKENstring无Hugging Face 访问令牌。OLARES_USER_PYPI_SERVICEurlhttps://pypi.org/simple/PyPI 镜像地址。OLARES_USER_GITHUB_SERVICEurlhttps://github.com/GitHub 镜像地址。OLARES_USER_GITHUB_TOKENstring无GitHub 个人访问令牌。API 密钥变量类型默认值说明OLARES_USER_OPENAI_APIKEYpassword无OpenAI API 密钥。OLARES_USER_CUSTOM_OPENAI_SERVICEurl无自定义 OpenAI 兼容服务地址。OLARES_USER_CUSTOM_OPENAI_APIKEYpassword无自定义 OpenAI 兼容服务的 API 密钥。实践要点与校验边界结合仓库中的实现与测试开发应用时建议遵循以下要点模板消费的唯一正确姿势是.Values.olaresEnv.envName。oac.Lint对 v3 应用会同时拦截两类错误模板直接写.Values.OLARES_USER_*、以及values.yaml中出现OLARES_USER_*字面量v3_envs_test.go 给出了正反两个用例。应用变量名不要占用系统/用户保留前缀。envs[].envName以OLARES_USER开头会在ValidateManifestContent阶段报错错误信息明确指引声明应用本地名用valueFrom.envName映射用户变量envs.go。valueFrom是继承语义而非覆盖语义。需要控制校验行为类型、正则、可编辑性时应确保被引用的系统/用户变量自身定义正确而非在映射条目上重复声明。变更生效策略由applyOnChange决定。设为true后修改即触发 AppEnvController 的 Helm upgrade 路径重启相关组件设为false则变更挂起直到应用升级或重装。需要完整字段样例时可参考仓库内的测试清单 testdata/full_manifest/OlaresManifest.yaml 与 testdata/codex/OlaresManifest.yaml其中展示了options、remoteOptions、regex、valueFrom的组合用法。赞分享云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载相关推荐Terminus (Olares) 应用环境变量机制详解.Values.olaresEnv 声明式注入与系统运行时值Terminus Olares 应用环境变量机制详解 .Values.olaresEnv 声明式注入与系统运行时值 本篇技术指南基于 OlaresTermi云原生后端运维Cycle.js开发环境设置响应式应用的本地开发环境配置指南Cycle.js开发环境设置响应式应用的本地开发环境配置指南 你是否还在为响应式应用的状态管理感到头疼是否想构建可预测、易维护的前端应用却不知从何入手本文前端Web框架TanStack Store订阅系统详解如何高效监听状态变化TanStack Store订阅系统详解如何高效监听状态变化 TanStack Store是一个框架无关、类型安全的状态管理库它通过响应式框架适配器提供强大创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考