Lampirkan gambar SageMaker AI ke domain Lampirkan gambar SageMaker AI ke ruang bersama Lihat gambar terlampir

Lampirkan gambar SageMaker AI khusus

penting

Kebijakan IAM khusus yang memungkinkan Amazon SageMaker Studio atau Amazon SageMaker Studio Classic membuat SageMaker sumber daya Amazon juga harus memberikan izin untuk menambahkan tag ke sumber daya tersebut. Izin untuk menambahkan tag ke sumber daya diperlukan karena Studio dan Studio Classic secara otomatis menandai sumber daya apa pun yang mereka buat. Jika kebijakan IAM memungkinkan Studio dan Studio Classic membuat sumber daya tetapi tidak mengizinkan penandaan, kesalahan "AccessDenied" dapat terjadi saat mencoba membuat sumber daya. Untuk informasi selengkapnya, lihat Berikan izin untuk menandai sumber daya AI SageMaker .

AWS kebijakan terkelola untuk Amazon SageMaker AIyang memberikan izin untuk membuat SageMaker sumber daya sudah menyertakan izin untuk menambahkan tag saat membuat sumber daya tersebut.

penting

Per 30 November 2023, pengalaman Amazon SageMaker Studio sebelumnya sekarang bernama Amazon SageMaker Studio Classic. Bagian berikut khusus untuk menggunakan aplikasi Studio Classic. Untuk informasi tentang menggunakan pengalaman Studio yang diperbarui, lihat SageMaker Studio Amazon.

Untuk menggunakan gambar SageMaker AI kustom, Anda harus melampirkan versi gambar ke domain atau ruang bersama Anda. Saat Anda melampirkan versi gambar, itu akan muncul di SageMaker Studio Classic Launcher dan tersedia di daftar tarik-turun Pilih gambar, yang digunakan pengguna untuk meluncurkan aktivitas atau mengubah gambar yang digunakan oleh buku catatan.

Untuk membuat gambar SageMaker AI kustom tersedia untuk semua pengguna dalam domain, Anda melampirkan gambar ke domain. Untuk membuat gambar tersedia bagi semua pengguna dalam ruang bersama, Anda dapat melampirkan gambar ke ruang bersama. Untuk membuat gambar tersedia untuk satu pengguna, Anda melampirkan gambar ke profil pengguna. Saat Anda melampirkan gambar, SageMaker AI menggunakan versi gambar terbaru secara default. Anda juga dapat melampirkan versi gambar tertentu. Setelah melampirkan versi, Anda dapat memilih versi dari Peluncur SageMaker AI atau pemilih gambar saat meluncurkan buku catatan.

Ada batasan jumlah versi gambar yang dapat dilampirkan pada waktu tertentu. Setelah Anda mencapai batas, Anda harus melepaskan versi untuk melampirkan versi lain dari gambar.

Bagian berikut menunjukkan cara melampirkan gambar SageMaker AI khusus ke domain Anda menggunakan konsol SageMaker AI atau AWS CLI. Anda hanya dapat melampirkan gambar kustom ke ruang berbagi menggunakan AWS CLI.

Lampirkan gambar SageMaker AI ke domain

Lampirkan gambar SageMaker AI menggunakan Konsol

Topik ini menjelaskan bagaimana Anda dapat melampirkan versi gambar SageMaker AI kustom yang ada ke domain Anda menggunakan panel kontrol SageMaker AI. Anda juga dapat membuat gambar SageMaker AI kustom dan versi gambar, dan kemudian melampirkan versi itu ke domain Anda. Untuk prosedur membuat versi gambar dan gambar, lihatBuat gambar SageMaker AI khusus.

Untuk melampirkan gambar yang ada

