Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bawa gambar Anda sendiri (BYOI)
Gambar adalah file yang mengidentifikasi kernel, paket bahasa, dan dependensi lain yang diperlukan untuk menjalankan aplikasi Anda. Ini termasuk:
+ Bahasa pemrograman (seperti Python atau R)
+ Kernel
+ Perpustakaan dan paket
+ Perangkat lunak lain yang diperlukan
Amazon SageMaker Distribution (`sagemaker-distribution`) adalah sekumpulan gambar Docker yang mencakup kerangka kerja dan paket populer untuk pembelajaran mesin, ilmu data, dan visualisasi. Untuk informasi selengkapnya, lihat [SageMaker Kebijakan dukungan gambar studio](sagemaker-distribution.md).
Jika Anda membutuhkan fungsionalitas yang berbeda, Anda dapat membawa gambar Anda sendiri (BYOI). Anda mungkin ingin membuat gambar khusus jika:
+ Anda memerlukan versi tertentu dari bahasa pemrograman atau perpustakaan
+ Anda ingin menyertakan alat atau paket khusus
+ Anda bekerja dengan perangkat lunak khusus yang tidak tersedia dalam gambar standar
## Terminologi kunci
Bagian berikut mendefinisikan istilah kunci untuk membawa gambar Anda sendiri untuk digunakan dengan SageMaker AI.
+ **Dockerfile:** Dokumen berbasis teks dengan instruksi untuk membuat gambar Docker. Ini mengidentifikasi paket bahasa dan dependensi lain untuk image Docker Anda.
+ **Docker image:** Satu set paket perangkat lunak dan dependensi yang dibangun dari Dockerfile.
+ **SageMaker Toko gambar AI:** Penyimpanan gambar khusus Anda di SageMaker AI.
**Topics**
+ [
## Terminologi kunci
](#studio-updated-byoi-basics)
+ [
# Spesifikasi gambar kustom
](studio-updated-byoi-specs.md)
+ [
# Cara membawa gambar Anda sendiri
](studio-updated-byoi-how-to.md)
+ [
# Luncurkan gambar kustom di Studio
](studio-updated-byoi-how-to-launch.md)
+ [
# Lihat detail gambar kustom Anda
](studio-updated-byoi-view-images.md)
+ [
# Mempercepat startup kontainer dengan SOCI
](soci-indexing.md)
+ [
# Lepaskan dan bersihkan sumber daya gambar kustom
](studio-updated-byoi-how-to-detach-from-domain.md)
# Spesifikasi gambar kustom
Gambar yang Anda tentukan di Dockerfile Anda harus sesuai dengan spesifikasi di bagian berikut untuk membuat gambar dengan sukses.
**Topics**
+ [
## Menjalankan gambar
](#studio-updated-byoi-specs-run)
+ [
## Spesifikasi untuk pengguna dan sistem file
](#studio-updated-byoi-specs-user-and-filesystem)
+ [
## Pemeriksaan Kesehatan dan URL untuk aplikasi
](#studio-updated-byoi-specs-app-healthcheck)
+ [
## Sampel Dockerfile
](#studio-updated-byoi-specs-dockerfile-templates)
## Menjalankan gambar
Konfigurasi berikut dapat dibuat dengan memperbarui Anda [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html). Sebagai contoh, lihat [Perbarui konfigurasi wadah](studio-updated-byoi-how-to-container-configuration.md).
+ `Entrypoint`— Anda dapat mengonfigurasi `ContainerEntrypoint` dan `ContainerArguments` yang diteruskan ke wadah saat runtime. Kami merekomendasikan untuk mengonfigurasi titik masuk Anda menggunakan`ContainerConfig`. Lihat tautan di atas sebagai contoh.
+ `EnvVariables`— Saat menggunakan Studio, Anda dapat menentukan `ContainerEnvironment` variabel khusus untuk wadah Anda. Anda dapat memperbarui variabel lingkungan Anda secara opsional menggunakan`ContainerConfig`. Lihat tautan di atas sebagai contoh.
SageMaker Variabel lingkungan khusus AI diutamakan dan akan mengganti variabel apa pun dengan nama yang sama. Misalnya, SageMaker AI secara otomatis menyediakan variabel lingkungan yang diawali dengan `AWS_` dan `SAGEMAKER_` untuk memastikan integrasi yang tepat dengan AWS layanan dan fungsionalitas SageMaker AI. Berikut ini adalah beberapa contoh variabel lingkungan SageMaker khusus AI:
+ `AWS_ACCOUNT_ID`
+ `AWS_REGION`
+ `AWS_DEFAULT_REGION`
+ `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI`
+ `SAGEMAKER_SPACE_NAME`
+ `SAGEMAKER_APP_TYPE`
## Spesifikasi untuk pengguna dan sistem file
+ `WorkingDirectory`— Volume Amazon EBS untuk ruang Anda dipasang di jalur`/home/sagemaker-user`. Anda tidak dapat mengubah jalur pemasangan. Gunakan `WORKDIR` instruksi untuk mengatur direktori kerja gambar Anda ke folder di dalamnya`/home/sagemaker-user`.
+ `UID`— ID pengguna Docker wadah. UID=1000 adalah nilai yang didukung. Anda dapat menambahkan akses sudo ke pengguna Anda. Itu IDs dipetakan ulang untuk mencegah proses yang berjalan di wadah memiliki lebih banyak hak istimewa daripada yang diperlukan.
+ `GID`— ID grup Docker wadah. GID=100 adalah nilai yang didukung. Anda dapat menambahkan akses sudo ke pengguna Anda. Itu IDs dipetakan ulang untuk mencegah proses yang berjalan di wadah memiliki lebih banyak hak istimewa daripada yang diperlukan.
+ Direktori metadata — Direktori `/opt/.sagemakerinternal` dan `/opt/ml` direktori yang digunakan oleh. AWS File metadata di `/opt/ml` berisi metadata tentang sumber daya seperti. `DomainId`
Gunakan perintah berikut untuk menampilkan isi sistem file:
```
cat /opt/ml/metadata/resource-metadata.json
```
+ Direktori logging - `/var/log/studio` dicadangkan untuk direktori logging aplikasi Anda dan ekstensi yang terkait dengannya. Kami menyarankan Anda untuk tidak menggunakan folder ini dalam membuat gambar Anda.
## Pemeriksaan Kesehatan dan URL untuk aplikasi
Pemeriksaan kesehatan dan URL tergantung pada aplikasi. Pilih tautan berikut yang terkait dengan aplikasi yang Anda buat gambarnya.
+ [Pemeriksaan Kesehatan dan URL untuk aplikasi](code-editor-custom-images.md#code-editor-custom-images-app-healthcheck)untuk Editor Kode
+ [Pemeriksaan Kesehatan dan URL untuk aplikasi](studio-updated-jl-admin-guide-custom-images.md#studio-updated-jl-admin-guide-custom-images-app-healthcheck)untuk JupyterLab
## Sampel Dockerfile
Untuk sampel Dockerfile yang memenuhi persyaratan di halaman ini dan kebutuhan aplikasi spesifik Anda, navigasikan ke contoh Dockerfiles di bagian aplikasi masing-masing. Opsi berikut termasuk aplikasi Amazon SageMaker Studio.
+ [Contoh Dockerfile](code-editor-custom-images.md#code-editor-custom-images-dockerfile-templates)untuk Editor Kode
+ [Contoh Dockerfile](studio-updated-jl-admin-guide-custom-images.md#studio-updated-jl-custom-images-dockerfile-templates)untuk JupyterLab
**catatan**
Jika Anda membawa gambar Anda sendiri ke SageMaker Unified Studio, Anda harus mengikuti [spesifikasi Dockerfile](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) di Panduan Pengguna *Amazon SageMaker Unified* Studio.
`Dockerfile`contoh untuk SageMaker Unified Studio dapat ditemukan di [contoh Dockerfile di Panduan](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) Pengguna *Amazon SageMaker Unified* Studio.
# Cara membawa gambar Anda sendiri
Halaman-halaman berikut akan memberikan petunjuk tentang cara membawa gambar kustom Anda sendiri. Pastikan prasyarat berikut terpenuhi sebelum melanjutkan.
## Prasyarat
Anda harus menyelesaikan prasyarat berikut untuk membawa gambar Anda sendiri ke Amazon AI. SageMaker
+ Siapkan aplikasi Docker. Untuk informasi selengkapnya, lihat [Memulai](https://docs.docker.com/get-started/) *dokumentasi Docker*.
+ Instal yang terbaru AWS CLI dengan mengikuti langkah-langkah dalam [Memulai dengan AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) di *Panduan AWS Command Line Interface Pengguna untuk Versi 2*.
+ Izin untuk mengakses layanan Amazon Elastic Container Registry (Amazon ECR). Untuk informasi selengkapnya, lihat [Kebijakan Terkelola Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/ecr_managed_policies.html) di *Panduan Pengguna Amazon ECR*.
+ AWS Identity and Access Management Peran yang memiliki [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)kebijakan terlampir.
**Topics**
+ [
## Prasyarat
](#studio-updated-byoi-how-to-prerequisites)
+ [
# Buat gambar khusus dan dorong ke Amazon ECR
](studio-updated-byoi-how-to-prepare-image.md)
+ [
# Lampirkan gambar kustom Anda ke domain Anda
](studio-updated-byoi-how-to-attach-to-domain.md)
+ [
# Perbarui konfigurasi wadah
](studio-updated-byoi-how-to-container-configuration.md)
# Buat gambar khusus dan dorong ke Amazon ECR
Halaman ini memberikan petunjuk tentang cara membuat Dockerfile lokal, membuat image container, dan menambahkannya ke Amazon Elastic Container Registry (Amazon ECR).
**catatan**
Dalam contoh berikut, tag tidak ditentukan, dan tag `latest` diterapkan secara default. Jika Anda ingin menentukan tag, Anda harus menambahkan `:tag` ke akhir nama gambar. Untuk informasi selengkapnya, lihat [tag gambar docker](https://docs.docker.com/reference/cli/docker/image/tag/) di dokumentasi *Docker*.
**Topics**
+ [
## Buat Dockerfile lokal dan buat gambar kontainer
](#studio-updated-byoi-how-to-create-local-dockerfile)
+ [
## Tambahkan gambar Docker ke Amazon ECR
](#studio-updated-byoi-add-container-image)
## Buat Dockerfile lokal dan buat gambar kontainer
Gunakan petunjuk berikut untuk membuat Dockerfile dengan perangkat lunak dan dependensi yang Anda inginkan.
**Untuk membuat Dockerfile Anda**
1. Pertama atur variabel Anda untuk AWS CLI perintah yang mengikuti.
```
LOCAL_IMAGE_NAME=local-image-name
```
`local-image-name`adalah nama gambar kontainer di perangkat lokal Anda, yang Anda tentukan di sini.
1. Buat dokumen berbasis teks, bernama`Dockerfile`, yang memenuhi spesifikasi di. [Spesifikasi gambar kustom](studio-updated-byoi-specs.md)
`Dockerfile`contoh untuk aplikasi yang didukung dapat ditemukan di[Sampel Dockerfile](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates).
**catatan**
Jika Anda membawa gambar Anda sendiri ke SageMaker Unified Studio, Anda harus mengikuti [spesifikasi Dockerfile](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) di Panduan Pengguna *Amazon SageMaker Unified* Studio.
`Dockerfile`contoh untuk SageMaker Unified Studio dapat ditemukan di [contoh Dockerfile di Panduan](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) Pengguna *Amazon SageMaker Unified* Studio.
1. Di direktori yang berisi Anda`Dockerfile`, buat image Docker menggunakan perintah berikut. Periode (`.`) menetapkan bahwa `Dockerfile` harus dalam konteks perintah build.
```
docker build -t ${LOCAL_IMAGE_NAME} .
```
Setelah build selesai, Anda dapat mencantumkan informasi image container Anda dengan perintah berikut.
```
docker images
```
1. (Opsional) Anda dapat menguji gambar Anda dengan menggunakan perintah berikut.
```
docker run -it ${LOCAL_IMAGE_NAME}
```
Dalam output Anda akan menemukan bahwa server Anda berjalan di URL, seperti`http://127.0.0.1:8888/...`. Anda dapat menguji gambar dengan menyalin URL ke browser.
Jika ini tidak berhasil, Anda mungkin perlu memasukkan `-p port:port` perintah docker run. Opsi ini memetakan port yang terbuka pada kontainer ke port pada sistem host. Untuk informasi selengkapnya tentang docker run, lihat [Container Running](https://docs.docker.com/engine/containers/run/) di *dokumentasi Docker*.
Setelah Anda memverifikasi bahwa server berfungsi, Anda dapat menghentikan server dan mematikan semua kernel sebelum melanjutkan. Instruksi dapat dilihat output.
## Tambahkan gambar Docker ke Amazon ECR
Untuk menambahkan gambar kontainer ke Amazon ECR, Anda perlu melakukan hal berikut.
+ Buat repositori Amazon ECR.
+ Masuk ke registri default Anda.
+ Dorong gambar ke repositori Amazon ECR.
**catatan**
Repositori Amazon ECR harus Wilayah AWS sama dengan domain tempat Anda melampirkan gambar.
**Untuk membangun dan mendorong gambar kontainer ke Amazon ECR**
1. Pertama atur variabel Anda untuk AWS CLI perintah yang mengikuti.
```
ACCOUNT_ID=account-id
REGION=aws-region
ECR_REPO_NAME=ecr-repository-name
```
+ `account-id`adalah ID akun Anda. Anda dapat menemukan ini di kanan atas halaman AWS konsol mana pun. Misalnya, [konsol SageMaker AI](https://console.aws.amazon.com/sagemaker).
+ `aws-region`adalah Wilayah AWS domain SageMaker AI Amazon Anda. Anda dapat menemukan ini di kanan atas halaman AWS konsol mana pun.
+ `ecr-repository-name`adalah nama repositori Amazon Elastic Container Registry Anda, yang Anda definisikan di sini. Untuk melihat repositori Amazon ECR Anda, lihat konsol [Amazon](https://console.aws.amazon.com/ecr) ECR.
1. Masuk ke Amazon ECR dan masuk ke Docker.
```
aws ecr get-login-password \
--region ${REGION} | \
docker login \
--username AWS \
--password-stdin ${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com
```
Pada otentikasi yang berhasil, Anda akan menerima pesan log in yang berhasil.
**penting**
Jika Anda menerima kesalahan, Anda mungkin perlu menginstal atau meningkatkan ke versi terbaru AWS CLI. Untuk informasi selengkapnya, lihat [Menginstal AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) dalam *Panduan Pengguna AWS Command Line Interface *.
1. Tandai gambar dalam format yang kompatibel dengan Amazon ECR, untuk mendorong ke repositori Anda.
```
docker tag \
${LOCAL_IMAGE_NAME} \
${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com/${ECR_REPO_NAME}
```
1. Buat repositori Amazon ECR menggunakan file. AWS CLI Untuk membuat repositori menggunakan konsol Amazon ECR, lihat Membuat [repositori pribadi Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-create.html) untuk menyimpan gambar.
```
aws ecr create-repository \
--region ${REGION} \
--repository-name ${ECR_REPO_NAME}
```
1. Dorong gambar ke repositori Amazon ECR Anda. Anda juga dapat menandai gambar Docker.
```
docker push ${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com/${ECR_REPO_NAME}
```
Setelah gambar berhasil ditambahkan ke repositori Amazon ECR Anda, Anda dapat melihatnya di konsol [Amazon](https://console.aws.amazon.com/ecr) ECR.
# Lampirkan gambar kustom Anda ke domain Anda
Halaman ini memberikan petunjuk tentang cara melampirkan gambar kustom Anda ke domain Anda. Gunakan prosedur berikut untuk menggunakan konsol Amazon SageMaker AI untuk menavigasi ke domain Anda dan memulai proses **Lampirkan gambar**.
Instruksi berikut mengasumsikan bahwa Anda telah mendorong gambar ke repositori Amazon ECR Wilayah AWS sama dengan domain Anda. Jika Anda belum melakukannya, lihat[Buat gambar khusus dan dorong ke Amazon ECR](studio-updated-byoi-how-to-prepare-image.md).
Ketika Anda memilih untuk melampirkan gambar, Anda akan memiliki dua opsi:
+ Lampirkan **gambar Baru**: Opsi ini akan membuat versi gambar dan gambar di toko gambar SageMaker AI Anda dan kemudian melampirkannya ke domain Anda.
**catatan**
Jika Anda melanjutkan proses BYOI, dari[Buat gambar khusus dan dorong ke Amazon ECR](studio-updated-byoi-how-to-prepare-image.md), gunakan opsi **Gambar baru**.
+ Lampirkan **gambar yang ada**: Jika Anda telah membuat gambar kustom yang diinginkan di toko gambar SageMaker AI, gunakan opsi ini. Opsi ini melampirkan gambar kustom yang ada ke domain Anda. Untuk melihat gambar kustom Anda di toko gambar SageMaker AI, lihat[Lihat detail gambar khusus (konsol)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console).
------
#### [ New image ]
**Untuk melampirkan gambar baru ke domain Anda**
1. Buka [konsol SageMaker AI](https://console.aws.amazon.com/sagemaker).
1. Perluas bagian **konfigurasi Admin**, jika belum dilakukan.
1. Di bawah **konfigurasi Admin**, pilih **Domain**.
1. Dari daftar **Domain**, pilih domain yang ingin Anda lampirkan gambarnya.
**catatan**
Jika Anda melampirkan gambar ke proyek SageMaker Unified Studio dan Anda memerlukan klarifikasi tentang domain mana yang akan digunakan, lihat [Melihat detail domain SageMaker AI yang terkait dengan](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain) proyek Anda.
1. Buka tab **Lingkungan**.
1. Di bagian **Custom images for personal Studio apps**, pilih **Lampirkan image**.
1. Untuk **Sumber gambar**, pilih **Gambar baru**.
1. Sertakan URI gambar Amazon ECR Anda. Formatnya adalah sebagai berikut.
```
account-id.dkr.ecr.aws-region.amazonaws.com/repository-name:tag
```
1. Untuk mendapatkan URI gambar Amazon ECR Anda, navigasikan ke halaman [repositori pribadi Amazon ECR](https://console.aws.amazon.com/ecr/private-registry/repositories) Anda.
1. Pilih tautan nama repositori Anda.
1. Pilih ikon **Salin URI** yang sesuai dengan versi gambar Anda (**Tag gambar**).
1. Ikuti instruksi lainnya untuk melampirkan gambar kustom Anda.
**catatan**
Pastikan bahwa Anda menggunakan jenis aplikasi yang konsisten dengan Anda`Dockerfile`. Untuk informasi selengkapnya, lihat [Sampel Dockerfile](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates).
Setelah gambar berhasil dilampirkan ke domain Anda, Anda akan dapat melihatnya di tab **Lingkungan**.
------
#### [ Existing image ]
**Untuk melampirkan gambar yang ada ke domain Anda**
1. Buka [konsol SageMaker AI](https://console.aws.amazon.com/sagemaker).
1. Perluas bagian **konfigurasi Admin**, jika belum dilakukan.
1. Di bawah **konfigurasi Admin**, pilih **Domain**.
1. Dari daftar **Domain**, pilih domain yang ingin Anda lampirkan gambarnya.
**catatan**
Jika Anda melampirkan gambar ke proyek SageMaker Unified Studio dan Anda memerlukan klarifikasi tentang domain mana yang akan digunakan, lihat [Melihat detail domain SageMaker AI yang terkait dengan](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain) proyek Anda.
1. Buka tab **Lingkungan**.
1. Di bagian **Custom images for personal Studio apps**, pilih **Lampirkan image**.
1. Untuk **Sumber gambar**, pilih **Gambar yang ada**.
1. Pilih versi gambar dan gambar yang ada dari toko gambar SageMaker AI.
Jika Anda tidak dapat melihat versi gambar Anda, Anda mungkin perlu membuat versi gambar. Untuk informasi selengkapnya, lihat [Lihat detail gambar khusus (konsol)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console).
1. Ikuti instruksi lainnya untuk melampirkan gambar kustom Anda.
**catatan**
Pastikan bahwa Anda menggunakan jenis aplikasi yang konsisten dengan Anda`Dockerfile`. Untuk informasi selengkapnya, lihat [Sampel Dockerfile](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates).
Setelah gambar berhasil dilampirkan ke domain Anda, Anda akan dapat melihatnya di tab **Lingkungan**.
------
Setelah gambar Anda berhasil dilampirkan ke domain Anda, pengguna domain dapat memilih gambar untuk aplikasi mereka. Untuk informasi selengkapnya, lihat [Luncurkan gambar kustom di Studio](studio-updated-byoi-how-to-launch.md).
**catatan**
Jika Anda telah melampirkan gambar kustom ke proyek SageMaker Unified Studio Anda, Anda harus meluncurkan aplikasi dari dalam SageMaker Unified Studio. Untuk informasi selengkapnya, lihat [Meluncurkan gambar kustom Anda](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-launch-custom-image.html) di *Panduan Pengguna Amazon SageMaker Unified Studio*.
# Perbarui konfigurasi wadah
Anda dapat membawa gambar Docker khusus ke dalam alur kerja pembelajaran mesin Anda. Aspek kunci dari menyesuaikan gambar-gambar ini adalah mengonfigurasi konfigurasi kontainer, atau. [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html) Halaman berikut memberikan contoh tentang cara mengkonfigurasi Anda`ContainerConfig`.
Entrypoint adalah perintah atau skrip yang berjalan saat wadah dimulai. Entrypoint khusus memungkinkan Anda untuk mengatur lingkungan Anda, menginisialisasi layanan, atau melakukan pengaturan yang diperlukan sebelum aplikasi Anda diluncurkan.
Contoh ini memberikan petunjuk tentang cara mengkonfigurasi entrypoint kustom, untuk JupyterLab aplikasi Anda, menggunakan. AWS CLI Contoh ini mengasumsikan bahwa Anda telah membuat gambar dan domain khusus. Untuk petunjuk, lihat [Lampirkan gambar kustom Anda ke domain Anda](studio-updated-byoi-how-to-attach-to-domain.md).
1. Pertama atur variabel Anda untuk AWS CLI perintah yang mengikuti.
```
APP_IMAGE_CONFIG_NAME=app-image-config-name
ENTRYPOINT_FILE=entrypoint-file-name
ENV_KEY=environment-key
ENV_VALUE=environment-value
REGION=aws-region
DOMAIN_ID=domain-id
IMAGE_NAME=custom-image-name
IMAGE_VERSION=custom-image-version
```
+ `app-image-config-name`adalah nama konfigurasi gambar aplikasi Anda.
+ `entrypoint-file-name`adalah nama skrip entrypoint container Anda. Misalnya, `entrypoint.sh`.
+ `environment-key`adalah nama variabel lingkungan Anda.
+ `environment-value`adalah nilai yang diberikan ke variabel lingkungan Anda.
+ `aws-region`adalah Wilayah AWS domain SageMaker AI Amazon Anda. Anda dapat menemukan ini di kanan atas halaman AWS konsol mana pun.
+ `domain-id`adalah ID domain Anda. Untuk melihat domain Anda, lihat[Lihat domain](domain-view.md).
+ `custom-image-name`adalah nama gambar kustom Anda. Untuk melihat detail gambar kustom Anda, lihat[Lihat detail gambar khusus (konsol)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console).
Jika Anda mengikuti instruksi[Lampirkan gambar kustom Anda ke domain Anda](studio-updated-byoi-how-to-attach-to-domain.md), Anda mungkin ingin menggunakan nama gambar yang sama dengan yang Anda gunakan dalam proses itu.
+ `custom-image-version`adalah nomor versi gambar kustom Anda. Ini harus berupa bilangan bulat, mewakili versi gambar Anda. Untuk melihat detail gambar kustom Anda, lihat[Lihat detail gambar khusus (konsol)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console).
1. Gunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateAppImageConfig.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateAppImageConfig.html)API untuk membuat konfigurasi gambar.
```
aws sagemaker create-app-image-config \
--region ${REGION} \
--app-image-config-name "${APP_IMAGE_CONFIG_NAME}" \
--jupyter-lab-app-image-config "ContainerConfig = {
ContainerEntrypoint = "${ENTRYPOINT_FILE}",
ContainerEnvironmentVariables = {
"${ENV_KEY}"="${ENV_VALUE}"
}
}"
```
1. Gunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)API untuk memperbarui pengaturan default untuk domain Anda. Ini akan melampirkan gambar kustom serta konfigurasi gambar aplikasi.
```
aws sagemaker update-domain \
--region ${REGION} \
--domain-id "${DOMAIN_ID}" \
--default-user-settings "{
\"JupyterLabAppSettings\": {
\"CustomImages\": [
{
\"ImageName\": \"${IMAGE_NAME}\",
\"ImageVersionNumber\": ${IMAGE_VERSION},
\"AppImageConfigName\": \"${APP_IMAGE_CONFIG_NAME}\"
}
]
}
}"
```
# Luncurkan gambar kustom di Studio
Setelah Anda melampirkan gambar khusus ke domain Amazon SageMaker AI Anda, gambar menjadi tersedia untuk pengguna di domain. Gunakan petunjuk berikut untuk meluncurkan aplikasi dengan gambar kustom.
**catatan**
Jika Anda telah melampirkan gambar kustom ke proyek SageMaker Unified Studio Anda, Anda harus meluncurkan aplikasi dari dalam SageMaker Unified Studio. Untuk informasi selengkapnya, lihat [Meluncurkan gambar kustom Anda](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-launch-custom-image.html) di *Panduan Pengguna Amazon SageMaker Unified Studio*.
1. Luncurkan Amazon SageMaker Studio. Untuk petunjuk, lihat [Luncurkan Amazon SageMaker Studio](studio-updated-launch.md).
1. Jika belum dilakukan, perluas bagian **Aplikasi**.
1. Pilih aplikasi dari bagian **Aplikasi**. Jika Anda tidak melihat aplikasi yang tersedia, aplikasi mungkin disembunyikan dari Anda. Dalam hal ini, hubungi administrator Anda.
1. Untuk membuat spasi, pilih **\$1 Buat *application* ruang** dan ikuti instruksi untuk membuat ruang.
Untuk memilih ruang yang ada, pilih nama tautan dari ruang yang ingin Anda buka.
1. Di bawah **Gambar**, pilih gambar yang ingin Anda gunakan.
Jika dropdown **Gambar** tidak tersedia, Anda mungkin perlu menghentikan ruang Anda. Pilih **Stop Space** untuk melakukannya.
1. Konfirmasikan pengaturan untuk ruang dan pilih **Jalankan ruang**.
# Lihat detail gambar kustom Anda
Halaman berikut memberikan petunjuk tentang cara melihat detail gambar kustom Anda di toko gambar SageMaker AI.
## Lihat detail gambar khusus (konsol)
Berikut ini memberikan petunjuk tentang cara melihat gambar kustom Anda menggunakan konsol SageMaker AI. Di bagian ini, Anda dapat melihat dan mengedit detail gambar Anda.
**Lihat gambar kustom Anda (konsol)**
1. Buka [konsol SageMaker AI](https://console.aws.amazon.com/sagemaker).
1. Perluas bagian **Konfigurasi Admin**.
1. Di bawah **konfigurasi Admin**, pilih **Gambar**.
1. Dari daftar **gambar Kustom**, pilih hyperlink nama gambar Anda.
## Lihat detail gambar kustom (AWS CLI)
Bagian berikut menunjukkan contoh tentang cara melihat gambar kustom Anda menggunakan AWS CLI.
```
aws sagemaker list-images \
--region aws-region
```
# Mempercepat startup kontainer dengan SOCI
Pengindeksan SOCI (Seekable Open Container Initiative) memungkinkan pemuatan lambat gambar kontainer khusus di atau [SageMaker Studio Amazon](studio-updated.md) [Amazon SageMaker ](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/what-is-sagemaker-unified-studio.html) Unified Studio. SOCI secara signifikan mengurangi waktu startup sekitar 30-70% untuk kontainer khusus [Bawa gambar Anda sendiri (BYOI)](studio-updated-byoi.md) Anda. Peningkatan latensi bervariasi tergantung pada ukuran gambar, ketersediaan instance hosting, dan dependensi aplikasi lainnya. SOCI membuat indeks yang memungkinkan kontainer diluncurkan hanya dengan komponen yang diperlukan, mengambil file tambahan sesuai permintaan sesuai kebutuhan.
SOCI membahas waktu startup kontainer yang lambat, yang mengganggu alur kerja pengembangan pembelajaran mesin berulang (ML), untuk gambar khusus. Ketika beban kerja ML menjadi lebih kompleks, gambar kontainer telah tumbuh lebih besar, menciptakan penundaan startup yang menghambat siklus pengembangan.
**Topics**
+ [
## Manfaat utama
](#soci-indexing-key-benefits)
+ [
## Cara kerja pengindeksan SOCI
](#soci-indexing-how-works)
+ [
## Komponen arsitektur
](#soci-indexing-architecture-components)
+ [
## Alat yang didukung
](#soci-indexing-supported-tools)
+ [
# Izin untuk pengindeksan SOCI
](soci-indexing-setup.md)
+ [
# Buat indeks SOCI dengan contoh nerdctl dan SOCI CLI
](soci-indexing-example-create-indexes.md)
+ [
# Integrasikan gambar yang diindeks Sosial dengan contoh Studio
](soci-indexing-example-integrate-studio.md)
## Manfaat utama
+ **Siklus iterasi yang lebih cepat**: Kurangi startup kontainer, tergantung pada jenis gambar dan instance
+ **Pengoptimalan universal**: Memperluas manfaat kinerja ke semua kontainer BYOI khusus di Studio
## Cara kerja pengindeksan SOCI
SOCI membuat indeks metadata khusus yang memetakan struktur file internal gambar kontainer Anda. Indeks ini memungkinkan akses ke file individual tanpa mengunduh seluruh gambar. Indeks SOCI disimpan sebagai artefak yang sesuai dengan OCI (Open Container Initiative) di [Amazon](https://docs.aws.amazon.com/AmazonECR/latest/userguide/what-is-ecr.html) ECR dan ditautkan ke gambar kontainer asli Anda, menjaga intisari gambar dan validitas tanda tangan.
Saat Anda meluncurkan wadah di Studio, sistem menggunakan indeks SOCI untuk mengidentifikasi dan mengunduh hanya file penting yang diperlukan untuk memulai. Komponen tambahan diambil secara paralel karena aplikasi Anda memerlukannya.
## Komponen arsitektur
+ **Gambar wadah asli**: Wadah dasar Anda disimpan di Amazon ECR
+ **Artefak indeks SOCI**: Metadata memetakan struktur file gambar Anda
+ **Manifes Indeks Gambar OCI**: Menautkan gambar asli Anda dan indeks SOCI
+ **Runtime kontainer Finch**: Mengaktifkan integrasi pemuatan lambat dengan Studio
## Alat yang didukung
| Alat | Integrasi |
| --- | --- |
| nerdctl | Membutuhkan setup containerd |
| CLI Finch | Dukungan SOCI asli |
| Docker\$1SOCI CLI | Perkakas tambahan diperlukan |
**Topics**
+ [
## Manfaat utama
](#soci-indexing-key-benefits)
+ [
## Cara kerja pengindeksan SOCI
](#soci-indexing-how-works)
+ [
## Komponen arsitektur
](#soci-indexing-architecture-components)
+ [
## Alat yang didukung
](#soci-indexing-supported-tools)
+ [
# Izin untuk pengindeksan SOCI
](soci-indexing-setup.md)
+ [
# Buat indeks SOCI dengan contoh nerdctl dan SOCI CLI
](soci-indexing-example-create-indexes.md)
+ [
# Integrasikan gambar yang diindeks Sosial dengan contoh Studio
](soci-indexing-example-integrate-studio.md)
# Izin untuk pengindeksan SOCI
[Buat indeks SOCI untuk gambar kontainer Anda dan simpan di Amazon ECR sebelum menggunakan pengindeksan SOCI dengan [SageMaker Studio Amazon](studio-updated.md) atau Amazon Unified Studio. SageMaker ](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/what-is-sagemaker-unified-studio.html)
**Topics**
+ [
## Prasyarat
](#soci-indexing-setup-prerequisites)
+ [
## Izin IAM yang diperlukan
](#soci-indexing-setup-iam-permissions)
## Prasyarat
+ Akun AWS dengan peran [AWS Identity and Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html)(IAM) dengan izin untuk dikelola
+ [Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/what-is-ecr.html)
+ [Amazon SageMaker AI](https://docs.aws.amazon.com/sagemaker/latest/dg/gs.html)
+ [Repositori pribadi Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Repositories.html) untuk menyimpan gambar kontainer Anda
+ [AWS CLI v2.0\$1dikonfigurasi](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) dengan kredensyal yang sesuai
+ Alat kontainer berikut:
+ Diperlukan: [soci-snapshotter](https://github.com/awslabs/soci-snapshotter)
+ Opsi:
+ [nerdctl](https://github.com/containerd/nerdctl)
+ [burung kutilang](https://github.com/runfinch/finch)
## Izin IAM yang diperlukan
Peran IAM Anda memerlukan izin untuk:
+ Buat dan kelola sumber daya SageMaker AI (domain, gambar, konfigurasi aplikasi).
+ Anda dapat menggunakan kebijakan [SageMakerFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonSageMakerFullAccess.html) AWS terkelola. Untuk detail izin selengkapnya, lihat[AWS kebijakan terkelola: AmazonSageMakerFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonSageMakerFullAccess).
+ [Izin IAM untuk mendorong gambar ke repositori pribadi Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/image-push-iam.html).
# Buat indeks SOCI dengan contoh nerdctl dan SOCI CLI
Halaman berikut memberikan contoh tentang cara membuat indeks SOCI dengan nerdctl dan SOCI CLI.
**Buat contoh indeks SOCI**
1. Pertama atur variabel Anda untuk AWS CLI perintah yang mengikuti. Berikut ini adalah contoh pengaturan variabel Anda.
```
ACCOUNT_ID="111122223333"
REGION="us-east-1"
REPOSITORY_NAME="repository-name"
ORIGINAL_IMAGE_TAG="original-image-tag"
SOCI_IMAGE_TAG="soci-indexed-image-tag"
```
Definisi variabel:
+ `ACCOUNT_ID`adalah Akun AWS ID Anda
+ `REGION`adalah Wilayah AWS registri pribadi Amazon ECR Anda
+ `REPOSITORY_NAME`adalah nama registri pribadi Amazon ECR Anda
+ `ORIGINAL_IMAGE_TAG`adalah tag dari gambar asli Anda
+ `SOCI_IMAGE_TAG`adalah tag gambar yang diindeks Sosial Anda
1. Instal alat yang diperlukan:
```
# Install SOCI CLI, containerd, and nerdctl
sudo yum install soci-snapshotter
sudo yum install containerd jq
sudo systemctl start soci-snapshotter
sudo systemctl restart containerd
sudo yum install nerdctl
```
1. Tetapkan variabel registri Anda:
```
REGISTRY_USER=AWS
REGISTRY="$ACCOUNT_ID.dkr.ecr.$REGION.amazonaws.com"
```
1. Ekspor wilayah Anda dan autentikasi ke Amazon ECR:
```
export AWS_REGION=$REGION
REGISTRY_PASSWORD=$(/usr/local/bin/aws ecr get-login-password --region $AWS_REGION)
echo $REGISTRY_PASSWORD | sudo nerdctl login -u $REGISTRY_USER --password-stdin $REGISTRY
```
1. Tarik gambar kontainer asli Anda:
```
sudo nerdctl pull $REGISTRY/$REPOSITORY_NAME:$ORIGINAL_IMAGE_TAG
```
1. Buat indeks SOCI:
```
sudo nerdctl image convert --soci $REGISTRY/$REPOSITORY_NAME:$ORIGINAL_IMAGE_TAG $REGISTRY/$REPOSITORY_NAME:$SOCI_IMAGE_TAG
```
1. Dorong gambar yang diindeks Sosial:
```
sudo nerdctl push --platform linux/amd64 $REGISTRY/$REPOSITORY_NAME:$SOCI_IMAGE_TAG
```
Proses ini membuat dua artefak untuk gambar kontainer asli di repositori ECR Anda:
+ Indeks SOCI - Metadata memungkinkan pemuatan lambat
+ Manifes Indeks Gambar - Manifes yang sesuai dengan OCI
# Integrasikan gambar yang diindeks Sosial dengan contoh Studio
Anda harus mereferensikan tag gambar yang diindeks Soci-untuk menggunakan gambar yang diindeks Sosial di Studio, bukan tag gambar kontainer asli. Gunakan tag yang Anda tentukan selama proses konversi SOCI (misalnya, `SOCI_IMAGE_TAG` di[Buat indeks SOCI dengan contoh nerdctl dan SOCI CLI](soci-indexing-example-create-indexes.md)).
**Integrasikan contoh gambar yang diindeks Sosial**
1. Pertama atur variabel Anda untuk AWS CLI perintah yang mengikuti. Berikut ini adalah contoh pengaturan variabel Anda.
```
ACCOUNT_ID="111122223333"
REGION="us-east-1"
IMAGE_NAME="sagemaker-image-name"
IMAGE_CONFIG_NAME="sagemaker-image-config-name"
ROLE_ARN="your-role-arn"
DOMAIN_ID="domain-id"
SOCI_IMAGE_TAG="soci-indexed-image-tag"
```
Definisi variabel:
+ `ACCOUNT_ID`adalah Akun AWS ID Anda
+ `REGION`adalah Wilayah AWS registri pribadi Amazon ECR Anda
+ `IMAGE_NAME`adalah nama SageMaker gambar Anda
+ `IMAGE_CONFIG_NAME`adalah nama konfigurasi SageMaker gambar Anda
+ `ROLE_ARN`[adalah ARN dari peran eksekusi Anda dengan izin yang tercantum dalam izin IAM yang Diperlukan](soci-indexing-setup.md#soci-indexing-setup-iam-permissions)
+ `DOMAIN_ID`adalah [ID domain](https://docs.aws.amazon.com/sagemaker/latest/dg/domain-view.html)
**catatan**
Jika Anda melampirkan gambar ke proyek SageMaker Unified Studio dan Anda memerlukan klarifikasi tentang domain mana yang akan digunakan, lihat [Melihat detail domain SageMaker AI yang terkait dengan](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain) proyek Anda.
+ `SOCI_IMAGE_TAG`adalah tag gambar yang diindeks Sosial Anda
1. Ekspor wilayah Anda:
```
export AWS_REGION=$REGION
```
1. Buat SageMaker gambar:
```
aws sagemaker create-image \
--image-name "$IMAGE_NAME" \
--role-arn "$ROLE_ARN"
```
1. Buat Versi SageMaker Gambar menggunakan URI indeks SOCI Anda:
```
IMAGE_INDEX_URI="$ACCOUNT_ID.dkr.ecr.$REGION.amazonaws.com/$IMAGE_NAME:$SOCI_IMAGE_TAG"
aws sagemaker create-image-version \
--image-name "$IMAGE_NAME" \
--base-image "$IMAGE_INDEX_URI"
```
1. Buat konfigurasi gambar aplikasi dan perbarui domain Amazon SageMaker AI Anda untuk menyertakan gambar khusus untuk aplikasi Anda. Anda dapat melakukan ini untuk Editor Kode, berdasarkan Code-OSS, Visual Studio Code - Open Source (Editor Kode) dan aplikasi. JupyterLab Pilih opsi aplikasi di bawah ini untuk melihat langkah-langkahnya.
------
#### [ Code Editor ]
Buat konfigurasi gambar aplikasi untuk Editor Kode:
```
aws sagemaker create-app-image-config \
--app-image-config-name "$IMAGE_CONFIG_NAME" \
--code-editor-app-image-config '{ "FileSystemConfig": { "MountPath": "/home/sagemaker-user", "DefaultUid": 1000, "DefaultGid": 100 } }'
```
Perbarui domain Amazon SageMaker AI Anda untuk menyertakan gambar khusus untuk Editor Kode:
```
aws sagemaker update-domain \
--domain-id "$DOMAIN_ID" \
--default-user-settings '{
"CodeEditorAppSettings": {
"CustomImages": [{
"ImageName": "$IMAGE_NAME",
"AppImageConfigName": "$IMAGE_CONFIG_NAME"
}]
}
}'
```
------
#### [ JupyterLab ]
Buat konfigurasi gambar aplikasi untuk JupyterLab:
```
aws sagemaker create-app-image-config \
--app-image-config-name "$IMAGE_CONFIG_NAME" \
--jupyter-lab-app-image-config '{ "FileSystemConfig": { "MountPath": "/home/sagemaker-user", "DefaultUid": 1000, "DefaultGid": 100 } }'
```
Perbarui domain Amazon SageMaker AI Anda untuk menyertakan gambar khusus untuk JupyterLab:
```
aws sagemaker update-domain \
--domain-id "$DOMAIN_ID" \
--default-user-settings '{
"JupyterLabAppSettings": {
"CustomImages": [{
"ImageName": "$IMAGE_NAME",
"AppImageConfigName": "$IMAGE_CONFIG_NAME"
}]
}
}'
```
------
1. Setelah memperbarui domain untuk menyertakan gambar kustom, Anda dapat membuat aplikasi di Studio menggunakan gambar kustom Anda. Ketika Anda [Luncurkan gambar kustom di Studio](studio-updated-byoi-how-to-launch.md) memastikan bahwa Anda menggunakan gambar kustom Anda.
# Lepaskan dan bersihkan sumber daya gambar kustom
Halaman berikut memberikan petunjuk tentang cara melepaskan gambar kustom Anda dan membersihkan sumber daya terkait menggunakan konsol Amazon SageMaker AI atau AWS Command Line Interface (AWS CLI).
**penting**
Anda harus terlebih dahulu melepaskan gambar kustom Anda dari domain Anda sebelum menghapus gambar dari toko gambar SageMaker AI. Jika tidak, Anda mungkin mengalami kesalahan saat melihat informasi domain Anda atau melampirkan gambar kustom baru ke domain Anda.
Jika Anda mengalami kesalahan saat memuat gambar khusus, lihat[Kegagalan memuat gambar kustom](studio-updated-troubleshooting.md#studio-updated-troubleshooting-custom-image).
## Lepaskan dan hapus gambar khusus (konsol)
Berikut ini memberikan petunjuk tentang cara melepaskan gambar kustom Anda dari SageMaker AI dan membersihkan sumber daya gambar khusus Anda menggunakan konsol.
**Lepaskan gambar kustom Anda dari domain Anda**
1. Buka [konsol SageMaker AI](https://console.aws.amazon.com/sagemaker).
1. Perluas bagian **Konfigurasi Admin**.
1. Di bawah **konfigurasi Admin**, pilih **Domain**.
1. Dari daftar **domain**, pilih domain.
1. Buka tab **Lingkungan**.
1. Untuk **gambar kustom untuk aplikasi Studio pribadi**, pilih kotak centang untuk gambar yang ingin dilepas.
1. Pilih **Lepaskan**.
1. Ikuti instruksi untuk melepaskan diri.
**Hapus gambar kustom Anda**
1. Buka [konsol SageMaker AI](https://console.aws.amazon.com/sagemaker).
1. Perluas bagian **konfigurasi Admin**, jika belum dilakukan.
1. Di bawah **konfigurasi Admin**, pilih **Gambar**.
1. Dari daftar **Gambar**, pilih gambar yang ingin Anda hapus.
1. Pilih **Hapus**.
1. Ikuti petunjuk untuk menghapus gambar Anda dan semua versinya dari SageMaker AI.
**Hapus gambar dan repositori kustom Anda dari Amazon ECR**
**penting**
Ini juga akan menghapus gambar kontainer dan artefak apa pun di repositori ini.
1. Buka [konsol Amazon ECR](https://console.aws.amazon.com/ecr).
1. Jika belum melakukannya, perluas panel navigasi kiri.
1. Di bawah **Registri pribadi**, pilih **Repositori**.
1. Pilih repositori yang ingin Anda hapus.
1. Pilih **Hapus**.
1. Ikuti instruksi untuk menghapus.
## Lepaskan dan hapus gambar kustom ()AWS CLI
Bagian berikut menunjukkan contoh tentang cara melepaskan gambar kustom Anda menggunakan. AWS CLI
1. Pertama atur variabel Anda untuk AWS CLI perintah yang mengikuti.
```
ACCOUNT_ID=account-id
REGION=aws-region
APP_IMAGE_CONFIG=app-image-config
SAGEMAKER_IMAGE_NAME=custom-image-name
```
+ `aws-region`adalah Wilayah AWS domain SageMaker AI Amazon Anda. Anda dapat menemukan ini di kanan atas halaman AWS konsol mana pun.
+ `app-image-config`adalah nama konfigurasi gambar aplikasi Anda. Gunakan AWS CLI perintah berikut untuk membuat daftar konfigurasi gambar aplikasi di Anda Wilayah AWS.
```
aws sagemaker list-app-image-configs \
--region ${REGION}
```
+ `custom-image-name`adalah nama gambar kustom. Gunakan AWS CLI perintah berikut untuk membuat daftar gambar di Anda Wilayah AWS.
```
aws sagemaker list-images \
--region ${REGION}
```
1. Untuk melepaskan versi gambar dan gambar dari domain Anda menggunakan petunjuk ini, Anda harus membuat atau memperbarui file json konfigurasi domain.
**catatan**
Jika Anda mengikuti petunjuk di[Lampirkan gambar kustom Anda ke domain Anda](studio-updated-byoi-how-to-attach-to-domain.md), Anda mungkin telah memperbarui domain Anda menggunakan file bernama`update-domain.json`.
Jika Anda tidak memiliki file itu, Anda dapat membuat file json baru sebagai gantinya.
Buat file bernama `update-domain.json` yang akan Anda gunakan untuk memperbarui domain Anda.
1. Untuk menghapus gambar khusus, Anda harus membiarkan `CustomImages` kosong, sehingga`"CustomImages": []`. Pilih salah satu dari berikut ini untuk melihat contoh file konfigurasi untuk Editor Kode atau JupyterLab.
------
#### [ Code Editor: update domain configuration file example ]
Contoh file konfigurasi untuk Editor Kode, menggunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CodeEditorAppSettings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CodeEditorAppSettings.html).
```
{
"DomainId": "domain-id",
"DefaultUserSettings": {
"CodeEditorAppSettings": {
"CustomImages": [
]
}
}
}
```
------
#### [ JupyterLab: update domain configuration file example ]
Contoh file konfigurasi untuk JupyterLab, menggunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_JupyterLabAppSettings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_JupyterLabAppSettings.html).
```
{
"DomainId": "domain-id",
"DefaultUserSettings": {
"JupyterLabAppSettings": {
"CustomImages": [
]
}
}
}
```
------
`domain-id`adalah ID domain tempat gambar Anda dilampirkan. Gunakan perintah berikut untuk membuat daftar domain Anda.
```
aws sagemaker list-domains \
--region ${REGION}
```
1. Simpan file tersebut.
1. Panggil [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html) AWS CLI menggunakan file konfigurasi domain pembaruan,. `update-domain.json`
**catatan**
Sebelum Anda dapat memperbarui gambar kustom, Anda harus menghapus semua **aplikasi** di domain Anda. Anda **tidak** perlu menghapus profil pengguna atau spasi bersama. Untuk instruksi tentang menghapus aplikasi, pilih salah satu opsi berikut.
Jika Anda ingin menggunakan konsol SageMaker AI, lihat[Matikan sumber daya SageMaker AI di domain Anda](sm-console-domain-resources-shut-down.md).
Jika Anda ingin menggunakan AWS CLI, gunakan langkah 1 hingga 3 dari[Hapus domain Amazon SageMaker AI (AWS CLI)](gs-studio-delete-domain.md#gs-studio-delete-domain-cli).
```
aws sagemaker update-domain \
--cli-input-json file://update-domain.json \
--region ${REGION}
```
1. Hapus konfigurasi gambar aplikasi.
```
aws sagemaker delete-app-image-config \
--app-image-config-name ${APP_IMAGE_CONFIG}
```
1. Hapus gambar kustom. Ini juga menghapus semua versi gambar. Ini tidak menghapus gambar wadah Amazon ECR dan versi gambar. Untuk melakukannya, gunakan langkah-langkah opsional di bawah ini.
```
aws sagemaker delete-image \
--image-name ${SAGEMAKER_IMAGE_NAME}
```
1. (Opsional) Hapus sumber daya Amazon ECR Anda. Daftar berikut menyediakan AWS CLI perintah untuk mendapatkan informasi sumber daya Amazon ECR Anda untuk langkah-langkah di bawah ini.
1. Tetapkan variabel Anda untuk AWS CLI perintah yang mengikuti.
```
ECR_REPO_NAME=ecr-repository-name
```
`ecr-repository-name`adalah nama repositori Amazon Elastic Container Registry Anda.
Untuk membuat daftar detail repositori Anda, gunakan perintah berikut.
```
aws ecr describe-repositories \
--region ${REGION}
```
1. Hapus repositori Anda dari Amazon ECR.
**penting**
Ini juga akan menghapus gambar kontainer dan artefak apa pun di repositori ini.
```
aws ecr delete-repository \
--repository-name ${ECR_REPO_NAME} \
--force \
--region ${REGION}
```