Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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}\"
}
]
}
}"
```