1. 使用场景和优势

1.1 使用场景

• 首次镜像化安装苍穹

• 苍穹标准产品镜像化升级

• 二开产品使用镜像化构建和部署

1.2 优势

对比容器启动时再去动态拉取jar包的方式，苍穹镜像化模式具有如下优势：

1. 运维简单

镜像里的基础环境和jar包都是固定的。避免了以往jar包的版本在开发，测试，生产环境版本不一致的情况，运维更简单。

2. 分领域标准化

苍穹服务按照最新的标准，按业务领域进行了拆分。这使得各个领域的服务运行更加独立，在更新迭代方面也更加灵活可靠。

3. 镜像和元数据自动映射

苍穹镜像化流水线会生成镜像（源码）和元数据包（元数据&脚本），并在两者间建立映射关联，为采用镜像化交付的项目提供更严谨的元数据版本管理。

1.3 部署模式

针对不同的用户规模，苍穹V6.0推出了不同的部署模式，通常情况下我们推荐分领域部署的模式；对于规模小、业务简单、购买领域少的团队，为了节省资源，我们也支持ALLONE部署模式。

1. 分领域模式

分领域模式是苍穹V6.0版本后推荐的服务部署方案，由于拆分服务部署对资源要求较高，推荐在测试、生产环境使用，具体按用户实际资源情况决策。在V6.0后，苍穹服务按官方标准拆分为14个领域（如下图右侧表格所示），用户可根据实际业务购买相应的模块，并拆分、创建服务，同领域的服务指向同一个服务镜像，通过环境变量进行控制（下图方案一）。

2. ALLNOE模式

主要针对团队规模小、二开工作量少或无二开场景的客户。所谓ALLONE模式，即将苍穹的服务（比如hr，财务，供应链等）全部构建到同一个镜像中。后续部署也只需要更新这一个镜像。从而达到减少资源使用的效果。

2. 前置条件

• gPaaS版本V6.0及以上，其中对应轻轨线（CI/CD）服务V2.9.4及以上。

• 星瀚和苍穹版本V6.0及以上。

3. 操作步骤

3.1 苍穹首次安装

苍穹首次镜像化安装流程说明：

3.1.1 用安装器安装苍穹

苍穹首次安装，需通过安装器进行一键式安装。V6.0版本后，官方将苍穹服务拆分为14个领域，每个领域对应一个服务镜像，用户在安装时，可根据购买的领域模块，分领域分应用选择相应的安装内容。

说明：安装器的最新版本目前（截止到2023.11.20）尚未支持分领域的直接安装。苍穹分领域的方式，目前可以在安装完苍穹后，再通过4.3.1步骤手工在容器服务里面直接创建服务即可（后续安装器会直接支持分领域安装）。

通过安装器安装苍穹环境的文档点击这里。

3.1.2 构建苍穹标准镜像

用户在用安装器安装苍穹后，需分领域构建苍穹标准镜像。轻轨线（CI/CD）提供了制作苍穹标准镜像的模板。操作步骤：【流水线】-- 新建流水线 – 选择“苍穹标准版本镜像化构建模板”创建 -- 全局变量

▲ 生成苍穹标准镜像的流水线示例

配置变量及其释义如下表所示：

注意：

1、具体构建、生成的标准镜像与客户购买的领域有关，请按需生成。

2、变量获取地址参考本文档4.1

3、COSMIC_WEB变量为V2.9.11版本新增，用来进行web镜像构建。

配置完成后，点击“保存并运行”流水线，系统会自动生成多个标准镜像并保存在镜像仓库。

▲ 生成的苍穹标准镜像

3.1.3 配置苍穹服务及参数

打开【容器服务】,手工创建或者复制苍穹已有的服务mservice（标准全领域为14个服务，具体创建多少个服务，以客户实际购买的情况为准），再调整相关的环境变量值。按领域分应用的全部服务列表示例如下（仅代表示例，服务名根据客户实际情况命名即可）：

