다음을 통해 공유


Azure의 가상머신에 대한 cloud-init 지원

적용 대상: ✔️ Linux VM ✔️ 유연한 확장 집합

이 문서에서는 Azure에서 프로비전 시간에 VM(가상 머신) 또는 Virtual Machine Scale Sets를 구성하는 cloud-init에 대한 지원을 설명합니다. Azure에서 리소스가 프로비저닝된 후 처음 부팅할 때 이러한 cloud-init 구성이 실행됩니다.

VM 프로비전은 Azure가 호스트 이름, 사용자 이름, 암호와 같은 VM 만들기 매개 변수 값을 전달하고 VM이 부팅될 때 해당 값을 사용할 수 있도록 하는 프로세스입니다. ‘프로비저닝 에이전트’는 이런 값을 사용하고, VM을 구성하며, 완료되면 다시 보고합니다.

Azure는 cloud-initWALA(Azure Linux Agent) 등의 두 프로비저닝 에이전트를 지원합니다.

cloud-init 개요

cloud-init는 처음 부팅 시 Linux VM을 사용자 지정하는 데 널리 사용되는 방법입니다. Cloud-init를 사용하여 패키지를 설치하고 파일을 쓰거나, 사용자 및 보안을 구성할 수 있습니다. 초기 부팅 프로세스 중에 cloud-init가 호출되므로 구성을 적용하기 위한 추가 단계나 필요한 에이전트가 없습니다. #cloud-config 파일 또는 다른 입력의 형식을 올바르게 지정하는 방법에 대한 자세한 내용은 cloud-init 설명서 사이트를 참조하세요. #cloud-config 파일은 base64로 인코딩된 텍스트 파일입니다.

cloud-init는 배포 간에도 작동합니다. 예를 들어, 패키지를 설치하는 데 apt-get install 또는 yum install은 사용하지 않습니다. 대신 설치할 패키지 목록을 정의할 수 있습니다. cloud-init는 선택한 배포판에 대해 기본 패키지 관리 도구를 자동으로 사용합니다.

Azure Marketplace에서 cloud-init 활성화 이미지를 사용할 수 있도록 하기 위해 승인된 Linux 배포판 파트너와 적극적으로 공조하고 있습니다. 이러한 이미지를 사용하면 VM 및 가상 머신 확장 집합에서 cloud-init 배포 및 구성 작업을 원활하게 진행할 수 있습니다. 처음에는 보증된 Linux 배포판 파트너 및 공급업체와의 협력을 통해 cloud-init가 Azure의 해당 OS에서 작동하게 하였고, 이후 패키지를 업데이트하고 배포판 패키지 리포지토리에서 공개 제공했습니다.

Azure에서 지원되는 Linux 배포판에 cloud-init를 사용할 수 있도록 하는 두 단계에는 패키지 지원 및 이미지 지원이 있습니다.

  • ‘Azure에서의 cloud-init 패키지 지원’은 이제 어떤 cloud-init 패키지가 지원되거나 미리 보기 상태인지 설명하므로 이 패키지를 사용자 지정 이미지의 OS에 사용할 수 있습니다.
  • '이미지 cloud-init 준비 여부'는 이미지가 이미 cloud-init를 사용하도록 구성되었는지 설명합니다.

Canonical

게시자/버전 제안 SKU 버전 이미지 cloud-init 준비 여부 Azure에서의 cloud-init 패키지 지원
Canonical 24.04 UbuntuServer 22.04-LTS latest
Canonical 22.04 UbuntuServer 22.04-LTS latest
Canonical 20.04 UbuntuServer 20.04-LTS latest

RHEL

게시자/버전 제안 SKU 버전 이미지 cloud-init 준비 여부 Azure에서의 cloud-init 패키지 지원
RedHat 7 RHEL 7.7, 7.8, 7_9 latest
RedHat 8 RHEL 8.1, 8.2, 8_3, 8_4 latest
RedHat 9 RHEL 9_0, 9_1 latest
  • Gen1 및 Gen2 이미지를 포함하여 RHEL 7(버전 7.7) 및 RHEL 8(버전 8.1)에서 시작하는 다른 모든 RedHat SKU는 cloud-init를 사용하여 프로비전됩니다. RHEL 6에서는 Cloud-init이 지원되지 않습니다.

Oracle

게시자/버전 제안 SKU 버전 이미지 cloud-init 준비 여부 Azure에서의 cloud-init 패키지 지원
Oracle 7 Oracle Linux 77, 78, ol79 latest
Oracle 8 Oracle Linux 81, ol82, ol83-lvm, ol84-lvm latest
  • Gen1 및 Gen2 이미지를 포함하여 Oracle 7(버전 7.7) 및 Oracle 8(버전 8.1)에서 시작하는 다른 모든 Oracle SKU는 cloud-init를 사용하여 프로비전됩니다.

SUSE SLES

