Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Lampirkan SageMaker gambar khusus Lampirkan gambar **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. Panduan ini menunjukkan cara melampirkan RStudio gambar khusus ke domain Amazon SageMaker AI Anda menggunakan konsol SageMaker AI atau AWS Command Line Interface (AWS CLI). Untuk menggunakan SageMaker gambar kustom, Anda harus melampirkan RStudio gambar kustom ke domain Anda. Saat Anda melampirkan versi gambar, itu muncul di RStudio Peluncur dan tersedia di daftar **dropdown Pilih gambar**. Anda menggunakan dropdown untuk mengubah gambar yang digunakan oleh. RStudio Ada batasan jumlah versi gambar yang dapat Anda lampirkan. Setelah Anda mencapai batas, Anda harus terlebih dahulu melepaskan versi sehingga Anda dapat melampirkan versi gambar yang berbeda. **Topics** + [ ## Lampirkan versi gambar ke domain Anda menggunakan konsol ](#rstudio-byoi-attach-console) + [ ## Lampirkan versi gambar yang ada ke domain Anda menggunakan AWS CLI ](#rstudio-byoi-attach-cli) ## Lampirkan versi gambar ke domain Anda menggunakan konsol Anda dapat melampirkan versi SageMaker gambar khusus ke domain Anda menggunakan panel kontrol konsol SageMaker AI. Anda juga dapat membuat SageMaker gambar kustom, dan versi gambar, lalu melampirkan versi itu ke domain Anda. **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. Pilih domain yang diinginkan. 1. Pilih **Lingkungan**. 1. Di bawah **gambar Custom SageMaker Studio Classic yang dilampirkan ke domain**, pilih **Lampirkan gambar**. 1. Untuk **Sumber gambar**, pilih **Gambar yang ada** atau **Gambar baru**. Jika Anda memilih **Gambar yang ada**, pilih gambar dari toko SageMaker gambar Amazon. Jika Anda memilih **Gambar baru**, berikan jalur registri Amazon ECR untuk gambar Docker Anda. Jalur harus AWS Region sama dengan domain. Repo Amazon ECR harus berada di akun yang sama dengan domain Anda, atau izin lintas akun untuk SageMaker AI harus diaktifkan. 1. Pilih gambar yang ada dari daftar. 1. Pilih versi gambar dari daftar. 1. Pilih **Berikutnya**. 1. Masukkan nilai untuk **nama Gambar, Nama** **tampilan gambar**, dan **Deskripsi**. 1. Pilih peran IAM. Untuk informasi selengkapnya, lihat [Buat RStudio gambar kustom](rstudio-byoi-create.md). 1. (Opsional) Tambahkan tag untuk gambar. 1. (Opsional) Pilih **Tambahkan tag baru**, lalu tambahkan tag konfigurasi. 1. Untuk **jenis Gambar**, pilih **RStudioGambar**. 1. Pilih **Kirim**. Tunggu hingga versi gambar dilampirkan ke domain. Setelah versi dilampirkan, itu muncul di daftar **Gambar khusus** dan disorot secara singkat. ## Lampirkan versi gambar yang ada ke domain Anda menggunakan AWS CLI Dua metode disajikan untuk melampirkan versi gambar ke domain Anda menggunakan AWS CLI. Pada metode pertama, Anda membuat domain baru dengan versi terlampir. Metode ini lebih sederhana tetapi Anda harus menentukan informasi Amazon Virtual Private Cloud (Amazon VPC) dan peran eksekusi yang diperlukan untuk membuat domain. Jika Anda sudah onboard ke domain, Anda dapat menggunakan metode kedua untuk melampirkan versi gambar ke domain Anda saat ini. Dalam hal ini, Anda tidak perlu menentukan informasi VPC Amazon dan peran eksekusi. Setelah Anda melampirkan versi, hapus semua aplikasi di domain Anda dan luncurkan kembali RStudio. ### Lampirkan SageMaker gambar ke domain baru Untuk menggunakan metode ini, Anda harus menentukan peran eksekusi yang memiliki [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)kebijakan yang dilampirkan. Gunakan 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 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 ``` Respons: ``` vpc-xxxxxxxx ``` 1. Dapatkan subnet default Anda IDs menggunakan ID VPC dari langkah sebelumnya. ``` aws ec2 describe-subnets \ --filters Name=vpc-id,Values= \ --query "Subnets[*].SubnetId" --output json ``` Respons: ``` [ "subnet-b55171dd", "subnet-8a5f99c6", "subnet-e88d1392" ] ``` 1. Buat file konfigurasi bernama`create-domain-input.json`. Masukkan ID VPC, subnet IDs`ImageName`, dan `AppImageConfigName` dari langkah sebelumnya. Karena `ImageVersionNumber` tidak ditentukan, versi terbaru dari gambar digunakan, yang merupakan satu-satunya versi dalam kasus ini. Peran eksekusi Anda harus memenuhi persyaratan di[Prasyarat lengkap](rstudio-byoi-prerequisites.md). ``` { "DomainName": "domain-with-custom-r-image", "VpcId": "", "SubnetIds": [ "" ], "DomainSettings": { "RStudioServerProDomainSettings": { "DomainExecutionRoleArn": "" } }, "DefaultUserSettings": { "ExecutionRole": "", "RSessionAppSettings": { "CustomImages": [ { "AppImageConfigName": "rstudio-custom-config", "ImageName": "rstudio-custom-image" } ] } }, "AuthMode": "IAM" } ``` 1. Buat domain dengan SageMaker gambar kustom terlampir. ``` aws sagemaker create-domain \ --cli-input-json file://create-domain-input.json ``` Respons: ``` { "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id", "Url": "https://domain-id.studio.region.sagemaker.aws/..." } ``` ### Lampirkan SageMaker gambar ke domain yang ada Metode ini mengasumsikan bahwa Anda sudah onboard ke domain. Untuk informasi selengkapnya, lihat [Ikhtisar domain Amazon SageMaker AI](gs-studio-onboard.md). **catatan** Anda harus menghapus semua aplikasi di domain Anda untuk memperbarui domain dengan versi gambar baru. Untuk informasi tentang menghapus aplikasi ini, lihat[Hapus domain Amazon SageMaker AI](gs-studio-delete-domain.md). Gunakan langkah-langkah berikut untuk menambahkan SageMaker gambar ke domain Anda saat ini. + Dapatkan `DomainID` dari konsol SageMaker AI. + 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. Pilih domain yang diinginkan. 1. Pilih **pengaturan domain**. 1. Di bawah **Pengaturan Umum**, temukan **ID domain**. ID dalam format berikut:`d-xxxxxxxxxxxx`. 1. Gunakan ID domain untuk mendapatkan deskripsi domain. ``` aws sagemaker describe-domain \ --domain-id ``` Respons: ``` { "DomainId": "d-xxxxxxxxxxxx", "DefaultUserSettings": { "KernelGatewayAppSettings": { "CustomImages": [ ], ... } } } ``` 1. Simpan `DefaultUserSettings` bagian respons ke file bernama`update-domain-input.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": { "RSessionAppSettings": { "CustomImages": [ { "ImageName": "rstudio-custom-image", "AppImageConfigName": "rstudio-custom-config" } ] } } } ``` 1. Gunakan ID domain dan file pengaturan pengguna default untuk memperbarui domain Anda. ``` aws sagemaker update-domain \ --domain-id \ --cli-input-json file://update-domain-input.json ``` Respons: ``` { "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id" } ``` 1. Hapus `RStudioServerPro` aplikasi. Anda harus memulai ulang aplikasi `RStudioServerPro` bersama domain untuk UI RStudio Peluncur untuk mengambil perubahan terbaru. ``` aws sagemaker delete-app \ --domain-id --user-profile-name domain-shared \ --app-type RStudioServerPro --app-name default ``` 1. Buat `RStudioServerPro` aplikasi baru. Anda harus membuat aplikasi ini menggunakan file AWS CLI. ``` aws sagemaker create-app \ --domain-id --user-profile-name domain-shared \ --app-type RStudioServerPro --app-name default ```