다음을 통해 공유

ContainerImageConfig 클래스

  • 참조

컨테이너 배포와 관련된 이미지 구성 설정을 정의합니다. 실행 스크립트 및 런타임이 필요합니다.

일반적인 사용 사례에서는 ContainerImage 클래스의 image_configuration 메서드를 사용하여 ContainerImageConfig 개체를 생성합니다.

구성 개체를 초기화합니다.

상속
ImageConfig
ContainerImageConfig

생성자

ContainerImageConfig(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, allow_absolute_path=False, cuda_version=None)

매개 변수

Name Description
execution_script
필수
str

이미지에 실행할 코드가 포함된 로컬 파일의 경로입니다.
runtime
필수
str

이미지에 사용할 런타임입니다. 현재 지원되는 런타임은 'spark-py' 및 'python'입니다.
conda_file
str

이미지에 사용할 conda 환경 정의가 포함된 로컬 파일의 경로입니다.

Default value: None
docker_file
str

이미지를 설정할 때 실행할 추가 Docker 단계가 포함된 로컬 파일의 경로입니다.

Default value: None
schema_file
str

이미지를 배포할 때 사용할 웹 서비스 스키마가 포함된 로컬 파일의 경로입니다.

Default value: None
dependencies
list[str]

이미지를 실행해야 하는 추가 파일/폴더에 대한 경로 목록입니다.

Default value: None
enable_gpu
bool

이미지에서 GPU 지원을 사용할지 여부입니다. GPU 이미지는 Azure Container Instances, Azure Machine Learning 컴퓨팅, Azure Virtual Machines 및 Azure Kubernetes Service와 같은 Microsoft Azure Services에서 사용해야 합니다. 기본값은 False입니다.

Default value: None
tags
dict[(str, str)]

이 이미지를 제공할 키 값 태그의 사전입니다.

Default value: None
properties
dict[(str, str)]

이 이미지를 제공할 키 값 속성의 사전입니다. 배포 후에는 이러한 속성을 변경할 수 없지만 새 키 값 쌍을 추가할 수 있습니다.

Default value: None
description
str

이 이미지를 제공할 설명입니다.

Default value: None
base_image
str

기본 이미지로 사용할 사용자 지정 이미지입니다. 기본 이미지가 지정되지 않으면 지정된 런타임 매개 변수를 기반으로 기본 이미지가 사용됩니다.

Default value: None
base_image_registry
ContainerRegistry

기본 이미지가 포함된 이미지 레지스트리입니다.

Default value: None
allow_absolute_path
bool

절대 경로를 허용할지 여부를 나타냅니다.

Default value: False
cuda_version
str

GPU 지원이 필요한 이미지에 설치할 CUDA 버전입니다. GPU 이미지는 Azure Container Instances, Azure Machine Learning 컴퓨팅, Azure Virtual Machines 및 Azure Kubernetes Service와 같은 Microsoft Azure Services에서 사용해야 합니다. 지원되는 버전은 9.0, 9.1 및 10.0입니다. 'enable_gpu'가 설정되면 기본값은 '9.1'입니다.

Default value: None
execution_script
필수
str

이미지에 대해 실행할 코드가 포함된 로컬 파일의 경로
runtime
필수
str

이미지에 사용할 런타임입니다. 현재 지원되는 런타임은 'spark-py' 및 'python'입니다.
conda_file
필수
str

이미지에 사용할 conda 환경 정의가 포함된 로컬 파일의 경로
docker_file
필수
str

이미지를 설정할 때 실행할 추가 Docker 단계가 포함된 로컬 파일의 경로
schema_file
필수
str

이미지를 배포할 때 사용할 웹 서비스 스키마가 포함된 로컬 파일의 경로
dependencies
필수
list[str]

이미지를 실행해야 하는 추가 파일/폴더에 대한 경로 목록
enable_gpu
필수
bool

이미지에서 GPU 지원을 사용하도록 설정할지 여부를 나타냅니다. GPU 이미지는 Azure Container Instances, Azure Machine Learning 컴퓨팅, Azure Virtual Machines 및 Azure Kubernetes Service와 같은 Microsoft Azure Services에서 사용해야 합니다. 기본값은 false입니다.
tags
필수
dict[str, str]

이 이미지를 제공하기 위한 키 값 태그 사전
properties
필수
dict[str, str]

이 이미지를 제공하는 키 값 속성의 사전입니다. 배포 후에는 이러한 속성을 변경할 수 없지만 새 키 값 쌍을 추가할 수 있습니다.
description
필수
str

이 이미지를 제공하는 설명
base_image
필수
str

기본 이미지로 사용할 사용자 지정 이미지입니다. 기본 이미지가 제공되지 않으면 지정된 런타임 매개 변수를 기반으로 기본 이미지가 사용됩니다.
base_image_registry
필수
ContainerRegistry

기본 이미지가 포함된 이미지 레지스트리입니다.
allow_absolute_path
필수
bool

절대 경로를 허용하는 플래그
cuda_version
필수
str

GPU 지원이 필요한 이미지에 설치할 CUDA 버전입니다. GPU 이미지는 Azure Container Instances, Azure Machine Learning 컴퓨팅, Azure Virtual Machines 및 Azure Kubernetes Service와 같은 Microsoft Azure Services에서 사용해야 합니다. 지원되는 버전은 9.0, 9.1 및 10.0입니다. 'enable_gpu'가 설정되면 기본값은 '9.1'입니다.

메서드

build_create_payload

컨테이너 이미지에 대한 생성 페이로드를 빌드합니다.
create_local_debug_payload

컨테이너 이미지에 대한 생성 페이로드를 빌드합니다.
validate_configuration

지정된 구성 값이 유효한지 확인합니다.

유효성 검사에 실패하면 :class:azureml.exceptions.WebserviceException`을 발생시킵니다.

build_create_payload

컨테이너 이미지에 대한 생성 페이로드를 빌드합니다.

build_create_payload(workspace, name, model_ids)

매개 변수

Name Description
workspace
필수
Workspace

이미지를 생성할 작업 영역 개체입니다.
name
필수
str

이미지의 이름입니다.
model_ids
필수
list[str]

이미지에 패키징할 모델 ID 목록입니다.

반환

형식 Description
dict

컨테이너 이미지 생성 페이로드입니다.

예외

형식 Description
WebserviceException

create_local_debug_payload

컨테이너 이미지에 대한 생성 페이로드를 빌드합니다.

create_local_debug_payload(workspace, model_ids)

매개 변수

Name Description
workspace
필수
Workspace

이미지를 생성할 작업 영역 개체입니다.
model_ids
필수
list[str]

이미지에 패키징할 모델 ID 목록입니다.

반환

형식 Description
dict

컨테이너 이미지 생성 페이로드입니다.

예외

형식 Description
WebserviceException

validate_configuration

지정된 구성 값이 유효한지 확인합니다.

유효성 검사에 실패하면 :class:azureml.exceptions.WebserviceException`을 발생시킵니다.

validate_configuration()

예외

형식 Description
WebserviceException