Migration Center에서는 제공된 템플릿을 사용하여 데이터를 직접 입력한 테이블을 업로드할 수 있습니다. 인프라의 애셋 수가 제한적이고 데이터를 수동으로 만들려는 경우에 유용합니다.
수동으로 입력한 테이블을 가져오려면 다음 단계를 수행합니다.
- 사용 가능한 템플릿 목록에서 템플릿을 다운로드합니다.
- 인프라의 데이터를 테이블에 수동으로 입력합니다.
- Migration Center에 테이블을 업로드합니다.
제한사항
- 파일 업로드의 최대 크기는 100Mb입니다.
사용 가능한 데이터 템플릿
다음 표에서는 인프라 데이터를 Migration Center에 업로드하는 데 사용할 수 있는 파일 템플릿을 제공합니다. 이 템플릿에는 테이블에 입력하는 방법을 제안하기 위한 샘플 데이터가 포함되어 있습니다. 필요한 데이터 형식에 대한 자세한 내용은 가져오기 파일 사양을 참조하세요.
| 파일 이름 | Data type(데이터 유형) | 설명 |
|---|---|---|
| vmInfo.csv | 시스템 정보 | CPU, 메모리, 기타 구성 매개변수를 비롯한 개별 애셋에 대한 정보를 제공하려면 이 템플릿을 사용합니다. 이 테이블은 새 가져오기를 만들 때마다 필요합니다. |
| perfInfo.csv | 성능 데이터 | 선택사항: 시계열 형식으로 애셋의 성능 데이터를 제공하려면 이 템플릿을 사용합니다. |
| diskInfo.csv | 디스크 데이터 | 선택사항: 디스크와 사용률에 대한 정보를 제공하려면 이 템플릿을 사용합니다. |
| tagInfo.csv | 시스템 태그 | 선택사항: 애셋에 라벨을 할당하려면 이 템플릿을 사용합니다. 라벨은 Google Cloud의 라벨 요구사항을 따라야 합니다. |
각 파일의 사양에 대한 자세한 내용은 가져오기 파일 사양을 참조하세요.
테이블 업로드
파일을 업로드하려면 다음 단계를 따르세요.
콘솔
데이터 가져오기 페이지로 이동합니다.
데이터 추가 > 파일 업로드를 클릭합니다.
파일 업로드 설정 섹션에서 파일 업로드 이름을 입력합니다.
파일 형식 목록에서 수동으로 입력된 CSV 템플릿을 선택합니다.
업로드할 파일 선택을 클릭한 후 업로드하려는 모든 파일을 선택합니다.
파일 업로드를 클릭하여 파일을 확인하고 업로드를 시작합니다.
파일이 올바르게 검증된 경우 파일에서 애셋을 만들려면 데이터 가져오기를 클릭한 후 확인을 클릭합니다.
API
가져오기 작업을 만듭니다.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID { "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID" }다음을 바꿉니다.
PROJECT_ID: 가져오기 작업을 만들 프로젝트의 ID입니다.REGION: 가져오기 작업을 만들 리전입니다.IMPORT_JOB_ID: 새 가져오기 작업의 ID입니다.SOURCE_ID: 가져오기 작업과 연결할 기존 소스의 ID입니다.
선택사항: 가져오기 작업이 올바르게 생성되었는지 확인하려면 가져오기 작업을 가져옵니다.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
가져오기 작업에 연결된 가져오기 데이터 파일을 만듭니다.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID { "format": "IMPORT_JOB_FORMAT" }다음을 바꿉니다.
DATA_FILE_ID: 새 데이터 파일의 IDIMPORT_JOB_FORMAT:IMPORT_JOB_FORMAT_MANUAL_CSV
데이터 파일을 가져옵니다.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID
응답의
signedUrl필드에서 URL을 복사합니다.복사된 URL에 파일을 업로드합니다.
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
다음을 바꿉니다.
UPLOAD_FILE_PATH: 업로드된 파일의 로컬 경로입니다.COPIED_URL: 미리보기 단계에서 복사된 서명된 URL입니다.
선택사항: 3~6단계를 반복하여 동일한 가져오기 작업 아래에 데이터 파일을 더 만듭니다.
선택사항: 가져오기 작업의 모든 데이터 파일을 가져옵니다.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
가져오기 작업을 검증합니다.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
가져오기 작업을 가져오고 검증 보고서를 확인합니다. 상태가
READY이면 다음 단계로 진행할 수 있습니다. 그렇지 않고 작업 또는 특정 파일을 수정해야 하는 경우 파일을 삭제하거나 새 파일을 업로드해야 할 수 있습니다.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
가져오기 작업을 실행합니다.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
가져오기 작업을 가져오고 실행 보고서를 확인합니다. 상태가
COMPLETED이면 작업이 성공적으로 실행된 것입니다. 그렇지 않고 작업이 실패하고 종결 상태인 경우 실행 보고서에 오류가 포함됩니다. 새 가져오기 작업을 만들고 필요한 변경사항을 적용합니다.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
파일 업로드에 문제가 발생하면 일반적인 오류 메시지 문제 해결 방법을 참조하세요.
업로드 검토
파일을 업로드한 후 파일이 공식적으로 올바른지 Migration Center에서 검사합니다. 검증이 성공하면 Migration Center는 데이터를 처리하여 새 애셋을 만들거나 기존 애셋을 업데이트합니다. Google Cloud 콘솔에서 업로드 작업 상태를 확인할 수 있습니다.
업로드 작업 상태를 검토하려면 다음 단계를 수행합니다.
- 데이터 가져오기 페이지로 이동한 후 파일 업로드를 클릭합니다.
- 파일 가져오기 목록에서 검토하려는 업로드를 선택합니다.
- 파일 업로드 페이지의 데이터 가져오기 진행 상황에서 업로드된 파일의 상태를 검토합니다.
파일이 다음과 같은 상태 중 하나로 표시될 수 있습니다.
상태 목록
- 완료됨. 파일 가져오기에 성공했습니다.
- 준비됨. 파일 검증을 통과하여 파일을 가져올 준비가 되었습니다.
- 대기 중. 파일이 다른 파일의 처리가 완료될 때까지 기다리는 중입니다.
- 실행 중. 파일을 처리하는 중입니다.
- 유효성 검사 중. 파일이 검증 단계에 있습니다.
- 검증 실패. 파일에 오류가 있습니다. 오류를 해결한 후 파일을 다시 업로드하세요.
- 실패. 파일을 가져올 수 없습니다.
오류 세부정보 검토
파일을 가져온 후 오류가 발생하면 Google Cloud 콘솔에서 직접 오류 메시지를 검토할 수 있습니다.
업로드 작업 오류를 검토하려면 다음 단계를 수행합니다.
- 데이터 가져오기 페이지로 이동한 후 파일 업로드를 클릭합니다.
- 경고 또는 오류가 표시된 가져오기 파일을 클릭합니다. 가져오기 파일 세부정보 페이지에 전체 오류 목록이 표시됩니다.
가져오기 파일 세부정보 페이지에서 오류를 일으킨 애셋 및 데이터 필드를 검토하고 오류에 대한 설명을 볼 수 있습니다. 파일 가져오기 작업에 오류가 발생하면 Migration Center에서 새 애셋을 만들지 않거나 새 변경사항으로 기존 애셋을 업데이트하지 못할 수 있습니다. 오류를 해결하려면 파일을 수정하고 새 파일 가져오기 작업을 만들어 다시 업로드합니다.
발생 가능한 오류 메시지에 대한 자세한 내용은 파일 가져오기 오류 문제 해결을 참조하세요.
가져오기 파일 사양
다음 표는 수동 가져오기에 사용되는 템플릿 파일의 기술 사양을 보여줍니다.
vmInfo 파일
| 열 | 예상 유형 | 설명 |
|---|---|---|
| MachineId | 문자열 | 가상 머신 고유 식별자입니다. |
| MachineName | 문자열 | 가상 머신 표시 이름입니다. |
| PrimaryIPAddress | 문자열 | 머신의 IP 주소입니다. |
| PrimaryMACAddress | 문자열 | 머신의 MAC 주소입니다. 이 주소는 머신을 식별하는 데만 사용됩니다. |
| PublicIPAddress | 문자열 | 머신의 공개 IP 주소입니다. |
| IpAddressListSemiColonDelimited | 메시지 목록 | 할당된 네트워크 주소 목록입니다. |
| TotalDiskAllocatedGiB | int64 | 디스크의 총 용량입니다. |
| TotalDiskUsedGiB | int64 | 디스크에서 사용된 총 공간입니다. |
| MachineTypeLabel | 문자열 | AWS 또는 Azure 머신 유형 라벨입니다. |
| AllocatedProcessorCoreCount | int64 | 가상 머신의 CPU 코어 수입니다. |
| MemoryGiB | int32 | 가상 머신의 메모리 용량입니다. |
| HostingLocation | 문자열 | AWS 또는 Azure 형식의 머신 위치입니다. |
| OsType | 문자열 | 머신의 OS입니다. |
| OsName | 문자열 | 머신의 OS입니다. |
| OsVersion | 문자열 | 머신의 OS 버전입니다. |
| MachineStatus | 문자열 | 머신의 전원 상태입니다. |
| ProvisioningState | 문자열 | 프로비저닝 상태이면 Azure VM만 해당됩니다. |
| CreateDate | 타임스탬프 | 머신의 생성 타임스탬프입니다. |
| IsPhysical | 문자열 | 머신이 물리적 머신인지 가상 머신인지 여부입니다. |
| 소스 | 메시지 | AWS 또는 Azure 머신의 소스 세부정보입니다. |
diskInfo 파일
| 열 | 예상 유형 | 설명 |
|---|---|---|
| MachineId | 문자열 | 가상 머신 고유 식별자입니다. |
| DiskLabel | 문자열 | 디스크 라벨입니다. |
| SizeInGib | int64 | 디스크의 총 용량입니다. |
| UsedInGib | int64 | 디스크에서 사용된 총 공간입니다. |
| StorageTypeLabel | 문자열 | 디스크 라벨 유형(예: BIOS 또는 GPT)입니다. |
perfInfo 파일
| 열 | 예상 유형 | 설명 |
|---|---|---|
| MachineId | 문자열 | 가상 머신 고유 식별자입니다. |
| TimeStamp | 샘플이 수집된 타임스탬프입니다. | |
| CpuUtilizationPercentage | float | 사용한 총 CPU 용량의 비율입니다. 0~100 간격에 속해야 합니다. |
| MemoryUtilizationPercentage | float | 사용한 시스템 메모리의 비율입니다. 0~100 간격에 속해야 합니다. |
| UtilizedMemoryBytes | float | 사용된 총 메모리 용량(바이트)입니다. |
| DiskReadOperationsPerSec | float | 짧은 기간 동안 샘플링된 평균 IOPS입니다. |
| DiskWriteOperationsPerSec | float | 짧은 기간 동안 샘플링된 평균 IOPS입니다. |
| NetworkBytesPerSecSent | float | 짧은 기간 동안 샘플링된 B/초 단위의 평균 네트워크 이그레스입니다. |
| NetworkBytesPerSecReceived | float | 짧은 기간 동안 샘플링된 B/초 단위의 평균 네트워크 인그레스입니다. |
tagInfo 파일
| 열 | 예상 유형 | 설명 |
|---|---|---|
| MachineId | 문자열 | 가상 머신 고유 식별자입니다. |
| 키 | 문자열 | 라벨 키입니다. |
| 값 | 문자열 | 라벨 값입니다. |
라벨의 파싱 알고리즘
tagInfo 파일로 업로드하는 라벨은 Google Cloud의 라벨 요구사항을 따라야 합니다. 라벨이 요구사항을 준수하지 않는 경우 Migration Center는 다음 전략을 사용하여 라벨을 변환합니다.
- 키의 경우에만 영어 알파벳이 아닌 모든 선행 문자를 삭제합니다.
- 모든 대문자를 소문자로 바꿉니다.
- 잘못된 모든 문자를 밑줄(
_)로 바꿉니다. - 라벨은 최대 62자(영문 기준)로 자릅니다.
- 원본 문자열을 기준으로 계산된
_<CRC32>서픽스를 추가합니다.
라벨이 변환될 때마다 경고 메시지가 표시됩니다.
검증에 실패하거나 키가 이미 존재하면 가져오기가 행을 건너뛰고 경고 메시지가 표시됩니다.
다음 단계
- Migration Center 수집 메서드 자세히 알아보기
- 파일 업로드 관리 방법 알아보기