#配置与连接

平台配置分成两类：给用户看的公开配置，以及连接外部系统的后台配置。

#公开配置

公开配置会影响控制台展示，例如：

• 站点标题。
• Logo 和 Favicon。
• 登录页副标题。
• 主题和语言偏好。

这些内容可以放心展示给前端，但不要放 Token、密码或内部地址。

#Git Provider

Git Provider 用来连接 GitHub 或 Gitea。配置完成后，用户可以绑定仓库、接收 Webhook，并按分支或标签触发构建。

删除 Git Provider 时，平台会同步删除属于该 Provider 的 Git 凭据。删除前请确认相关仓库绑定和构建链路不再依赖这些凭据。

如果你只是想先跑通部署，可以暂时跳过 Git Provider，直接使用已有镜像。

#镜像站

镜像站用于拉取或推送镜像。常见选择包括 Harbor、Gitea Registry 和 DockerHub。

删除镜像站时，平台会同步删除属于该镜像站的凭据。删除前请确认部署配置、构建任务或运行集群拉取镜像不再依赖这些凭据。

需要自动构建时，部署配置会使用镜像站推送凭据；只部署已有镜像时，重点确认运行集群能拉取目标镜像。

#运行集群

运行集群是发布目标。平台会把 Release 转换成 Kubernetes 资源，并把状态、日志和诊断信息展示回来。

如果 API 或 worker 在容器里运行，kubeconfig 里的地址必须能从容器访问，不要直接使用宿主机专用的 127.0.0.1。

运行集群也承担 Kubernetes 构建 Job。小团队默认每个运行集群最多同时运行 4 个构建 Job；项目空间默认最多同时运行 2 个构建。超过额度时，新构建会保持排队并自动重试，不会立刻标记为失败。

#密钥

Secret、Token 和 Registry Credential 不会明文回显。编辑时留空表示“不修改已有值”，需要替换时输入新值并保存。