

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Gambar kustom
<a name="studio-updated-jl-admin-guide-custom-images"></a>

Jika Anda memerlukan fungsionalitas yang berbeda dari yang disediakan oleh SageMaker distribusi, Anda dapat membawa gambar Anda sendiri dengan ekstensi dan paket khusus Anda. Anda juga dapat menggunakannya untuk mempersonalisasi JupyterLab UI untuk kebutuhan branding atau kepatuhan Anda sendiri.

Halaman berikut akan memberikan JupyterLab-specific informasi dan template untuk membuat gambar SageMaker AI kustom Anda sendiri. Ini dimaksudkan untuk melengkapi informasi Amazon SageMaker Studio dan instruksi tentang membuat gambar SageMaker AI Anda sendiri dan membawa gambar Anda sendiri ke Studio. Untuk mempelajari tentang gambar Amazon SageMaker AI khusus dan cara membawa gambar Anda sendiri ke Studio, lihat[Bawa gambar Anda sendiri (BYOI)](studio-updated-byoi.md). 

**Topics**
+ [Pemeriksaan Kesehatan dan URL untuk aplikasi](#studio-updated-jl-admin-guide-custom-images-app-healthcheck)
+ [Contoh Dockerfile](#studio-updated-jl-custom-images-dockerfile-templates)

## Pemeriksaan Kesehatan dan URL untuk aplikasi
<a name="studio-updated-jl-admin-guide-custom-images-app-healthcheck"></a>
+ `Base URL`— URL dasar untuk aplikasi BYOI harus. `jupyterlab/default` Anda hanya dapat memiliki satu aplikasi dan harus selalu diberi nama`default`.
+ `HealthCheck API`— SageMaker AI menggunakan titik akhir pemeriksaan kesehatan di port `8888` untuk memeriksa kesehatan JupyterLab aplikasi. `jupyterlab/default/api/status`adalah titik akhir untuk pemeriksaan kesehatan.
+ `Home/Default URL`— `/opt/ml` Direktori `/opt/.sagemakerinternal` dan direktori yang digunakan oleh AWS. File metadata di `/opt/ml` berisi metadata tentang sumber daya seperti. `DomainId`
+ Otentikasi — Untuk mengaktifkan otentikasi bagi pengguna Anda, matikan token notebook Jupyter atau otentikasi berbasis kata sandi dan izinkan semua asal.

## Contoh Dockerfile
<a name="studio-updated-jl-custom-images-dockerfile-templates"></a>

Contoh berikut adalah `Dockerfile` s yang memenuhi informasi di atas dan[Spesifikasi gambar kustom](studio-updated-byoi-specs.md).

**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.

------
#### [ Example AL2023 Dockerfile ]

Berikut ini adalah contoh AL2023 Dockerfile yang memenuhi informasi di atas dan[Spesifikasi gambar kustom](studio-updated-byoi-specs.md).

```
FROM public.ecr.aws/amazonlinux/amazonlinux:2023

ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100

# Install Python3, pip, and other dependencies
RUN yum install -y \
    python3 \
    python3-pip \
    python3-devel \
    gcc \
    shadow-utils && \
    useradd --create-home --shell /bin/bash --gid "${NB_GID}" --uid ${NB_UID} ${NB_USER} && \
    yum clean all

RUN python3 -m pip install --no-cache-dir \
    'jupyterlab>=4.0.0,<5.0.0' \
    urllib3 \
    jupyter-activity-monitor-extension \
    --ignore-installed

# Verify versions
RUN python3 --version && \
    jupyter lab --version

USER ${NB_UID}
CMD jupyter lab --ip 0.0.0.0 --port 8888 \
    --ServerApp.base_url="/jupyterlab/default" \
    --ServerApp.token='' \
    --ServerApp.allow_origin='*'
```

------
#### [ Example  SageMaker Distribusi Amazon Dockerfile ]

Berikut ini adalah contoh Amazon SageMaker Distribution Dockerfile yang memenuhi informasi di atas dan[Spesifikasi gambar kustom](studio-updated-byoi-specs.md).

```
FROM public.ecr.aws/sagemaker/sagemaker-distribution:latest-cpu
ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100

ENV MAMBA_USER=$NB_USER

USER root

RUN apt-get update
RUN micromamba install sagemaker-inference --freeze-installed --yes --channel conda-forge --name base

USER $MAMBA_USER

ENTRYPOINT ["entrypoint-jupyter-server"]
```

------