게시자/버전 제안 SKU 버전 이미지 cloud-init 준비 여부 Azure에서의 cloud-init 패키지 지원
SUSE 15 SLES(SUSE Linux Enterprise Server) sp1, sp2, sp3 latest
SUSE 12 SLES(SUSE Linux Enterprise Server) sp5 latest

Debian

게시자/버전 제안 SKU 버전 이미지 cloud-init 준비 여부 Azure에서의 cloud-init 패키지 지원
debian-10 Debian 10-cloudinit-gen2 Debian:debian-10:10-cloudinit-gen2:0.0.1015
debian-10 Debian 10-cloudinit-gen2 Debian:debian-10:10-cloudinit-gen2:0.0.991
debian-10 Debian 10-cloudinit-gen2 Debian:debian-10:10-cloudinit-gen2:0.0.999

현재 Azure Stack은 cloud-init 사용 이미지의 프로비전을 지원합니다.

cloud-init와 Linux 에이전트(WALA)의 차이는 무엇입니까?

WALA는 VM을 프로비저닝 및 구성하고 Azure 확장을 처리하는 데 사용되는 Azure 플랫폼 관련 에이전트입니다.

기존 cloud-init 고객이 현재 cloud-init 스크립트를 사용하거나 새 고객이 상세한 cloud-init 구성 기능을 활용할 수 있도록 하기 위해서는 Linux 에이전트 대신 cloud-init를 사용하도록 VM을 구성하는 작업을 개선하고 있습니다. Linux 시스템을 구성하기 위해 cloud-init 스크립트에 이미 투자한 경우 cloud-init 프로세스를 사용하기 위한 추가 설정이 필요하지 않습니다.

cloud-init은 Azure 확장 기능을 처리할 수 없으므로 확장 기능을 처리하려면 이미지에 WALA가 여전히 필요하지만 프로비전 코드를 사용하지 않도록 설정해야 합니다. cloud-init에 의해 프로비전되도록 변환되는 인증된 Linux 배포판 이미지의 경우 WALA가 설치되고 올바르게 설정됩니다.

VM을 만들 때 프로비전 시간에 Azure CLI --custom-data 스위치를 포함하지 않은 경우 cloud-init 또는 WALA는 VM을 프로비전하는 데 필요한 최소한의 VM 프로비전 매개 변수를 사용하여 기본 설정으로 배포를 완료합니다. --custom-data 스위치로 cloud-init 구성을 참조할 경우 VM 부팅 시점에 사용자 지정 데이터에 포함된 모든 항목이 cloud-init에 제공됩니다.

VM에 적용된 cloud-init 구성은 시간 제약 조건이 없고 시간 초과로 인해 배포가 실패하지 않습니다. WALA에는 해당하지 않습니다. WALA 기본값을 변경하여 사용자 지정 데이터를 처리할 경우 전체 VM 프로비전 사용 가능 시간인 40분을 초과할 수 없으므로 VM Create에 실패합니다.

UDF 드라이버가 없는 cloud-init VM 프로비전

cloud-init 21.2부터 cloud-init를 사용하여 UDF 드라이버 없이 Azure에서 VM을 프로비전할 수 있습니다. 이미지에서 UDF 드라이버를 사용할 수 없는 경우 cloud-init는 Azure Instance Metadata Service에서 사용할 수 있는 메타데이터를 사용하여 VM을 프로비전합니다. 이 옵션은 SSH 키 및 사용자 데이터에 대해서만 사용할 수 있습니다. 프로비전하는 동안 VM에 암호나 사용자 지정 데이터를 전달하려면 UDF 드라이버를 사용해야 합니다.

cloud-init를 사용하는 가상 머신 배포

cloud-init를 사용하는 가상 머신 배포 방법은 배포하는 동안 cloud-init 지원 배포를 참조하는 것만큼 간단합니다. Linux 배포 유지 관리자는 cloud-init를 사용하도록 설정하고 기본 Azure 게시 이미지와 통합하도록 선택해야 합니다. 배포하려는 이미지가 cloud-init을 사용하도록 설정되어 있는지 확인하면 Azure CLI를 사용하여 이미지를 배포할 수 있습니다.

이미지 배포의 첫 번째 단계로 az group create 명령을 사용하여 리소스 그룹을 만들어야 합니다. Azure 리소스 그룹은 Azure 리소스가 배포 및 관리되는 논리적 컨테이너입니다.

다음 예제에서는 eastus 위치에 myResourceGroup이라는 리소스 그룹을 만듭니다.

az group create --name myResourceGroup --location eastus

그 다음 단계로 현재 셸에서 cloud-init.txt라는 파일을 만들고 다음 구성을 붙여넣습니다. 이 예제에서는 로컬 컴퓨터에 없는 Cloud Shell에서 파일을 만듭니다. 선택한 모든 편집기를 사용할 수 있습니다. sensible-editor cloud-init.txt를 입력하여 파일을 만들고 사용 가능한 편집기 목록을 확인합니다. 선택한 편집기를 사용합니다. 일반적인 선택 사항은 nano, vim 또는 ed입니다. 전체 cloud-init 파일, 특히 첫 줄이 올바르게 복사되었는지 확인합니다.

