Environment Kelas

Mengonfigurasi lingkungan Python yang dapat direproduksi untuk eksperimen pembelajaran mesin.

Lingkungan mendefinisikan paket Python, variabel lingkungan, dan pengaturan Docker yang digunakan dalam eksperimen pembelajaran mesin, termasuk dalam persiapan data, pelatihan, dan penyebaran ke layanan web. Lingkungan dikelola dan di-versi dalam Azure Machine Learning Workspace. Anda dapat memperbarui lingkungan yang ada dan mengambil versi untuk digunakan kembali. Lingkungan eksklusif untuk ruang kerja tempat mereka dibuat dan tidak dapat digunakan di berbagai ruang kerja.

Untuk informasi selengkapnya tentang lingkungan, lihat Membuat dan mengelola lingkungan yang dapat digunakan kembali.

Konstruktor Lingkungan Kelas.

Konstruktor

Environment(name, **kwargs)

Parameter

Nama	Deskripsi
name Diperlukan	string Nama lingkungan. Nota Jangan mulai nama lingkungan Anda dengan "Microsoft" atau "AzureML". Awalan "Microsoft" dan "AzureML" dicadangkan untuk lingkungan yang dikumpulkan. Untuk informasi selengkapnya tentang lingkungan yang dikumpulkan, lihat Membuat dan mengelola lingkungan yang dapat digunakan kembali.

Keterangan

Azure Machine Learning menyediakan lingkungan yang dikumpulkan, yang merupakan lingkungan yang telah ditentukan sebelumnya yang menawarkan titik awal yang baik untuk membangun lingkungan Anda sendiri. Lingkungan yang dikumpulkan didukung oleh gambar Docker yang di-cache, memberikan pengurangan biaya persiapan eksekusi. Untuk informasi selengkapnya tentang lingkungan yang dikumpulkan, lihat Membuat dan mengelola lingkungan yang dapat digunakan kembali.

Ada sejumlah cara lingkungan dibuat di Azure Machine Learning, termasuk saat Anda:

Menginisialisasi objek Lingkungan baru.
Gunakan salah satu metode kelas Lingkungan: from_conda_specification, , from_pip_requirementsatau from_existing_conda_environment.
submit Gunakan metode kelas Eksperimen untuk mengirimkan eksekusi eksperimen tanpa menentukan lingkungan, termasuk dengan Estimator objek.

Contoh berikut menunjukkan cara membuat instans lingkungan baru.


   from azureml.core import Environment
   myenv = Environment(name="myenv")

Anda dapat mengelola lingkungan dengan mendaftarkannya. Melakukannya memungkinkan Anda melacak versi lingkungan, dan menggunakannya kembali dalam eksekusi mendatang.


   myenv.register(workspace=ws)

Untuk sampel selengkapnya tentang bekerja dengan lingkungan, lihat lingkungan Jupyter Notebook Using.

Variabel

Nama	Deskripsi
Environment.databricks	Bagian ini mengonfigurasi dependensi pustaka azureml.core.databricks.DatabricksSection.
docker	DockerSection Bagian ini mengonfigurasi pengaturan yang terkait dengan gambar Docker akhir yang dibangun berdasarkan spesifikasi lingkungan dan apakah akan menggunakan kontainer Docker untuk membangun lingkungan.
inferencing_stack_version	string Bagian ini menentukan versi tumpukan inferensi yang ditambahkan ke gambar. Untuk menghindari penambahan tumpukan inferensi, jangan atur nilai ini. Nilai valid: "terbaru".
python	PythonSection Bagian ini menentukan lingkungan dan interpreter Python mana yang akan digunakan pada komputasi target.
spark	SparkSection Bagian ini mengonfigurasi pengaturan Spark. Ini hanya digunakan ketika kerangka kerja diatur ke PySpark.
r	RSection Bagian ini menentukan lingkungan R mana yang akan digunakan pada komputasi target.
version	string Versi lingkungan.
asset_id	string ID Aset. Mengisi saat lingkungan terdaftar.

Metode

