Orbit As Code 升级常见问题
Orbit 将于 2024 年 07 月 06 日进行功能升级，升级后数据结构会发生变化，可能出现历史数据兼容问题，存在不支持部分旧数据查询的场景。建议您参考如下 FAQ 进行操作，降低版本升级的影响。
数据库
Orbit 功能升级后，历史的数据库变更记录会变为禁用状态，不建议对这类已禁用的历史数据库再进行操作。建议您在版本升级前将需要发布的变更尽快发布完毕，升级后不会影响您数据库发版功能的使用。
版本升级后新建的数据库变更记录，功能保持正常，不会存在上述问题。
版本
- Orbit 功能升级后，如有升级前未发布的版本，该历史版本将会被禁止发布。升级前创建的版本如果需要发布，建议在版本升级前全部发布完毕。
升级后，不可再基于升级前创建的版本进行发布，如需发布服务您可重新创建新版本并发布。
升级后，对升级前未发布和已发布的版本，点击「详情」查看版本详情时，版本变更的展示列表会有变动。这是由于升级前是以镜像为单位展示变更，而升级后是以服务为单位展示变更。
例如，升级前的版本变更展示如下。
升级后的版本变更展示如下。
- 如果服务的镜像来源非 CODING 镜像仓库或者 Tencent TCR 企业版镜像仓库，创建版本时无法展示该镜像的版本列表。
如需支持镜像版本查询，请将所需镜像上传至 CODING 镜像仓库或者 Tencent TCR 企业版镜像仓库。以使用 CODING 镜像仓库为例，操作步骤示例如下：
a. 登录仓库，docker login -u 。
b. 镜像打标签，docker tag nginx:latest xxx-docker.pkg.coding.net/xxx/nginx:latest。
c. 推送镜像，docker push xxx-docker.pkg.coding.net/xxx/nginx:latest。
d. 在应用服务管理页面修改服务的镜像配置。
权限
Orbit 功能升级后，如遇到权限问题，可以通过如下方式解决。
一、提示“无权访问”添加权限方法
点击发布时提示无权访问，需要团队仓库所在项目添加该用户。
- 项目中查找团队仓库所在项目，通常为“团队模板配置项目”。如无该项目，则从「应用中心」的「服务模板」跳转到团队仓库所在项目。
- 在团队仓库所在项目的「项目设置」->「项目与成员」的「成员」页签，点击「添加成员」添加无权限用户。
二、提示“数据库权限不足”添加权限方法
- 在「团队设置中心」->「全局设置」->「团队权限方案」，为用户的用户组添加应用中心数据库变更管理权限。
- 如用户需关联新权限组，在「团队设置中心」->「全局设置」->「成员管理」的「成员」页签，将用户关联至该权限组。如修改原权限组，则无需执行此步骤。
完整发布功能
Orbit 功能升级后，完整发布功能简介。
- 在「应用管理」的「服务管理」页签，在应用下创建 ser-nginx、ser-tomcat 服务。
- 在「应用管理」的「版本管理」页签点击「创建版本」，在创建版本页面的「版本变更」区域可以查看该服务变更及配置变更。
- 在创建版本页面配置后点击「创建并发布」，在「版本发布」对话框根据提示选择对应的部署流程。
- 「完整发布」配置项默认关闭，如需发布全部服务，需打开「完整发布」开关。
- 如用户在该版本，只需发布部分服务，可保持「完整发布」开关关闭状态，按需手动勾选需要发布的服务。
- 「版本管理」页签点击版本后的「发布」。发布完成后，可在对应部署记录查看该版本具体发布的服务。已发布的服务默认勾选，未发布的服务不勾选。
分支
提示“团队或应用仓库未找到 master 分支, 请尝试初始化团队仓库或检查应用仓库是否存在 master 分支”。
- 在「应用中心」点击右上角的「···」，点击「运维插件」进入团队仓库运维插件页面。
- 在「运维插件」页签点击「快速初始化」。
- 设置初始化信息后，点击「保存仓库和内置模板插件」。
初始化团队仓库完成后，在「运维插件」页签可查看具体信息。
overlay 路径需要在 master 主目录存在
以下介绍环境配置中的「value」（Helm）和「环境覆盖目录」（Kustomize）配置。
因为环境信息作为多分支的公共信息，通常，我们将其存储在应用设置主分支。在「应用」->「设置」->「Yaml仓库」的「仓库分支」区域可查看，通常为 master。
如果某个分支需要发布到目标环境，但是该分支发布需要特定的「value」（Helm）或者「环境覆盖目录」（Kustomize）配置。
则需保证应用主分支包含该「value」（Helm）和「环境覆盖目录」（Kustomize），用于保存记录并到分支目标路径寻找文件/文件夹。
实际在分支发布中调用的文件/文件夹内容为分支上该路径的内容，而非主分支内容。
2024-07-15最近更新在阅读中是否遇到以下问题？*
您希望我们如何改进？*
如果您希望得到回复，请留下您的邮箱地址。