SLES Ubuntu RHEL
# cloud-config
package_upgrade: true
packages:
- apache2
# cloud-config
package_upgrade: true
packages:
- httpd
# cloud-config
package_upgrade: true
packages:
- httpd

참고 항목

cloud-init에는 여러 입력 유형이 있으며, cloud-init는 customData/userData의 첫 번째 줄을 사용하여 입력을 처리하는 방법을 나타냅니다. 예를 들어 #cloud-config는 콘텐츠가 cloud-init 구성으로 처리되어야 함을 나타냅니다.

파일을 종료하고 편집기의 지시에 따라 파일을 저장합니다. 종료 시 파일 이름을 확인합니다.

마지막 단계로 az vm create 명령을 사용하여 VM을 만듭니다.

다음 예제에서는 ubuntu2204라는 VM을 만들고 기본 키 위치에 SSH 키가 없는 경우 이 키를 만듭니다. 특정 키 집합을 사용하려면 --ssh-key-value 옵션을 사용합니다. --custom-data 매개 변수를 사용하여 cloud-init 구성 파일을 전달합니다. 현재 작업 디렉터리 외부에 파일을 저장한 경우 cloud-init.txt 구성의 전체 경로를 제공합니다.

az vm create \
  --resource-group myResourceGroup \
  --name ubuntu2204 \
  --image Canonical:UbuntuServer:22_04-lts:latest \
  --custom-data cloud-init.txt \
  --generate-ssh-keys 

VM이 만들어지면 Azure CLI는 배포와 관련된 정보를 표시합니다. publicIpAddress을 기록해 둡니다. 이 주소는 VM에 액세스하는 데 사용됩니다. VM을 만들고 패키지를 설치하고 앱을 시작하는 데 시간이 약간 걸립니다. Azure CLI에서 프롬프트로 반환한 후 실행을 계속하는 백그라운드 작업이 있습니다. VM에 SSH한 후 문제 해결 섹션에 설명된 단계를 사용하여 cloud-init 로그를 볼 수 있습니다.

ARM 템플릿의 매개 변수를 전달하여 cloud-init 지원 VM을 배포할 수도 있습니다.

cloud-init 문제 해결

VM이 프로비전되면 cloud-init는 --custom-data에 정의된 모든 모듈과 스크립트를 실행하여 VM을 구성합니다. 구성 오류 또는 누락을 해결해야 하는 경우 /var/log/cloud-init.log에 있는 cloud-init 로그에서 모듈 이름(예: disk_setup 또는 runcmd)을 검색해야 합니다.

참고 항목

모든 모듈 실패가 심각한 cloud-init 전체 구성 실패로 이어지는 것은 아닙니다. 예를 들어 runcmd 모듈을 사용하는 경우 스크립트가 실패해도 runcmd 모듈이 실행되었기 때문에 cloud-init는 성공한 프로비전을 계속 보고합니다.

cloud-init 로깅에 대한 자세한 내용은 cloud-init 설명서를 참조하세요.

원격

cloud-init에서는 사용량 현황 데이터를 수집한 후 Microsoft로 보내 제품 및 서비스를 개선합니다. 원격 분석은 프로비전 프로세스(VM의 첫 번째 부팅) 중에만 수집됩니다. 수집된 데이터는 프로비저닝 오류를 조사하고 성능 및 안정성을 모니터링하는 데 도움이 됩니다. 수집된 데이터에는 식별자(개인 식별자)가 포함되지 않습니다. 자세히 알아보려면 개인정보처리방침을 읽어보세요. 수집되는 원격 분석의 몇 가지 예(전체 목록은 아님)는 OS 관련 정보(cloud-init 버전, 배포판 버전, 커널 버전), 필수 VM 프로비전 작업의 성능 메트릭(DHCP 임대를 가져오는 시간, VM을 구성하는 데 필요한 메타데이터를 검색하는 시간 등), cloud-init 로그, dmesg 로그입니다.

원격 분석 수집은 현재 cloud-init를 사용하는 대부분의 마켓플레이스 이미지에 대해 사용하도록 설정되어 있습니다. cloud-init에 대한 KVP 원격 분석 리포터를 지정하면 활성화됩니다. 대부분의 Azure Marketplace 이미지에서 이 구성은 /etc/cloud/cloud.cfg.d/10-azure-kvp.cfg 파일에서 찾을 수 있습니다. 이미지 준비 중에 이 파일을 제거하면 이 이미지에서 만들어진 모든 VM에 대한 원격 분석 컬렉션이 사용하지 않도록 설정됩니다.

10-azure-kvp.cfg의 샘플 콘텐츠

reporting:
  logging:
    type: log
  telemetry:
    type: hyperv

다음 단계

cloud-init 관련 문제 해결.

구성 변경에 대한 cloud-init 예제를 보려면 다음 문서를 참조하세요.