从OBS中导入AI应用文件创建模型

约束与限制

• 针对创建AI应用的模型，需符合ModelArts的模型包规范，推理代码和配置文件也需遵循ModelArts的要求，详细说明请参见模型包结构介绍、模型配置文件编写说明、模型推理代码编写说明。
• 使用容器化部署，导入的元模型有大小限制，详情请参见导入AI应用对于镜像大小限制。

前提条件

• 已完成模型开发和训练，使用的AI引擎为ModelArts支持的类型和版本，详细请参见推理支持的AI引擎。
• 已完成训练的模型包，及其对应的推理代码和配置文件，且已上传至OBS目录中。
• 确保您使用的OBS与ModelArts在同一区域。

创建AI应用操作步骤

1. 登录ModelArts管理控制台，在左侧导航栏中选择“AI应用”，进入AI应用列表页面。
2. 单击左上角的“创建应用”，进入“创建应用”页面。
3. 在“创建应用”页面，填写相关参数。
   1. 填写AI应用基本信息，详细参数说明请参见表1。

      表1 AI应用基本信息参数说明

      参数名称	说明
      名称	AI应用名称。支持1～64位可见字符（含中文），名称可以包含字母、中文、数字、中划线、下划线。
      版本	设置所创建AI应用的版本。第一次导入时，默认为0.0.1。 说明： AI应用创建完成后，可以通过创建新版本，导入不同的元模型进行调优。
      描述	AI应用的简要描述。

   2. 填写元模型来源及其相关参数。当“元模型来源”选择“从对象存储服务（OBS）中选择”时，其相关的参数配置请参见表2。

      针对从OBS导入的元模型，ModelArts要求根据模型包规范，编写推理代码和配置文件，并将推理代码和配置文件放置元模型存储的“model”文件夹下。如果您选择的目录下不符合模型包规范，将无法创建AI应用。

      图1 从OBS中选择元模型
      

      表2 元模型来源参数说明

      参数	说明
      “选择元模型”	选择元模型存储的OBS路径。 OBS路径不能含有空格，否则创建AI应用会失败。
      “AI引擎”	根据您选择的元模型存储路径，将自动关联出元模型使用的“AI引擎”。 如果“AI引擎”是Custom引擎时，需要配置容器调用接口，用于指定模型启动的协议和端口号。请求协议和端口号的缺省值是HTTPS和8080，端口和协议需要根据用户模型实际使用情况自行配置。
      “容器调用接口”	模型提供的推理接口所使用的协议和端口号，需要根据模型实际定义的推理接口进行配置。 说明： AI引擎选择Custom引擎时才会显示该参数，ModelArts提供的请求协议和端口号的缺省值是HTTPS和8080，端口和协议需要根据用户模型实际使用情况自行配置。
      “健康检查”	用于指定模型的健康检查。使用Custom引擎时，会显示该参数。使用非Custom引擎时，选择了“AI引擎”和“运行环境”后，部分支持健康检查的引擎会显示该参数，请以实际界面显示为准。 当使用Custom引擎时，引擎包需要选择容器镜像，仅当容器镜像中配置了健康检查接口，才能配置“健康检查”，否则会导致AI应用创建失败。 当前支持以下三种探针： 启动探针：用于检测应用实例是否已经启动。如果提供了启动探针(startup probe)，则禁用所有其他探针，直到它成功为止。如果启动探针失败，将会重启实例。如果没有提供启动探针，则默认状态为成功Success。 就绪探针：用于检测应用实例是否已经准备好接收流量。如果就绪探针失败，即实例未准备好，会从服务负载均衡的池中剔除该实例，不会将流量路由到该实例，直到探测成功。 存活探针：用于检测应用实例内应用程序的健康状态。如果存活探针失败，即应用程序不健康，将会自动重启实例。 3种探针的配置参数均为： 检查方式：仅支持“HTTP请求检查”。 健康检查URL：健康检查的URL固定为“/health”。 健康检查周期（秒）：填写1-2147483647之前的整数，单位为秒。 延迟时间（秒）：实例启动后，延迟执行健康检查的时间。填写0-2147483647之间的整数，单位为秒，不能为空。 超时时间 （秒）： 每次检查的超时时间，填写0-2147483647之间的整数，单位为秒。 最大失败次数：填写1-2147483647之间的整数。在服务启动阶段，当健康检查请求连续失败达到所填次数后，服务会进入异常状态；在服务运行阶段，当健康检查请求连续失败达到所填次数后，服务会进入告警状态。 说明： 使用Custom引擎时需要符合自定义引擎规范，请参见使用自定义引擎创建AI应用。 当AI应用配置了健康检查，部署的服务在收到停止指令后，会延后3分钟才停止。
      “动态加载”	用于实现快速部署和快速更新模型。如果勾选“动态加载”，则模型文件和运行时依赖仅在实际部署时拉取。单个模型文件大小超过5GB，需要配置“动态加载”。
      “运行时依赖”	罗列选中模型对环境的依赖。例如依赖“tensorflow”，安装方式为“pip”，其版本必须为1.8.0及以上版本。
      “AI应用说明”	为了帮助其他AI应用开发者更好的理解及使用您的AI应用，建议您提供AI应用的说明文档。单击“添加AI应用说明”，设置“文档名称”及其“URL”。AI应用说明支持增加3条。
      “配置文件”	系统默认关联您存储在OBS中的配置文件。打开开关，您可以直接在当前界面查看或编辑模型配置文件。 说明： 该功能即将下线，后续请根据“AI引擎”、“运行时依赖”和“apis定义”修改模型的配置信息。
      “部署类型”	选择此AI应用支持部署服务的类型，部署上线时只支持部署为此处选择的部署类型，例如此处只选择在线服务，那您导入后只能部署为在线服务。当前支持“在线服务”、“批量服务”和“边缘服务”。
      “启动命令”	选填参数，指定模型的启动命令，您可以自定义该命令。 如果使用预置的AI引擎，如果启动命令没有填写，会使用默认的启动命令，默认的启动命令见表1。如果填写了启动命令，新填写的启动命令覆盖默认启动命令。 说明： 包含字符$，|，>，<，`，!，\n，\，?，-v，--volume，--mount，--tmpfs，--privileged，--cap-add的启动命令，在AI应用发布时将会置空。
      “apis定义”	提供AI应用对外Restfull api数据定义，用于定义AI应用的输入、输出格式。apis定义填写规范请参见模型配置文件编写说明中的apis参数说明，示例代码请参见apis参数代码示例。

   3. 确认信息填写无误，单击“立即创建”，完成AI应用创建。

      在AI应用列表中，您可以查看刚创建的AI应用及其对应的版本。当AI应用状态变更为“正常”时，表示AI应用创建成功。在此页面，您还可以创建新版本、快速部署服务、发布AI应用等操作。

后续操作

部署服务：在“AI应用列表”中，单击AI应用的操作列的“部署”，在对应版本所在行，单击“操作”列的部署按钮，可以将AI应用部署上线为创建AI应用时所选择的部署类型。