다음을 통해 공유

ContainerImage 클래스

컨테이너 이미지를 나타내며 현재 Docker 이미지에만 해당합니다.

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

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

  • 런타임

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

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

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

이미지 생성자입니다.

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

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

생성자

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

버전과 이름을 모두 지정하면 특정 버전의 Image가 반환됩니다.

Default value: None

설명

ContainerImage는 이전에 만든 ContainerImage의 Image 이름 또는 ID를 전달하여 클래스 생성자를 사용하여 검색됩니다. 다음 코드 예제에서는 이름과 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 .

이 함수는 웹 서비스 내에서 모델을 실행하는 방법과 실행할 수 있어야 하는 특정 환경 및 종속성을 정의하는 매개 변수를 허용합니다.
run

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

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

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

image_configuration

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

이 함수는 웹 서비스 내에서 모델을 실행하는 방법과 실행할 수 있어야 하는 특정 환경 및 종속성을 정의하는 매개 변수를 허용합니다.

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

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

Default value: None
dependencies
list[str]

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

Default value: None
enable_gpu
bool

이미지에서 GPU 지원을 사용하도록 설정할지 여부입니다. GPU 이미지는 Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines 및 Azure Kubernetes Service와 같은 Microsoft Azure 서비스에서 사용해야 합니다. 기본값은 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 Compute, Azure Virtual Machines 및 Azure Kubernetes Service와 같은 Microsoft Azure 서비스에서 사용해야 합니다. 지원되는 버전은 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 표현입니다.