Managing Images

Obtaining an Image Pull Address

1. Log in to ServiceStage.
2. Choose Deployment Source Management > Image Repository > My Images.
3. Select an organization from the drop-down list on the right of Org Management.
4. In the image repository list, click an image repository name to go to the details page.
5. Click the Image Tags tab and obtain the command for pulling an image.

   Click on the right of the command of the image version to be downloaded to copy the command.

Setting Image Repository Attributes

1. Log in to ServiceStage.
2. Choose Deployment Source Management > Image Repository > My Images.
3. Select an organization from the drop-down list on the right of Org Management.
4. In the image repository list, click an image repository name to go to the details page.
5. Click Edit in the upper-right corner. In the displayed dialog box, perform the following operations:
   • Set Sharing Type to Public or Private.
     

     Public images can be downloaded and used by all users.

     • If your node and the image repository are in the same region, you can access the image repository over private networks.
     • If your node and the image repository are in different regions, the node must have access to public networks to pull images from the image repository.
   • Set Category to set the repository category.
   • Set Description to update the description of the image repository.

6. Click OK.

Sharing a Private Image

You can share your private images with other users and grant the users access permissions.

Only administrator and Identity and Access Management (IAM) users authorized to manage the private image can share the image. The users with whom you share the image only have the read permission. That is, they can only pull the image.

1. Log in to ServiceStage and choose Deployment Source Management > Image Repository > My Images.
2. Select an organization from the drop-down list on the right of Org Management.
3. In the image repository list, click an image repository name to go to the details page.
4. Click the Sharing tab, click Share Image, and set the following parameters:
   1. Share With: Enter an account name.
   2. Valid Until: Set the expiration date. If you want the image to be permanently accessible to the account, select Permanently valid.
   3. Description: Enter the description.
   4. Permission: Select the permission. Currently, only the Download permission is supported.

5. Click OK.
   • You can view all shared images in the shared image list.
   • Select an account name and click Edit in the Operation column to edit the parameters of the shared image.
   • Select an account name and click Delete in the Operation column to cancel sharing.

Setting Automatic Image Synchronization

If image synchronization is enabled, the latest images are automatically synchronized to image repositories in other regions. Only accounts and users with administrator permissions can configure automatic image synchronization.

After you configure automatic image synchronization, image updates will also be synchronized to target repositories. However, images that were pushed to repositories before automatic image synchronization was enabled will not be automatically synchronized.

For details on how to synchronize images pushed before you set the automatic synchronization, see Can Existing Images be Automatically Synchronized.

1. Log in to ServiceStage and choose Deployment Source Management > Image Repository > My Images.
2. Select an organization from the drop-down list on the right of Org Management.
3. In the image repository list, click an image repository name to go to the details page.
4. Click Set Image Synchronization in the upper-right corner.
5. In the displayed dialog box, click Add, set the following parameters, and click OK in the Operation column.
   • Target Region: Select the target region for synchronization.
   • Target Organization: Select the target organization for synchronization.
   • Overwrite Existing Image: Select this option if you want to overwrite any nonidentical images that have the same name in the target organization. Deselect this option if you do not want any nonidentical images having the same name in the target organization to be overwritten and you want to receive a notification of the existence of such images.

6. Click OK.

   On the Synchronization Records tab of image details page, you can view the details of each synchronization task, including the start time, image tag, task status, type, duration, target region and organization, and task operator.

Adding Image Permissions

To allow IAM users of your account to read, write, and manage a specific image, add the required permissions to the IAM users on the details page of this image.

1. Log in to ServiceStage and choose Deployment Source Management > Image Repository > My Images.
2. Select an organization from the drop-down list on the right of Org Management.
3. In the image repository list, click an image repository name to go to the details page.
4. Click the Permission Management tab, click Add Permission, select an IAM user, add the Read, Write, or Manage permission, and click OK.

   Then, this IAM user has the corresponding permission.

Deleting an Image

After an image is deleted, the image repository and its image packages cannot be selected when Creating and Deploying a Component, Upgrading a Single Component, Upgrading Components in Batches, or Cloning Components in Batches.

1. Log in to ServiceStage and choose Deployment Source Management > Image Repository > My Images.
2. Select an organization from the drop-down list on the right of Org Management.
3. In the image repository list, click an image repository name to go to the details page.
   • Deleting an image repository

     Click Delete in the upper-right corner of the page and delete the image repository as prompted.

   • Deleting an image tag

     In the Operation column of the target image tag, click Delete to delete the image tag as prompted.

   • Deleting image tags in batches

     Select the target image tags, click Delete above the tag list, and delete the image tags as prompted.