需变更的环境变量如下：

服务中环境变量变更的具体说明：

服务和领域云libs映射关系表2（默认配置）：

说明：web镜像构建需要V2.9.11版本支持。

镜像化模式下，如果只有苍穹标准产品（不存在二开场景）的前提下，苍穹标准产品的安装，先根据3.1.2章节制作成苍穹标准镜像（如mservice-bos:v6.0.001.008），再在容器服务中替换相应服务的镜像的版本即可。以mservice-bos服务为例：

3.2 苍穹标准产品升级

当用户需要进行苍穹标准产品升级时（如苍穹标准版本更新、苍穹私包更新等），在镜像化部署的场景下，用户需要按升级流程处理。

苍穹标准产品升级的流程如下：

注：如果不存在二开场景，则无需完成上图所示的第三、四步骤。

3.2.1 通过MC更新苍穹环境

苍穹标准产品更新后，客户如需基于镜像化方案实现升级，第一步需通过MC更新对应苍穹环境的AppStore，完成新版本jar包和元数据的更新。操作文档点击这里

3.2.2 构建苍穹标准版本镜像

在通过MC更新完苍穹的appstore和元数据后，就可以制作新的苍穹标准镜像，同样通过轻轨线（CI/CD）提供的模板创建流水线即可，如历史存在构建苍穹标准镜像的流水线，可以复用。操作步骤：【流水线】-- 新建流水线 – 选择“苍穹标准版本镜像化构建模板”创建 -- 全局变量

▲ 苍穹标准版本镜像化构建模板

具体的生成苍穹标准镜像的流水线变量配置，可参考本文档3.1.2章节。在没有二开场景下，如用户只需升级苍穹标准产品，在构建获得新的苍穹服务标准镜像后，进入【容器服务】界面替换并部署新的镜像即可完成升级。如存在二开场景，则需要按本文档3.2.3和3.2.4章节操作。

3.2.3 构建二开镜像和补丁

标准镜像生成后，在二开场景下，用户就能根据所属环境，基于新构建的苍穹标准镜像，进行二开镜像和补丁的制作。

操作路径为：【流水线】– 新建流水线（如已有可不创建）-- 选择“苍穹二开补丁镜像化CI模板” – 配置并运行

【拉代码】和【拉静态资源】是git节点，分别获取源码及静态资源的路径、token权限、分支信息等；

【代码扫描】是可选节点，配置对应仓库的扫描任务，如无需可关闭该节点；

【构建补丁包】节点决定了哪些应用的源码、元数据、脚本纳入此次构建的范畴，该步骤需要提前完成“苍穹应用管理”的配置，具体可参考文档：项目管理-苍穹应用管理。在【构建补丁包】节点中，请务必将服务镜像中所需的全部应用勾选上，确保该镜像包含了该服务历史全量的二开代码。

“全局变量”菜单需要按要求配置，配置变量及其释义如下表所示：

变量获取地址参考本文档4.1

配置完成后，点击“保存并运行”流水线，在正确配置的前提下，流水线会输出该领域云对应的二开镜像和补丁包。

二开镜像的命名规则为：标准镜像名称-IMAGE_TAG变量值-cus:标准镜像版本号_时间.序列号,如标准镜像为/mservice-fi：v6.0.001.001，二开镜像标签为dev，构建时间为10月19日，则首次构建的二开镜像名称为：/mservice-fi-dev-cus：v6.0.001.001_1019.1

说明：

1、所有二开镜像都会自带cus，作为二开镜像的统一标识；

2、二开镜像会用IMAGE_TAG来区分同一领域的镜像是由哪条流水线构建的，如一条流水线用来构建财务云dev环境的二开镜像，则IMAGE_TAG变量值可以设置为dev，则该条流水线构建的二开镜像名称都会会带上dev标识，如/mservice-fi-dev-cus：v6.0.001.001_1019.1；