add_private_pip_wheel	Unggah file roda pip privat pada disk ke blob penyimpanan Azure yang dilampirkan ke ruang kerja. Memberikan pengecualian jika roda pip privat dengan nama yang sama sudah ada di blob penyimpanan ruang kerja.
build	Buat gambar Docker untuk lingkungan ini di cloud.
build_local	Bangun lingkungan Docker atau conda lokal.
clone	Kloning objek lingkungan. Mengembalikan instans baru objek lingkungan dengan nama baru.
from_conda_specification	Buat objek lingkungan dari file YAML spesifikasi lingkungan. Untuk mendapatkan file YAML spesifikasi lingkungan, lihat Mengelola lingkungan di panduan pengguna conda.
from_docker_build_context	Buat objek lingkungan dari konteks build Docker.
from_docker_image	Buat objek lingkungan dari gambar docker dasar dengan dependensi python opsional. Lapisan Python akan ditambahkan ke lingkungan jika conda_specification atau pip_requirements ditentukan. conda_specification dan pip_requirements saling eksklusif.
from_dockerfile	Buat objek lingkungan dari Dockerfile dengan dependensi python opsional. Lapisan Python akan ditambahkan ke lingkungan jika conda_specification atau pip_requirements ditentukan. conda_specification dan pip_requirements saling eksklusif.
from_existing_conda_environment	Buat objek lingkungan yang dibuat dari lingkungan conda yang ada secara lokal. Untuk mendapatkan daftar lingkungan conda yang ada, jalankan `conda env list`. Untuk informasi selengkapnya, lihat Mengelola lingkungan di panduan pengguna conda.
from_pip_requirements	Buat objek lingkungan yang dibuat dari file persyaratan pip. Dependensi pip yang tidak disematkan akan ditambahkan jika pip_version tidak ditentukan.
get	Mengembalikan objek lingkungan. Jika label ditentukan, objek yang sebelumnya diberi label dengan nilai akan dikembalikan. Hanya salah satu parameter versi atau label yang dapat ditentukan. Jika keduanya terlewatkan, versi terbaru objek Lingkungan akan dikembalikan.
get_image_details	Mengembalikan detail Gambar.
label	Beri label objek lingkungan di ruang kerja Anda dengan nilai yang ditentukan.
list	Mengembalikan kamus yang berisi lingkungan di ruang kerja.
load_from_directory	Muat definisi lingkungan dari file dalam direktori.
register	Daftarkan objek lingkungan di ruang kerja Anda.
save_to_directory	Simpan definisi lingkungan ke direktori dalam format yang mudah diedit.

add_private_pip_wheel

Unggah file roda pip privat pada disk ke blob penyimpanan Azure yang dilampirkan ke ruang kerja.

Memberikan pengecualian jika roda pip privat dengan nama yang sama sudah ada di blob penyimpanan ruang kerja.

static add_private_pip_wheel(workspace, file_path, exist_ok=False)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Objek ruang kerja yang digunakan untuk mendaftarkan roda pip privat.
file_path Diperlukan	str Jalur ke roda pip lokal pada disk, termasuk ekstensi file.
exist_ok	bool Menunjukkan apakah akan melemparkan pengecualian jika roda sudah ada. Nilai default: False

Mengembalikan

Jenis	Deskripsi
str	Mengembalikan URI penuh ke roda pip yang diunggah pada penyimpanan blob Azure untuk digunakan dalam dependensi conda.

build

Buat gambar Docker untuk lingkungan ini di cloud.

build(workspace, image_build_compute=None)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Ruang kerja dan Azure Container Registry terkait tempat gambar disimpan.
image_build_compute	str Nama komputasi tempat build gambar akan berlangsung Nilai default: None

Mengembalikan

Jenis	Deskripsi
ImageBuildDetails	Mengembalikan objek detail build gambar.

build_local

Bangun lingkungan Docker atau conda lokal.

build_local(workspace, platform=None, **kwargs)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Ruang kerja.
platform	str Balei-balei. Salah satu Linux, Windows , atau OSX. Platform saat ini akan digunakan secara default. Nilai default: None
kwargs Diperlukan	dict Argumen kata kunci tingkat lanjut

Mengembalikan

Jenis	Deskripsi
str	Mengalirkan docker yang sedang berlangsung atau output bawaan conda ke konsol.

