# Guidewire 部署集成 ## 概述使用适当的发布管理实践将 Guidewire InsuranceSuite 配置和集成部署到 Guidewire 云平台。 ## 先决条件 * Guidewire云控制台访问 * 具有部署权限的服务帐号 * 构建并测试配置包 * 目标环境的批准 ## 部署架构 +------------------+ +------------------+ +------------------+ | | | | | | | 发展|----->| 沙箱|----->| 生产| | 环境 | | 环境 | | 环境 | | | | | | | +------------------+ +------------------+ +------------------+ | | | 维维维构建包部署和测试部署和验证运行单元测试集成测试生产测试代码审查 UAT 批准上线批准 ## 说明 ### 步骤一：准备配置包 // build.gradle - 配置包创建任务.register('createConfigPackage', Zip) { 描述 = '为 Guidewire 云部署创建配置包' 组 = '部署' archiveFileName = "config-${project.version}-${new Date().format('yyyyMMddHHmmss')}.zip" 目标目录 = 文件（“$buildDir/packages”）来自（'模块/配置'）{ 包括“gsrc/**” 包括“配置/**” 排除“**/*.swp” 排除“**/测试/**” } 来自（'模块/集成'）{ 包括“gsrc/**” 排除“**/*Test.gs” } // 包含元数据来自（'。'）{ 包括“版本.属性” 包含“部署清单.json” } } 任务.register('validatePackage') { 描述 = '部署前验证配置包' 取决于“createConfigPackage” 做最后{ def packageFile = file("$buildDir/packages").listFiles().find { it.name.endsWith('.zip') } // 验证包大小 def sizeMB = packageFile.length() / (1024 * 1024) 如果（大小MB > 100）{ throw new GradleException("包太大: ${sizeMB}MB (最大 100MB)") } // 验证所需文件 def zipFile = new java.util.zip.ZipFile(packageFile) def requiredFiles = ['deployment-manifest.json', 'version.properties'] requiredFiles.each { 必需 -> if (!zipFile.entries().any { it.name == 必需 }) { 抛出新的GradleException（“缺少必需的文件：$ {required}”） } } zipFile.close() println "包验证已通过：${packageFile.name} (${sizeMB}MB)" } } ### 步骤 2：部署清单 { "清单版本": "2.0", “包信息”：{ “名称”：“策略中心自定义配置”， “版本”：“1.5.0”， "description": "具有集成扩展的自定义 PolicyCenter 配置", "buildNumber": "${BUILD_NUMBER}", "buildTimestamp": "${BUILD_TIMESTAMP}" }, “目标应用程序”：[ { “应用程序”：“政策中心”， "最小版本": "202503", “最大版本”：“202507” } ], “组件”：[ { “类型”：“gosu”， “路径”：“gsrc / gw /自定义/ **”， "description": "自定义 Gosu 业务逻辑" }, { “类型”：“pcf”， "路径": "config/pcf/**", "description": "自定义 UI 屏幕" }, { “类型”：“产品”， “路径”：“配置/产品/**”， "description": "产品型号定制" }, { “类型”：“集成”， “路径”：“配置/集成/**”， "description": "集成配置" } ], “预部署检查”：[ { "name": "数据库兼容性", “type”：“模式验证” }, { "name": "api 兼容性", “type”：“api 版本检查” } ], “部署后操作”：[ { "name": "清除缓存", “type”：“缓存失效” }, { "name": "重新加载产品", “type”：“产品重新加载” } ] } ### 步骤 3：部署 API 客户端 // Guidewire 云部署客户端接口部署状态{ id：字符串；状态：“待处理”| '进行中' | “完成”| “失败”| 'ROLLED_BACK'; 开始时间：字符串；结束时间？：字符串；进度：数量；消息？：字符串；日志？：字符串[]； } 接口部署请求{ 环境：字符串；包路径：字符串； rollbackOnFailure：布尔值；验证模式？：'严格' | '宽容'; } 类 GuidewireDeploymentClient { 私有baseUrl：字符串；私有令牌管理器：TokenManager；构造函数（baseUrl：字符串，tokenManager：TokenManager）{ this.baseUrl = baseUrl; this.tokenManager = tokenManager; } 异步部署（请求：DeploymentRequest）：Promise { const token =等待this.tokenManager.getToken(); // 上传包 const packageBuffer = wait fs.readFile(request.packagePath); const uploadResponse =等待 fetch(`${this.baseUrl}/deployment/v1/packages`, { 方法：'POST'，标题：{ '授权': `不记名${token}`, '内容类型'：'应用程序/zip'， 'X-环境': request.environment, 'X-Rollback-On-Failure'：字符串（request.rollbackOnFailure）， 'X-Validation-Mode'：request.validationMode || “严格” }, 主体：包缓冲区 }); 如果（！uploadResponse.ok）{ const error = 等待 uploadResponse.json(); throw new Error(`部署失败：${error.message}`); } const 结果 = 等待 uploadResponse.json(); 返回结果.deploymentId； } async getStatus(deploymentId: string): Promise { const token =等待this.tokenManager.getToken(); 常量响应 = 等待获取（ `${this.baseUrl}/deployment/v1/deployments/${deploymentId}`, { headers: { '授权': `承载 ${token}` } } ）；返回response.json(); } 异步等待完成（部署 ID：字符串，超时时间：数量=1800000， pollIntervalMs：数量 = 10000 ): Promise<部署状态> { const startTime = Date.now(); while (Date.now() - startTime < timeoutMs) { const status = wait this.getStatus(deploymentId); console.log(`部署 ${deploymentId}: ${status.status} (${status.progress}%)`); if (status.status === '已完成') { 返回状态； } if (status.status === 'FAILED' || status.status === 'ROLLED_BACK') { 抛出新错误(`部署失败：${status.message}`); } 等待睡眠（pollIntervalMs）； } 抛出新错误（`部署在 ${timeoutMs}ms 后超时`）； } 异步回滚（deploymentId：字符串）：Promise { const token =等待this.tokenManager.getToken(); 常量响应 = 等待获取（ `${this.baseUrl}/deployment/v1/deployments/${deploymentId}/rollback`, { 方法：'POST'， headers: { '授权': `承载 ${token}` } } ）；如果（！response.ok）{ throw new Error('回滚失败'); } } } ### 步骤 4：蓝绿部署 // 蓝绿部署策略接口环境槽{ 名称： '蓝色' | '绿色的'; 状态：'活动'| '支持'; 版本：字符串；健康网址：字符串； } 类 BlueGreenDeployment { 私有部署客户端：GuidewireDeploymentClient；私有负载均衡器：LoadBalancerClient；异步部署（packagePath：字符串）：Promise { // 步骤1：识别当前的主用和备用槽位 const slot =等待this.getSlotStatus(); const activeSlot = slot.find(s => s.status === 'active')!; conststandbySlot = slot.find(s => s.status === 'standby')!; console.log(`当前活动：${activeSlot.name} (${activeSlot.version})`); console.log(`部署到：${standbySlot.name}`); // 步骤2：部署到备用槽位 const deploymentId = 等待 this.deploymentClient.deploy({ 环境：standbySlot.name，包路径, 失败时回滚：true }); 等待 this.deploymentClient.waitForCompletion(deploymentId); // 步骤 3：在待机状态下运行健康检查 consthealthy=awaitthis.runHealthChecks(standbySlot.healthUrl); 如果（！健康）{ throw new Error('备用插槽运行状况检查失败'); } // 步骤 4：运行冒烟测试 const SmokeTestsPassed = 等待 this.runSmokeTests(standbySlot.name); 如果（！smokeTestsPassed）{ throw new Error('冒烟测试失败'); } // 步骤5：切换流量 console.log('将流量切换到新部署...'); 等待 this.loadBalancer.switchTraffic(standbySlot.name); // 步骤6：验证开关 const newActive = 等待 this.verifyActiveSlot(); if (newActive !==standbySlot.name) { throw new Error('流量开关验证失败'); } console.log(`部署完成。活动插槽：${standbySlot.name}`); } 异步回滚(): Promise { const slot =等待this.getSlotStatus(); conststandbySlot = slot.find(s => s.status === 'standby')!; console.log(`回滚到 ${standbySlot.name}...`); 等待 this.loadBalancer.switchTraffic(standbySlot.name); console.log('回滚完成'); } 私有异步 runHealthChecks(healthUrl: string): Promise { for (令 i = 0; i < 5; i++) { 尝试{ const 响应 = 等待 fetch(healthUrl); const health =等待response.json(); if (health.status === '健康') { 返回真； } } 捕获（错误）{ console.log(`健康检查尝试 ${i + 1} 失败`); } 等待睡眠（10000）； } 返回假； } } ### 步骤 5：环境宣传 // 促进环境之间的部署接口促销请求{ 源环境：字符串；目标环境：字符串；包ID：字符串；批准者：字符串；更改票证：字符串； } 类环境促销{ 异步促销（请求：PromotionRequest）：Promise { // 验证晋升路径常量有效路径 = [ ['开发'，'沙箱']， ['沙箱', '暂存'], [‘舞台’、‘制作’] ]; const isValidPath = validPaths.some( ([from, to]) => from === request.sourceEnvironment && to === request.targetEnvironment ）； if (!isValidPath) { throw new Error(`无效的升级路径：${request.sourceEnvironment} -> ${request.targetEnvironment}`); } // 验证包是否存在于源中 const sourcePackage = wait this.getPackage(request.sourceEnvironment, request.packageId); 如果（！源包）{ throw new Error('在源环境中找不到包'); } // 检查目标环境的先决条件等待这个。checkPromotionPrecessions（请求）； // 创建促销记录 const PromotionId = 等待 this.createPromotionRecord(request); // 执行部署到目标 const deploymentId = 等待 this.deploymentClient.deploy({ 环境：请求.targetEnvironment，包路径：sourcePackage.packagePath，失败时回滚：true }); // 等待完成等待 this.deploymentClient.waitForCompletion(deploymentId); // 更新促销记录等待 this.updatePromotionRecord(promotionId, 'COMPLETED'); 返回促销Id； } 私有异步 checkPromotionPrecessions（请求：PromotionRequest）： Promise { // 检查是否批准 if (request.targetEnvironment === '生产') { const 批准 = 等待 this.getApproval(request.changeTicket); if (!approval.approved) { throw new Error('生产部署需要批准'); } } // 检查没有活动的部署 const activeDeployments = 等待 this.getActiveDeployments(request.targetEnvironment); if (activeDeployments.length > 0) { throw new Error('另一个部署正在进行中'); } // 检查维护窗口（用于生产） if (request.targetEnvironment === '生产') { const inWindow = 等待 this.isInMaintenanceWindow(); 如果（！inWindow）{ throw new Error('仅在维护时段允许生产部署'); } } } } ### 步骤 6：部署验证 // 部署后验证测试包 gw.deployment.verify 使用 gw.api.util.Logger 使用 gw.api.database.Query 类部署验证{ private static Final var LOG = Logger.forCategory("DeploymentVerification") 静态函数 runVerification() : VerificationResult { var 结果 = new VerificationResult() // 检查数据库连接 result.addCheck("数据库", verifyDatabaseConnection()) // 检查加载的产品型号 result.addCheck("ProductModel", verifyProductModel()) // 检查配置的集成 result.addCheck("积分", verifyIntegrations()) // 检查加载的自定义 Gosu 类 result.addCheck("CustomCode", verifyCustomCode()) 返回结果 } 私有静态函数 verifyDatabaseConnection() : boolean { 尝试{ var count = Query.make(Account).select().Count LOG.info("数据库检查已通过：找到${count}个帐户") 返回真 } catch (e: 异常) { LOG.error("数据库检查失败", e) 返回错误 } } 私有静态函数 verifyProductModel() : boolean { 尝试{ var 产品 = gw.api.productmodel.ProductLookup.getAll() LOG.info("产品型号检查已通过：已加载${products.Count}个产品") 退货产品数量 > 0 } catch (e: 异常) { LOG.error("产品型号检查失败", e) 返回错误 } } 私有静态函数 verifyIntegrations() : boolean { 尝试{ // 验证集成端点是否已配置 var 端点 = IntegrationConfig.getAllEndpoints() LOG.info(“集成检查已通过：配置了${endpoints.Count}个端点”) 返回真 } catch (e: 异常) { LOG.error("集成检查失败", e) 返回错误 } } 私有静态函数 verifyCustomCode() : boolean { 尝试{ // 尝试实例化自定义类 var 实例 = new gw.custom.MyCustomClass() LOG.info("自定义代码检查通过") 返回真 } catch (e: 异常) { LOG.error("自定义代码检查失败", e) 返回错误 } } } ## 输出 * 创建并验证配置包 * 带有依赖项的部署清单 * 蓝绿部署能力 * 环境提升工作流程 * 部署后验证 ## 错误处理错误|原因 |解决方案 ---|---|--- 包验证失败 |缺少所需文件 |检查清单并包含所有文件部署超时 |大包裹或网速慢|增加超时，优化包健康检查失败 |应用程序错误 |检查日志、修复问题、重新部署回滚失败 |状态不一致|需要人工干预 ## 资源 * [Guidewire 云部署指南]() * [配置包参考]() ## 后续步骤有关 Webhook 和事件处理的信息，请参阅“guidewire-webhooks-events”。

Guidewire 部署集成

包含技能