Lampirkan SageMaker gambar khusus - Amazon SageMaker AI
Lampirkan versi gambar ke domain Anda menggunakan konsolLampirkan versi gambar yang ada ke domain Anda menggunakan AWS CLI

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

Lampirkan SageMaker gambar khusus

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.

Panduan ini menunjukkan cara melampirkan RStudio gambar khusus ke domain Amazon SageMaker AI Anda menggunakan konsol SageMaker AI atau AWS Command Line Interface (AWS CLI).

Untuk menggunakan SageMaker gambar kustom, Anda harus melampirkan RStudio gambar kustom ke domain Anda. Saat Anda melampirkan versi gambar, itu muncul di RStudio Peluncur dan tersedia di daftar dropdown Pilih gambar. Anda menggunakan dropdown untuk mengubah gambar yang digunakan oleh. RStudio

Ada batasan jumlah versi gambar yang dapat Anda lampirkan. Setelah Anda mencapai batas, Anda harus terlebih dahulu melepaskan versi sehingga Anda dapat melampirkan versi gambar yang berbeda.

Lampirkan versi gambar ke domain Anda menggunakan konsol

Anda dapat melampirkan versi SageMaker gambar khusus ke domain Anda menggunakan panel kontrol konsol SageMaker AI. Anda juga dapat membuat SageMaker gambar kustom, dan versi gambar, dan kemudian melampirkan versi itu ke domain Anda.

Untuk melampirkan gambar yang ada

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

  4. Pilih domain yang diinginkan.

  5. Pilih Lingkungan.

  6. Di bawah gambar Custom SageMaker Studio Classic yang dilampirkan ke domain, pilih Lampirkan gambar.

  7. Untuk Sumber gambar, pilih Gambar yang ada atau Gambar baru.

    Jika Anda memilih Gambar yang ada, pilih gambar dari toko SageMaker gambar Amazon.

    Jika Anda memilih Gambar baru, berikan jalur registri Amazon ECR untuk gambar Docker Anda. Jalur harus Wilayah AWS sama dengan domain. Repo Amazon ECR harus berada di akun yang sama dengan domain Anda, atau izin lintas akun untuk SageMaker AI harus diaktifkan.

  8. Pilih pengguna yang ada dari daftar.

  9. Pilih versi gambar dari daftar.

  10. Pilih Berikutnya.

  11. Masukkan nilai untuk nama Gambar, Nama tampilan gambar, dan Deskripsi.

  12. Pilih IAM role. Untuk informasi selengkapnya, lihat Buat RStudio citra kustom.

  13. (Opsional) Tambahkan tag untuk gambar.

  14. (Opsional) Pilih Tambahkan tag baru, lalu tambahkan tag konfigurasi.

  15. Untuk jenis Gambar, pilih RStudioGambar.

  16. Pilih Kirim.

Tunggu hingga versi gambar dilampirkan ke domain. Setelah versi dilampirkan, itu muncul di daftar Gambar khusus dan disorot secara singkat.

Lampirkan versi gambar yang ada ke domain Anda menggunakan AWS CLI

Dua metode disajikan untuk melampirkan versi gambar ke domain Anda menggunakan AWS CLI. Pada metode pertama, Anda membuat domain baru dengan versi terlampir. Metode ini lebih sederhana tetapi Anda harus menentukan informasi Amazon Virtual Private Cloud (Amazon VPC) dan peran eksekusi yang diperlukan untuk membuat domain.

Jika Anda sudah onboard ke domain, Anda dapat menggunakan metode kedua untuk melampirkan versi gambar ke domain Anda saat ini. Dalam hal ini, Anda tidak perlu menentukan informasi dan eksekusi Amazon VPC. Setelah Anda melampirkan versi, hapus semua aplikasi di domain Anda dan luncurkan kembali RStudio.

Lampirkan SageMaker gambar ke domain baru

Untuk menggunakan metode ini, Anda harus menentukan peran eksekusi yang memiliki AmazonSageMakerFullAccesskebijakan yang dilampirkan.

Gunakan langkah-langkah berikut untuk membuat domain dan melampirkan gambar SageMaker AI kustom:

  • Dapatkan ID dan subnet VPC default Anda. IDs

  • Buat file konfigurasi untuk domain, yang menentukan gambar.

  • Buat File Konfigurasi Agen dengan Wizard

