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