3、元数据和静态资源，打成制品zip包；源码输出为镜像；

4、制品zip和镜像会建立映射关系，防止管理上的混乱。

生成的镜像和补丁，可分别在镜像仓库和制品库查看。

3.2.4 发布二开镜像和补丁

最后只需将3.2.3步骤获得的新镜像和补丁发布到环境，即可完成二开场景下，苍穹标准产品升级。操作路径为：流水线 – 新建流水线（如已有可不创建）-- 选择“苍穹二开补丁镜像化CD模板” – 配置并运行

【全局变量】配置变量及其释义如下表所示：

变量获取地址参考本文档4.1

配置完成后，点击“保存并运行”流水线，在正确配置的前提下，流水线会执行镜像升级流程，更新最新的镜像和补丁到目标环境上去。此处流水线变量配置中，在选择了补丁包后，其关联的镜像会自动获取，无需人工匹配，确保Jar包和元数据版本统一。

3.3 二开镜像化CICD

对于镜像化二开的客户来说，二开镜像化CICD是日常工作中最常见的场景，其实完整的二开镜像和补丁的构建和发布流程，在3.2.3和3.2.4章节已经涉及。

3.2.1 构建苍穹二开镜像和补丁

构建苍穹二开镜像和补丁的方案如下图：

操作路径为：【流水线】– 新建流水线（如已有可不创建）-- 选择“苍穹二开补丁镜像化CI模板” – 配置并运行

具体的参数配置方法与3.2.3章节相同。

3.2.2 发布苍穹二开镜像和补丁

部署苍穹二开镜像和补丁的方案如下图：

操作路径为：流水线 – 新建流水线（如已有可不创建）-- 选择“苍穹二开补丁镜像化CD模板” – 配置并运行

具体的参数配置方法与3.2.4章节相同。

3.4 ALLONE模式部署

3.4.1 ALLONE模式的区别和应用

ALLONE部署模式是为中小团队打造，和苍穹V6.0的标准部署模式的差异在于：ALLONE模板会将苍穹服务全部至于一个镜像中（mservice-all），而苍穹V6.0的标准部署模式，将苍穹服务按领域云拆分为多个镜像（按用户实际购买情况决定），分别输出运行。这种差异导致了如下结果：

1. ALLONE模式下苍穹标准镜像只有一个，运行时占用资源较小；

2. ALLONE模式下，只允许一个轻轨线项目和一个代码仓库；

3. ALLONE模式下，构建镜像都是全量构建，所需时间可能较长。

因此，具有如下特征的团队可考虑采用ALLONE模式部署：

1、二开涉及的领域少，构建不频繁的客户；

2、团队规模小，数据隔离需求弱的客户。

3.4.2 ALLONE模式首次安装苍穹

3.4.2.1 用安装器安装苍穹

文档点击这里。

3.4.2.2 构建苍穹ALLONE标准镜像

苍穹环境安装后，需要基于该环境构建苍穹ALLONE标准镜像。路径：【流水线】-- 新建流水线 -- 苍穹标准版本镜像化构建模板 --按下图选择构建节点（构建mservice-allone和构建mservice-qing）--全局变量

配置变量及其释义如下表所示：

变量获取地址参考本文档4.1

配置完成后，点击“保存并运行”流水线，流水线会自动生成一个“allone镜像”和“轻分析镜像”并保存在镜像仓库。

说明：

1、 标准镜像和二开镜像通过cus标识进行明确的区分，二开镜像名称会统一分配cus字段，如标准镜像路径为/mservice-fi，则二开镜像为/mservice-fi-dev-cus；

2、 标准镜像会通过自增序列号来区分各个子版本，防止管理混乱，如苍穹版本为v6.0.001，则首次构建的版本号为/mservice-fi:v6.0.001.001,再次构建版本号会变为/mservice-fi:v6.0.001.002

