🔹 waagent란?
waagent는 Microsoft Azure Linux Agent(WALinuxAgent)의 실행 파일입니다.
Azure에서 Linux 가상 머신(VM)을 관리하는 역할을 하며, VM과 Azure 플랫폼 간의 통신을 담당합니다.
📌 주요 기능:
✅ Azure VM의 프로비저닝(Provisioning) 및 초기 설정
✅ VM 디스크 크기 조정 및 관리
✅ SSH 키 및 사용자 계정 관리
✅ VM 메타데이터 가져오기
✅ Azure Extension(확장 기능) 관리
✅ VM의 네트워크 인터페이스 및 IP 주소 관리
🔹 waagent의 주요 역할
Azure 환경에서 Linux VM이 정상적으로 동작하도록 다음과 같은 기능을 수행합니다.
1️⃣ VM 프로비저닝 (Provisioning)
- VM이 처음 배포될 때 SSH 키를 설정하고, 사용자 계정을 생성합니다.
- /etc/waagent.conf 파일에서 기본 설정을 적용합니다.
waagent -deprovision
waagent -provision- -deprovision : 현재 VM을 초기화하여 이미지 스냅샷을 만들기 전에 실행
- -provision : 새로운 VM에서 설정을 적용
2️⃣ 디스크 및 파일 시스템 관리
- Azure 디스크 크기 조정 (/dev/sda1 등의 루트 볼륨 확장)
- 클라우드 스토리지 (Azure Data Disks) 자동 마운트
waagent -force -deprovision💡 OS 디스크를 초기화하고, VM 이미지로 만들기 전에 실행하는 명령어
3️⃣ 네트워크 관리
- VM의 IP 주소를 자동으로 구성
- Azure DHCP 및 네트워크 설정 관리
4️⃣ Azure 확장 프로그램(Extensions) 관리
Azure에서 추가 기능(예: 모니터링, 보안 패치) 설치 시 사용됩니다.
예를 들어, Azure Diagnostics 또는 Custom Script Extension이 포함됩니다.
waagent -install🔹 waagent 명령어 사용법
명령어설명
| waagent -version | 현재 설치된 waagent 버전 확인 |
| waagent -status | 서비스 실행 상태 확인 |
| waagent -start | Azure Linux Agent 서비스 시작 |
| waagent -stop | Azure Linux Agent 서비스 중지 |
| waagent -restart | 서비스 재시작 |
| waagent -deprovision | VM 초기화 (사용자 데이터 삭제) |
| waagent -provision | VM 설정 재적용 |
| waagent -install | Azure 확장 설치 |
| waagent -force -deprovision | VM을 초기화하여 이미지 생성 |
🔹 waagent 로그 확인 및 설정
📌 로그 파일 위치
waagent의 로그는 /var/log/waagent.log에서 확인할 수 있습니다.
tail -f /var/log/waagent.log📌 설정 파일 위치
waagent 설정은 /etc/waagent.conf에서 관리됩니다.
- SSH 키 자동 생성 비활성화
Provisioning.UseCloudInit=n- 자동 디스크 확장 설정
ResourceDisk.Format=y
ResourceDisk.MountPoint=/mnt/resource🔹 waagent 업데이트 방법
Azure에서 최신 waagent 버전을 유지하는 것이 중요합니다.
✅ Ubuntu/Debian
sudo apt update && sudo apt install walinuxagent -y✅ CentOS/RHEL
sudo yum update WALinuxAgent✅ Manual Installation
pip install --upgrade walinuxagent🔹 결론
✅ waagent(WALinuxAgent)은 Azure Linux VM의 필수 서비스로, VM 프로비저닝, 네트워크 설정, 디스크 관리, 확장 기능을 담당합니다.
✅ waagent 명령어를 사용하여 VM 초기화, 프로비저닝, 네트워크 및 디스크 관리를 수행할 수 있습니다.
✅ /etc/waagent.conf에서 설정을 변경하고, /var/log/waagent.log에서 문제 해결을 할 수 있습니다.
💡 Azure에서 Linux VM을 관리할 때 waagent가 자동으로 실행되는지 확인하는 것이 중요합니다! 🚀