发布、环境与版本
0. 界限规定
功能权限1. 预览
预览功能可以根据当前应用的配置情况,生成一个展示态的页面提供给用户测试使用。预览模式下是没有用户、角色、权限相关概念。
预览功能的入口在应用编辑页面的右上角。
2. 发布与环境
与预览不同,发布是可以将应用生成一个独立部署包并将其部署到某个环境中独立运行的,发布功能生成的实例是可以脱离开发工具母体独立运行的。
同时发布功能生成的实例是具有完整功能的一个应用实例,可以支持用户控制、角色权限控制,独立访问地址、完全的数据控制权限等多项功能。
实际场景中,经常会有一个应用需要发布到多个集群、需要发布多次迭代版本的需求。针对这些痛点,共工提出了环境与版本功能,用户可以自由选择应用需要发布的环境,并且可以将同一个应用发布为多个版本,满足蓝绿发布等需求。
2.1. 环境
环境分为三种环境:
- 沙箱环境:共工默认提供的环境,用户所有的沙箱发布操作生成的应用都存在于这个环境;
- 在线环境:用户自定义添加的环境,并且此环境与公共开发工具的网络是可达的,后续操作可以通过页面直接操作;
- 离线环境:用户自定义添加的环境,并且此环境与公共开发工具的网络是不可达的,后续操作是需要运维人员介入的;
2.1.1. 使用建议
沙箱环境
可以用于应用的测试,例如应用搭建完成后想要尝试是否可以登录、角色配置是否正确。但要注意的是,沙箱环境的所有应用会不定时清理,不保证应用的长时间可用性,应用存活时长最多为 14 天。
在线环境
可以用于应用的预发布环境,该环境是需要用户自己提供服务器并在服务器上安装好对应的 sidecar 调度器使其成为共工支持的运行时环境(sidecar 安装流程查看文档)。但是要注意的是,在线环境不推荐作为正式的生产环境使用,因为其发布成本过低,发布的时候误操作选中此环境可能会导致应用被误更新为不稳定的版本。
离线环境
离线环境:可以用于应用的生产环境,该环境是需要用户自己提供服务器并在服务器上安装好对应的 sidecar 调度器使其成为共工支持的运行时环境(sidecar 安装流程查看文档)。一般离线环境使用的情况有两种:
- 运行时环境和开发工具之间的网络不可达;
- 作为生产环境,重视每一次发布的备份和存档;
2.1.2. 安装环境
沙箱环境无需安装,每个开发工具会配套提供。详细讲解下在线环境和离线环境的安装。
首先两个环境的安装都需要用户手动先将 gg-sidecar
调度器安装到目标服务器使其可以成为一个共工认可的环境。具体的 sidecar 安装流程请参考:共工安装说明。
2.1.2.1. 安装在线环境
用户在 控制台 - 环境管理 - 新增环境
中选择新增环境,填入必要的环境名称后,会动态生成一串 url,用户将这串 url 复制到目标环境的机器上执行,等待脚本执行完毕后,在线环境就新增成功了。
2.1.2.2. 安装离线环境
用户在 控制台 - 环境管理 - 新增环境
中选择新增离线环境,此时需要用户手动填入相关信息,之后点击下方的确认按钮即可。后续在生成应用离线安装包时,就会根据此时填入的信息生成安装脚本。
2.2. 版本
2.2.1. 说明
在应用的多次迭代需求过程中,应用需要实现不停迭代以及保证生产版本稳定性,为了满足这个目标,共工提出了 版本
这一个功能。
每个版本对应的应该是一个稳定版本,用户在发布的时候可以选择是否生成一个新版本,新版本代表的是一个初始化全新发布,而选择老版本代表的是在这个版本上一次的操作上继续迭代更新内容。
2.2.2. 如何选择正确的版本
这边给出的操作建议是:
- 如果应用是第一次发布,一个版本都没有,那么现在也只有一个选项:创建新版本(v1);功能持续迭代中,就在这个版本上持续发布;
- 当此次需求全部迭代完成,v1 版本应该就封板了,根据这个时间点出一个稳定版本配合离线发布功能发布到生产环境;
2.3. 发布
首先需要明确几个概念:
一个应用会根据环境、操作类型、离线等信息的不同,生成多个唯一标识(app_uuid);
每次应用操作都会生成一个唯一的操作标识(app_action_id),这个标识是一个标准的 uuid;
即一个应用拥有多个实例(auId 是实例的唯一标识),每个实例会对应到多个操作标识(aaId)。
2.3.1. 发布为新版本
在应用编辑器的右上角,点击发布,选择好具体的环境后,点击 发布为新版本
即可;
2.3.2. 迭代发布
在应用编辑器的右上角,点击发布,选择好具体的环境后,选择已经存在的某个版本(选中的版本会高亮显示),点击下一步即可;
2.3.3. 如何查看已发布版本
在控制台的右上角,选择 环境与版本
:
选择一个具体的环境后,可以看到在这个环境下发布的所有应用:
点击应用后,即可看到这个应用的所有版本包括应用信息: