Memulai dengan mode lokal - Amazon SageMaker AI
PrasyaratPengaturan EnableDockerAccessDockerinstalasi

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

Memulai dengan mode lokal

Bagian berikut menguraikan langkah-langkah yang diperlukan untuk memulai mode lokal di Amazon SageMaker Studio, termasuk:

  • Menyelesaikan prasyarat

  • Pengaturan EnableDockerAccess

  • Dockerinstalasi

Prasyarat

Lengkapi prasyarat berikut untuk menggunakan mode lokal di aplikasi Studio:

  • Untuk menarik gambar dari repositori Amazon Elastic Container Registry, akun yang menghosting image Amazon ECR harus memberikan izin akses untuk peran eksekusi pengguna. Peran eksekusi domain juga harus memungkinkan akses Amazon ECR.

  • Verifikasi bahwa Anda menggunakan versi terbaru Studio Python SDK dengan menggunakan perintah berikut:  

    pip install -U sagemaker

  • Untuk menggunakan mode dan Docker kemampuan lokal, atur parameter domain berikut DockerSettings menggunakan AWS Command Line Interface (AWS CLI):  

    EnableDockerAccess : ENABLED

  • Dengan menggunakanEnableDockerAccess, Anda juga dapat mengontrol apakah pengguna di domain dapat menggunakan mode lokal. Secara default, mode dan Docker kemampuan lokal tidak diizinkan dalam aplikasi Studio. Untuk informasi selengkapnya, lihat Pengaturan EnableDockerAccess.

  • Instal Docker CLI di aplikasi Studio dengan mengikuti langkah-langkah di. Dockerinstalasi

Pengaturan EnableDockerAccess

Bagian berikut menunjukkan cara mengatur EnableDockerAccess kapan domain memiliki akses internet publik atau dalam VPC-only mode.

catatan

Perubahan EnableDockerAccess hanya berlaku untuk aplikasi yang dibuat setelah domain diperbarui. Anda harus membuat aplikasi baru setelah memperbarui domain.

Akses internet publik

Contoh perintah berikut menunjukkan cara mengatur EnableDockerAccess saat membuat domain baru atau memperbarui domain yang ada dengan akses internet publik:

# create new domain
aws --region region \
    sagemaker create-domain --domain-name domain-name \
    --vpc-id vpc-id \
    --subnet-ids subnet-ids \
    --auth-mode IAM \
    --default-user-settings "ExecutionRole=execution-role" \
    --domain-settings '{"DockerSettings": {"EnableDockerAccess": "ENABLED"}}' \
    --query DomainArn \
    --output text

# update domain
aws --region region \
    sagemaker update-domain --domain-id domain-id \
    --domain-settings-for-update '{"DockerSettings": {"EnableDockerAccess": "ENABLED"}}'

VPC-onlymodus

Saat menggunakan domain dalam VPC-only mode, permintaan push dan pull Docker image dirutekan melalui VPC layanan alih-alih VPC yang dikonfigurasi oleh pelanggan. Karena fungsi ini, administrator dapat mengonfigurasi daftar tepercaya Akun AWS bahwa pengguna dapat membuat permintaan operasi Docker tarik dan dorong Amazon ECR.

Jika permintaan push atau pull Docker gambar dibuat ke Akun AWS yang tidak ada dalam daftar tepercaya Akun AWS, permintaan gagal. Dockeroperasi tarik dan dorong di luar Amazon Elastic Container Registry (Amazon ECR) tidak didukung dalam mode. VPC-only

Akun AWS Berikut ini dipercaya secara default:

  • Akun hosting domain SageMaker AI.

  • SageMaker Akun AI yang menampung SageMaker gambar-gambar berikut:

    • Gambar kerangka kerja DLC

    • Sklearn,Spark, XGBoost memproses gambar

Untuk mengonfigurasi daftar tambahan tepercaya Akun AWS, tentukan VpcOnlyTrustedAccounts nilainya sebagai berikut: 

aws --region region \
    sagemaker update-domain --domain-id domain-id \
    --domain-settings-for-update '{"DockerSettings": {"EnableDockerAccess": "ENABLED", "VpcOnlyTrustedAccounts": ["account-list"]}}'

Dockerinstalasi

