Help Center/ ModelArts/ Model Inference/ Managing AI Applications/ Creating an AI Application/ Importing a Meta Model from a Container Image
Updated on 2024-04-30 GMT+08:00

Importing a Meta Model from a Container Image

For AI engines that are not supported by ModelArts, you can import the models you compile to ModelArts from custom images.

Constraints

Prerequisites

The OBS directory you use and ModelArts are in the same region.

Creating an AI Application

  1. Log in to the ModelArts management console, and choose AI Application Management > AI Applications in the left navigation pane. The AI Applications page is displayed.
  2. Click Create in the upper left corner.
  3. On the displayed page, set the parameters.
    1. Set basic information about the AI application. For details about the parameters, see Table 1.
      Table 1 Parameters of basic AI application information

      Parameter

      Description

      Name

      Application name. The value can contain 1 to 64 visible characters. Only letters, digits, hyphens (-), and underscores (_) are allowed.

      Version

      Version of the AI application to be created. For the first import, the default value is 0.0.1.

      NOTE:

      After an AI application is created, you can create new versions using different meta models for optimization.

      Description

      Brief description of an AI application

    2. Select the meta model source and set related parameters. Set Meta Model Source to Container image. For details about the parameters, see Table 2.
      Figure 1 Setting a container image as the meta model source
      Table 2 Parameters of the meta model source

      Parameter

      Description

      Container Image Path

      Click to import the model image from the container image. The model is of the Image type, and you do not need to use swr_location in the configuration file to specify the image location.

      For details about operation guidance and requirements for creating a custom image, see Custom Image Specifications for Creating AI Applications.

      NOTE:

      The model image you select will be shared with the system administrator, so ensure you have the permission to share the image (images shared with other accounts are not supported). When you deploy a service, ModelArts deploys the image as an inference service. Ensure that your image can be properly started and provide an inference API.

      Container API

      Protocol and port number for starting an AI application

      NOTE:

      The default request protocol and port number provided by ModelArts are HTTP and 8080, respectively. Set them based on the actual custom image.

      Image Replication

      Indicates whether to copy the model image in the container image to ModelArts.

      • When this function is disabled, the model image is not copied, AI applications can be created quickly, but modifying or deleting images in the source directory of SWR may affect service deployment.
      • When this function is enabled, the model image is copied, AI applications cannot be created quickly, but you can modify or delete images in the source directory of SWR as that would not affect service deployment.
      NOTE:

      You must enable this function if you want to use images shared by others. Otherwise, AI applications will fail to be created.

      Health Check

      Health check on an AI application. This parameter is configurable only when the health check API is configured in the custom image. Otherwise, the AI application deployment will fail.

      • Check Mode: Select HTTP request or Command.
      • Health Check URL: This parameter is displayed when Check Mode is set to HTTP request. Enter the health check URL. The default value is /health.
      • Health Check Command: This parameter is displayed when Check Mode is set to Command. Enter the health check command.
      • Health Check Period: Enter an integer ranging from 1 to 2147483647. The unit is second.
      • Delay( seconds ): specifies the delay for performing the health check after the instance is started. Enter an integer ranging from 0 to 2147483647.
      • Maximum Failures: Enter an integer ranging from 1 to 2147483647. During service startup, if the number of consecutive health check failures reaches the specified value, the service will be abnormal. During service running, if the number of consecutive health check failures reaches the specified value, the service will enter the alarm status.
      NOTE:

      If health check is configured for an AI application, the deployed services using this AI application will stop 3 minutes after receiving the stop instruction.

      AI Application Description

      Provide AI application descriptions to help other AI application developers better understand and use your applications. Click Add AI Application Description and set the Document name and URL. You can add up to three AI application descriptions.

      Deployment Type

      Select the service types that the application can be deployed. When deploying a service, only the service types selected here are available. For example, if you only select Real-time services here, you can only deploy the AI application as a real-time service after it is created.

      Start command

      Customizable start command of a model

      Apis

      When you enable this function, you can edit RESTful APIs to define the AI application input and output formats. The model APIs must comply with ModelArts specifications. For details, see Specifications for Editing a Model Configuration File. For details about the code example, see Code Example of apis Parameters.

    3. Check the information and click Next. The AI application is created.

      In the AI application list, you can view the created AI application and its version. When the status changes to Normal, the AI application is successfully created. On this page, you can perform such operations as creating new versions and quickly deploying services.

Follow-Up Procedure

Deploying an AI Application as a Service: In the AI application list, click the option button on the left of the AI application name to display the version list at the bottom of the list page. Locate the row that contains the target version, click Deploy in the Operation column to deploy the AI application as a deployment type selected during AI application creation.