Azure Container Instances에 Anomaly Detector 단변량 컨테이너 배포

아티클
09/04/2024

Important

2023년 9월 20일부터 새로운 Anomaly Detector 리소스를 만들 수 없습니다. Anomaly Detector 서비스는 2026년 10월 1일에 사용 중지됩니다.

Azure AI 서비스 Anomaly Detector 컨테이너를 Azure Container Instances에 배포하는 방법을 알아봅니다. 이 절차에서는 Anomaly Detector 리소스를 만드는 방법을 보여 줍니다. 그런 다음 연결된 컨테이너 이미지를 풀하는 방법을 설명합니다. 마지막으로 브라우저에서 이 둘의 오케스트레이션을 실행하는 기능을 강조합니다. 컨테이너를 사용하면 개발자가 인프라 관리보다 애플리케이션 개발에 집중할 수 있습니다.

필수 조건

Azure 구독을 사용합니다. Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
Azure CLI(az)를 설치합니다.
Docker 엔진. 콘솔 창에서 Docker CLI를 가 작동하는지 확인합니다.

Anomaly Detector 리소스 만들기

Azure Portal에 로그인합니다.
Anomaly Detector 만들기 리소스를 선택합니다.

필수 설정 모두 입력:

설정	값
속성	원하는 이름(2-64자)
구독	적합한 구독 선택
위치	주변 및 사용 가능한 위치 선택
가격 책정 계층	`F0` - 초당 호출 10회, 월별 20K 트랜잭션. 또는 `S0` - 초당 80회 호출
리소스 그룹	사용 가능한 리소스 그룹 선택

만들기를 선택하고, 리소스가 만들어질 때까지 기다립니다. 생성된 후 리소스 페이지로 이동합니다.

구성된 endpoint 및 API 키를 수집합니다.

포털의 키 및 엔드포인트 탭	설정	값
개요	엔드포인트	엔드포인트를 복사합니다. `https://<your-resource-name>.cognitiveservices.azure.com/`과 비슷합니다.
Keys	API 키	두 키 중 하나를 복사합니다. 공백 또는 대시가 없는 32자 영숫자 문자열인 `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`입니다.

Azure CLI에서 Azure Container Instance 리소스 만들기

아래 YAML은 Azure Container Instance 리소스를 정의합니다. 콘텐츠를 복사하여 my-aci.yaml이라는 새 파일에 붙여넣고 주석 처리된 값을 사용자 고유의 값으로 바꿉니다. 유효한 YAML은 템플릿 형식을 참조하세요. 사용 가능한 이미지 이름 및 해당 리포지토리는 컨테이너 리포지토리 및 이미지를 참조하세요. 컨테이너 인스턴스의 YAML 참조에 대한 자세한 내용은 Yaml 참조: Azure Container Instances를 참조하세요.

apiVersion: 2018-10-01
location: # < Valid location >
name: # < Container Group name >
properties:
  imageRegistryCredentials: # This is only required if you are pulling a non-public image that requires authentication to access. For example Text Analytics for health.
  - server: containerpreview.azurecr.io
    username: # < The username for the preview container registry >
    password: # < The password for the preview container registry >
  containers:
  - name: # < Container name >
    properties:
      image: # < Repository/Image name >
      environmentVariables: # These env vars are required
        - name: eula
          value: accept
        - name: billing
          value: # < Service specific Endpoint URL >
        - name: apikey
          value: # < Service specific API key >
      resources:
        requests:
          cpu: 4 # Always refer to recommended minimal resources
          memoryInGb: 8 # Always refer to recommended minimal resources
      ports:
        - port: 5000
  osType: Linux
  volumes: # This node, is only required for container instances that pull their model in at runtime, such as LUIS.
  - name: aci-file-share
    azureFile:
      shareName: # < File share name >
      storageAccountName: # < Storage account name>
      storageAccountKey: # < Storage account key >
  restartPolicy: OnFailure
  ipAddress:
    type: Public
    ports:
    - protocol: tcp
      port: 5000
tags: null
type: Microsoft.ContainerInstance/containerGroups

참고 항목

모든 위치에서 CPU 및 메모리 가용성이 동일하지는 않습니다. 위치 및 OS별 컨테이너에 사용 가능한 리소스 목록은 위치 및 리소스 표를 참조하세요.

az container create 명령에 대해 만든 YAML 파일을 사용합니다. Azure CLI에서 <resource-group>을 사용자 고유의 것으로 바꾸는 az container create 명령을 실행합니다. 또한 YAML 배포 내에서 값을 보호하려면 보안 값을 참조합니다.

az container create -g <resource-group> -f my-aci.yaml

명령의 출력이 유효한 경우 Running...이며 나중에 출력을 새로 만든 ACI 리소스를 나타내는 JSON 문자열로 변경합니다. 컨테이너 이미지는 잠시 동안 사용하지 못할 수도 있지만 지금 리소스가 배포됩니다.

팁

해당 위치와 일치하도록 YAML을 적절하게 조정해야 하므로 공개 미리 보기에서 Azure AI 서비스의 위치에 세심한 주의를 기울여야 합니다.

컨테이너가 실행 중인지 확인

컨테이너가 실행되고 있는지 확인하는 방법은 여러 가지가 있습니다. 확인 대상인 컨테이너의 외부 IP 주소 및 노출된 포트를 찾고 즐겨 찾는 웹 브라우저를 엽니다. 아래의 다양한 요청 URL을 사용하여 컨테이너가 실행되는지 확인합니다. 여기에 나열된 예제 요청 URL은 http://localhost:5000이지만, 특정 컨테이너는 다를 수 있습니다. 컨테이너의 외부 IP 주소 및 공개된 포트를 사용해야 합니다.

요청 URL	용도
`http://localhost:5000/`	컨테이너는 홈페이지를 제공합니다.
`http://localhost:5000/ready`	GET을 사용하여 요청된 이 URL에서 컨테이너가 모델에 대한 쿼리를 수락할 준비가 되었음을 확인합니다. 이 요청은 Kubernetes 활동성 및 준비 상태 프로브에 사용될 수 있습니다.
`http://localhost:5000/status`	또한 GET을 사용하여 요청된 이 URL은 컨테이너를 시작하는 데 사용된 API 키가 엔드포인트 쿼리를 수행하지 않고 유효한지 확인합니다. 이 요청은 Kubernetes 활동성 및 준비 상태 프로브에 사용될 수 있습니다.
`http://localhost:5000/swagger`	컨테이너는 엔드포인트에 대한 전체 설명서 세트와 사용해 보기 기능을 제공합니다. 이 기능을 사용하면 웹 기반 HTML 양식으로 설정을 입력할 수 있고 코드 작성 없이 쿼리를 만들 수 있습니다. 쿼리가 반환되면 필요한 HTTP 헤더 및 본문 형식을 보여주기 위해 예제 CURL 명령이 제공됩니다.

컨테이너의 홈페이지

다음 단계

컨테이너 설치 및 실행을 검토하여 컨테이너 이미지를 풀하고 컨테이너를 실행합니다.
컨테이너 구성에서 구성 설정을 검토합니다.
Anomaly Detector API 서비스에 대해 자세히 알아보기

다음을 통해 공유