Bagikan melalui

ContainerImage Kelas

  • Referensi

Mewakili gambar kontainer, saat ini hanya untuk gambar Docker.

Kelas ini TIDAK DIGUNAKAN LAGI. Sebagai gantinya, gunakan kelas Environment.

Gambar berisi dependensi yang diperlukan untuk menjalankan model termasuk:

  • Runtime

  • Definisi lingkungan Python yang ditentukan dalam file Conda

  • Kemampuan untuk mengaktifkan dukungan GPU

  • File Docker kustom untuk perintah eksekusi tertentu

Konstruktor gambar.

Kelas ini TIDAK DIGUNAKAN LAGI. Sebagai gantinya, gunakan kelas Environment.

Konstruktor gambar digunakan untuk mengambil representasi cloud objek Gambar yang terkait dengan ruang kerja yang disediakan. Akan mengembalikan instans kelas anak yang sesuai dengan jenis tertentu dari objek Gambar yang diambil.

Warisan
Image
ContainerImage

Konstruktor

ContainerImage(workspace, name=None, id=None, tags=None, properties=None, version=None)

Parameter

Nama Deskripsi
workspace
Diperlukan
Workspace

Objek ruang kerja yang berisi Gambar yang akan diambil
name
str

Nama Gambar yang akan diambil. Akan mengembalikan versi terbaru, jika ada

Nilai default: None
id
str

ID spesifik dari Gambar yang akan diambil. (ID adalah ":")

Nilai default: None
tags
list

Akan memfilter hasil Gambar berdasarkan daftar yang disediakan, baik berdasarkan 'key' atau '[key, value]'. Mis. ['key', ['key2', 'key2 value']]

Nilai default: None
properties
list

Akan memfilter hasil Gambar berdasarkan daftar yang disediakan, baik berdasarkan 'key' atau '[key, value]'. Mis. ['key', ['key2', 'key2 value']]

Nilai default: None
version
str

Ketika versi dan nama ditentukan, akan mengembalikan versi spesifik dari Gambar.

Nilai default: None

Keterangan

ContainerImage diambil menggunakan konstruktor kelas Image dengan meneruskan nama atau id ContainerImage yang dibuat sebelumnya. Contoh kode berikut menunjukkan pengambilan Gambar dari Ruang kerja dengan nama dan id.


   container_image_from_name = Image(workspace, name="image-name")
   container_image_from_id = Image(workspace, id="image-id")

Untuk membuat konfigurasi Gambar baru untuk digunakan dalam penyebaran, bangun objek ContainerImageConfig seperti yang ditunjukkan dalam contoh kode berikut:


   from azureml.core.image import ContainerImage

   image_config = ContainerImage.image_configuration(execution_script="score.py",
                                                    runtime="python",
                                                    conda_file="myenv.yml",
                                                    description="image for model",
                                                    cuda_version="9.0"
                                                    )

Metode

image_configuration

Buat dan kembalikan objek ContainerImageConfig.

Fungsi ini menerima parameter untuk menentukan bagaimana model Anda harus berjalan dalam Webservice, serta lingkungan dan dependensi tertentu yang diperlukan untuk dapat dijalankan.
run

Jalankan gambar secara lokal dengan data input yang diberikan.

Docker harus terpasang dan menjalankan docker untuk bekerja. Metode ini hanya akan bekerja pada CPU, karena gambar yang mendukung GPU hanya dapat berjalan di Microsoft Azure Services.
serialize

Ubah objek ContainerImage ini menjadi kamus serial JSON.

image_configuration

Buat dan kembalikan objek ContainerImageConfig.

Fungsi ini menerima parameter untuk menentukan bagaimana model Anda harus berjalan dalam Webservice, serta lingkungan dan dependensi tertentu yang diperlukan untuk dapat dijalankan.

static image_configuration(execution_script, runtime, conda_file=None, docker_file=None, schema_file=None, dependencies=None, enable_gpu=None, tags=None, properties=None, description=None, base_image=None, base_image_registry=None, cuda_version=None)

