자습서: YAML 파일을 사용하여 다중 컨테이너 그룹 배포

아티클
10/15/2024

Azure Container Instances에서는 컨테이너 그룹을 사용하여 여러 컨테이너를 단일 호스트에 배포하도록 지원합니다. 로깅, 모니터링 또는 서비스에 두 번째 연결된 프로세스가 필요한 기타 구성용으로 애플리케이션 사이드카를 빌드할 때 컨테이너 그룹을 사용하면 유용합니다.

이 자습서에서는 Azure CLI를 사용하여 YAML 파일을 배포하여 두 컨테이너 사이드카 구성을 실행하는 단계를 따릅니다. YAML 파일은 인스턴스 설정을 지정하기 위한 간결한 형식을 제공합니다. 다음 방법에 대해 설명합니다.

YAML 파일 구성
컨테이너 그룹 배포
컨테이너 로그 보기

참고 항목

현재 다중 컨테이너 그룹은 Linux 컨테이너에 제한됩니다.

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

필수 조건

Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell의 Bash에 대한 빠른 시작을 참조하세요.
CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.
- 로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 로그인을 참조하세요.
- 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI에서 확장 사용을 참조하세요.
- az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.

YAML 파일 구성

Azure CLI에서 az container create 명령을 사용하여 다중 컨테이너 그룹을 배포하려면 YAML 파일에서 컨테이너 그룹 구성을 지정해야 합니다. 그런 후 YAML 파일을 매개 변수로 명령에 전달합니다.

먼저 다음 YAML을 deploy-aci.yaml이라는 새 파일에 복사합니다. Azure Cloud Shell에서 Visual Studio Code를 사용하여 작업 디렉터리에 파일을 만들 수 있습니다.

code deploy-aci.yaml

이 YAML 파일은 두 개의 컨테이너, 하나의 공용 IP 주소, 두 개의 노출된 포트가 있는 “myContainerGroup”이라는 컨테이너 그룹을 정의합니다. 컨테이너는 퍼블릭 Microsoft 이미지에서 배포됩니다. 그룹의 첫 번째 컨테이너는 인터넷 연결 웹 애플리케이션을 실행합니다. 두 번째 컨테이너인 사이드카는 컨테이너 그룹의 로컬 네트워크를 통해 첫 번째 컨테이너에서 실행되는 웹 애플리케이션에 주기적으로 HTTP 요청을 보냅니다.

apiVersion: 2019-12-01
location: eastus
name: myContainerGroup
properties:
  containers:
  - name: aci-tutorial-app
    properties:
      image: mcr.microsoft.com/azuredocs/aci-helloworld:latest
      resources:
        requests:
          cpu: 1
          memoryInGb: 1.5
      ports:
      - port: 80
      - port: 8080
  - name: aci-tutorial-sidecar
    properties:
      image: mcr.microsoft.com/azuredocs/aci-tutorial-sidecar
      resources:
        requests:
          cpu: 1
          memoryInGb: 1.5
  osType: Linux
  ipAddress:
    type: Public
    ports:
    - protocol: tcp
      port: 80
    - protocol: tcp
      port: 8080
tags: {exampleTag: tutorial}
type: Microsoft.ContainerInstance/containerGroups

프라이빗 컨테이너 이미지 레지스트리를 사용하려면 사용자 환경에 맞게 수정된 값을 사용하여 컨테이너 그룹에 imageRegistryCredentials 속성을 추가합니다.

  imageRegistryCredentials:
  - server: imageRegistryLoginServer
    username: imageRegistryUsername
    password: imageRegistryPassword

컨테이너 그룹 배포

az group create 명령을 사용하여 리소스 그룹을 만듭니다.

az group create --name myResourceGroup --location eastus

az container create 명령을 사용하여 컨테이너 그룹을 배포하고, YAML 파일을 인수로 전달합니다.

az container create --resource-group myResourceGroup --file deploy-aci.yaml

몇 초 정도 지나면 Azure에서 초기 응답이 수신됩니다.

배포 상태 확인

배포 상태를 확인하려면 다음 az container show 명령을 사용합니다.

az container show --resource-group myResourceGroup --name myContainerGroup --output table

실행 중인 애플리케이션을 보려면 사용하는 브라우저에서 공용 IP 주소로 이동합니다. 예를 들어 이 예제 출력의 IP는 52.168.26.124입니다.

Name              ResourceGroup    Status    Image                                                                                               IP:ports              Network    CPU/Memory       OsType    Location
----------------  ---------------  --------  --------------------------------------------------------------------------------------------------  --------------------  ---------  ---------------  --------  ----------
myContainerGroup  danlep0318r      Running   mcr.microsoft.com/azuredocs/aci-tutorial-sidecar,mcr.microsoft.com/azuredocs/aci-helloworld:latest  20.42.26.114:80,8080  Public     1.0 core/1.5 gb  Linux     eastus

컨테이너 로그 보기

az container logs 명령을 사용하여 컨테이너의 로그 출력을 확인합니다. --container-name 인수는 로그를 가져올 컨테이너를 지정합니다. 이 예제에서는 aci-tutorial-app 컨테이너를 지정합니다.

az container logs --resource-group myResourceGroup --name myContainerGroup --container-name aci-tutorial-app

출력

listening on port 80
::1 - - [02/Jul/2020:23:17:48 +0000] "HEAD / HTTP/1.1" 200 1663 "-" "curl/7.54.0"
::1 - - [02/Jul/2020:23:17:51 +0000] "HEAD / HTTP/1.1" 200 1663 "-" "curl/7.54.0"
::1 - - [02/Jul/2020:23:17:54 +0000] "HEAD / HTTP/1.1" 200 1663 "-" "curl/7.54.0"

사이드카 컨테이너의 로그를 보려면 aci-tutorial-sidecar 컨테이너를 지정하여 비슷한 명령을 실행합니다.

az container logs --resource-group myResourceGroup --name myContainerGroup --container-name aci-tutorial-sidecar

출력

Every 3s: curl -I http://localhost                          2020-07-02 20:36:41

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0  1663    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
HTTP/1.1 200 OK
X-Powered-By: Express
Accept-Ranges: bytes
Cache-Control: public, max-age=0
Last-Modified: Wed, 29 Nov 2017 06:40:40 GMT
ETag: W/"67f-16006818640"
Content-Type: text/html; charset=UTF-8
Content-Length: 1663
Date: Thu, 02 Jul 2020 20:36:41 GMT
Connection: keep-alive

보시다시피 사이드카는 그룹의 로컬 네트워크를 통해 메인 웹 애플리케이션에 주기적으로 HTTP 요청을 보내서 애플리케이션이 실행되는지 확인합니다. 200 OK 이외의 HTTP 응답 코드가 수신된 경우에는 이 사이드카 예제를 확장하여 경고를 트리거할 수 있습니다.

다음 단계

이 자습서에서는 YAML 파일을 사용하여 Azure Container Instances에서 다중 컨테이너 그룹을 배포했습니다. 다음 방법에 대해 알아보았습니다.

다중 컨테이너 그룹에 대한 YAML 파일 구성
컨테이너 그룹 배포
컨테이너 로그 보기

Resource Manager 템플릿을 사용하여 다중 컨테이너 그룹을 지정할 수도 있습니다. 컨테이너 그룹을 사용하여 추가 Azure 서비스 리소스를 배포해야 하는 경우 시나리오에 맞게 Resource Manager 템플릿을 쉽게 조정할 수 있습니다.

다음을 통해 공유