Keterangan

Contoh berikut menunjukkan cara membangun lingkungan lokal. Pastikan ruang kerja dibuat sebagai objek azureml.core.workspace.Workspace yang valid

Membangun lingkungan conda lokal


   from azureml.core import Environment
   myenv = Environment(name="myenv")
   registered_env = myenv.register(workspace)
   registered_env.build_local(workspace)

Membangun lingkungan docker lokal


   from azureml.core import Environment
   myenv = Environment(name="myenv")
   registered_env = myenv.register(workspace)
   registered_env.build_local(workspace, useDocker=True)

Buat gambar docker secara lokal dan opsional dorong ke registri kontainer yang terkait dengan ruang kerja


   from azureml.core import Environment
   myenv = Environment(name="myenv")
   registered_env = myenv.register(workspace)
   registered_env.build_local(workspace, useDocker=True, pushImageToWorkspaceAcr=True)

clone

Kloning objek lingkungan.

Mengembalikan instans baru objek lingkungan dengan nama baru.

clone(new_name)

Parameter

Nama	Deskripsi
new_name Diperlukan	str Nama lingkungan baru

Mengembalikan

Jenis	Deskripsi
Environment	Objek lingkungan baru

from_conda_specification

Buat objek lingkungan dari file YAML spesifikasi lingkungan.

Untuk mendapatkan file YAML spesifikasi lingkungan, lihat Mengelola lingkungan di panduan pengguna conda.

static from_conda_specification(name, file_path)

Parameter

Nama	Deskripsi
name Diperlukan	str Nama lingkungan.
file_path Diperlukan	str Jalur file YAML spesifikasi lingkungan conda.

Mengembalikan

Jenis	Deskripsi
Environment	Objek lingkungan.

from_docker_build_context

Buat objek lingkungan dari konteks build Docker.

static from_docker_build_context(name, docker_build_context)

Parameter

Nama	Deskripsi
name Diperlukan	str Nama lingkungan.
docker_build_context Diperlukan	DockerBuildContext Objek DockerBuildContext.

Mengembalikan

Jenis	Deskripsi
Environment	Objek lingkungan.

from_docker_image

Buat objek lingkungan dari gambar docker dasar dengan dependensi python opsional.

Lapisan Python akan ditambahkan ke lingkungan jika conda_specification atau pip_requirements ditentukan. conda_specification dan pip_requirements saling eksklusif.

static from_docker_image(name, image, container_registry=None, conda_specification=None, pip_requirements=None)

Parameter

Nama	Deskripsi
name Diperlukan	str Nama lingkungan.
image Diperlukan	str nama gambar yang sepenuhnya memenuhi syarat.
conda_specification	str file spesifikasi conda. Nilai default: None
container_registry	ContainerRegistry detail repositori kontainer privat. Nilai default: None
pip_requirements	str file persyaratan pip. Nilai default: None

Mengembalikan

Jenis	Deskripsi
Environment	Objek lingkungan.

Keterangan

Jika gambar dasar berasal dari repositori privat yang memerlukan otorisasi, dan otorisasi tidak diatur pada tingkat ruang kerja AzureML, container_registry diperlukan

from_dockerfile

Buat objek lingkungan dari Dockerfile dengan dependensi python opsional.

Lapisan Python akan ditambahkan ke lingkungan jika conda_specification atau pip_requirements ditentukan. conda_specification dan pip_requirements saling eksklusif.

static from_dockerfile(name, dockerfile, conda_specification=None, pip_requirements=None)

Parameter

Nama	Deskripsi
name Diperlukan	str Nama lingkungan.
dockerfile Diperlukan	str Konten atau jalur Dockerfile ke file.
conda_specification	str file spesifikasi conda. Nilai default: None
pip_requirements	str file persyaratan pip. Nilai default: None

Mengembalikan

Jenis	Deskripsi
Environment	Objek lingkungan.

from_existing_conda_environment

Buat objek lingkungan yang dibuat dari lingkungan conda yang ada secara lokal.

Untuk mendapatkan daftar lingkungan conda yang ada, jalankan conda env list. Untuk informasi selengkapnya, lihat Mengelola lingkungan di panduan pengguna conda.

