Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Lampirkan SageMaker Gambar Kustom di Amazon SageMaker Studio Classic
**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](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS kebijakan terkelola untuk Amazon SageMaker AI](security-iam-awsmanpol.md)yang 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](studio-updated.md).
Studio Classic masih dipertahankan untuk beban kerja yang ada tetapi tidak lagi tersedia untuk orientasi. Anda hanya dapat menghentikan atau menghapus aplikasi Studio Classic yang ada dan tidak dapat membuat yang baru. Kami menyarankan Anda [memigrasikan beban kerja Anda ke pengalaman Studio yang baru](studio-updated-migrate.md).
Untuk menggunakan SageMaker gambar 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 SageMaker gambar 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 SageMaker gambar khusus ke domain Anda menggunakan konsol SageMaker AI atau AWS CLI. Anda hanya dapat melampirkan gambar kustom ke ruang berbagi menggunakan AWS CLI.
## Lampirkan SageMaker gambar ke domain
### Lampirkan SageMaker gambar menggunakan Konsol
Topik ini menjelaskan bagaimana Anda dapat melampirkan versi SageMaker gambar kustom yang ada ke domain Anda menggunakan panel kontrol SageMaker AI. Anda juga dapat membuat SageMaker gambar kustom dan versi gambar, dan kemudian melampirkan versi itu ke domain Anda. Untuk prosedur membuat versi gambar dan gambar, lihat[Membuat SageMaker Gambar Kustom untuk Amazon SageMaker Studio Classic](studio-byoi-create.md).
**Untuk melampirkan gambar yang ada**
1. Buka konsol Amazon SageMaker AI di [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Di panel navigasi kiri, pilih **Konfigurasi admin**.
1. Di bawah **konfigurasi Admin**, pilih **domain**.
1. Dari halaman **Domain**, pilih domain untuk melampirkan gambar.
1. Dari halaman **Detail domain**, pilih tab **Lingkungan**.
1. Pada tab **Lingkungan**, di bawah **gambar Custom SageMaker Studio Classic yang dilampirkan ke domain**, pilih **Lampirkan gambar**.
1. Untuk **Sumber gambar**, pilih **Gambar yang ada**.
1. Pilih gambar yang ada dari daftar.
1. Pilih versi gambar dari daftar.
1. Pilih **Berikutnya**.
1. Verifikasi nilai untuk **nama Gambar****, nama tampilan Gambar**, dan **Deskripsi**.
1. Pilih peran IAM. Untuk informasi selengkapnya, lihat [Membuat SageMaker Gambar Kustom untuk Amazon SageMaker Studio Classic](studio-byoi-create.md).
1. (Opsional) Tambahkan tag untuk gambar.
1. Tentukan jalur pemasangan EFS. Ini adalah jalur dalam gambar untuk me-mount direktori home Amazon Elastic File System (EFS) pengguna.
1. Untuk **jenis Gambar**, pilih **Gambar SageMaker studio**
1. Untuk **nama Kernel**, masukkan nama kernel yang ada di gambar. Untuk informasi tentang cara mendapatkan informasi kernel dari gambar, lihat [PENGEMBANGAN](https://github.com/aws-samples/sagemaker-studio-custom-image-samples/blob/main/DEVELOPMENT.md) di repositori Sampel Gambar Kustom SageMaker Studio Classic. Untuk informasi selengkapnya, lihat bagian **Penemuan Kernel** dan **data Pengguna**[Spesifikasi SageMaker Gambar Kustom untuk Amazon SageMaker Studio Classic](studio-byoi-specs.md).
1. (Opsional) Untuk **nama tampilan Kernel**, masukkan nama tampilan untuk kernel.
1. Pilih **Tambahkan kernel**.
1. Pilih **Kirim**.
1. Tunggu hingga versi gambar dilampirkan ke domain. Saat dilampirkan, versi ditampilkan dalam daftar **Gambar khusus** dan disorot secara singkat.
### Lampirkan SageMaker gambar menggunakan AWS CLI
Bagian berikut menunjukkan cara melampirkan SageMaker gambar kustom saat membuat domain baru atau memperbarui domain yang ada menggunakan domain AWS CLI.
#### Lampirkan SageMaker gambar 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 SageMaker gambar kustom:
+ Dapatkan ID VPC default dan ID subnet Anda.
+ Buat file konfigurasi untuk domain, yang menentukan gambar.
+ Buat domain dengan file konfigurasi.
**Untuk menambahkan SageMaker gambar kustom ke domain Anda**
1. 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
```
1. Dapatkan ID subnet default Anda menggunakan ID VPC dari langkah sebelumnya.
```
aws ec2 describe-subnets \
--filters Name=vpc-id,Values={{}} \
--query "Subnets[*].SubnetId" --output json
```
Responsnya akan terlihat mirip dengan yang berikut ini.
```
[
"subnet-b55171dd",
"subnet-8a5f99c6",
"subnet-e88d1392"
]
```
1. Buat file konfigurasi bernama`create-domain-input.json`. Masukkan ID VPC, ID subnet`ImageName`, 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": "{{}}",
"SubnetIds": [
"{{}}"
],
"DefaultUserSettings": {
"ExecutionRole": "{{}}",
"KernelGatewayAppSettings": {
"CustomImages": [
{
"ImageName": "custom-image",
"AppImageConfigName": "custom-image-config"
}
]
}
},
"AuthMode": "IAM"
}
```
1. Buat domain dengan SageMaker gambar 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 SageMaker gambar 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, lihat[Ikhtisar domain Amazon SageMaker AI](gs-studio-onboard.md). 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, lihat[Hapus domain Amazon SageMaker AI](gs-studio-delete-domain.md).
Anda melakukan langkah-langkah berikut untuk menambahkan SageMaker gambar 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` ke`DefaultUserSettings`.
+ Perbarui domain Anda untuk menyertakan gambar kustom.
**Untuk menambahkan SageMaker gambar kustom ke domain Anda**
1. Buka konsol Amazon SageMaker AI di [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Di panel navigasi kiri, pilih **Konfigurasi admin**.
1. Di bawah **konfigurasi Admin**, pilih **domain**.
1. Dari halaman **Domain**, pilih domain untuk melampirkan gambar.
1. Dari halaman **Detail domain**, pilih tab **Pengaturan domain**.
1. Dari tab **Pengaturan domain**, di bawah **Pengaturan umum**, temukan`DomainId`. ID dalam format berikut:`d-xxxxxxxxxxxx`.
1. Gunakan ID domain untuk mendapatkan deskripsi domain.
```
aws sagemaker describe-domain \
--domain-id {{}}
```
Responsnya akan terlihat mirip dengan yang berikut ini.
```
{
"DomainId": "d-xxxxxxxxxxxx",
"DefaultUserSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
}
}
}
```
1. Simpan bagian pengaturan pengguna default dari respons ke file bernama`default-user-settings.json`.
1. 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"
}
],
...
}
}
}
```
1. Gunakan ID domain dan file pengaturan pengguna default untuk memperbarui domain Anda.
```
aws sagemaker update-domain \
--domain-id {{}} \
--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 SageMaker gambar ke ruang bersama
Anda hanya dapat melampirkan SageMaker gambar 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, lihat[Hapus domain Amazon SageMaker AI](gs-studio-delete-domain.md).
Anda melakukan langkah-langkah berikut untuk menambahkan SageMaker gambar ke ruang bersama.
+ Dapatkan `DomainID` dari panel kontrol SageMaker AI Anda.
+ Gunakan `DomainID` untuk mendapatkan domain. `DefaultSpaceSettings`
+ Tambahkan `ImageName` dan `AppImageConfig` sebagai a `CustomImage` ke`DefaultSpaceSettings`.
+ Perbarui domain Anda untuk menyertakan gambar kustom untuk ruang bersama.
**Untuk menambahkan SageMaker gambar kustom ke ruang bersama Anda**
1. Buka konsol Amazon SageMaker AI di [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Di panel navigasi kiri, pilih **Konfigurasi admin**.
1. Di bawah **konfigurasi Admin**, pilih **domain**.
1. Dari halaman **Domain**, pilih domain untuk melampirkan gambar.
1. Dari halaman **Detail domain**, pilih tab **Pengaturan domain**.
1. Dari tab **Pengaturan domain**, di bawah **Pengaturan umum**, temukan`DomainId`. ID dalam format berikut:`d-xxxxxxxxxxxx`.
1. Gunakan ID domain untuk mendapatkan deskripsi domain.
```
aws sagemaker describe-domain \
--domain-id {{}}
```
Responsnya akan terlihat mirip dengan yang berikut ini.
```
{
"DomainId": "d-xxxxxxxxxxxx",
...
"DefaultSpaceSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
}
}
}
```
1. Simpan bagian pengaturan ruang default dari respons ke file bernama`default-space-settings.json`.
1. 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.
```
{
"DefaultSpaceSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
{
"ImageName": "string",
"AppImageConfigName": "string"
}
],
...
}
}
}
```
1. Gunakan ID domain dan file pengaturan ruang default untuk memperbarui domain Anda.
```
aws sagemaker update-domain \
--domain-id {{}} \
--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 SageMaker gambar 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 {{}}
```