Buat RStudio citra kustom - Amazon SageMaker AI
Tambahkan gambar kontainer RStudio Docker yang SageMaker kompatibel dengan AI ke Amazon ECRBuat SageMaker gambar dari konsolBuat gambar dari AWS CLI

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

Buat RStudio citra 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 .

Kebijakan terkelola untuk Amazon S3yang 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. Setiap versi citra mewakili citra kontainer yang disimpan di Amazon Container Registry (ECR). Gambar kontainer harus memenuhi persyaratan yang akan digunakan RStudio. Untuk informasi selengkapnya, lihat Spesifikasi RStudio gambar kustom.

Untuk informasi tentang menguji gambar secara lokal dan menyelesaikan masalah umum, lihat repo Sampel Gambar Kustom SageMaker Studio.

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.

  • Mengunggah gambar ke repositori Amazon ECR

catatan

Repositori Amazon ECR harus Wilayah AWS sama dengan domain Anda.

Untuk membangun dan menambahkan citra Docker ke Amazon ECR

  1. Buat repositori di Amazon ECR menggunakan perintah AWS CLI. Untuk membuat repositori menggunakan konsol Amazon ECR, lihat Membuat 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",
        ...
    }
}

  2. Otentikasi ke Amazon ECR menggunakan URI repositori yang dikembalikan sebagai respons dari perintah. create-repository Pastikan bahwa aplikasi Docker sedang berjalan. Untuk informasi lebih lanjut, lihat Autentikasi Registri.

    aws ecr get-login-password | \
    docker login --username AWS --password-stdin <repository-uri>

    Respons:

    Login Succeeded

  3. membuat gambar Docker. Jalankan perintah berikut dari direktori yang menyertakan Dockerfile Anda.

    docker build .

  4. Tandai gambar buatan Anda dengan tag unik.

    docker tag <image-id> "<repository-uri>:<tag>"

  5. Dorong citra kontainer ke repositori Amazon ECR. Untuk informasi selengkapnya, lihat ImagePushdan Mendorong gambar.

    docker push <repository-uri>:<tag>

    Respons:

    The push refers to repository [<account-id>.dkr.ecr.us-east-2.amazonaws.com/rstudio-custom]
r: digest: <digest> size: 3066

Buat SageMaker gambar dari konsol

Membuat citra

  1. Buka konsol Amazon SageMaker AI di https://console.aws.amazon.com/sagemaker/.

  2. Di panel navigasi, pilih Konfigurasi lisensi.

  3. Di bawah konfigurasi Admin, pilih Gambar.

  4. Pada halaman Custom images, pilih Create image.

  5. Untuk Sumber gambar, masukkan jalur registri ke gambar kontainer di Amazon ECR. Muatan berada dalam format JSON berikut:

    acct-id.dkr.ecr.region.amazonaws.com/repo-name[:tag] or [@digest]

  6. Pilih Berikutnya.

  7. Di bawah properti Gambar, masukkan yang berikut ini:

    • Nama harus unik untuk akun Anda di Wilayah saat ini.

    • (Opsional) Nama tampilan gambar - Nama yang ditampilkan di antarmuka pengguna domain. Ketika tidak disediakan, Image name ditampilkan.

    • Deskripsi – (Opsional) Tambahkan deskripsi pembuat kecocokan.

    • Peran IAM — Peran harus memiliki AmazonSageMakerFullAccesskebijakan yang dilampirkan. Pilih salah satu opsi berikut di menu dropdown Pilih izin:

      • Buat peran baru — Tentukan bucket Amazon Simple Storage Service (Amazon S3) tambahan yang ingin Anda akses oleh pengguna notebook. Jika Anda tidak ingin mengizinkan akses ke bucket tambahan, pilih Tidak Ada.

        Lampirkan kebijakan pada peran tersebut. Peran ini memungkinkan pengguna notebook Anda mengakses bucket Amazon S3 yang tercantum di sebelah tanda centang.

      • Masukkan ARN peran IAM kustom — Masukkan Amazon Resource Name (ARN) dari IAM role 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 tanda. Tag dapat dicari menggunakan konsol SageMaker AI atau SageMaker AI Search API.

  8. Di bawah Jenis gambar, pilih RStudio gambar.

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

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

Buat gambar dari AWS CLI

Bagian ini menunjukkan cara membuat SageMaker gambar Amazon khusus menggunakan file AWS CLI.

Lakukan 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::<acct-id>:role/service-role/<execution-role>

    Respons:

    {
    "ImageArn": "arn:aws:sagemaker:us-east-2:acct-id:image/rstudio-custom-image"
}

  2. 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 <repository-uri>:<tag>

    Respons:

    {
    "ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/rstudio-image/1"
}

  3. Periksa bahwa 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 respons tersebut"ImageVersionStatus": "CREATED_FAILED", respons tersebut juga mencakup alasan kegagalan. Masalah izin adalah penyebab umum kegagalan. Anda juga dapat memeriksa CloudWatch Log Amazon Anda. Nama grup log. Nama pengaliran log.

  4. Buat file konfigurasi JSON bernama app-image-config-input.json. Konfigurasi gambar aplikasi digunakan untuk konfigurasi untuk menjalankan SageMaker gambar sebagai aplikasi Kernel Gateway.

    {
    "AppImageConfigName": "rstudio-custom-config"
}

  5. Navigasikan ke file AppImageConfig 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"
}