生命周期

本文将指导您完成容器生命周期管理策略的配置操作，核心涵盖「命令行与参数」「容器创建后处理」「容器终止前处理」三大模块。通过在容器生命周期的特定阶段执行调用（注册钩子函数），可实现定制化的容器管理，例如在容器停止前完成业务排水等操作。操作以无状态应用为例，其他类型负载（有状态应用、守护进程集等）流程可参考。

一、前提条件

• 已获取MCE容器引擎系统登录权限，且具备目标应用所在命名空间的编辑权限；
• 明确容器生命周期各阶段的定制化需求，提前规划好需执行的命令、参数或请求配置；
• 若应用处于运行状态，修改生命周期配置后会触发容器重启，建议在业务低峰期操作。

二、进入生命周期配置页面

请按以下明确路径进入目标应用的容器生命周期配置页面：

• 登录系统后，在系统主界面选择【MCE容器引擎】模块，点击进入；
• 进入MCE容器引擎后，在左侧导航菜单中依次点击【容器云服务】→对应应用类型（如无状态应用/有状态应用），进入应用列表页面；
• 在应用列表中，找到需要配置生命周期的目标应用，点击其名称进入应用详情页面；
• 在详情页面的选项卡区域，找到并点击【更新升级】中更多设置，在展开的配置模块中定位到【生命周期】配置项，即可进入生命周期配置界面，界面参考如下：

三、核心配置项说明与操作步骤

容器生命周期配置主要包含运行命令、运行参数、启动后处理、停止前处理四个核心配置项，其中启动后处理和停止前处理支持命令方式和HttpGet请求方式，具体配置说明如下：

（一）运行命令

运行命令即容器的启动命令，容器将以该命令启动。若不配置，容器运行时将执行镜像制作时默认的启动命令（对应Docker镜像元数据中的“Entrypoint”字段）。

配置步骤：

• 在生命周期配置界面的「运行命令」输入框中，填写容器启动时需执行的命令（例如“/bin/bash”“java”等）；
• 命令需符合容器内操作系统的语法规范，确保容器内存在该命令对应的可执行文件；
• 配置完成后，点击输入框右侧的【确认】或【保存】按钮暂存配置。

（二）运行参数

运行参数是启动命令的补充参数，与运行命令配合使用。若不配置，将使用Docker镜像默认的启动参数（对应Docker镜像元数据中的“CMD”字段）。关于Entrypoint和CMD的详细关联规则，可参考Docker官方文档。

配置步骤：

• 在「运行参数」输入框中，填写与启动命令对应的参数（多个参数以空格分隔，例如“-jar app.jar –port=8080”）；
• 确保参数与运行命令匹配，符合命令的参数语法要求；
• 配置完成后，点击【确认】或【保存】按钮暂存配置。

（三）启动后处理

启动后处理为容器启动后触发的钩子函数，支持通过命令方式或HttpGet请求方式执行定制化操作，用于容器启动完成后的初始化准备。

1. 命令方式配置

• 在「启动后处理」模块中，选择“命令方式”；
• 在命令输入框中，填写容器启动后需执行的命令（例如“sh /init.sh”，用于执行初始化脚本）；
• 确认命令可在容器内正常执行，若涉及脚本文件，需确保该脚本已存在于容器内且具备可执行权限；
• 配置完成后，点击【确认】暂存配置。

2. HttpGet请求方式配置

• 在「启动后处理」模块中，选择“HttpGet请求方式”；
• 填写请求参数：
  • 协议：选择http或https（根据目标服务的协议类型选择）；
  • 主机：填写目标服务的主机地址（容器内可访问，例如“localhost”“127.0.0.1”或容器内服务名称）；
  • 端口：填写目标服务的端口号（例如8080）；
  • 路径：填写具体的请求路径（例如“/health/check”，用于校验服务启动状态）；
  • 请求头（可选）：若需自定义请求头，点击【添加请求头】，填写头名称和头值。
• 确保配置的HttpGet请求可正常访问，避免因请求失败导致容器启动后处理异常；
• 配置完成后，点击【确认】暂存配置。

（四）停止前处理

停止前处理为容器停止前触发的钩子函数，支持命令方式和HttpGet请求方式，核心作用是确保应用升级或实例删除时，可提前将实例中运行的业务排水（例如终止用户连接、保存业务数据、告知注册中心下线等），保障业务连续性。

1. 命令方式配置

• 在「停止前处理」模块中，选择“命令方式”；
• 在命令输入框中，填写容器停止前需执行的业务排水命令（例如“sh /drain.sh”，用于执行业务下线脚本）；
• 确保命令执行逻辑完整，预留充足的业务排水时间，避免因命令执行超时或失败影响容器正常停止；
• 配置完成后，点击【确认】暂存配置。

2. HttpGet请求方式配置

• 在「停止前处理」模块中，选择“HttpGet请求方式”；
• 填写请求参数：
  • 协议：选择http或https；
  • 主机：填写目标服务的可访问主机地址；
  • 端口：填写目标服务的端口号；
  • 路径：填写业务排水对应的请求路径（例如“/service/offline”，用于触发服务下线流程）；
  • 请求头（可选）：根据服务要求添加自定义请求头。
• 确保HttpGet请求对应的服务接口可正常响应，且能正确执行业务排水逻辑；
• 配置完成后，点击【确认】暂存配置。

四、完成配置提交

• 所有生命周期配置项暂存完成后，返回上级配置界面，仔细核对运行命令、运行参数、启动后处理、停止前处理的配置信息，确保无语法错误或参数遗漏；
• 核对无误后，点击页面底部的【提交】或【确认修改】按钮，提交生命周期配置变更；
• 系统将校验配置的合法性，若校验通过，将触发应用容器重启以加载新的生命周期配置；若校验失败（如命令无效、HttpGet参数不完整等），需根据提示修正后重新提交；
• 提交完成后，返回应用详情页面，查看应用状态，确保容器重启后正常运行；可通过查看容器日志，验证生命周期各阶段的配置是否正常执行。

五、注意事项

• 生命周期配置修改后容器会自动重启，需提前评估对业务的影响，建议在业务低峰期操作；
• 运行命令和参数需与容器内环境匹配，若不熟悉镜像默认的Entrypoint和CMD，建议先通过容器终端执行相关命令验证可行性；
• 启动后处理和停止前处理的命令执行时长存在限制，避免配置耗时过长的操作，否则可能被系统强制终止；
• 使用HttpGet请求方式时，需确保目标服务在容器内可正常访问，请求路径、端口等参数准确无误，避免因请求失败导致钩子函数执行异常；
• 停止前处理的核心目的是业务排水，配置时需优先保障业务数据安全和连接正常终止，建议提前测试排水逻辑的有效性；
• 若容器启动后因生命周期配置异常（如命令错误）无法正常运行，可通过编辑应用配置，删除或修正生命周期相关配置后重新提交。