# 从容器镜像中导入模型文件创建模型 针对ModelArts目前不支持的AI引擎，您可以通过自定义镜像的方式将编写的模型导入ModelArts。 #### 约束与限制 - 关于自定义镜像规范和说明，请参见[模型镜像规范](https://support.huaweicloud.com/usermanual-standard-modelarts/modelarts_23_0219.html#section2)。 - 使用容器化部署，导入的元模型有大小限制，详情请参见[导入模型对于镜像大小限制](https://support.huaweicloud.com/modelarts_faq/modelarts_13_0211.html)。 - 当自定义镜像更新以后，需要同步更新镜像版本号，或者使用该镜像创建模型时打开镜像复制功能，否则会存在使用新创建的模型部署在线服务时使用的还是旧版本镜像的情况。 #### 前提条件 确保您使用的OBS目录与ModelArts在同一区域。 #### 创建模型操作步骤 1. 登录[ModelArts管理控制台](https://console.huaweicloud.com/modelarts/)，在左侧导航栏中选择"模型管理"，进入模型列表页面。 2. 单击左上角的"创建模型"，进入"创建模型"页面。 3. 在"创建应用"页面，填写相关参数。 1. 填写模型基本信息，详细参数说明请参见[表1]。 表1模型基本信息参数说明 | 参数名称 | 说明 | |:---|:---| | 名称 | 模型名称。支持1～64位可见字符（含中文），名称可以包含字母、中文、数字、中划线、下划线。 | | 版本 | 设置所创建模型的版本。第一次导入时，默认为0.0.1。 说明： 模型创建完成后，可以通过[创建新版本](https://support.huaweicloud.com/usermanual-standard-modelarts/inference-modelarts-0013.html#ZH-CN_TOPIC_0000001952663282__zh-cn_topic_0171858290_section102881451161111)，导入不同的元模型进行调优。 | | 描述 | 模型的简要描述。 | 2. 填写元模型来源及其相关参数。当"元模型来源"选择"从容器镜像中选择"时，其相关的参数配置请参见[表2]。 图1从容器镜像中选择模型 ![](https://support.huaweicloud.com/usermanual-standard-modelarts/figure/zh-cn_image_0000002088568785.png "点击放大") 表2元模型来源参数说明 | 参数 | 说明 | |:---|:---| | "容器镜像所在的路径" | 单击![](https://support.huaweicloud.com/usermanual-standard-modelarts/figure/zh-cn_image_0000001986022933.png)从容器镜像中导入模型的镜像，其中，模型均为Image类型，且不再需要用配置文件中的"swr_location"来指定您的镜像位置。 制作自定义镜像的操作指导及规范要求，请参见[模型镜像规范](https://support.huaweicloud.com/usermanual-standard-modelarts/modelarts_23_0219.html#section2)。 说明： 您选择的模型镜像将共享给系统管理员，请确保具备共享该镜像的权限（不支持导入其他账户共享给您的镜像），部署上线时，ModelArts将使用该镜像部署成推理服务，请确保您的镜像能正常启动并提供推理接口。 | | "容器调用接口" | 模型提供的推理接口所使用的协议和端口号，请根据模型实际定义的推理接口进行配置。 | | "镜像复制" | 镜像复制开关，选择是否将容器镜像中的模型镜像复制到ModelArts中。 - 关闭时，表示不复制模型镜像，可极速创建模型，更改或删除SWR源目录中的镜像会影响服务部署。 - 开启时，表示复制模型镜像，无法极速创建模型，SWR源目录中的镜像更改或删除不影响服务部署。 说明： 如果使用他人共享的镜像，需要开启镜像复制功能，否则会导致创建模型失败。 | | "健康检查" | 用于指定模型的健康检查。仅当自定义镜像中配置了健康检查接口，才能配置"健康检查"，否则会导致模型创建失败。当前支持以下三种探针： - **启动探针：**用于检测应用实例是否已经启动。如果提供了启动探针(startup probe)，则禁用所有其他探针，直到它成功为止。如果启动探针失败，将会重启实例。如果没有提供启动探针，则默认状态为成功Success。 - **就绪探针：**用于检测应用实例是否已经准备好接收流量。如果就绪探针失败，即实例未准备好，会从服务负载均衡的池中剔除该实例，不会将流量路由到该实例，直到探测成功。 - **存活探针：**用于检测应用实例内应用程序的健康状态。如果存活探针失败，即应用程序不健康，将会自动重启实例。 3种探针的配置参数均为： - **检查方式：**可以选择"HTTP请求检查"或者"执行命令检查"。 - **健康检查URL**："检查方式"选择"HTTP请求检查"时显示，填写健康检查的URL，默认值为"/health"。 - **健康检查命令：**"检查方式"选择"执行命令检查"时显示，填写健康检查的命令。 - **健康检查周期（秒）**：填写1-2147483647之前的整数，单位为秒。 - **延迟时间（秒）：**实例启动后，延迟执行健康检查的时间。填写0-2147483647之间的整数，单位为秒，不能为空。 - **超时时间 （秒）：** 每次检查的超时时间，填写0-2147483647之间的整数，单位为秒。 - **最大失败次数**：填写1-2147483647之间的整数。在服务启动阶段，当健康检查请求连续失败达到所填次数后，服务会进入异常状态；在服务运行阶段，当健康检查请求连续失败达到所填次数后，服务会进入告警状态。 说明： 当模型配置了健康检查，部署的服务在收到停止指令后，会延后3分钟才停止。 | | "模型说明" | 为了帮助其他模型开发者更好的理解及使用您的模型，建议您提供模型的说明文档。单击"添加模型说明"，设置"文档名称"及其"URL"。模型说明支持增加3条。 | | "部署类型" | 选择此模型支持部署服务的类型，部署上线时只支持部署为此处选择的部署类型，例如此处只选择在线服务，那您导入后只能部署为在线服务。当前支持"在线服务"、"批量服务"和"边缘服务"。 | | "启动命令" | 指定模型的启动命令，您可以自定义该命令。启动命令设置的路径必须与镜像实际路径一致。 说明： 包含字符$，\|，\>，\<，\`，!，\\n，\\，?，-v，--volume，--mount，--tmpfs，--privileged，--cap-add的启动命令，在模型发布时将会置空。 | | "apis定义" | 提供模型对外RESTful api数据定义，用于定义模型的输入、输出格式。apis定义填写规范请参见[模型配置文件编写说明](https://support.huaweicloud.com/usermanual-standard-modelarts/inference-modelarts-0056.html)中的apis参数说明，示例代码请参见[apis参数代码示例](https://support.huaweicloud.com/usermanual-standard-modelarts/inference-modelarts-0056.html#ZH-CN_TOPIC_0000001845554738__section9498141310396)。 | 3. 确认信息填写无误，单击"立即创建"，完成模型创建。 在模型列表中，您可以查看刚创建的模型及其对应的版本。当模型状态变更为"正常"时，表示模型创建成功。在此页面，您还可以进行创建新版本、快速部署服务、发布模型等操作。 #### 后续操作 **[部署服务](https://support.huaweicloud.com/usermanual-standard-modelarts/inference-modelarts-0016.html)**：在"模型列表"中，单击模型的操作列的"部署"，在对应版本所在行，单击"操作"列的部署按钮，可以将模型部署上线为创建模型时所选择的部署类型。