カスタムイメージリソースのデタッチとクリーンアップ - Amazon SageMaker AI

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

カスタムイメージリソースのデタッチとクリーンアップ

次のページでは、Amazon SageMaker AI コンソールまたは AWS Command Line Interface () を使用してカスタムイメージをデタッチし、関連リソースをクリーンアップする方法について説明しますAWS CLI。

重要

SageMaker AI イメージストアからイメージを削除する前に、まずドメインからカスタムイメージをデタッチする必要があります。そうしないと、ドメイン情報の表示時やドメインへの新しいカスタムイメージのアタッチ時にエラーが発生する可能性があります。

カスタムイメージのロードでエラーが発生した場合は、「」を参照してくださいカスタムイメージのロードの失敗

コンソールを使用して SageMaker AI からカスタムイメージをデタッチし、カスタムイメージリソースをクリーンアップする方法について説明します。

ドメインからカスタムイメージをデタッチする
  1. SageMaker AI コンソールを開きます。

  2. 管理者設定セクションを展開します。

  3. [管理設定] で、[ドメイン] を選択します。

  4. [ドメイン] リストで、ドメインを選択します。

  5. [環境] タブを開きます。

  6. 個人用 Studio アプリのカスタムイメージでは、デタッチするイメージのチェックボックスをオンにします。

  7. [デタッチ] を選択します。

  8. 手順に従ってデタッチします。

カスタムイメージを削除する
  1. SageMaker AI コンソールを開きます。

  2. 管理者設定セクションを展開していない場合は、展開します。

  3. [管理設定][イメージ] を選択します。

  4. イメージのリストから、削除するイメージを選択します。

  5. [削除] を選択します。

  6. 手順に従って、SageMaker AI からイメージとそのすべてのバージョンを削除します。

Amazon ECR からカスタムイメージとリポジトリを削除する
重要

これにより、このリポジトリ内のコンテナイメージとアーティファクトも削除されます。

  1. Amazon ECR コンソールを開きます。

  2. まだ行っていない場合は、左側のナビゲーションペインを展開します。

  3. プライベートレジストリで、リポジトリを選択します。

  4. 削除するリポジトリを選択します。

  5. [削除] を選択します。

  6. 手順に従って削除します。

次のセクションでは、 を使用してカスタムイメージをデタッチする方法の例を示します AWS CLI。

  1. まず、以下の AWS CLI コマンドの変数を設定します。

    ACCOUNT_ID=account-id REGION=aws-region APP_IMAGE_CONFIG=app-image-config SAGEMAKER_IMAGE_NAME=custom-image-name
    • aws-region は、Amazon SageMaker AI ドメイン AWS リージョン の です。これは、 AWS コンソールページの右上にあります。

    • app-image-config はアプリケーションイメージ設定の名前です。次の AWS CLI コマンドを使用して、 のアプリケーションイメージ設定を一覧表示します AWS リージョン。

      aws sagemaker list-app-image-configs \ --region ${REGION}
    • custom-image-name はカスタムイメージ名です。次の AWS CLI コマンドを使用して、 内のイメージを一覧表示します AWS リージョン。

      aws sagemaker list-images \ --region ${REGION}
  2. これらの手順に従ってイメージとイメージバージョンをドメインからデタッチするには、ドメイン設定 json ファイルを作成または更新する必要があります。

    注記

    「」の手順に従った場合はカスタムイメージをドメインにアタッチする、 という名前のファイルを使用してドメインを更新した可能性がありますupdate-domain.json

    そのファイルがない場合は、代わりに新しい json ファイルを作成できます。

    ドメインの更新に使用する update-domain.json という名前のファイルを作成します。

  3. カスタムイメージを削除するには、 のようにCustomImages空白のままにする必要があります"CustomImages": []。Code Editor または JupyterLab の設定ファイルの例を表示するには、次のいずれかを選択します。

    Code Editor: update domain configuration file example

    を使用した Code Editor の設定ファイルの例CodeEditorAppSettings

    { "DomainId": "domain-id", "DefaultUserSettings": { "CodeEditorAppSettings": { "CustomImages": [ ] } } }
    JupyterLab: update domain configuration file example

    を使用した JupyterLab の設定ファイルの例JupyterLabAppSettings

    { "DomainId": "domain-id", "DefaultUserSettings": { "JupyterLabAppSettings": { "CustomImages": [ ] } } }

    domain-id は、イメージがアタッチされているドメイン ID です。ドメインを一覧表示するには、次のコマンドを使用します。

    aws sagemaker list-domains \ --region ${REGION}
  4. ファイルを保存します。

  5. 更新ドメイン設定ファイル を使用して update-domain AWS CLI を呼び出しますupdate-domain.json

    注記

    カスタムイメージを更新する前に、ドメイン内のすべてのアプリケーションを削除する必要があります。ユーザープロファイルや共有スペースを削除する必要はありません。アプリケーションを削除する手順については、次のいずれかのオプションを選択します。

    aws sagemaker update-domain \ --cli-input-json file://update-domain.json \ --region ${REGION}
  6. アプリケーションイメージ構成を削除します。

    aws sagemaker delete-app-image-config \ --app-image-config-name ${APP_IMAGE_CONFIG}
  7. カスタムイメージを削除します。これにより、すべてのイメージバージョンも削除されます。これにより、Amazon ECR コンテナイメージとイメージバージョンは削除されません。これを行うには、以下のオプションのステップを使用します。

    aws sagemaker delete-image \ --image-name ${SAGEMAKER_IMAGE_NAME}
  8. (オプション) Amazon ECR リソースを削除します。次のリストは、以下の手順の Amazon ECR リソース情報を取得するための AWS CLI コマンドを示しています。

    1. 以下の AWS CLI コマンドの変数を設定します。

      ECR_REPO_NAME=ecr-repository-name

      ecr-repository-name は、Amazon Elastic Container Registry リポジトリの名前です。

      リポジトリの詳細を一覧表示するには、次のコマンドを使用します。

      aws ecr describe-repositories \ --region ${REGION}
    2. Amazon ECR からリポジトリを削除します。

      重要

      これにより、このリポジトリ内のコンテナイメージとアーティファクトも削除されます。

      aws ecr delete-repository \ --repository-name ${ECR_REPO_NAME} \ --force \ --region ${REGION}