首次构建完苍穹的ALLONE镜像后，需进行部署。打开【容器服务】，编辑已有的苍穹服务（mservice），如无，则创建新的苍穹服务（mservice），调整相关的环境变量值即可。实际操作需创建两个服务，如：mservice-all和mservice-qing，名字可以按需修改。

如下为mservice-all服务的示例：

服务中环境变量变更的具体说明：

服务和领域云libs映射关系表1（默认配置）：

苍穹的标准产品如需升级，先根据3.1.1.2章节制作成苍穹升级镜像（如mservice-all:v6.0.001.008）, 再在容器服务中替换服务的镜像的版本即可。

如下以mservice-all升级示例：

3.4.3 ALLONE模式苍穹标准产品升级

3.4.3.1 通过MC更新苍穹环境

苍穹标准产品更新后，客户如需基于ALLONE镜像化方案实现升级，第一步需通过MC更新对应苍穹环境的AppStore，完成新版本jar包和元数据的更新。操作文档点击这里

在通过MC更新完苍穹的appstore和元数据后，就可以制作苍穹的标准镜像。操作路径：【流水线】-- 新建流水线 – 选择苍穹标准版本镜像化构建模板 ---开启构建mservice-allone和构建mservice-qing节点 -- 全局变量

▲ 苍穹标准版本镜像化构建模板-ALLONE

ALLONE标准镜像构建流水线的参数配置可参考文档3.4.2.2章节。

在ALLONE模式下，苍穹二开镜像的构建和部署步骤与标准部署相同，详细步骤可参考3.2.3及3.2.4章节，只需要在配置标准镜像时，选择ALLONE模板生成的标准镜像即可。

4. 附件

4.1 流水线变量参数获取指导

MAGE_REGISTRY_PASSWORD

该参数为镜像仓库的密码，在第一次登录平台镜像仓库页面时设置，操作路径为：容器服务 – 镜像服务 – 平台仓库。

X_Console_Ukey

即gPaaS控制台中的密钥。操作路径：控制台右上角点击个人信息图标 → 点击“密钥管理”→ 新建密钥并在列表中复制。

NEXUS_REPO

即项目ID。

NEXUS_PROXY

gPaaS中的部署在容器服务中的third-api-server服务的外部访问地址。

COSMIC_CLOUD_NAME

苍穹中应用云的编码。

ISV

开发商标识。自动生成流水线时默认映射为为租户ID，需修改成实际的值。

操作路径：登录开发者门户  → 点击右上角“工作台”

开发商标识界面：

MS_PID

苍穹mservice服务所在的集群项目ID。可在【omp系统】中在相应的租户下面查询项目获取. 本示例中集群项目ID为“10272”。

MS_REGION

苍穹mservice服务所在的k8s集群中的集群编码。操作路径：进入【容器服务】→ 【集群管理】→【资源管理】。

集群编码即为“区域英文标识”。

MS_NAMESPACE

苍穹mservice服务所在的k8s集群中的命名空间。操作路径：【容器服务】→【集群管理】→【项目管理】。

选择部署了苍穹mservice服务的集群，并点击“项目管理”进入如下页面：

列表上选择苍穹mservice服务所在的项目，并点击操作列中的“配置”按钮，如下图：

示例图说明：苍穹mservice服务所在的项目为 “一体化PaaS项目”，所在的k8s集群为“融合平台集群”，所在的命名空间为“cosmic-devops”。

COSMIC_DATACENTER_ID

mc中的数据中心ID，通过mc系统查看，操作路径：【租户列表】→ 【租户】→ 【数据中心】。

COSMIC_CLUSTER_ID

mc中的集群ID。

MC_TRD_APPID

mc中第三方应用ID。

MC_TRD_KEY

mc中的第三方应用key，首次进入时点击刷新图标即能看到数据；如果没有看到此界面，则需要更新mc的内核和版本。

注意：点击[刷新]后，需要点击[保存]按钮，key才能保存成功。