다음을 통해 공유

ContainerImage 클래스

  • 참조

컨테이너 이미지를 나타냅니다. 현재는 Docker 이미지에만 적용됩니다.

이 클래스는 사용되지 않습니다. 대신 Environment 클래스를 사용합니다.

이미지에는 다음을 포함하여 모델을 실행하는 데 필요한 종속성이 포함됩니다.

  • 런타임

  • Conda 파일에 지정된 Python 환경 정의

  • GPU 지원을 사용하도록 설정하는 기능

  • 특정 실행 명령에 대한 사용자 지정 Docker 파일

이미지 생성자입니다.

이 클래스는 사용되지 않습니다. 대신 Environment 클래스를 사용합니다.

이미지 생성자는 제공된 작업 영역과 연결된 Image 개체의 클라우드 표현을 검색하는 데 사용됩니다. 검색된 Image 개체의 특정 형식에 해당하는 자식 클래스의 인스턴스를 반환합니다.

상속
Image
ContainerImage

생성자

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

매개 변수

Name Description
workspace
필수
Workspace

검색할 이미지를 포함하는 작업 영역 개체입니다.
name
str

검색할 이미지의 이름입니다. 최신 버전이 있는 경우 반환됩니다.

Default value: None
id
str

검색할 이미지의 특정 ID입니다. (ID는 ":")

Default value: None
tags
list

제공된 목록을 기준으로 ‘key’ 또는 ‘[key, value]’로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']]

Default value: None
properties
list

제공된 목록을 기준으로 ‘key’ 또는 ‘[key, value]’로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']]

Default value: None
version
str

버전과 이름이 모두 지정되면 이미지의 특정 버전을 반환합니다.

Default value: None

설명

이전에 만들어진 ContainerImage의 이름 또는 ID를 전달하여 Image 클래스 생성자를 통해 ContainerImage를 검색합니다. 다음 코드 예제는 이름과 ID로 작업 영역에서 이미지를 검색하는 방법을 보여 줍니다.


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

배포에 사용할 새 이미지 구성을 만들려면 다음 코드 예제와 같이 ContainerImageConfig 개체를 빌드합니다.


   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"
                                                    )

메서드

image_configuration

ContainerImageConfig 개체를 만들고 반환합니다.

이 함수는 모델이 Webservice 내에서 실행되어야 하는 방법과 특정 환경 및 실행 가능해야 하는 종속성을 정의하는 매개 변수를 허용합니다.
run

지정된 입력 데이터로 이미지를 로컬로 실행합니다.

작동하려면 Docker가 설치되어 있고 실행 중이어야 합니다. GPU 지원 이미지는 Microsoft Azure 서비스에서만 실행할 수 있으므로 이 메서드는 CPU에서만 작동합니다.
serialize

이 ContainerImage 개체를 JSON 직렬화된 사전으로 변환합니다.

image_configuration

ContainerImageConfig 개체를 만들고 반환합니다.

이 함수는 모델이 Webservice 내에서 실행되어야 하는 방법과 특정 환경 및 실행 가능해야 하는 종속성을 정의하는 매개 변수를 허용합니다.

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)

매개 변수

Name Description
execution_script
필수
str

이미지에 대해 실행할 코드가 포함된 로컬 Python 파일의 경로입니다. Webservice에 대한 모델 실행 단계를 정의하는 init() 및 run(input_data) 함수를 모두 포함해야 합니다.
runtime
필수
str

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

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

Default value: None
docker_file
str

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

Default value: None
schema_file
str

이미지가 배포될 때 사용할 Webservice 스키마가 포함된 로컬 파일의 경로입니다. 모델 배포를 위한 Swagger 사양을 생성하는 데 사용됩니다.

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
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

반환

형식 Description
ContainerImageConfig

이미지를 만들 때 사용할 구성 개체입니다.

예외

형식 Description
WebserviceException

run

지정된 입력 데이터로 이미지를 로컬로 실행합니다.

작동하려면 Docker가 설치되어 있고 실행 중이어야 합니다. GPU 지원 이미지는 Microsoft Azure 서비스에서만 실행할 수 있으므로 이 메서드는 CPU에서만 작동합니다.

run(input_data)

매개 변수

Name Description
input_data
필수
<xref:varies>

실행할 때 이미지에 전달할 입력 데이터

반환

형식 Description
<xref:varies>

이미지 실행 결과입니다.

예외

형식 Description
WebserviceException

serialize

이 ContainerImage 개체를 JSON 직렬화된 사전으로 변환합니다.

serialize()

반환

형식 Description
dict

이 ContainerImage의 JSON 표현입니다.

예외

형식 Description
WebserviceException