Help Center/ ModelArts/ Docker Containers with ModelArts/ Using Custom Images in Notebook Instances/ Saving a Notebook Instance as a Custom Image/ Saving a Notebook Environment Image
Updated on 2024-06-12 GMT+08:00
View PDF

Saving a Notebook Environment Image

To save a notebook environment image, do as follows: Create a notebook instance using a preset image, install custom software and dependencies on the base image, and save the running instance as a container image.

In the saved image, the installed dependencies are retained. The data stored in home/ma-user/work for persistent storage will not be stored. When you use VS Code for remote development, the plug-ins installed on the Server are retained.

Images stored in a notebook instance cannot be larger than 25 GB and there cannot be more than 125 image layers. Otherwise, the image cannot be created.

If error "The container size (xx) is greater than the threshold (25G)" is reported when an image is saved, handle the error by referring to What Do I Do If Error "The container size (xG) is greater than the threshold (25G)" Is Displayed When I Save an Image?

Prerequisites

The notebook instance is in Running state.

Saving an Image

  1. Log in to the ModelArts management console and choose DevEnviron > Notebook in the navigation pane on the left to switch to notebook of the new version.
  2. In the notebook instance list, select the target notebook instance and choose Save Image from the More drop-down list in the Operation column. The Save Image dialog box is displayed.
    Figure 1 Save Image
  3. In the Save Image dialog box, configure parameters. Click OK to save the image.
    Figure 2 Configuring image parameters

    Choose an organization from the Organization drop-down list. If no organization is available, click Create on the right to create one.

    Users in an organization can share all images in the organization.

  4. The image will be saved as a snapshot, and it will take about 5 minutes. During this period of time, do not perform any operations on the instance.
    Figure 3 Saving as a snapshot

    The time required for saving an image as a snapshot will be counted in the instance running duration. If the instance running duration expires before the snapshot is saved, saving the image will fail.

  5. After the image is saved, the instance status changes to Running. View the image on the Image Management page.
  6. Click the name of the image to view its details.