Parameter

Nama Deskripsi
execution_script
Diperlukan
str

Jalur ke file Python lokal yang berisi kode yang akan dijalankan untuk gambar. Harus menyertakan fungsi init() dan run(input_data) yang menentukan langkah eksekusi model untuk Layanan web.
runtime
Diperlukan
str

Runtime yang akan digunakan untuk gambar. Runtime bahasa umum yang didukung saat ini adalah 'spark-py' dan 'python'.
conda_file
str

Jalur ke file .yml lokal yang berisi definisi lingkungan Conda untuk digunakan gambar.

Nilai default: None
docker_file
str

Jalur ke file lokal yang berisi langkah-langkah Docker tambahan untuk dijalankan saat menyiapkan gambar.

Nilai default: None
schema_file
str

Jalur ke file lokal yang berisi skema layanan web untuk digunakan saat gambar disebarkan. Digunakan untuk menghasilkan spesifikasi Swagger untuk penyebaran model.

Nilai default: None
dependencies
list[str]

Daftar jalur ke file/folder tambahan yang perlu dijalankan gambar.

Nilai default: None
enable_gpu
bool

Apakah akan mengaktifkan dukungan GPU dalam gambar atau tidak. Gambar GPU harus digunakan pada Layanan Microsoft Azure seperti Azure Container Instances, Komputasi Azure Machine Learning, Microsoft Azure Virtual Machines, dan Azure Kubernetes Service. Default ke False

Nilai default: None
tags
dict[str, str]

Kamus tag nilai kunci untuk memberikan gambar ini.

Nilai default: None
properties
dict[str, str]

Kamus properti nilai kunci untuk memberikan gambar ini. Properti ini tidak dapat diubah setelah penyebaran, tetapi pasangan kunci-nilai baru dapat ditambahkan.

Nilai default: None
description
str

Deskripsi teks untuk memberikan gambar ini.

Nilai default: None
base_image
str

Gambar kustom yang akan digunakan sebagai gambar dasar. Jika tidak ada gambar dasar yang diberikan maka gambar dasar akan digunakan berdasarkan parameter runtime yang diberikan.

Nilai default: None
base_image_registry
ContainerRegistry

Registri gambar yang berisi gambar dasar.

Nilai default: None
cuda_version
str

Versi CUDA dipasang untuk gambar yang membutuhkan dukungan GPU. Gambar GPU harus digunakan pada Layanan Microsoft Azure seperti Azure Container Instances, Komputasi Azure Machine Learning, Microsoft Azure Virtual Machines, dan Azure Kubernetes Service. Versi yang didukung adalah 9.0, 9.1, dan 10.0. Jika 'enable_gpu' diatur, defaultnya adalah '9.1'.

Nilai default: None

Mengembalikan

Jenis Deskripsi
ContainerImageConfig

Objek konfigurasi yang akan digunakan saat membuat gambar.

Pengecualian

Jenis Deskripsi
WebserviceException

run

Jalankan gambar secara lokal dengan data input yang diberikan.

Docker harus terpasang dan menjalankan docker untuk bekerja. Metode ini hanya akan bekerja pada CPU, karena gambar yang mendukung GPU hanya dapat berjalan di Microsoft Azure Services.

run(input_data)

Parameter

Nama Deskripsi
input_data
Diperlukan
<xref:varies>

Data input untuk diteruskan ke gambar saat dijalankan

Mengembalikan

Jenis Deskripsi
<xref:varies>

Hasil menjalankan gambar.

Pengecualian

Jenis Deskripsi
WebserviceException

serialize

Ubah objek ContainerImage ini menjadi kamus serial JSON.

serialize()

Mengembalikan

Jenis Deskripsi
dict

Representasi JSON dari ContainerImage ini.

Pengecualian

Jenis Deskripsi
WebserviceException