static from_existing_conda_environment(name, conda_environment_name)

Parameter

Nama	Deskripsi
name Diperlukan	str Nama lingkungan.
conda_environment_name Diperlukan	str Nama lingkungan conda yang ada secara lokal.

Mengembalikan

Jenis	Deskripsi
Environment	Objek lingkungan atau Tidak Ada jika mengekspor file spesifikasi conda gagal.

from_pip_requirements

Buat objek lingkungan yang dibuat dari file persyaratan pip.

Dependensi pip yang tidak disematkan akan ditambahkan jika pip_version tidak ditentukan.

static from_pip_requirements(name, file_path, pip_version=None)

Parameter

Nama	Deskripsi
name Diperlukan	str Nama lingkungan.
file_path Diperlukan	str Jalur file persyaratan pip.
pip_version	str Versi pip untuk lingkungan conda. Nilai default: None

Mengembalikan

Jenis	Deskripsi
Environment	Objek lingkungan.

get

Mengembalikan objek lingkungan.

Jika label ditentukan, objek yang sebelumnya diberi label dengan nilai akan dikembalikan. Hanya salah satu parameter versi atau label yang dapat ditentukan. Jika keduanya terlewatkan, versi terbaru objek Lingkungan akan dikembalikan.

static get(workspace, name, version=None, label=None)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Ruang kerja yang berisi lingkungan.
name Diperlukan	str Nama lingkungan yang akan dikembalikan.
version	str Versi lingkungan yang akan dikembalikan. Nilai default: None
label	str Nilai label lingkungan. Nilai default: None

Mengembalikan

Jenis	Deskripsi
Environment	Objek lingkungan.

get_image_details

Mengembalikan detail Gambar.

get_image_details(workspace)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Ruang kerja.

Mengembalikan

Jenis	Deskripsi
DockerImageDetails	Mengembalikan detail gambar sebagai dict

label

Beri label objek lingkungan di ruang kerja Anda dengan nilai yang ditentukan.

static label(workspace, name, version, labels)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Ruang kerja
name Diperlukan	str Nama lingkungan
version Diperlukan	str Versi lingkungan
labels Diperlukan	list[str] Nilai untuk memberi label Lingkungan dengan

list

Mengembalikan kamus yang berisi lingkungan di ruang kerja.

static list(workspace)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Ruang kerja tempat mencantumkan lingkungan.

Mengembalikan

Jenis	Deskripsi
<xref:builtin.dict>[str, Environment]	Kamus objek lingkungan.

load_from_directory

Muat definisi lingkungan dari file dalam direktori.

static load_from_directory(path)

Parameter

Nama	Deskripsi
path Diperlukan	str Jalur ke direktori sumber.

register

Daftarkan objek lingkungan di ruang kerja Anda.

register(workspace)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Ruang kerja
name Diperlukan	str

Mengembalikan

Jenis	Deskripsi
Environment	Mengembalikan objek lingkungan

save_to_directory

Simpan definisi lingkungan ke direktori dalam format yang mudah diedit.

save_to_directory(path, overwrite=False)

Parameter

Nama	Deskripsi
path Diperlukan	str Jalur ke direktori tujuan.
overwrite	bool Jika direktori yang ada harus ditimpa. Default salah. Nilai default: False

Environment Kelas

Konstruktor

Parameter

Keterangan

Variabel

Metode

add_private_pip_wheel

Parameter

Mengembalikan

build

Parameter

Mengembalikan

build_local

Parameter

Mengembalikan

Keterangan

clone

Parameter

Mengembalikan

from_conda_specification

Parameter

Mengembalikan

from_docker_build_context

Parameter

Mengembalikan

from_docker_image

Parameter

Mengembalikan

Keterangan

from_dockerfile

Parameter

Mengembalikan

from_existing_conda_environment

Parameter

Mengembalikan

from_pip_requirements

Parameter

Mengembalikan

get

Parameter

Mengembalikan

get_image_details

Parameter

Mengembalikan

label

Parameter

list

Parameter

Mengembalikan

load_from_directory

Parameter

register

Parameter

Mengembalikan

save_to_directory

Parameter

Atribut

environment_variables

Saran dan Komentar