게스트 검색 및 데이터 수집 일괄 처리

---

이 튜토리얼에서는 마이그레이션 센터 검색 클라이언트 CLI 게스트 검색을 사용하여 일괄 VMware 가상 머신(VM) 인스턴스에서 데이터를 검색하고 수집하는 프로세스를 안내합니다. 대규모 VM 배치는 모니터링하고 문제를 해결하기 어려울 수 있습니다. 따라서 1,000개 미만의 소규모 그룹으로 일괄 처리하는 것이 좋습니다.

목표

이 튜토리얼에서는 다음과 같은 방법을 알아봅니다.

• mcdc CLI 다운로드
• VMWare 인벤토리 검색 수행
• 검색된 모든 VM이 포함된 CSV 파일 생성
• CSV 파일을 VM의 하위 집합이 포함된 여러 CSV 파일로 분할
• CSV 파일의 모든 VM에서 게스트 검색 수행
• 오프라인 평가 보고서 생성

비용

이 가이드는 온프레미스 리소스를 사용하므로 Google Cloud 비용이 발생하지 않습니다.

시작하기 전에

1. mcdc CLI를 설치하고 실행할 Linux 머신을 준비합니다. Linux 머신의 최소 요구사항은 다음과 같습니다.

   • glibc 버전 2.25 이상
   • 4GB RAM 및 10GB 디스크 공간
   • vCenter 및 ESX 호스트에 대한 네트워크 연결

2. 필요한 권한을 포함하는 vSphere 사용자가 있는지 확인합니다.

   • VM에 대한 읽기 권한
   • 모든 ESX 호스트에 대한 읽기 권한
   • 게스트 작업 수정
   • 게스트 작업 프로그램 실행
   • 게스트 작업 쿼리

mcdc CLI 다운로드

1. Linux 머신에 연결합니다.

   ssh MACHINE_IP
   

   MACHINE_IP를 Linux 머신의 IP 주소로 바꿉니다.

2. mcdc CLI의 최신 버전을 다운로드하고 실행 파일로 만듭니다.

     curl -O "https://mcdc-release.storage.googleapis.com/$(curl -s https://mcdc-release.storage.googleapis.com/latest)/mcdc"
     chmod +x mcdc
   

3. 셸 경로에 mcdc CLI를 추가합니다.

   PATH=$PATH:`pwd`
   

VMware 인벤토리 검색 수행

• 인벤토리 검색을 실행합니다.

  ./mcdc discover vsphere -u USERNAME --url https://VSPHERE_URL
  

  다음을 바꿉니다.

  • USERNAME: vCenter 사용자 이름
  • VSPHERE_URL: vCenter Server 인스턴스 또는 vSphere 클라이언트의 URL

  discover 명령어를 실행하면 다음과 같이 출력됩니다.

  [+] Found 528 VMs
  Collecting data...
  528 / 528 [---------------------------------------------------] 100.00% 5 p/s
  [✓] Collection completed.
  

검색된 모든 VM이 포함된 CSV 파일 생성

CSV 파일을 생성하려면 GitHub에서 Migrate to Containers 저장소의 export 스크립트를 사용합니다.

vms=$(mcdc report --format csv | tail -n +2 | awk -F ',' '{; print $2";"$3";"$4";;;"}')
printf "%s\n" "Name;Platform VM ID;OS Family;IP;USERNAME;PASSWORD"
printf "%s\n" "$vms"

이 스크립트는 report 명령어를 사용하여 이전 단계에서 검색된 모든 VM이 포함된 CSV 파일을 생성합니다.

1. 스크립트 다운로드:

   curl -O https://raw.githubusercontent.com/GoogleCloudPlatform/migrate-to-containers/main/scripts/mcdc/mcdc_discovery_export_guest_tools.sh
   chmod +x mcdc_discovery_export_guest_tools.sh
   

2. 스크립트를 실행하고 출력을 파일에 저장합니다.

   ./mcdc_discovery_export_guest_tools.sh > VMS_CSV_FILE
   

   VMS_CSV_FILE을 CSV 파일에 사용할 이름으로 바꿉니다.

VM의 하위 집합을 사용하여 CSV 파일을 여러 CSV 파일로 분할

큰 CSV 파일을 작은 CSV 파일로 분할하려면 GitHub의 Migrate to Containers 저장소에서 splitter 스크립트를 사용합니다.

tail -n +2 $1 | split -d -l $num_of_lines - $2
for file in $2*
do
    head -n 1 $1 > tmp_file
    cat "$file" >> tmp_file
    mv -f tmp_file "$file"
done

1. 스크립트 다운로드:

   curl -O https://raw.githubusercontent.com/GoogleCloudPlatform/migrate-to-containers/main/scripts/mcdc/csv_splitter.sh
   chmod +x csv_splitter.sh
   