Buka konsol Amazon SageMaker AI di https://console.aws.amazon.com/sagemaker/.
Di panel navigasi kiri, pilih Konfigurasi admin.
Di bawah konfigurasi Admin, pilih domain.
Dari halaman Domain, pilih domain untuk melampirkan gambar.
Dari halaman Detail domain, pilih tab Lingkungan.
Pada tab Lingkungan, di bawah gambar Custom SageMaker Studio Classic yang dilampirkan ke domain, pilih Lampirkan gambar.
Untuk Sumber gambar, pilih Gambar yang ada.
Pilih gambar yang ada dari daftar.
Pilih versi gambar dari daftar.
Pilih Berikutnya.
Verifikasi nilai untuk nama Gambar, nama tampilan Gambar, dan Deskripsi.
Pilih peran IAM. Untuk informasi selengkapnya, lihat Buat gambar SageMaker AI khusus.
(Opsional) Tambahkan tag untuk gambar.
Tentukan jalur pemasangan EFS. Ini adalah jalur dalam gambar untuk me-mount direktori home Amazon Elastic File System (EFS) pengguna.
Untuk jenis Gambar, pilih Gambar SageMaker studio
Untuk nama Kernel, masukkan nama kernel yang ada di gambar. Untuk informasi tentang cara mendapatkan informasi kernel dari gambar, lihat PENGEMBANGAN di repositori Sampel Gambar Kustom SageMaker Studio Classic. Untuk informasi selengkapnya, lihat bagian Penemuan Kernel dan data PenggunaSpesifikasi gambar SageMaker AI khusus.
(Opsional) Untuk nama tampilan Kernel, masukkan nama tampilan untuk kernel.
Pilih Tambahkan kernel.
Pilih Kirim.
1. Tunggu hingga versi gambar dilampirkan ke domain. Saat dilampirkan, versi ditampilkan dalam daftar Gambar khusus dan disorot secara singkat.

Lampirkan gambar SageMaker AI menggunakan AWS CLI

Bagian berikut menunjukkan cara melampirkan gambar SageMaker AI kustom saat membuat domain baru atau memperbarui domain yang ada menggunakan domain AWS CLI.

Lampirkan gambar SageMaker AI ke domain baru

Bagian berikut menunjukkan cara membuat domain baru dengan versi terlampir. Langkah-langkah ini mengharuskan Anda menentukan informasi Amazon Virtual Private Cloud (VPC) dan peran eksekusi yang diperlukan untuk membuat domain. Anda melakukan langkah-langkah berikut untuk membuat domain dan melampirkan gambar SageMaker AI kustom:

Dapatkan ID dan subnet VPC default Anda. IDs
Buat file konfigurasi untuk domain, yang menentukan gambar.
Buat domain dengan file konfigurasi.

Untuk menambahkan gambar SageMaker AI kustom ke domain Anda

Dapatkan ID VPC default Anda.


aws ec2 describe-vpcs \
    --filters Name=isDefault,Values=true \
    --query "Vpcs[0].VpcId" --output text

Responsnya akan terlihat mirip dengan yang berikut ini.


vpc-xxxxxxxx

Dapatkan subnet default Anda IDs menggunakan ID VPC dari langkah sebelumnya.


aws ec2 describe-subnets \
    --filters Name=vpc-id,Values=<vpc-id> \
    --query "Subnets[*].SubnetId" --output json

Responsnya akan terlihat mirip dengan yang berikut ini.


[
    "subnet-b55171dd",
    "subnet-8a5f99c6",
    "subnet-e88d1392"
]

Buat file konfigurasi bernamacreate-domain-input.json. Masukkan ID VPC, subnet IDsImageName, dan AppImageConfigName dari langkah sebelumnya. Karena ImageVersionNumber tidak ditentukan, versi terbaru dari gambar digunakan, yang merupakan satu-satunya versi dalam kasus ini.


{
    "DomainName": "domain-with-custom-image",
    "VpcId": "<vpc-id>",
    "SubnetIds": [
        "<subnet-ids>"
    ],
    "DefaultUserSettings": {
        "ExecutionRole": "<execution-role>",
        "KernelGatewayAppSettings": {
            "CustomImages": [
                {
                    "ImageName": "custom-image",
                    "AppImageConfigName": "custom-image-config"
                }
            ]
        }
    },
    "AuthMode": "IAM"
}

Buat domain dengan gambar SageMaker AI kustom terlampir.


aws sagemaker create-domain \
    --cli-input-json file://create-domain-input.json

Responsnya akan terlihat mirip dengan yang berikut ini.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx",
    "Url": "https://d-xxxxxxxxxxxx.studio.us-east-2.sagemaker.aws/..."
}

Lampirkan gambar SageMaker AI ke domain Anda saat ini

Jika Anda telah onboard ke domain SageMaker AI, Anda dapat melampirkan gambar kustom ke domain Anda saat ini. Untuk informasi selengkapnya tentang orientasi ke domain SageMaker AI, lihatIkhtisar domain Amazon SageMaker AI. Anda tidak perlu menentukan informasi VPC dan peran eksekusi saat melampirkan gambar khusus ke domain Anda saat ini. Setelah melampirkan versi, Anda harus menghapus semua aplikasi di domain Anda dan membuka kembali Studio Classic. Untuk informasi tentang menghapus aplikasi, lihatHapus domain Amazon SageMaker AI.