Menambahkan domain kustom ke aplikasi

  1. Dapatkan ID VPC default Anda.

    aws ec2 describe-vpcs \
    --filters Name=isDefault,Values=true \
    --query "Vpcs[0].VpcId" --output text

    Respons:

    vpc-xxxxxxxx

  2. Dapatkan subnet default Anda IDs menggunakan ID VPC dari langkah sebelumnya.

    aws ec2 describe-subnets \
    --filters Name=vpc-id,Values=<vpc-id> \
    --query "Subnets[*].SubnetId" --output json

    Respons:

    [
    "subnet-b55171dd",
    "subnet-8a5f99c6",
    "subnet-e88d1392"
]

  3. Buat file konfigurasi JSON bernama create-domain-input.json. Masukkan ID VPC, subnet IDsImageName, dan AppImageConfigName dari langkah sebelumnya. Karena ImageVersionNumber tidak ditentukan, versi terbaru dari gambar digunakan, yang merupakan satu-satunya versi dalam kasus ini. Peran eksekusi Anda harus memenuhi persyaratan diPrasyarat lengkap.

    {
  "DomainName": "domain-with-custom-r-image",
  "VpcId": "<vpc-id>",
  "SubnetIds": [
    "<subnet-ids>"
  ],
  "DomainSettings": {
    "RStudioServerProDomainSettings": {
      "DomainExecutionRoleArn": "<execution-role>"
    }
  },
  "DefaultUserSettings": {
    "ExecutionRole": "<execution-role>",
    "RSessionAppSettings": {
      "CustomImages": [
        {
         "AppImageConfigName": "rstudio-custom-config",
         "ImageName": "rstudio-custom-image"
        }
      ]
     }
  },
  "AuthMode": "IAM"
}

  4. Buat domain dengan SageMaker gambar kustom terlampir.

    aws sagemaker create-domain \
    --cli-input-json file://create-domain-input.json

    Respons:

    {
    "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id",
    "Url": "https://domain-id.studio.region.sagemaker.aws/..."
}

Lampirkan SageMaker gambar ke domain yang ada

Metode ini menganggap bahwa Anda telah onboard ke domain. Untuk informasi selengkapnya, lihat Ikhtisar domain Amazon SageMaker AI.

catatan

Anda harus menghapus semua aplikasi di domain Anda untuk memperbarui domain dengan versi gambar baru. Untuk informasi tentang menghapus aplikasi ini, lihatHapus domain Amazon SageMaker AI.

Lakukan langkah-langkah berikut untuk menambahkan SageMaker gambar ke domain Anda saat ini.

  • Dapatkan DomainID dari konsol SageMaker AI.

  • Gunakan DomainID untuk mendapatkan domain. DefaultUserSettings

  • Tambahkan ImageName dan AppImageConfig sebagai a CustomImage keDefaultUserSettings.

  • Perbarui domain Anda untuk menyertakan gambar kustom.

Menambahkan domain kustom ke aplikasi

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

  4. Pilih domain yang diinginkan.

  5. Pilih pengaturan domain.

  6. Di bawah Pengaturan Umum, temukan ID domain. Format namanya adalah sebagai berikut:

  7. Gunakan ID domain untuk mendapatkan deskripsi domain.

    aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

    Respons:

    {
    "DomainId": "d-xxxxxxxxxxxx",
    "DefaultUserSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

  8. Simpan DefaultUserSettings bagian respons ke file bernamaupdate-domain-input.json.

  9. Masukkan ImageName dan AppImageConfigName dari langkah sebelumnya sebagai gambar khusus. Karena ImageVersionNumber tidak ditentukan, versi terbaru dari gambar digunakan, yang merupakan satu-satunya versi dalam kasus ini.

    {
    "DefaultUserSettings": {
        "RSessionAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "rstudio-custom-image",
                 "AppImageConfigName": "rstudio-custom-config"
              }
           ]
        }
    }
}

  10. Gunakan ID domain dan file pengaturan pengguna default untuk memperbarui domain Anda.

    aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://update-domain-input.json

    Respons:

    {
    "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id"
}

  11. Untuk menghapus aplikasi Anda harus memulai ulang aplikasi RStudioServerPro bersama domain untuk UI RStudio Peluncur untuk mengambil perubahan terbaru.

    aws sagemaker delete-app \
    --domain-id <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
    --app-type RStudioServerPro --app-name default

  12. Membuat proyek aplikasi baru Anda harus membuat aplikasi ini menggunakan file AWS CLI.

    aws sagemaker create-app \
    --domain-id <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
    --app-type RStudioServerPro --app-name default