Untuk menggunakannyaDocker, Anda harus menginstal secara manual Docker dari terminal aplikasi Studio Anda. Langkah-langkah untuk menginstal Docker berbeda jika domain memiliki akses ke internet atau tidak.

Akses internet

Jika domain dibuat dengan akses internet publik atau dalam VPC-only mode dengan akses internet terbatas, gunakan langkah-langkah berikut untuk menginstalDocker.

  1. (Opsional) Jika domain Anda dibuat dalam VPC-only mode dengan akses internet terbatas, buat gateway NAT publik dengan akses ke Docker situs web. Untuk instruksi, lihat gateway NAT.

  2. Arahkan ke terminal aplikasi Studio yang ingin Anda instalDocker.

  3. Untuk mengembalikan sistem operasi aplikasi, jalankan perintah berikut dari terminal:

    cat /etc/os-release

  4. Instal Docker mengikuti instruksi untuk sistem operasi aplikasi di repositori Contoh Mode Lokal Amazon SageMaker AI.

    Misalnya, instal Docker Ubuntu mengikuti skrip di https://github.com/aws-samples/amazon-sagemaker-local-mode/blob/main/sagemaker_studio_docker_cli_install/sagemaker- ubuntu-focal-docker-cli -install.sh dengan pertimbangan berikut:

    • Jika perintah dirantai gagal, jalankan perintah satu per satu.

    • Studio hanya mendukung Docker versi 20.10.X. dan versi Docker Engine API1.41.

    • Paket-paket berikut tidak diperlukan untuk menggunakan Docker CLI di Studio dan penginstalannya dapat dilewati:

      • containerd.io

      • docker-ce

      • docker-buildx-plugin

    catatan

    Anda tidak perlu memulai Docker layanan di aplikasi Anda. Instance yang meng-host aplikasi Studio menjalankan Docker layanan secara default. Semua panggilan Docker API dirutekan melalui Docker layanan secara otomatis.

  5. Gunakan Docker soket terbuka untuk Docker interaksi dalam aplikasi Studio. Secara default, soket berikut terbuka:

    unix:///docker/proxy.sock

    Variabel lingkungan aplikasi Studio berikut untuk default USER menggunakan soket terbuka ini:

    DOCKER_HOST

Tidak ada akses internet

Jika domain dibuat dalam VPC-only mode tanpa akses internet, gunakan langkah-langkah berikut untuk menginstalDocker.

  1. Arahkan ke terminal aplikasi Studio yang ingin Anda instalDocker.

  2. Jalankan perintah berikut dari terminal untuk mengembalikan sistem operasi aplikasi:

    cat /etc/os-release

  3. Unduh Docker .deb file yang diperlukan ke mesin lokal Anda. Untuk petunjuk tentang mengunduh file yang diperlukan untuk sistem operasi aplikasi Studio, lihat Menginstal Docker Engine.

    Misalnya, instal Docker dari paket di Ubuntu mengikuti langkah-langkah 1-4 di Instal dari paket dengan pertimbangan berikut:

    • Instal Docker dari paket. Menggunakan metode lain untuk menginstal Docker akan gagal.

    • Instal paket terbaru yang sesuai dengan Docker versi20.10.X.

    • Paket-paket berikut tidak diperlukan untuk menggunakan Docker CLI di Studio. Anda tidak perlu menginstal yang berikut ini:

      • containerd.io

      • docker-ce

      • docker-buildx-plugin

    catatan

    Anda tidak perlu memulai Docker layanan di aplikasi Anda. Instance yang meng-host aplikasi Studio menjalankan Docker layanan secara default. Semua panggilan Docker API dirutekan melalui Docker layanan secara otomatis.

  4. Unggah .deb file ke sistem file Amazon EFS atau ke sistem file Amazon EBS aplikasi.

  5. Instal docker-compose-plugin .deb paket docker-ce-cli dan paket secara manual dari terminal aplikasi Studio. Untuk informasi dan petunjuk selengkapnya, lihat langkah 5 di Instal dari paket di situs web Docker dokumen.

  6. Gunakan Docker soket terbuka untuk Docker interaksi dalam aplikasi Studio. Secara default, soket berikut terbuka:

    unix:///docker/proxy.sock

    Variabel lingkungan aplikasi Studio berikut untuk default USER menggunakan soket terbuka ini:

    DOCKER_HOST