Anda melakukan langkah-langkah berikut untuk menambahkan gambar SageMaker AI ke domain Anda saat ini.

Dapatkan DomainID dari panel kontrol SageMaker AI Anda.
Gunakan DomainID untuk mendapatkan domain. DefaultUserSettings
Tambahkan ImageName dan AppImageConfig sebagai a CustomImage keDefaultUserSettings.
Perbarui domain Anda untuk menyertakan gambar kustom.

Untuk menambahkan gambar SageMaker AI kustom ke domain Anda

Buka konsol Amazon SageMaker AI di https://console.aws.amazon.com/sagemaker/.
Di panel navigasi kiri, pilih Konfigurasi admin.
Di bawah konfigurasi Admin, pilih domain.
Dari halaman Domain, pilih domain untuk melampirkan gambar.
Dari halaman Detail domain, pilih tab Pengaturan domain.
Dari tab Pengaturan domain, di bawah Pengaturan umum, temukanDomainId. ID dalam format berikut:d-xxxxxxxxxxxx.

Gunakan ID domain untuk mendapatkan deskripsi domain.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

Responsnya akan terlihat mirip dengan yang berikut ini.


{
    "DomainId": "d-xxxxxxxxxxxx",
    "DefaultUserSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

Simpan bagian pengaturan pengguna default dari respons ke file bernamadefault-user-settings.json.

Masukkan ImageName dan AppImageConfigName dari langkah sebelumnya sebagai gambar khusus. Karena ImageVersionNumber tidak ditentukan, versi terbaru dari gambar digunakan, yang merupakan satu-satunya versi dalam kasus ini.


{
    "DefaultUserSettings": {
        "KernelGatewayAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "string",
                 "AppImageConfigName": "string"
              }
           ],
           ...
        }
    }
}

Gunakan ID domain dan file pengaturan pengguna default untuk memperbarui domain Anda.


aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://default-user-settings.json

Responsnya akan terlihat mirip dengan yang berikut ini.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx"
}

Lampirkan gambar SageMaker AI ke ruang bersama

Anda hanya dapat melampirkan gambar SageMaker AI ke ruang bersama menggunakan file AWS CLI. Setelah Anda melampirkan versi, Anda harus menghapus semua aplikasi di ruang bersama Anda dan membuka kembali Studio Classic. Untuk informasi tentang menghapus aplikasi, lihatHapus domain Amazon SageMaker AI.

Anda melakukan langkah-langkah berikut untuk menambahkan gambar SageMaker AI ke ruang bersama.

Dapatkan DomainID dari panel kontrol SageMaker AI Anda.
Gunakan DomainID untuk mendapatkan domain. DefaultSpaceSettings
Tambahkan ImageName dan AppImageConfig sebagai a CustomImage keDefaultSpaceSettings.
Perbarui domain Anda untuk menyertakan gambar kustom untuk ruang bersama.

Untuk menambahkan gambar SageMaker AI kustom ke ruang bersama Anda

Buka konsol Amazon SageMaker AI di https://console.aws.amazon.com/sagemaker/.
Di panel navigasi kiri, pilih Konfigurasi admin.
Di bawah konfigurasi Admin, pilih domain.
Dari halaman Domain, pilih domain untuk melampirkan gambar.
Dari halaman Detail domain, pilih tab Pengaturan domain.
Dari tab Pengaturan domain, di bawah Pengaturan umum, temukanDomainId. ID dalam format berikut:d-xxxxxxxxxxxx.

Gunakan ID domain untuk mendapatkan deskripsi domain.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

Responsnya akan terlihat mirip dengan yang berikut ini.


{
    "DomainId": "d-xxxxxxxxxxxx",
    ...
    "DefaultSpaceSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

Simpan bagian pengaturan ruang default dari respons ke file bernamadefault-space-settings.json.


{
    "DefaultSpaceSettings": {
        "KernelGatewayAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "string",
                 "AppImageConfigName": "string"
              }
           ],
           ...
        }
    }
}

Gunakan ID domain dan file pengaturan ruang default untuk memperbarui domain Anda.


aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://default-space-settings.json

Responsnya akan terlihat mirip dengan yang berikut ini.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx"
}

Lihat gambar terlampir di SageMaker AI

Setelah Anda membuat gambar SageMaker AI kustom dan melampirkannya ke domain Anda, gambar akan muncul di tab Lingkungan domain. Anda hanya dapat melihat gambar terlampir untuk ruang bersama menggunakan AWS CLI dengan menggunakan perintah berikut.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Buat gambar SageMaker AI

Luncurkan gambar khusus