Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# RStudio di manajemen SageMaker AI Amazon
Topik berikut memberikan informasi tentang pengelolaan RStudio di Amazon SageMaker AI. Ini termasuk informasi tentang konfigurasi RStudio lingkungan Anda, sesi pengguna, dan sumber daya yang diperlukan. Untuk informasi tentang cara menggunakan RStudio SageMaker AI, lihat[RStudio di panduan pengguna Amazon SageMaker AI](rstudio-use.md).
Untuk informasi tentang membuat domain Amazon SageMaker AI dengan RStudio diaktifkan, lihat[Ikhtisar domain Amazon SageMaker AI](gs-studio-onboard.md).
Untuk informasi tentang AWS Wilayah yang RStudio didukung SageMaker AI, lihat[Wilayah dan Kuota yang Didukung](regions-quotas.md).
**Topics**
+ [
# Dapatkan RStudio lisensi
](rstudio-license.md)
+ [
# RStudio Pembuatan Versi
](rstudio-version.md)
+ [
# Jaringan dan Penyimpanan
](rstudio-network.md)
+ [
# RStudioServerPro jenis contoh
](rstudio-select-instance.md)
+ [
# Tambahkan URL RStudio Connect
](rstudio-configure-connect.md)
+ [
# Perbarui URL RStudio Package Manager
](rstudio-configure-pm.md)
+ [
# Buat domain Amazon SageMaker AI dengan RStudio menggunakan AWS CLI
](rstudio-create-cli.md)
+ [
# Tambahkan RStudio dukungan ke domain yang ada
](rstudio-add-existing.md)
+ [
# Gambar khusus RStudio dengan SageMaker AI
](rstudio-byoi.md)
+ [
# Buat pengguna untuk digunakan RStudio
](rstudio-create-user.md)
+ [
# Masuk RStudio sebagai pengguna lain
](rstudio-login-another.md)
+ [
# Mengakhiri sesi untuk pengguna lain
](rstudio-terminate-another.md)
+ [
# Gunakan dasbor RStudio administratif
](rstudio-admin.md)
+ [
# Matikan RStudio
](rstudio-shutdown.md)
+ [
# Penagihan dan biaya
](rstudio-billing.md)
+ [
# Mendiagnosis masalah dan mendapatkan dukungan
](rstudio-troubleshooting.md)
# Dapatkan RStudio lisensi
RStudio di Amazon SageMaker AI adalah produk berbayar dan mengharuskan setiap pengguna dilisensikan dengan tepat. Lisensi untuk RStudio di Amazon SageMaker AI dapat diperoleh dari RStudio PBC secara langsung, atau dengan membeli langganan Posit Workbench di Marketplace. AWS Untuk pelanggan Posit Workbench Enterprise yang sudah ada, lisensi dikeluarkan tanpa biaya tambahan. Untuk menggunakan RStudio lisensi dengan Amazon SageMaker AI, Anda harus terlebih dahulu memiliki RStudio lisensi yang valid terdaftar AWS License Manager. Untuk lisensi yang dibeli langsung melalui Rstudio PBC, pemberian lisensi untuk AWS Akun Anda harus dibuat. Hubungi RStudio untuk pembelian lisensi langsung atau untuk mengaktifkan lisensi yang ada di AWS License Manager. Untuk informasi selengkapnya tentang mendaftarkan lisensi dengan AWS License Manager, lihat [Lisensi yang dikeluarkan Penjual di AWS License Manager](https://docs.aws.amazon.com/license-manager/latest/userguide/seller-issued-licenses.html).
Topik berikut menunjukkan cara memperoleh dan memvalidasi lisensi yang diberikan oleh RStudio PBC.
**Dapatkan RStudio lisensi**
1. Jika Anda tidak memiliki RStudio lisensi, Anda dapat membelinya dari AWS Marketplace atau dari RStudio PBC secara langsung.
+ Untuk membeli langganan dari AWS Marketplace, selesaikan langkah-langkah untuk [berlangganan kontrak SaaS dengan](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-saas-products.html) mencari **Platform Posit (RStudio on SageMaker)**. Untuk memenuhi lisensi, Anda akan diarahkan ke formulir eksternal di luar AWS Marketplace. Anda harus memberikan informasi tambahan, termasuk nama perusahaan dan alamat email Anda. Jika Anda tidak dapat mengakses formulir itu untuk memberikan nama perusahaan dan email kontak, buat tiket dengan Dukungan Posit di [https://support.posit. co/hc/en-us/requests/new](https://support.posit.co/hc/en-us/requests/new)dengan detail tentang pembelian Anda.
+ Untuk membeli dari RStudio PBC secara langsung, navigasikan ke [RStudio Harga](https://www.rstudio.com/pricing/) atau hubungi [sales@rstudio.com](mailto:sales@rstudio.com). Saat membeli atau memperbarui RStudio lisensi, Anda harus memberikan AWS Akun yang akan meng-host domain Amazon SageMaker AI Anda.
Jika Anda memiliki RStudio lisensi yang sudah ada, hubungi perwakilan RStudio Penjualan Anda atau [sales@rstudio.com](mailto:sales@rstudio.com) untuk menambahkan RStudio Amazon SageMaker AI ke lisensi Posit Workbench Enterprise yang ada, atau untuk mengonversi lisensi Posit Workbench Standard Anda. Perwakilan RStudio Penjualan akan mengirimkan formulir pemesanan elektronik yang sesuai kepada Anda.
1. RStudio memberikan lisensi Posit Workbench ke AWS Akun Anda melalui Wilayah AWS License Manager AS Timur (Virginia N.). Meskipun RStudio lisensi diberikan di Wilayah AS Timur (Virginia N.), lisensi Anda dapat dikonsumsi di AWS Wilayah mana pun yang RStudio didukung oleh SageMaker AI Amazon. Anda dapat mengharapkan proses pemberian lisensi selesai dalam waktu tiga hari kerja setelah Anda membagikan ID AWS akun Anda RStudio.
1. Ketika lisensi ini diberikan, Anda menerima email dari perwakilan RStudio Penjualan Anda dengan instruksi untuk menerima pemberian lisensi Anda.
**Validasi RStudio lisensi Anda untuk digunakan dengan Amazon AI SageMaker **
1. Masuk ke AWS License Manager konsol di wilayah yang sama dengan domain Amazon SageMaker AI Anda. Jika Anda menggunakan AWS License Manager untuk pertama kalinya, AWS License Manager meminta Anda untuk memberikan izin untuk menggunakan AWS License Manager.
1. Pilih **Mulai menggunakan Manajer AWS Lisensi**.
1. Pilih `I grant AWS License Manager the required permissions` dan pilih **Hibah Izin**.
1. Arahkan ke **Lisensi yang Diberikan** di panel kiri.
1. Pilih hibah lisensi dengan `RSW-SageMaker` sebagai `Product name` dan pilih **Lihat**.
1. Dari halaman detail lisensi, pilih **Terima & aktifkan lisensi**.
**RStudio dasbor administratif**
Anda dapat menggunakan dasbor RStudio administratif untuk melihat jumlah pengguna pada lisensi mengikuti langkah-langkah di[Gunakan dasbor RStudio administratif](rstudio-admin.md).
# RStudio Pembuatan Versi
**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 memberikan informasi tentang pembaruan `2025.05.1+513.pro3` versi untuk RStudio SageMaker AI. Mulai 31 Oktober 2025, domain baru dengan RStudio dukungan dibuat dengan Posit Workbench versi. `2025.05.1+513.pro3` Ini berlaku untuk `RStudioServerPro` aplikasi dan `RSessionGateway` aplikasi default.
Bagian berikut memberikan informasi tentang `2025.05.1+513.pro3` rilis.
## Pembaruan versi terbaru
RStudio Versi terbaru adalah`2025.05.1+513.pro3`.
+ Versi R yang didukung:
+ 4.5.1
+ 4.4.3
+ 4.4.0
+ 4.3.3
+ 4.2.3
+ 4.2.1
+ 4.1.3
+ 4.0.2
Untuk informasi selengkapnya tentang perubahan dalam rilis ini, lihat[https://docs.posit.co/ide/news/](https://docs.posit.co/ide/news/).
**catatan**
Untuk memastikan kompatibilitas, sebaiknya gunakan awalan yang cocok RSessions dengan Posit Workbench versi saat ini.
Jika Anda melihat peringatan berikut, ada ketidakcocokan versi antara versi `RSession` dan Posit Workbench versi yang digunakan RStudio di SageMaker AI. Untuk mengatasi masalah ini, perbarui RStudio versi domain. Untuk informasi tentang memperbarui RStudio versi, lihat[Tingkatkan ke versi baru](rstudio-version-upgrade.md).
```
Session version 2024.04.2+764.pro1 does not match server version 2025.05.1+513.pro3 - this is an unsupported configuration, and you may experience unexpected issues as a result.
```
## Penentuan versi
Saat ini ada dua versi yang Posit Workbench didukung oleh SageMaker AI.
+ Versi terbaru: `2025.05.1+513.pro3`
Tanggal Penghentian: 5 Desember 2026
+ Versi sebelumnya: `2024.04.2+764.pro1`
Tanggal Penghentian: 30 April 2026
**catatan**
Meskipun Anda dapat terus membuat domain baru dengan versi yang lebih lama `2024.04.2+764.pro1` hingga 04/30/2026 dengan menyematkan versi secara eksplisit saat Anda membuat domain menggunakan CLI, kami sangat menyarankan pelanggan untuk mulai menggunakan versi di semua domain. `2025.05` POSIT telah berhenti memberikan perbaikan kerentanan untuk. `2024.04.2+764.pro1`
Versi `2023.03.2-547.pro5` dan `2022.02.2-485.pro2` sudah usang dan tidak lagi didukung. Kami merekomendasikan memperbarui ke versi terbaru.
Posit WorkbenchVersi default yang dipilih SageMaker AI bergantung pada tanggal pembuatan domain.
+ Untuk domain yang dibuat setelah 31 Oktober 2025, versi `2025.05.1+513.pro3` adalah versi default yang dipilih.
+ Untuk domain yang dibuat setelah 04 September 2024 dan sebelum 31 Oktober 2025, versi `2024.04.2+764.pro1` adalah versi default yang dipilih. Anda dapat memperbarui domain Anda ke versi terbaru (`2025.05.1+513.pro3`) dengan menyetelnya sebagai versi default untuk domain. Untuk informasi selengkapnya, lihat [Tingkatkan ke versi baru](rstudio-version-upgrade.md).
**catatan**
Versi `RSessionGateway` aplikasi default cocok dengan versi `RStudioServerPro` aplikasi saat ini.
Tabel berikut mencantumkan gambar ARNs untuk kedua versi untuk masing-masing Wilayah AWS. Ini ARNs diteruskan sebagai bagian dari `update-domain` perintah untuk mengatur versi yang diinginkan.
| Region | `2024.04.2+764.pro1`Gambar ARN | `2025.05.1+513.pro3`Gambar ARN |
| --- | --- | --- |
| us-east-1 | arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| us-east-2 | arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| us-west-1 | arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| us-west-2 | arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| af-south-1 | arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-east-1 | arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-south-1 | arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-northeast-2 | arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-southeast-1 | arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-southeast-2 | arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-northeast-1 | arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ca-central-1 | arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-central-1 | arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-west-1 | arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-west-2 | arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-west-3 | arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-north-1 | arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-south-1 | arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| sa-east-1 | arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2025.05-sagemaker-1.0 |
### Perubahan pada Gambar BYOI
Jika Anda menggunakan gambar BYOI dengan RStudio dan memperbarui `RStudioServerPro` versi Anda`2025.05.1+513.pro3`, Anda harus memutakhirkan gambar kustom Anda untuk menggunakan `2025.05.1+513.pro3` rilis dan menerapkan ulang yang sudah ada. RSessions Jika Anda mencoba memuat gambar yang tidak kompatibel di domain menggunakan `2025.05.1+513.pro3` versi, gambar RSession gagal karena tidak dapat mengurai parameter yang diterimanya. RSession Untuk mencegah kegagalan, perbarui semua gambar kustom yang diterapkan di `RStudioServerPro` aplikasi Anda yang ada.
Di `RSW_VERSION` dalam Dockerfile harus konsisten dengan Posit Workbench versi yang digunakan RStudio pada SageMaker AI. Anda dapat memvalidasi versi saat ini diPosit Workbench. Untuk melakukannya, gunakan nama versi yang terletak di sudut kiri bawah halaman Posit Workbench peluncur.
```
ARG RSW_VERSION=2025.05.1+513.pro3
ENV RSTUDIO_FORCE_NON_ZERO_EXIT_CODE="1"
ARG RSW_NAME=rstudio-workbench
ARG OS_CODE_NAME=jammy
ARG RSW_DOWNLOAD_URL=https://s3.amazonaws.com/rstudio-ide-build/server/${OS_CODE_NAME}/amd64
RUN RSW_VERSION_URL=`echo -n "${RSW_VERSION}" | sed 's/+/-/g'` \
&& curl -o rstudio-workbench.deb ${RSW_DOWNLOAD_URL}/${RSW_NAME}-${RSW_VERSION_URL}-amd64.deb \
&& gdebi -n ./rstudio-workbench.deb
```
# Tingkatkan ke versi baru
Domain yang ada menggunakan versi `2024.04.2+764.pro1` dapat meningkatkan ke `2025.05.1+513.pro3` versi dengan salah satu dari dua cara:
+ Buat domain baru dari AWS CLI dengan RStudio diaktifkan.
+ Perbarui domain yang ada untuk menggunakan `2025.05.1+513.pro3` versi.
Prosedur berikut menunjukkan cara menghapus RStudio aplikasi untuk domain yang ada, mengatur versi default ke`2025.05.1+513.pro3`, dan kemudian membuat RStudio aplikasi.
1. Hapus `RStudioServerPro` aplikasi dan semua `RSessionGateway` aplikasi yang terkait dengan domain Anda yang ada. Untuk informasi tentang cara menemukan ID domain Anda, lihat[Lihat domain](domain-view.md). Untuk informasi selengkapnya tentang menghapus aplikasi, lihat[Matikan RStudio](rstudio-shutdown.md).
```
aws sagemaker delete-app \
--region region \
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
1. Jika domain Anda menggunakan RStudio versi`2024.04.2+764.pro1`, perbarui domain untuk disetel `2025.05.1+513.pro3` sebagai Posit Workbench versi default. `SageMakerImageArn`Nilai dalam `update-domain` perintah berikut menentukan RStudio `2025.05.1+513.pro3` versi sebagai default. ARN ini harus cocok dengan tempat Region domain Anda berada. Untuk daftar semua yang tersedia ARNs, lihat[Penentuan versi](rstudio-version.md#rstudio-version-new).
Lulus peran eksekusi ARN untuk domain yang menyediakan izin untuk memperbarui domain.
```
aws sagemaker update-domain \
--region region \
--domain-id domainId \
--domain-settings-for-update "{\"RStudioServerProDomainSettingsForUpdate\":{\"DefaultResourceSpec\": {\"SageMakerImageArn\": \"arn-for-2025.05.1+513.pro3-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}"
```
1. Buat `RStudioServerPro` aplikasi baru di domain yang ada.
```
aws sagemaker create-app \
--region region
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
`RStudioServerPro`Aplikasi Anda sekarang diperbarui ke versi`2025.05.1+513.pro3`. Anda sekarang dapat meluncurkan kembali aplikasi Anda`RSessionGateway`.
# Turunkan versi ke versi sebelumnya
Anda dapat menurunkan versi RStudio aplikasi yang ada secara manual ke `2024.04.2+764.pro1` versi.
**Untuk menurunkan versi ke versi sebelumnya**
1. Hapus `RStudioServerPro` aplikasi yang terkait dengan domain yang ada. Untuk informasi tentang cara menemukan ID domain Anda, lihat[Lihat domain](domain-view.md).
```
aws sagemaker delete-app \
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
1. Lewati `2024.04.2+764.pro1` ARN yang sesuai untuk Anda Region sebagai bagian dari perintah. `update-domain` Untuk daftar semua yang tersedia ARNs, lihat[Penentuan versi](rstudio-version.md#rstudio-version-new). Anda juga harus melewati peran eksekusi ARN untuk domain yang menyediakan izin untuk memperbarui domain.
```
aws sagemaker update-domain \
--region region \
--domain-id domainId \
--domain-settings-for-update "{\"RStudioServerProDomainSettingsForUpdate\":{\"DefaultResourceSpec\": {\"SageMakerImageArn\": \"arn-for-2024.04.2+764.pro1-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}"
```
1. Buat `RStudioServerPro` aplikasi baru di domain yang ada. RStudio Versi default ke. `2024.04.2+764.pro1`
```
aws sagemaker create-app \
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
`RStudioServerPro`Aplikasi Anda sekarang diturunkan ke versi. `2024.04.2+764.pro1`
# Jaringan dan Penyimpanan
Topik berikut menjelaskan akses jaringan dan pertimbangan penyimpanan data untuk RStudio instans Anda. Untuk informasi umum tentang akses jaringan dan penyimpanan data saat menggunakan Amazon SageMaker AI, lihat[Perlindungan Data di Amazon SageMaker AI](data-protection.md).
**Volume Amazon EFS**
RStudio di Amazon SageMaker AI membagikan volume Amazon EFS dengan aplikasi Amazon SageMaker Studio Classic di domain. Saat RStudio aplikasi ditambahkan ke domain, SageMaker AI membuat folder bernama `shared` di direktori Amazon EFS. Jika `shared` folder ini dihapus atau diubah secara manual, maka RStudio aplikasi mungkin tidak lagi berfungsi. Untuk informasi selengkapnya tentang volume Amazon EFS, lihat[Kelola Volume Penyimpanan Amazon EFS Anda di Amazon SageMaker Studio Classic](studio-tasks-manage-storage.md).
**Paket dan skrip yang diinstal**
Paket yang Anda instal dari dalam RStudio dicakup ke tingkat profil pengguna. Ini berarti bahwa paket yang diinstal tetap ada melalui RSession shutdown, restart, dan cross RSessions untuk setiap profil pengguna tempat mereka diinstal. R Skrip yang disimpan dalam RSessions berperilaku dengan cara yang sama. Baik paket dan R Script disimpan dalam volume Amazon EFS pengguna.
**Enkripsi**
RStudio di Amazon SageMaker AI mendukung enkripsi saat istirahat.
**Gunakan RStudio dalam mode VPC saja**
RStudio di Amazon SageMaker AI mendukung [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/userguide/endpoint-services-overview.html)integrasi. Dengan integrasi ini, Anda dapat menggunakan RStudio SageMaker AI dalam mode VPC saja tanpa akses langsung ke internet. Ketika Anda menggunakan RStudio dalam mode VPC saja, grup keamanan Anda secara otomatis dikelola oleh layanan. Ini termasuk konektivitas antara Anda RServer dan Anda RSessions.
Berikut ini diperlukan untuk digunakan RStudio dalam mode VPC saja. Untuk informasi selengkapnya tentang memilih VPC, lihat. [Pilih VPC Amazon](onboard-vpc.md)
+ Subnet pribadi dengan akses internet untuk melakukan panggilan ke Amazon SageMaker AI & License Manager, atau titik akhir Amazon Virtual Private Cloud (Amazon VPC) untuk Amazon SageMaker AI & License Manager.
+ Domain tidak dapat memiliki lebih dari dua Grup Keamanan terkait.
+ ID Grup Keamanan untuk digunakan dengan domain di Pengaturan domain. Ini harus memungkinkan semua akses keluar.
+ ID Grup Keamanan untuk digunakan dengan titik akhir VPC Amazon. Grup keamanan ini harus mengizinkan lalu lintas masuk dari ID Grup Keamanan domain.
+ Titik Akhir VPC Amazon untuk dan. `sagemaker.api` AWS License Manager Ini harus dalam VPC Amazon yang sama dengan subnet pribadi.
# RStudioServerPro jenis contoh
Saat memutuskan jenis instans Amazon EC2 yang akan digunakan untuk RStudio ServerPro aplikasi Anda, faktor utama yang perlu dipertimbangkan adalah bandwidth. Bandwidth penting karena RStudio ServerPro instans bertanggung jawab untuk melayani RStudio UI ke semua pengguna. Ini termasuk alur kerja UI yang berat, seperti menghasilkan angka, animasi, dan menampilkan banyak baris data. Oleh karena itu, mungkin ada beberapa penurunan kinerja UI tergantung pada beban kerja di semua pengguna. Berikut ini adalah jenis instance yang tersedia untuk digunakan untuk Anda RStudioServerPro. Untuk informasi harga tentang instans ini, lihat [ SageMakerHarga Amazon](https://aws.amazon.com/sagemaker/pricing/).
+ `system`: Jenis instance ini direkomendasikan untuk Domain dengan penggunaan UI rendah.
**catatan**
`system`Nilai diterjemahkan ke`ml.t3.medium`.
+ `ml.c5.4xlarge`: Jenis instance ini direkomendasikan untuk Domain dengan penggunaan UI moderat.
+ `ml.c5.9xlarge`: Jenis instance ini direkomendasikan untuk Domain dengan penggunaan UI berat.
**Mengubah jenis RStudio instance**
Untuk mengubah jenis instance Anda RStudioServerPro, teruskan jenis instance baru sebagai bagian dari panggilan ke perintah `update-domain` CLI. Anda kemudian perlu menghapus RStudio ServerPro aplikasi yang ada menggunakan perintah `delete-app` CLI dan membuat RStudio ServerPro aplikasi baru menggunakan perintah CLI`create-app`.
# Tambahkan URL RStudio Connect
RStudio Connect adalah platform penerbitan untuk aplikasi Shiny, laporan R Markdown, dasbor, plot, dan banyak lagi. RStudio Connect memudahkan untuk memunculkan wawasan pembelajaran mesin dan ilmu data dengan membuat konten hosting menjadi sederhana dan terukur. Jika Anda memiliki server RStudio Connect, maka Anda dapat mengatur server sebagai tempat default di mana aplikasi dipublikasikan. Untuk informasi selengkapnya tentang RStudio Connect, lihat [RStudio Connect](https://www.rstudio.com/products/connect/).
Saat Anda onboard ke RStudio di domain Amazon SageMaker AI, server RStudio Connect tidak dibuat. Anda dapat membuat server RStudio Connect di instans Amazon EC2 untuk menggunakan Connect with SageMaker Amazon AI domain. Untuk informasi tentang cara menyiapkan server RStudio Connect, lihat [Host RStudio Connect dan Package Manager untuk pengembangan ML RStudio di Amazon SageMaker AI](https://aws.amazon.com/blogs/machine-learning/host-rstudio-connect-and-package-manager-for-ml-development-in-rstudio-on-amazon-sagemaker/).
**Tambahkan URL RStudio Connect**
Jika Anda memiliki URL RStudio Connect, Anda dapat memperbarui URL default sehingga RStudio Pengguna Anda dapat mempublikasikannya.
1. Arahkan ke halaman **domain**.
1. Pilih domain yang diinginkan.
1. Pilih **Pengaturan domain**.
1. Di bawah **Pengaturan Umum**, pilih **Edit**.
1. Dari halaman baru, pilih **RStudio Pengaturan** di sisi kiri.
1. Di bawah **RStudio Connect URL**, masukkan URL RStudio Connect untuk ditambahkan.
1. Pilih **Kirim**.
**CLI**
Anda dapat mengatur URL RStudio Connect default saat membuat domain. Satu-satunya cara untuk memperbarui URL RStudio Connect Anda dari URL AWS CLI adalah dengan menghapus domain Anda dan membuat yang baru dengan URL RStudio Connect yang diperbarui.
# Perbarui URL RStudio Package Manager
RStudio Package Manager adalah server manajemen repositori yang digunakan untuk mengatur dan memusatkan paket di seluruh organisasi Anda. Untuk informasi selengkapnya tentang RStudio Package Manager, lihat [RStudio Package Manager](https://www.rstudio.com/products/package-manager/). Jika Anda tidak menyediakan URL Package Manager Anda sendiri, domain Amazon SageMaker AI menggunakan repositori Package Manager default saat Anda melakukan onboard RStudio mengikuti langkah-langkahnya. [Ikhtisar domain Amazon SageMaker AI](gs-studio-onboard.md) Untuk informasi selengkapnya, lihat [Host RStudio Connect dan Package Manager untuk pengembangan ML RStudio di Amazon SageMaker AI](https://aws.amazon.com/blogs/machine-learning/host-rstudio-connect-and-package-manager-for-ml-development-in-rstudio-on-amazon-sagemaker/). Prosedur berikut menunjukkan cara memperbarui URL Package Manager.
**Perbarui URL Package Manager**
Anda dapat memperbarui URL Package Manager yang digunakan untuk domain RStudio -enabled Anda sebagai berikut.
1. Arahkan ke halaman **domain**.
1. Pilih domain yang diinginkan.
1. Pilih **Pengaturan domain**.
1. Di bawah **Pengaturan Umum**, pilih **Edit**.
1. Dari halaman baru, pilih **RStudio Pengaturan** di sisi kiri.
1. Di bawah **RStudio Package Manager**, masukkan URL RStudio Package Manager Anda.
1. Pilih **Kirim**.
**CLI**
Satu-satunya cara untuk memperbarui URL Package Manager Anda AWS CLI adalah dengan menghapus domain Anda dan membuat yang baru dengan URL Package Manager yang diperbarui.
# Buat domain Amazon SageMaker AI dengan RStudio menggunakan AWS CLI
**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.
Topik berikut menunjukkan cara onboard ke domain Amazon SageMaker AI dengan RStudio diaktifkan menggunakan file. AWS CLI Untuk onboard menggunakan Konsol Manajemen AWS, lihat[Ikhtisar domain Amazon SageMaker AI](gs-studio-onboard.md).
## Prasyarat
+ Instal dan konfigurasikan [AWS CLI versi 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
+ Konfigurasikan [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config)kredenal dengan IAM
## Buat `DomainExecution` peran
Untuk meluncurkan RStudio Aplikasi, Anda harus memberikan `DomainExecution` peran. Peran ini digunakan untuk menentukan apakah RStudio perlu diluncurkan sebagai bagian dari pembuatan domain Amazon SageMaker AI. Peran ini juga digunakan oleh Amazon SageMaker AI untuk mengakses RStudio Lisensi dan push RStudio log.
**catatan**
`DomainExecution`Peran harus memiliki setidaknya AWS License Manager izin untuk mengakses RStudio Lisensi, dan CloudWatch izin untuk mendorong log di akun Anda.
Prosedur berikut menunjukkan cara membuat `DomainExecution` peran dengan AWS CLI.
1. Buat file dengan nama `assume-role-policy.json` dengan konten berikut ini.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": "sts:AssumeRole",
"Effect": "Allow",
"Principal": {
"Service": [
"sagemaker.amazonaws.com"
]
}
}
]
}
```
------
1. Buat `DomainExecution` peran. ``harus menjadi AWS Wilayah untuk meluncurkan domain Anda.
```
aws iam create-role --region --role-name DomainExecution --assume-role-policy-document file://assume-role-policy.json
```
1. Buat file dengan nama `domain-setting-policy.json` dengan konten berikut ini. Kebijakan ini memungkinkan RStudio ServerPro aplikasi mengakses sumber daya yang diperlukan dan memungkinkan Amazon SageMaker AI meluncurkan RStudio ServerPro aplikasi secara otomatis saat RStudio ServerPro aplikasi yang ada dalam `Failed` status `Deleted` atau.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"license-manager:ExtendLicenseConsumption",
"license-manager:ListReceivedLicenses",
"license-manager:GetLicense",
"license-manager:CheckoutLicense",
"license-manager:CheckInLicense",
"logs:CreateLogDelivery",
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:DeleteLogDelivery",
"logs:Describe*",
"logs:GetLogDelivery",
"logs:GetLogEvents",
"logs:ListLogDeliveries",
"logs:PutLogEvents",
"logs:PutResourcePolicy",
"logs:UpdateLogDelivery",
"sagemaker:CreateApp"
],
"Resource": "*"
}
]
}
```
------
1. Buat kebijakan pengaturan domain yang dilampirkan ke `DomainExecution` peran. Waspadai `PolicyArn` dari tanggapan, Anda harus memasukkan ARN itu dalam langkah-langkah berikut.
```
aws iam create-policy --region --policy-name domain-setting-policy --policy-document file://domain-setting-policy.json
```
1. `domain-setting-policy`Lampirkan ke `DomainExecution` peran. Gunakan yang `PolicyArn` dikembalikan pada langkah sebelumnya.
```
aws iam attach-role-policy --role-name DomainExecution --policy-arn
```
## Buat domain Amazon SageMaker AI dengan RStudio Aplikasi
RStudioServerPro Aplikasi diluncurkan secara otomatis saat Anda membuat domain Amazon SageMaker AI menggunakan perintah `create-domain` CLI dengan `RStudioServerProDomainSettings` parameter yang ditentukan. Saat meluncurkan RStudio ServerPro Aplikasi, Amazon SageMaker AI memeriksa RStudio lisensi yang valid di akun dan gagal membuat domain jika lisensi tidak ditemukan.
Pembuatan domain Amazon SageMaker AI berbeda berdasarkan metode otentikasi dan jenis jaringan. Opsi ini harus digunakan bersama, dengan satu metode otentikasi dan satu jenis koneksi jaringan dipilih. Untuk informasi selengkapnya tentang persyaratan untuk membuat domain baru, lihat [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html).
Metode otentikasi berikut didukung.
+ `IAM Auth`
+ `SSO Auth`
Jenis koneksi jaringan berikut didukung:
+ `PublicInternet`
+ `VPCOnly`
### Metode autentikasi
**Mode Auth IAM**
Berikut ini menunjukkan cara membuat domain Amazon SageMaker AI dengan RStudio diaktifkan dan Jenis `IAM Auth` Jaringan. Untuk informasi selengkapnya AWS Identity and Access Management, lihat [Apa itu IAM?](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) .
+ `DomainExecutionRoleArn`harus menjadi ARN untuk peran yang dibuat pada langkah sebelumnya.
+ `ExecutionRole`adalah ARN dari peran yang diberikan kepada pengguna di domain Amazon SageMaker AI.
+ `vpc-id`harus menjadi ID Amazon Virtual Private Cloud Anda. `subnet-ids`harus berupa daftar subnet yang dipisahkan spasi. IDs Untuk informasi tentang `vpc-id` dan`subnet-ids`, lihat [VPCs dan subnet](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html).
+ `RStudioPackageManagerUrl`dan `RStudioConnectUrl` bersifat opsional dan harus diatur ke URLs RStudio Package Manager dan RStudio Connect server Anda, masing-masing.
+ `app-network-access-type`harus salah satu `PublicInternetOnly` atau`VPCOnly`.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode IAM \
--default-user-settings ExecutionRole= \
--domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<,RStudioConnectUrl=<,DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids \
--app-network-access-type
```
**Otentikasi menggunakan IAM Identity Center**
Berikut ini menunjukkan cara membuat domain Amazon SageMaker AI dengan RStudio diaktifkan dan Jenis `SSO Auth` Jaringan. AWS IAM Identity Center harus diaktifkan untuk wilayah tempat domain diluncurkan. Untuk informasi lebih lanjut tentang IAM Identity Center, lihat [Apa itu? AWS IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) .
+ `DomainExecutionRoleArn`harus menjadi ARN untuk peran yang dibuat pada langkah sebelumnya.
+ `ExecutionRole`adalah ARN dari peran yang diberikan kepada pengguna di domain Amazon SageMaker AI.
+ `vpc-id`harus menjadi ID Amazon Virtual Private Cloud Anda. `subnet-ids`harus berupa daftar subnet yang dipisahkan spasi. IDs Untuk informasi tentang `vpc-id` dan`subnet-ids`, lihat [VPCs dan subnet](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html).
+ `RStudioPackageManagerUrl`dan `RStudioConnectUrl` bersifat opsional dan harus diatur ke URLs RStudio Package Manager dan RStudio Connect server Anda, masing-masing.
+ `app-network-access-type`harus salah satu `PublicInternetOnly` atau`VPCOnly`.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode SSO \
--default-user-settings ExecutionRole= \
--domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<,RStudioConnectUrl=<,DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids \
--app-network-access-type
```
### Tipe koneksi
**PublicInternet/Jenis jaringan Internet langsung**
Berikut ini menunjukkan cara membuat domain Amazon SageMaker AI dengan RStudio diaktifkan dan Jenis `PublicInternet` Jaringan.
+ `DomainExecutionRoleArn`harus menjadi ARN untuk peran yang dibuat pada langkah sebelumnya.
+ `ExecutionRole`adalah ARN dari peran yang diberikan kepada pengguna di domain Amazon SageMaker AI.
+ `vpc-id`harus menjadi ID Amazon Virtual Private Cloud Anda. `subnet-ids`harus berupa daftar subnet yang dipisahkan spasi. IDs Untuk informasi tentang `vpc-id` dan`subnet-ids`, lihat [VPCs dan subnet](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html).
+ `RStudioPackageManagerUrl`dan `RStudioConnectUrl` bersifat opsional dan harus diatur ke URLs RStudio Package Manager dan RStudio Connect server Anda, masing-masing.
+ `auth-mode`harus salah satu `SSO` atau`IAM`.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode \
--default-user-settings ExecutionRole= \
--domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<,RStudioConnectUrl=<,DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids \
--app-network-access-type PublicInternetOnly
```
**VPCOnly modus**
Berikut ini menunjukkan cara meluncurkan domain Amazon SageMaker AI dengan RStudio diaktifkan dan Jenis `VPCOnly` Jaringan. Untuk informasi selengkapnya tentang menggunakan jenis akses `VPCOnly` jaringan, lihat[Hubungkan notebook Studio di VPC ke sumber daya eksternal](studio-notebooks-and-internet-access.md).
+ `DomainExecutionRoleArn`harus menjadi ARN untuk peran yang dibuat pada langkah sebelumnya.
+ `ExecutionRole`adalah ARN dari peran yang diberikan kepada pengguna di domain Amazon SageMaker AI.
+ `vpc-id`harus menjadi ID Amazon Virtual Private Cloud Anda. `subnet-ids`harus berupa daftar subnet yang dipisahkan spasi. IDs Subnet pribadi Anda harus dapat mengakses internet untuk melakukan panggilan ke Amazon SageMaker AI, dan AWS License Manager atau memiliki titik akhir Amazon VPC untuk Amazon SageMaker AI dan. AWS License Manager[Untuk informasi tentang titik akhir VPC Amazon, lihat Antarmuka Titik akhir [VPC Amazon Untuk informasi tentang `vpc-id` dan, lihat](https://docs.aws.amazon.com/vpc/latest/privatelink/vpce-interface.html) dan subnet. `subnet-ids` VPCs ](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html)
+ `SecurityGroups`harus mengizinkan akses keluar ke SageMaker AI Amazon dan titik AWS License Manager akhir.
+ `auth-mode`harus salah satu `SSO` atau`IAM`.
**catatan**
Saat menggunakan titik akhir Amazon Virtual Private Cloud, grup keamanan yang dilampirkan ke titik akhir Amazon Virtual Private Cloud Anda harus mengizinkan lalu lintas masuk dari grup keamanan yang Anda lewati sebagai bagian dari `domain-setting` parameter panggilan CLI`create-domain`.
Dengan RStudio, Amazon SageMaker AI mengelola grup keamanan untuk Anda. Ini berarti Amazon SageMaker AI mengelola aturan grup keamanan untuk memastikan RSessions dapat mengakses RStudio ServerPro Aplikasi. Amazon SageMaker AI membuat satu aturan grup keamanan per profil pengguna.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode \
--default-user-settings SecurityGroups=,ExecutionRole= \
--domain-settings SecurityGroupIds=,RStudioServerProDomainSettings={DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids "" \
--app-network-access-type VPCOnly --app-security-group-management Service
```
Catatan: RStudio ServerPro Aplikasi ini diluncurkan oleh profil pengguna khusus bernama`domain-shared`. Akibatnya, aplikasi ini tidak dikembalikan sebagai bagian dari panggilan `list-app` API oleh profil pengguna lain.
Anda mungkin harus menambah kuota VPC Amazon di akun Anda untuk menambah jumlah pengguna. Untuk informasi selengkapnya, lihat [kuota Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html#vpc-limits-security-groups).
## Verifikasi pembuatan domain
Gunakan perintah berikut untuk memverifikasi bahwa domain Anda telah dibuat dengan `Status` file`InService`. Anda `domain-id` ditambahkan ke domain ARN. Misalnya, `arn:aws:sagemaker:::domain/`.
```
aws sagemaker describe-domain --domain-id --region
```
# Tambahkan RStudio dukungan ke domain yang ada
**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.
Jika Anda telah menambahkan RStudio Lisensi melalui AWS License Manager, Anda dapat membuat domain Amazon SageMaker AI baru dengan dukungan untuk RStudio pada SageMaker AI. Jika Anda memiliki domain yang tidak mendukung RStudio, Anda dapat menambahkan RStudio dukungan ke domain tersebut tanpa harus menghapus dan membuat ulang domain tersebut.
Topik berikut menguraikan cara menambahkan dukungan ini.
## Prasyarat
Anda harus menyelesaikan langkah-langkah berikut sebelum memperbarui domain Anda saat ini untuk menambahkan dukungan RStudio pada SageMaker AI.
+ Instal dan konfigurasikan [AWS CLI versi 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
+ Konfigurasikan [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config)kredenal dengan IAM
+ Buat peran eksekusi domain mengikuti langkah-langkah dalam [Membuat Domain SageMaker AI dengan RStudio menggunakan AWS CLI](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-create-cli.html#rstudio-create-cli-domainexecution). Peran IAM tingkat domain ini diperlukan oleh aplikasi. RStudio ServerPro Peran tersebut memerlukan akses AWS License Manager untuk memverifikasi lisensi Posit Workbench yang valid dan Amazon CloudWatch Logs untuk menerbitkan log server.
+ Bawa RStudio lisensi Anda untuk AWS License Manager mengikuti langkah-langkah dalam [RStudiolisensi](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-license.html).
+ (Opsional) Jika Anda ingin menggunakan RStudio dalam `VPCOnly` mode, selesaikan langkah-langkahnya hanya [RStudio dalam VPC](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-network.html).
+ Pastikan bahwa grup keamanan yang telah Anda konfigurasikan untuk masing-masing [UserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)di domain Anda memenuhi kuota tingkat akun. Saat mengonfigurasi profil pengguna default selama pembuatan domain, Anda dapat menggunakan `DefaultUserSettings` parameter [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)API untuk menambahkan `SecurityGroups` yang diwarisi oleh semua profil pengguna yang dibuat di domain. Anda juga dapat menyediakan grup keamanan tambahan untuk pengguna tertentu sebagai bagian dari `UserSettings` parameter [CreateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)API. Jika Anda telah menambahkan grup keamanan dengan cara ini, Anda harus memastikan bahwa jumlah grup keamanan per profil pengguna tidak melebihi kuota maksimum 2 dalam `VPCOnly` mode dan 4 dalam `PublicInternetOnly` mode. Jika jumlah grup keamanan yang dihasilkan untuk profil pengguna melebihi kuota, Anda dapat menggabungkan beberapa aturan grup keamanan menjadi satu grup keamanan.
## Tambahkan RStudio dukungan ke domain yang ada
Setelah menyelesaikan prasyarat, Anda dapat menambahkan RStudio dukungan ke domain yang ada. Langkah-langkah berikut menguraikan cara memperbarui domain yang ada untuk menambahkan dukungan. RStudio
### Langkah 1: Hapus semua aplikasi di domain
Untuk menambahkan dukungan RStudio di domain Anda, SageMaker AI harus memperbarui grup keamanan yang mendasarinya untuk semua profil pengguna yang ada. Untuk menyelesaikan ini, Anda harus menghapus dan membuat ulang semua aplikasi yang ada di domain. Prosedur berikut menunjukkan cara menghapus semua aplikasi.
1. Daftar semua aplikasi di domain.
```
aws sagemaker \
list-apps \
--domain-id-equals
```
1. Hapus setiap aplikasi untuk setiap profil pengguna di domain.
```
// JupyterServer apps
aws sagemaker \
delete-app \
--domain-id \
--user-profile-name \
--app-type JupyterServer \
--app-name
// KernelGateway apps
aws sagemaker \
delete-app \
--domain-id \
--user-profile-name \
--app-type KernelGateway \
--app-name
```
### Langkah 2 - Perbarui semua profil pengguna dengan daftar baru grup keamanan
Ini adalah tindakan satu kali yang harus Anda selesaikan untuk semua profil pengguna yang ada di domain Anda ketika Anda telah memfaktorkan ulang grup keamanan yang ada. Ini mencegah Anda mencapai kuota untuk jumlah maksimum grup keamanan. Panggilan `UpdateUserProfile` API gagal jika pengguna memiliki aplikasi yang [InService](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeApp.html#sagemaker-DescribeApp-response-Status)berstatus. Hapus semua aplikasi, lalu panggil `UpdateUserProfile` API untuk memperbarui grup keamanan.
**catatan**
Persyaratan berikut untuk `VPCOnly` mode yang diuraikan dalam [Connect Amazon SageMaker Studio Classic Notebook dalam VPC ke Sumber Daya Eksternal](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-notebooks-and-internet-access.html#studio-notebooks-and-internet-access-vpc-only) tidak lagi diperlukan saat menambahkan RStudio dukungan karena dikelola oleh `AppSecurityGroupManagement` layanan AI: SageMaker
“[Lalu lintas TCP dalam grup keamanan](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-rules-reference.html#sg-rules-other-instances). Ini diperlukan untuk konektivitas antara JupyterServer aplikasi dan KernelGateway aplikasi. Anda harus mengizinkan akses ke setidaknya port dalam jangkauan`8192-65535`.”
```
aws sagemaker \
update-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
### Langkah 3 - Aktifkan RStudio dengan memanggil UpdateDomain API
1. Panggil [UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)API untuk menambahkan dukungan RStudio pada SageMaker AI. `defaultusersettings`Parameter ini hanya diperlukan jika Anda telah memfaktorkan ulang grup keamanan default untuk profil pengguna Anda.
+ Untuk `VPCOnly` mode:
```
aws sagemaker \
update-domain \
--domain-id \
--app-security-group-management Service \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=} \
--default-user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
+ Untuk `PublicInternetOnly` mode:
```
aws sagemaker \
update-domain \
--domain-id \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=} \
--default-user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
1. Verifikasi bahwa status domain tersebut`InService`. Setelah status domain`InService`, dukungan untuk RStudio SageMaker AI ditambahkan.
```
aws sagemaker \
describe-domain \
--domain-id
```
1. Verifikasi bahwa status RStudio ServerPro aplikasi `InService` menggunakan perintah berikut.
```
aws sagemaker list-apps --user-profile-name domain-shared
```
### Langkah 4 - Tambahkan RStudio akses untuk pengguna yang ada
Sebagai bagian dari pembaruan di Langkah 3, SageMaker AI menandai RStudio [AccessStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_RStudioServerProAppSettings.html#sagemaker-Type-RStudioServerProAppSettings-AccessStatus)semua profil pengguna yang ada di domain sebagai `DISABLED` default. Ini mencegah melebihi jumlah pengguna yang diizinkan oleh lisensi Anda saat ini. Untuk menambahkan akses bagi pengguna yang ada, ada langkah keikutsertaan satu kali. Lakukan opt-in dengan memanggil [UpdateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateUserProfile.html)API dengan yang berikut: [RStudioServerProAppSettings](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UserSettings.html#sagemaker-Type-UserSettings-RStudioServerProAppSettings)
+ `AccessStatus` = `ENABLED`
+ *Opsional* - `UserGroup` = `R_STUDIO_USER` atau `R_STUDIO_ADMIN`
```
aws sagemaker \
update-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"ENABLED\"}}"
```
**catatan**
Secara default, jumlah pengguna yang dapat memiliki akses ke RStudio adalah 60.
### Langkah 5 - Nonaktifkan RStudio akses untuk pengguna baru
Kecuali ditentukan lain saat menelepon`UpdateDomain`, RStudio dukungan ditambahkan secara default untuk semua profil pengguna baru yang dibuat setelah Anda menambahkan dukungan untuk RStudio pada SageMaker AI. Untuk menonaktifkan akses untuk profil pengguna baru, Anda harus secara eksplisit mengatur `AccessStatus` parameter `DISABLED` sebagai bagian dari panggilan API. `CreateUserProfile` Jika `AccessStatus` parameter tidak ditentukan sebagai bagian dari `CreateUserProfile` API, status akses default adalah`ENABLED`.
```
aws sagemaker \
create-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"DISABLED\"}}"
```
# Gambar khusus RStudio dengan SageMaker AI
SageMaker Gambar adalah file yang mengidentifikasi paket bahasa dan dependensi lain yang diperlukan untuk berjalan di RStudio Amazon AI. SageMaker SageMaker AI menggunakan gambar-gambar ini untuk menciptakan lingkungan tempat Anda berlari RStudio. Amazon SageMaker AI menyediakan RStudio gambar bawaan untuk Anda gunakan. Jika Anda membutuhkan fungsionalitas yang berbeda, Anda dapat membawa gambar kustom Anda sendiri. Halaman ini memberikan informasi tentang konsep kunci untuk menggunakan gambar khusus dengan RStudio SageMaker AI. Proses untuk membawa gambar Anda sendiri untuk digunakan RStudio pada SageMaker AI membutuhkan tiga langkah:
1. Buat gambar kustom dari Dockerfile dan dorong ke repositori di Amazon Elastic Container Registry (Amazon ECR).
1. Buat SageMaker gambar yang mengarah ke gambar kontainer di Amazon ECR dan lampirkan ke domain Amazon SageMaker AI Anda.
1. Luncurkan sesi baru RStudio dengan gambar kustom Anda.
Anda dapat membuat gambar dan versi gambar, dan melampirkan versi gambar ke domain Anda, menggunakan panel kontrol SageMaker AI [AWS SDK untuk Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html),, dan [AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/). Anda juga dapat membuat gambar dan versi gambar menggunakan konsol SageMaker AI, bahkan jika Anda belum onboard ke domain.
Topik berikut menunjukkan cara membawa gambar Anda RStudio sendiri ke SageMaker AI dengan membuat, melampirkan, dan meluncurkan gambar khusus.
## Terminologi kunci
Bagian berikut mendefinisikan istilah kunci untuk membawa gambar Anda sendiri untuk digunakan RStudio pada SageMaker AI.
+ **Dockerfile:** Dockerfile adalah file yang mengidentifikasi paket bahasa dan dependensi lain untuk image Docker Anda.
+ Gambar **Docker: Gambar** Docker adalah Dockerfile yang dibangun. Gambar ini diperiksa ke Amazon ECR dan berfungsi sebagai dasar gambar SageMaker AI.
+ **SageMaker image:** SageMaker Gambar adalah dudukan untuk satu set versi SageMaker gambar berdasarkan gambar Docker.
+ **Versi gambar:** Versi gambar dari SageMaker gambar mewakili gambar Docker yang kompatibel dengan RStudio dan disimpan dalam repositori Amazon ECR. Setiap versi gambar tidak dapat diubah. Versi gambar ini dapat dilampirkan ke domain dan digunakan dengan RStudio SageMaker AI.
# Prasyarat lengkap
Anda harus menyelesaikan prasyarat berikut sebelum membawa gambar Anda sendiri untuk digunakan di RStudio Amazon AI. SageMaker
+ Jika Anda memiliki domain RStudio yang sudah dibuat sebelum 7 April 2022, Anda harus menghapus RStudio ServerPro aplikasi Anda dan membuatnya kembali. Untuk informasi tentang cara menghapus aplikasi, lihat[Matikan dan Perbarui Amazon SageMaker Studio Classic](studio-tasks-update-studio.md).
+ Instal aplikasi Docker. Untuk informasi tentang pengaturan Docker, lihat [Orientasi dan penyiapan](https://docs.docker.com/get-started/).
+ Buat salinan lokal dari Dockerfile RStudio -kompatibel yang bekerja dengan AI. SageMaker Untuk informasi tentang membuat contoh RStudio dockerfile, lihat [Menggunakan gambar khusus untuk menghadirkan lingkungan pengembangan Anda sendiri di RStudio Amazon SageMaker AI](https://aws.amazon.com/blogs/machine-learning/use-a-custom-image-to-bring-your-own-development-environment-to-rstudio-on-amazon-sagemaker/).
+ Gunakan peran AWS Identity and Access Management eksekusi yang memiliki [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)kebijakan terlampir. Jika Anda telah melakukan onboard ke domain, Anda bisa mendapatkan peran tersebut dari bagian **Ringkasan domain** pada panel kontrol SageMaker AI.
Tambahkan izin berikut untuk mengakses layanan Amazon Elastic Container Registry (Amazon ECR) ke peran eksekusi Anda.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Sid": "VisualEditor0",
"Effect":"Allow",
"Action":[
"ecr:CreateRepository",
"ecr:BatchGetImage",
"ecr:CompleteLayerUpload",
"ecr:DescribeImages",
"ecr:DescribeRepositories",
"ecr:UploadLayerPart",
"ecr:ListImages",
"ecr:InitiateLayerUpload",
"ecr:BatchCheckLayerAvailability",
"ecr:PutImage"
],
"Resource": "*"
}
]
}
```
------
+ Instal dan konfigurasikan AWS CLI dengan versi berikut (atau lebih tinggi). Untuk informasi tentang menginstal AWS CLI, lihat [Menginstal atau memperbarui versi terbaru AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
```
AWS CLI v1 >= 1.23.6
AWS CLI v2 >= 2.6.2
```
# Spesifikasi RStudio gambar khusus
Dalam panduan ini, Anda akan mempelajari spesifikasi RStudio gambar khusus untuk digunakan saat Anda membawa gambar Anda sendiri. Ada dua set persyaratan yang harus Anda penuhi dengan RStudio gambar khusus Anda untuk menggunakannya dengan Amazon SageMaker AI. Persyaratan ini diberlakukan oleh RStudio PBC dan platform Amazon SageMaker Studio Classic. Jika salah satu dari rangkaian persyaratan ini tidak terpenuhi, maka gambar kustom Anda tidak akan berfungsi dengan baik.
## RStudio Persyaratan PBC
RStudio Persyaratan PBC ditata dalam artikel [Menggunakan gambar Docker dengan RStudio Workbench RStudio /Server Pro, Launcher,](https://support.rstudio.com/hc/en-us/articles/360019253393-Using-Docker-images-with-RStudio-Server-Pro-Launcher-and-Kubernetes) dan Kubernetes. Ikuti petunjuk dalam artikel ini untuk membuat dasar RStudio gambar kustom Anda.
Untuk petunjuk tentang cara menginstal beberapa versi R dalam gambar kustom Anda, lihat [Menginstal beberapa versi R di Linux](https://support.rstudio.com/hc/en-us/articles/215488098).
## Persyaratan Amazon SageMaker Studio Classic
Amazon SageMaker Studio Classic memberlakukan serangkaian persyaratan instalasi berikut untuk RStudio gambar Anda.
+ Anda harus menggunakan gambar RStudio dasar setidaknya`2025.05.1+513.pro3`. Untuk informasi selengkapnya, lihat [RStudio Pembuatan Versi](rstudio-version.md).
+ Anda harus menginstal paket-paket berikut:
```
yum install -y sudo \
openjdk-11-jdk \
libpng-dev \
&& yum clean all \
&& /opt/R/${R_VERSION}/bin/R -e "install.packages('reticulate', repos='https://packagemanager.rstudio.com/cran/__linux__/centos7/latest')" \
&& /opt/python/${PYTHON_VERSION}/bin/pip install --upgrade \
'boto3>1.0<2.0' \
'awscli>1.0<2.0' \
'sagemaker[local]<3'
```
+ Anda harus memberikan nilai default untuk nilai `RSTUDIO_CONNECT_URL` dan `RSTUDIO_PACKAGE_MANAGER_URL` lingkungan.
```
ENV RSTUDIO_CONNECT_URL "YOUR_CONNECT_URL"
ENV RSTUDIO_PACKAGE_MANAGER_URL "YOUR_PACKAGE_MANAGER_URL"
ENV RSTUDIO_FORCE_NON_ZERO_EXIT_CODE 1
```
Spesifikasi umum berikut berlaku untuk gambar yang diwakili oleh versi RStudio gambar.
**Menjalankan gambar**
`ENTRYPOINT`dan `CMD` instruksi diganti sehingga gambar dijalankan sebagai aplikasi. RSession
**Menghentikan gambar**
`DeleteApp`API mengeluarkan `docker stop` perintah yang setara. Proses lain dalam wadah tidak akan mendapatkan SIGKILL/SIGTERM sinyal.
**Sistem file**
`/opt/ml`Direktori `/opt/.sagemakerinternal` dan dicadangkan. Data apa pun di direktori ini mungkin tidak terlihat saat runtime.
**Data pengguna**
Setiap pengguna dalam domain SageMaker AI mendapatkan direktori pengguna pada volume Amazon Elastic File System bersama dalam gambar. Lokasi direktori pengguna saat ini pada volume Amazon Elastic File System adalah`/home/sagemaker-user`.
**Metadata**
File metadata terletak di. `/opt/ml/metadata/resource-metadata.json` Tidak ada variabel lingkungan tambahan yang ditambahkan ke variabel yang ditentukan dalam gambar. Untuk informasi selengkapnya, lihat [Dapatkan Metadata Aplikasi](notebooks-run-and-manage-metadata.md#notebooks-run-and-manage-metadata-app).
**GPU**
Pada instance GPU, gambar dijalankan dengan `--gpus` opsi. Hanya toolkit CUDA yang harus disertakan dalam gambar, bukan driver NVIDIA. Untuk informasi selengkapnya, lihat [Panduan Pengguna NVIDIA](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/user-guide.html).
**Metrik dan pencatatan**
Log dari RSession proses dikirim ke Amazon CloudWatch di akun pelanggan. Nama grup log adalah`/aws/sagemaker/studio`. Nama aliran log adalah`$domainID/$userProfileName/RSession/$appName`.
**Ukuran gambar**
Ukuran gambar dibatasi hingga 25 GB. Untuk melihat ukuran gambar Anda, jalankan`docker image ls`.
# Buat RStudio gambar kustom
**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.
Topik ini menjelaskan bagaimana Anda dapat membuat RStudio gambar khusus menggunakan konsol SageMaker AI dan AWS CLI. Jika Anda menggunakan AWS CLI, Anda harus menjalankan langkah-langkah dari mesin lokal Anda. Langkah-langkah berikut tidak berfungsi dari dalam Amazon SageMaker Studio Classic.
Saat Anda membuat gambar, SageMaker AI juga membuat versi gambar awal. Versi gambar mewakili gambar kontainer di [Amazon Elastic Container Registry (ECR)](https://console.aws.amazon.com/ecr/). Gambar kontainer harus memenuhi persyaratan yang akan digunakan RStudio. Untuk informasi selengkapnya, lihat [Spesifikasi RStudio gambar khusus](rstudio-byoi-specs.md).
Untuk informasi tentang menguji gambar Anda secara lokal dan menyelesaikan masalah umum, lihat repo [Sampel Gambar Kustom SageMaker Studio](https://github.com/aws-samples/sagemaker-studio-custom-image-samples/blob/main/DEVELOPMENT.md).
**Topics**
+ [
## Tambahkan gambar kontainer RStudio Docker yang SageMaker kompatibel dengan AI ke Amazon ECR
](#rstudio-byoi-sdk-add-container-image)
+ [
## Buat SageMaker gambar dari konsol
](#rstudio-byoi-create-console)
+ [
## Buat gambar dari AWS CLI
](#rstudio-byoi-create-cli)
## Tambahkan gambar kontainer RStudio Docker yang SageMaker kompatibel dengan AI ke Amazon ECR
Gunakan langkah-langkah berikut untuk menambahkan image container Docker ke Amazon ECR:
+ Buat repositori Amazon ECR.
+ Otentikasi ke Amazon ECR.
+ Buat image RStudio Docker yang SageMaker kompatibel dengan AI.
+ Dorong gambar ke repositori Amazon ECR.
**catatan**
Repositori Amazon ECR harus Wilayah AWS sama dengan domain Anda.
**Untuk membangun dan menambahkan image Docker ke Amazon ECR**
1. Buat repositori Amazon ECR menggunakan file. AWS CLI Untuk membuat repositori menggunakan konsol Amazon ECR, lihat [Membuat](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-create.html) repositori.
```
aws ecr create-repository \
--repository-name rstudio-custom \
--image-scanning-configuration scanOnPush=true
```
Respons:
```
{
"repository": {
"repositoryArn": "arn:aws:ecr:us-east-2:acct-id:repository/rstudio-custom",
"registryId": "acct-id",
"repositoryName": "rstudio-custom",
"repositoryUri": "acct-id.dkr.ecr.us-east-2.amazonaws.com/rstudio-custom",
...
}
}
```
1. Otentikasi ke Amazon ECR menggunakan URI repositori yang dikembalikan sebagai respons dari perintah. `create-repository` Pastikan aplikasi Docker sedang berjalan. Untuk informasi selengkapnya, lihat [Otentikasi Registri](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html#registry_auth).
```
aws ecr get-login-password | \
docker login --username AWS --password-stdin
```
Respons:
```
Login Succeeded
```
1. membuat gambar Docker. Jalankan perintah berikut dari direktori yang menyertakan Dockerfile Anda.
```
docker build .
```
1. Tandai gambar buatan Anda dengan tag unik.
```
docker tag ":"
```
1. Dorong gambar kontainer ke repositori Amazon ECR. Untuk informasi selengkapnya, lihat [ImagePush](https://docs.docker.com/engine/api/v1.40/#operation/ImagePush)dan [Mendorong gambar](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html).
```
docker push :
```
Respons:
```
The push refers to repository [.dkr.ecr.us-east-2.amazonaws.com/rstudio-custom]
r: digest: size: 3066
```
## Buat SageMaker gambar dari konsol
**Untuk membuat gambar**
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 **Gambar**.
1. Pada halaman **Custom images**, pilih **Create image**.
1. Untuk **Sumber gambar**, masukkan jalur registri ke gambar kontainer di Amazon ECR. Path dalam format berikut:
` acct-id.dkr.ecr.region.amazonaws.com/repo-name[:tag] or [@digest] `
1. Pilih **Berikutnya**.
1. Di bawah **properti Gambar**, masukkan yang berikut ini:
+ Nama gambar — Nama harus unik untuk akun Anda saat ini Wilayah AWS.
+ (Opsional) Nama tampilan gambar - Nama yang ditampilkan di antarmuka pengguna domain. Ketika tidak disediakan, `Image name` ditampilkan.
+ (Opsional) Deskripsi — Deskripsi gambar.
+ Peran IAM — Peran harus memiliki [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)kebijakan yang dilampirkan. Gunakan menu tarik-turun untuk memilih salah satu opsi berikut:
+ Buat peran baru — Tentukan bucket Amazon Simple Storage Service (Amazon S3) tambahan yang ingin diakses oleh pengguna notebook. Jika Anda tidak ingin mengizinkan akses ke bucket tambahan, pilih **Tidak Ada**.
SageMaker AI melampirkan `AmazonSageMakerFullAccess` kebijakan pada peran tersebut. Peran ini memungkinkan pengguna notebook Anda mengakses bucket Amazon S3 yang tercantum di sebelah tanda centang.
+ Masukkan peran IAM khusus ARN — Masukkan Nama Sumber Daya Amazon (ARN) peran IAM Anda.
+ Gunakan peran yang ada — Pilih salah satu peran yang ada dari daftar.
+ (Opsional) Tag gambar - Pilih **Tambahkan tag baru**. Anda dapat menambahkan hingga 50 tag. Tag dapat dicari menggunakan konsol SageMaker AI atau SageMaker AI `Search` API.
1. Di bawah **Jenis gambar**, pilih RStudio gambar.
1. Pilih **Kirim**.
Gambar baru ditampilkan dalam daftar **gambar Kustom** dan disorot secara singkat. Setelah gambar berhasil dibuat, Anda dapat memilih nama gambar untuk melihat propertinya atau memilih **Buat versi** untuk membuat versi lain.
**Untuk membuat versi gambar lain**
1. Pilih **Buat versi** pada baris yang sama dengan gambar.
1. Untuk **Sumber gambar**, masukkan jalur registri ke gambar Amazon ECR. Gambar tidak boleh menjadi gambar yang sama seperti yang digunakan dalam versi sebelumnya dari gambar SageMaker AI.
Untuk menggunakan gambar kustom RStudio, Anda harus melampirkannya ke domain Anda. Untuk informasi selengkapnya, lihat [Lampirkan SageMaker gambar khusus](rstudio-byoi-attach.md).
## Buat gambar dari AWS CLI
Bagian ini menunjukkan cara membuat SageMaker gambar Amazon khusus menggunakan file AWS CLI.
Gunakan langkah-langkah berikut untuk membuat SageMaker gambar:
+ Buat `Image`.
+ Buat `ImageVersion`.
+ Buat file konfigurasi.
+ Buat `AppImageConfig`.
**Untuk membuat entitas SageMaker gambar**
1. Buat SageMaker gambar. Peran ARN harus memiliki setidaknya `AmazonSageMakerFullAccessPolicy` kebijakan terlampir.
```
aws sagemaker create-image \
--image-name rstudio-custom-image \
--role-arn arn:aws:iam:::role/service-role/
```
Respons:
```
{
"ImageArn": "arn:aws:sagemaker:us-east-2:acct-id:image/rstudio-custom-image"
}
```
1. Buat versi SageMaker gambar dari gambar. Berikan nilai tag unik yang Anda pilih saat Anda mendorong gambar ke Amazon ECR.
```
aws sagemaker create-image-version \
--image-name rstudio-custom-image \
--base-image :
```
Respons:
```
{
"ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/rstudio-image/1"
}
```
1. Periksa apakah versi gambar berhasil dibuat.
```
aws sagemaker describe-image-version \
--image-name rstudio-custom-image \
--version 1
```
Respons:
```
{
"ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/rstudio-custom-image/1",
"ImageVersionStatus": "CREATED"
}
```
**catatan**
Jika responsnya`"ImageVersionStatus": "CREATED_FAILED"`, responsnya juga mencakup alasan kegagalan. Masalah izin adalah penyebab umum kegagalan. Anda juga dapat memeriksa CloudWatch Log Amazon Anda. Nama grup log adalah`/aws/sagemaker/studio`. Nama aliran log adalah`$domainID/$userProfileName/KernelGateway/$appName`.
1. Buat file konfigurasi, bernama`app-image-config-input.json`. Konfigurasi gambar aplikasi digunakan untuk konfigurasi untuk menjalankan SageMaker gambar sebagai aplikasi Kernel Gateway.
```
{
"AppImageConfigName": "rstudio-custom-config"
}
```
1. Buat AppImageConfig menggunakan file yang Anda buat di langkah sebelumnya.
```
aws sagemaker create-app-image-config \
--cli-input-json file://app-image-config-input.json
```
Respons:
```
{
"AppImageConfigArn": "arn:aws:sagemaker:us-east-2:acct-id:app-image-config/r-image-config"
}
```
# Lampirkan SageMaker gambar 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](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 Wilayah AWS 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
```
# Luncurkan SageMaker gambar khusus di RStudio
Anda dapat menggunakan gambar kustom Anda saat meluncurkan RStudio aplikasi dari konsol. Setelah Anda membuat SageMaker gambar kustom dan melampirkannya ke domain Anda, gambar muncul di kotak dialog pemilih gambar RStudio Peluncur. Untuk meluncurkan RStudio aplikasi baru, ikuti langkah-langkah [Peluncuran RSessions dari RStudio Peluncur](rstudio-launcher.md) dan pilih gambar kustom Anda seperti yang ditunjukkan pada gambar berikut.
![\[Tangkapan layar RStudio peluncur dengan dropdown gambar.\]](http://docs.aws.amazon.com/id_id/sagemaker/latest/dg/images/rstudio-launcher-custom.png)
# Bersihkan sumber daya gambar
Panduan ini menunjukkan cara membersihkan sumber daya RStudio gambar yang Anda buat di bagian sebelumnya. Untuk menghapus gambar, selesaikan langkah-langkah berikut menggunakan konsol SageMaker AI atau AWS CLI, seperti yang ditunjukkan dalam panduan ini.
+ Lepaskan versi gambar dan gambar dari domain Amazon SageMaker AI Anda.
+ Hapus gambar, versi gambar, dan konfigurasi gambar aplikasi.
Setelah Anda menyelesaikan langkah-langkah ini, Anda dapat menghapus gambar kontainer dan repositori dari Amazon ECR. Untuk informasi selengkapnya tentang cara menghapus gambar kontainer dan repositori, lihat [Menghapus](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-delete.html) repositori.
## Bersihkan sumber daya dari konsol SageMaker AI
Saat Anda melepaskan gambar dari domain, semua versi gambar akan terlepas. Ketika gambar terlepas, semua pengguna domain kehilangan akses ke versi gambar.
**Untuk melepaskan gambar**
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 khusus yang dilampirkan ke domain**, pilih gambar dan kemudian pilih **Lepaskan**.
1. (Opsional) Untuk menghapus gambar dan semua versi dari SageMaker AI, pilih **Hapus juga gambar yang dipilih...** . Ini tidak menghapus gambar terkait dari Amazon ECR.
1. Pilih **Lepaskan**.
## Membersihkan sumber daya dari AWS CLI
**Untuk membersihkan sumber daya**
1. Lepaskan versi gambar dan gambar dari domain Anda dengan meneruskan daftar gambar kustom kosong ke domain. Buka `update-domain-input.json` file yang Anda buat[Lampirkan SageMaker gambar ke domain Anda saat ini](studio-byoi-attach.md#studio-byoi-sdk-attach-current-domain).
1. Hapus gambar `RSessionAppSettings` khusus dan kemudian simpan file. Jangan memodifikasi gambar `KernelGatewayAppSettings` kustom.
```
{
"DomainId": "d-xxxxxxxxxxxx",
"DefaultUserSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
},
"RSessionAppSettings": {
"CustomImages": [
],
"DefaultResourceSpec": {
}
...
}
}
}
```
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:us-east-2:acct-id:domain/d-xxxxxxxxxxxx"
}
```
1. Hapus konfigurasi gambar aplikasi.
```
aws sagemaker delete-app-image-config \
--app-image-config-name rstudio-image-config
```
1. Hapus SageMaker gambar, yang juga menghapus semua versi gambar. Gambar kontainer di Amazon ECR yang diwakili oleh versi gambar tidak dihapus.
```
aws sagemaker delete-image \
--image-name rstudio-image
```
# Buat pengguna untuk digunakan RStudio
**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.
Setelah RStudio domain Amazon SageMaker AI yang diaktifkan berjalan, Anda dapat menambahkan profil pengguna (UserProfiles) ke domain. Topik berikut menunjukkan cara membuat profil pengguna yang diizinkan untuk digunakan RStudio, serta memperbarui profil pengguna yang ada. Untuk informasi tentang cara menghapus RStudio Aplikasi, UserProfile, atau domain, ikuti langkah-langkah di [Menghapus domain Amazon SageMaker AI](https://docs.aws.amazon.com/sagemaker/latest/dg/gs-studio-delete-domain.html).
**catatan**
Batas untuk jumlah total UserProfiles dalam domain SageMaker AI Amazon adalah 60.
Ada dua jenis pengguna:
+ Tidak sah: Pengguna ini tidak dapat mengakses RStudio aplikasi.
+ Resmi: Pengguna ini dapat mengakses RStudio aplikasi dan menggunakan salah satu kursi RStudio lisensi. Secara default, pengguna baru adalah `Authorized` jika domain diaktifkan untuk RStudio.
Mengubah status otorisasi pengguna hanya berlaku dari `Unauthorized` ke`Authorized`. Jika pengguna diotorisasi, mereka dapat diberikan salah satu dari tingkat akses berikut RStudio.
+ RStudio Pengguna: Ini adalah RStudio pengguna standar dan dapat mengakses RStudio.
+ RStudio Admin: Admin domain Amazon SageMaker AI Anda memiliki kemampuan untuk membuat pengguna, menambahkan pengguna yang ada, dan memperbarui izin pengguna yang ada. Admin juga dapat mengakses dasbor RStudio Administratif. Namun, admin ini tidak dapat memperbarui parameter yang dikelola oleh Amazon SageMaker AI.
## Metode untuk membuat pengguna
Topik berikut menunjukkan cara membuat pengguna di domain Amazon SageMaker AI RStudio yang diaktifkan.
**Buat konsol pengguna**
Untuk membuat pengguna di domain Amazon SageMaker AI RStudio yang diaktifkan dari konsol, selesaikan langkah-langkahnya. [Tambahkan profil pengguna](domain-user-profile-add.md)
**Buat CLI pengguna**
Perintah berikut menunjukkan cara menambahkan pengguna ke domain Amazon SageMaker AI dengan otentikasi IAM. Pengguna dapat menjadi bagian dari grup `R_STUDIO_USER` atau `R_STUDIO_ADMIN` Pengguna.
```
aws sagemaker create-user-profile --region \
--domain-id \
--user-profile-name \
--user-settings RStudioServerProAppSettings={UserGroup=}
```
Perintah berikut menunjukkan cara menambahkan pengguna ke domain Amazon SageMaker AI dengan otentikasi menggunakan IAM Identity Center. Seorang pengguna dapat menjadi bagian dari grup `R_STUDIO_USER` atau `R_STUDIO_ADMIN` Pengguna.
```
aws sagemaker create-user-profile --region \
--domain-id \
--user-profile-name \
--user-settings RStudioServerProAppSettings={UserGroup=} \
--single-sign-on-user-identifier UserName \
--single-sign-on-user-value
```
# Masuk RStudio sebagai pengguna lain
Topik berikut menunjukkan cara masuk ke RStudio Amazon SageMaker AI sebagai pengguna lain.
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 berisi profil pengguna.
1. Pilih nama pengguna dari daftar pengguna. Ini membuka halaman baru dengan detail tentang profil pengguna dan aplikasi yang sedang berjalan.
1. Pilih **Luncurkan**.
1. Dari dropdown, pilih **RStudio**untuk meluncurkan instance RStudio .
# Mengakhiri sesi untuk pengguna lain
Topik berikut menunjukkan cara menghentikan sesi untuk pengguna lain di RStudio Amazon SageMaker AI.
1. Dari daftar aplikasi yang sedang berjalan, identifikasi aplikasi yang ingin Anda hapus.
1. Klik tombol **Hapus aplikasi** masing-masing untuk aplikasi yang Anda hapus.
# Gunakan dasbor RStudio administratif
Topik ini menunjukkan cara mengakses dan menggunakan dasbor RStudio administratif. Dengan dasbor RStudio administratif, admin dapat mengelola pengguna dan RSessions, serta melihat informasi tentang pemanfaatan instance RStudio Server dan Log Amazon. CloudWatch
## Luncurkan dasbor RStudio administratif
`R_STUDIO_ADMIN`Otorisasi memungkinkan pengguna untuk mengakses dasbor RStudio administratif. `R_STUDIO_ADMIN`Pengguna dapat mengakses dasbor RStudio administratif dengan mengganti `workspaces` dengan RStudio URL mereka `admin` secara manual. Berikut ini menunjukkan cara memodifikasi URL untuk mengakses dasbor RStudio administratif.
Misalnya, RStudio URL berikut:
```
https://.studio.us-east-2.sagemaker.aws/rstudio/default/s//workspaces
```
Dapat dikonversi ke:
```
https://.studio.us-east-2.sagemaker.aws/rstudio/default/s//admin
```
## Tab dasbor
Tab ini memberikan gambaran umum tentang pemanfaatan instance RStudio Server Anda, serta informasi tentang jumlah aktif RSessions.
## Tab sesi
Tab ini memberikan informasi tentang yang aktif RSessions, seperti pengguna yang meluncurkan RSessions, waktu yang RSessions telah berjalan, dan pemanfaatan sumber daya mereka.
## Tab pengguna
Tab ini memberikan informasi tentang pengguna yang RStudio berwenang di domain, seperti waktu yang terakhir RSession diluncurkan dan pemanfaatan sumber daya mereka.
## Tab Statistik
Tab ini memberikan informasi tentang penggunaan instance RStudio Server Anda.
## Tab log
Tab ini menampilkan CloudWatch Log Amazon untuk instance RStudio Server. Untuk informasi selengkapnya tentang peristiwa logging dengan Amazon CloudWatch Logs, lihat [Apa itu Amazon CloudWatch Logs?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) .
# Matikan RStudio
**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.
Untuk mematikan dan memulai ulang Posit Workbench Anda dan RStudio ServerPro aplikasi terkait, Anda harus terlebih dahulu mematikan semua yang ada RSessions. Anda dapat mematikan aplikasi RSession Gateway dari dalam RStudio. Anda kemudian dapat mematikan RStudio ServerPro aplikasi menggunakan file AWS CLI. Setelah RStudio ServerPro aplikasi dimatikan, Anda harus membuka kembali RStudio melalui konsol SageMaker AI.
Setiap informasi buku catatan yang belum disimpan hilang dalam prosesnya. Data pengguna dalam volume Amazon EFS tidak terpengaruh.
**catatan**
Jika Anda menggunakan gambar kustom dengan RStudio, pastikan gambar docker Anda menggunakan RStudio versi yang kompatibel dengan versi Posit Workbench yang digunakan oleh SageMaker AI setelah Anda memulai ulang aplikasi. RStudio ServerPro
Topik berikut menunjukkan cara mematikan RSession Gateway dan RStudio ServerPro aplikasi dan memulai ulang.
## Tangguhkan RSessions
Selesaikan prosedur berikut untuk menangguhkan semua Anda RSessions.
1. Dari RStudio Peluncur, identifikasi RSession yang ingin Anda tangguhkan.
1. Pilih **Tangguhkan** untuk sesi.
1. Ulangi ini untuk semua RSessions.
## Hapus RSessions
Selesaikan prosedur berikut untuk mematikan semua Anda RSessions.
1. Dari RStudio Peluncur, identifikasi RSession yang ingin Anda hapus.
1. Pilih **Keluar** untuk sesi. Ini membuka jendela **Quit Session** baru.
1. Dari jendela **Keluar Sesi**, pilih **Paksa Keluar**, untuk mengakhiri semua proses anak dalam sesi.
1. Pilih **Keluar Sesi** untuk mengonfirmasi penghapusan sesi.
1. Ulangi ini untuk semua RSessions.
## Hapus RStudio ServerPro aplikasi Anda
Jalankan perintah berikut dari AWS CLI untuk menghapus dan memulai ulang RStudio ServerPro aplikasi Anda.
1. Hapus RStudio ServerPro aplikasi dengan menggunakan id domain Anda saat ini.
```
aws sagemaker delete-app \
--domain-id \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
1. Buat ulang RStudio ServerPro aplikasi.
```
aws sagemaker create-app \
--domain-id \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
# Penagihan dan biaya
Untuk melacak biaya yang terkait dengan RStudio lingkungan Anda, Anda dapat menggunakan AWS Manajemen Penagihan dan Biaya layanan ini.AWS Manajemen Penagihan dan Biaya menyediakan alat yang berguna untuk membantu Anda mengumpulkan informasi yang terkait dengan biaya dan penggunaan Anda, menganalisis driver biaya dan tren penggunaan Anda, dan mengambil tindakan untuk menganggarkan pengeluaran Anda. Untuk informasi selengkapnya, lihat [Apa itu AWS Billing and Cost Management?](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html) . Berikut ini menjelaskan komponen yang diperlukan untuk berjalan RStudio di Amazon SageMaker AI dan bagaimana faktor masing-masing komponen dalam penagihan untuk RStudio instans Anda.
+ RStudio Lisensi —Anda harus membeli RStudio lisensi. Tidak ada biaya tambahan untuk menggunakan RStudio lisensi Anda dengan Amazon SageMaker AI. Untuk informasi selengkapnya tentang RStudio lisensi Anda, lihat[Dapatkan RStudio lisensi](rstudio-license.md).
+ RSession - Ini adalah sesi RStudio kerja yang diluncurkan oleh pengguna akhir. Anda dikenakan biaya saat RSession sedang berjalan.
+ RStudio Server - Server multi-penyewa mengelola semua. RSessions Anda dapat memilih jenis instans untuk menjalankan RStudio Server, dan membayar biaya terkait. Contoh default, “sistem”, gratis, tetapi Anda dapat memilih untuk membayar tingkat yang lebih tinggi. Untuk informasi selengkapnya tentang jenis instans yang tersedia untuk RStudio Server Anda, lihat[RStudioServerPro jenis contoh](rstudio-select-instance.md).
**Melacak penagihan di tingkat pengguna**
Untuk melacak penagihan di tingkat pengguna menggunakan Tag Alokasi Biaya, lihat [Menggunakan Tag Alokasi Biaya](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html).
# Mendiagnosis masalah dan mendapatkan dukungan
Bagian berikut menjelaskan cara mendiagnosis masalah RStudio di Amazon SageMaker AI. Untuk mendapatkan dukungan RStudio di Amazon SageMaker AI, hubungi dukungan Amazon SageMaker AI. Untuk bantuan dalam membeli RStudio lisensi atau memodifikasi jumlah kursi lisensi, hubungi [sales@rstudio.com](mailto:sales@rstudio.com).
## Tingkatkan versi Anda
Jika Anda menerima peringatan bahwa ada ketidakcocokan versi antara Anda RSession dan RStudio ServerPro aplikasi, maka Anda harus memutakhirkan versi RStudio ServerPro aplikasi Anda. Untuk informasi selengkapnya, lihat [RStudio Pembuatan Versi](rstudio-version.md).
## Lihat Metrik dan Log
Anda dapat memantau kinerja alur kerja Anda saat menggunakan RStudio di Amazon SageMaker AI. Lihat log data dan informasi tentang metrik dengan dasbor RStudio administratif atau Amazon CloudWatch.
### Lihat RStudio log Anda dari dasbor RStudio administratif
Anda dapat melihat metrik dan log langsung dari dasbor RStudio administratif.
1. Masuk ke **domain Amazon SageMaker AI** Anda.
1. Arahkan ke dasbor RStudio administratif mengikuti langkah-langkah masuk[Gunakan dasbor RStudio administratif](rstudio-admin.md).
1. Pilih tab **Log**.
### Melihat RStudio log Anda dari Amazon CloudWatch Logs
Amazon CloudWatch memantau AWS sumber daya Anda dan aplikasi yang Anda jalankan AWS secara real time. Anda dapat menggunakan Amazon CloudWatch untuk mengumpulkan dan melacak metrik, yang merupakan variabel yang dapat Anda ukur untuk sumber daya dan aplikasi Anda. Untuk memastikan bahwa RStudio aplikasi Anda memiliki izin untuk Amazon CloudWatch, Anda harus menyertakan izin yang dijelaskan di. [Ikhtisar domain Amazon SageMaker AI](gs-studio-onboard.md) Anda tidak perlu melakukan pengaturan apa pun untuk mengumpulkan CloudWatch Log Amazon.
Langkah-langkah berikut menunjukkan cara melihat CloudWatch Log Amazon untuk Anda RSession.
Log ini dapat ditemukan di aliran `/aws/sagemaker/studio` log dari AWS CloudWatch konsol.
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Pilih `Logs` dari sisi kiri. Dari menu tarik-turun, pilih. `Log groups`
1. Di `Log groups` layar, cari`aws/sagemaker/studio`. Pilih grup Log.
1. Di `aws/sagemaker/studio` `Log group` layar, navigasikan ke `Log streams` tab.
1. Untuk menemukan log untuk domain Anda, cari `Log streams` menggunakan format berikut:
```
/domain-shared/rstudioserverpro/default
```