2. 스크립트를 실행합니다.

   ./csv_splitter.sh VMS_CSV_FILE CSV_FILES_PREFIX LINES_PER_FILE VMS_CSV_FILE CSV_FILES_PREFIX
   

   다음을 바꿉니다.

   • VMS_CSV_FILE: 분할할 입력 CSV 파일
   • CSV_FILES_PREFIX: 생성된 CSV 파일의 프리픽스
   • LINES_PER_FILE: 생성된 CSV 파일당 줄의 수. 기본값은 10입니다.

   스크립트는 다양한 CSV 파일을 생성합니다.

3. 생성된 CSV 파일 목록을 확인합니다.

   ls -lrt CSV_FILES_PREFIX*
   

CSV 파일의 모든 VM에서 게스트 검색 수행

CSV 파일에서 VM의 게스트 검색을 실행하려면 Migrate to Containers GitHub 저장소에서 collection 스크립트를 사용합니다.

이전 단계에서 생성한 각 CSV 파일에 대해 이 단계를 반복합니다.

url_regex='^https?://[-A-Za-z0-9\+&@#/%?=~_|!:,.;]*[-A-Za-z0-9\+&@#/%=~_|]\.[-A-Za-z0-9\+&@#/%?=~_|!:,.;]*[-A-Za-z0-9\+&@#/%=~_|]$'

read -r -p "CSV file name: " CSV_FILE
if [[ ! -r "$CSV_FILE" ]]; then
    echo "The file $CSV_FILE does not exist or can not be accessed."
    exit 1
fi

read -r -p "vSphere URL: " VSPHERE_URL
if ! [[ $VSPHERE_URL =~ $url_regex ]]; then
    echo "vSphere URL $VSPHERE_URL IS not a valid URL"
    exit 1
fi
read -r -p "vSphere username: " VSPHERE_USER
read -r -s -p "vSphere password: " VSPHERE_PASSWORD
echo ""
read -r -p "Default username: " DEFAULT_USER
read -r -s -p "Default password: " DEFAULT_PASSWORD

echo ""

# CSV fields
#NAME;PLATFORM VM ID;OS;IP;USERNAME;PASSWORD
while IFS=";" read -r vm_name vm_id os ip username password
do
   if [ -z "$username" ]
    then
      username=$DEFAULT_USER
    fi
    if [ -z "$password" ]
    then
          password=$DEFAULT_PASSWORD
    fi

    if [ ! -z "$vm_id" ]
    then
      # Note that the below only works for VMWare VMs
      # vm_id after the last slash if prefixed by vSphere IP
      mod_vm_id=$(echo "$vm_id" | sed 's/.*\///')
      mcdc discover vsphere guest --url $VSPHERE_URL -u $VSPHERE_USER -p $VSPHERE_PASSWORD --vm-user $username --vm-password $password $mod_vm_id
    else
      echo "Skipping VM: $vm_name because it has no VM ID"
    fi
 done < <(tail -n +1 $CSV_FILE)

이 스크립트는 discover vsphere guest 명령어를 사용하여 VM에 게스트 수집 스크립트를 업로드하고 실행합니다.

이 스크립트를 백그라운드에서 실행하고 출력을 로그 파일로 전달하는 것이 가장 좋습니다. 이렇게 하려면 스크립트에 입력으로 전달되는 텍스트 파일을 만들어야 합니다.

1. 텍스트 파일을 만듭니다.

   cat <<EOF >> INPUT_FILE
   CSV_FILES_PREFIXCSV_FILE_SUFFIX
   VSPHERE_URL
   VSPHERE_USER
   VSPHERE_PASSWORD
   VM_USER
   VM_PASSWORD
   EOF
   

   다음을 바꿉니다.

   • INPUT_FILE: 입력 파일 이름
   • CSV_FILES_PREFIX: CSV 파일 이름 프리픽스
   • CSV_FILE_SUFFIX: CSV 파일 이름 서픽스
   • VSPHERE_URL: vCenter Server 인스턴스 또는 vSphere 클라이언트의 URL
   • VSPHERE_USER: vCenter 사용자 이름
   • VSPHERE_PASSWORD: vCenter 비밀번호
   • VM_USER: VM 사용자 이름
   • VM_PASSWORD: VM 비밀번호

2. 게스트 수집 스크립트를 실행합니다.

   nohup ./mcdc_collect_vms_guest_tools.sh <INPUT_FILE > /tmp/mcdc.out 2>&1 &
   

3. 이전 단계에서 생성한 각 CSV 파일에 1~2단계를 반복합니다.

오프라인 평가 보고서 생성

• 모든 데이터가 수집되면 상세한 HTML 보고서를 생성할 수 있습니다.

  ./mcdc report --format html --full > REPORT_NAME.html
   

다음 단계

• EC2 인스턴스에서 게스트 데이터를 수집하는 방법 알아보기
• mcdc CLI에 대해 자세히 알아보기
• 스크립트 샘플 살펴보기