Buat konfigurasi siklus hidup dari AWS CLI - Amazon SageMaker
PrasyaratLangkah 1: Buat konfigurasi siklus hidupLangkah 2: Lampirkan konfigurasi siklus hidupLangkah 3: Luncurkan aplikasi dengan konfigurasi siklus hidup

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

Buat konfigurasi siklus hidup dari AWS CLI

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 Sumber Daya Penandaan SageMaker.

AWS Kebijakan Terkelola untuk Amazon SageMakeryang memberikan izin untuk membuat SageMaker sumber daya sudah menyertakan izin untuk menambahkan tag saat membuat sumber daya tersebut.

penting

Per 30 November 2023, pengalaman Amazon SageMaker Studio sebelumnya sekarang bernama Amazon SageMaker Studio Classic. Bagian berikut khusus untuk menggunakan aplikasi Studio Classic. Untuk informasi tentang menggunakan pengalaman Studio yang diperbarui, lihat SageMaker Studio Amazon.

Topik berikut menunjukkan cara membuat konfigurasi siklus hidup menggunakan untuk mengotomatiskan penyesuaian AWS CLI untuk lingkungan Studio Classic Anda.

Prasyarat

Sebelum menggunakan fungsi , pastikan untuk melengkapi prasyarat berikut:

Langkah 1: Buat konfigurasi siklus hidup

Prosedur berikut menunjukkan cara membuat skrip konfigurasi siklus hidup yang mencetak. Hello World

catatan

Setiap skrip dapat memiliki hingga 16.384 karakter.

  1. Dari mesin lokal Anda, buat file bernama my-script.sh dengan konten berikut.

    #!/bin/bash
set -eux
echo 'Hello World!'

  2. Konversikan my-script.sh file Anda menjadi format base64. Persyaratan ini mencegah kesalahan yang terjadi dari spasi dan pengkodean jeda baris.

    LCC_CONTENT=`openssl base64 -A -in my-script.sh`

  3. Buat konfigurasi siklus hidup untuk digunakan dengan Studio Classic. Perintah berikut membuat konfigurasi siklus hidup yang berjalan saat Anda meluncurkan aplikasi terkaitKernelGateway. 

    aws sagemaker create-studio-lifecycle-config \
--region region \
--studio-lifecycle-config-name my-studio-lcc \
--studio-lifecycle-config-content $LCC_CONTENT \
--studio-lifecycle-config-app-type KernelGateway

    Perhatikan ARN dari konfigurasi siklus hidup yang baru dibuat yang dikembalikan. ARN ini diperlukan untuk melampirkan konfigurasi siklus hidup ke aplikasi Anda.

Langkah 2: Lampirkan konfigurasi siklus hidup ke domain, profil pengguna, atau ruang bersama

Untuk melampirkan konfigurasi siklus hidup, Anda harus memperbarui UserSettings untuk domain atau profil pengguna, atau SpaceSettings untuk ruang bersama. Skrip konfigurasi siklus hidup yang terkait pada tingkat domain diwarisi oleh semua pengguna. Namun, skrip yang terkait pada tingkat profil pengguna dicakup oleh pengguna tertentu, sementara skrip yang terkait pada tingkat ruang bersama dicakup ke ruang bersama.

Contoh berikut menunjukkan cara membuat profil pengguna baru dengan konfigurasi siklus hidup terlampir. Anda juga dapat membuat domain atau ruang baru dengan konfigurasi siklus hidup yang dilampirkan menggunakan perintah create-domain dan create-space, masing-masing.

Tambahkan ARN konfigurasi siklus hidup dari langkah sebelumnya ke pengaturan untuk jenis aplikasi yang sesuai. Misalnya, letakkan JupyterServerAppSettings di pengguna. Anda dapat menambahkan beberapa konfigurasi siklus hidup secara bersamaan dengan meneruskan daftar konfigurasi siklus hidup. Ketika pengguna meluncurkan JupyterServer aplikasi dengan AWS CLI, mereka dapat meneruskan konfigurasi siklus hidup untuk digunakan, bukan default. Konfigurasi siklus hidup yang dilewati pengguna harus termasuk dalam daftar konfigurasi siklus hidup. JupyterServerAppSettings

# Create a new UserProfile
aws sagemaker create-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"JupyterServerAppSettings": {
  "LifecycleConfigArns":
    [lifecycle-configuration-arn-list]
  }
}'

Contoh berikut menunjukkan cara memperbarui ruang bersama yang ada untuk melampirkan konfigurasi siklus hidup. Anda juga dapat memperbarui domain atau profil pengguna yang ada dengan konfigurasi siklus hidup yang dilampirkan menggunakan perintah update-domain atau update-user-profile. Saat memperbarui daftar konfigurasi siklus hidup yang dilampirkan, Anda harus meneruskan semua konfigurasi siklus hidup sebagai bagian dari daftar. Jika konfigurasi siklus hidup bukan bagian dari daftar ini, itu tidak akan dilampirkan ke aplikasi.

aws sagemaker update-space --domain-id domain-id \
--space-name space-name \
--region region \
--space-settings '{
"JupyterServerAppSettings": {
  "LifecycleConfigArns":
    [lifecycle-configuration-arn-list]
  }
}'

Untuk informasi tentang menyetel konfigurasi siklus hidup default untuk sumber daya, lihat. Tetapkan konfigurasi siklus hidup default

Langkah 3: Luncurkan aplikasi dengan konfigurasi siklus hidup

Setelah Anda melampirkan konfigurasi siklus hidup ke domain, profil pengguna, atau spasi, pengguna dapat memilihnya saat meluncurkan aplikasi dengan file. AWS CLI Bagian ini menjelaskan cara meluncurkan aplikasi dengan konfigurasi siklus hidup terlampir. Untuk informasi tentang mengubah konfigurasi siklus hidup default setelah meluncurkan JupyterServer aplikasi, lihat. Tetapkan konfigurasi siklus hidup default

Luncurkan jenis aplikasi yang diinginkan menggunakan create-app perintah dan tentukan konfigurasi siklus hidup ARN dalam argumen. resource-spec

  • Contoh berikut menunjukkan cara membuat JupyterServer aplikasi dengan konfigurasi siklus hidup terkait. Saat membuatJupyterServer, app-name harusdefault. Konfigurasi siklus hidup ARN yang diteruskan sebagai bagian dari resource-spec parameter harus menjadi bagian dari daftar ARN konfigurasi siklus hidup yang ditentukan untuk domain atau profil pengguna Anda, atau UserSettings untuk ruang bersama. SpaceSettings

    aws sagemaker create-app --domain-id domain-id \
--region region \
--user-profile-name user-profile-name \
--app-type JupyterServer \
--resource-spec LifecycleConfigArn=lifecycle-configuration-arn \
--app-name default

  • Contoh berikut menunjukkan cara membuat KernelGateway aplikasi dengan konfigurasi siklus hidup terkait.

    aws sagemaker create-app --domain-id domain-id \
--region region \
--user-profile-name user-profile-name \
--app-type KernelGateway \
--resource-spec LifecycleConfigArn=lifecycle-configuration-arn,SageMakerImageArn=sagemaker-image-arn,InstanceType=instance-type \
--app-name app-name