AWS CLI를 사용하여 AWS Backup 복구 지점에서 Amazon EFS 파일 시스템을 복원하려면 어떻게 해야 하나요?

해결 방법

AWS Backup 복구 지점에서 EFS 파일 시스템의 내부 복원

1.    list-backup-jobs 명령을 실행하여 복원할 EFS 파일 시스템의 Amazon 리소스 이름(ARN)을 가져옵니다. AWS Backup 복구 지점에서 EFS 파일 시스템 복원을 수행하려면 복구 지점 ARN이 있어야 합니다.

$ aws backup list-backup-jobs --by-resource-type EFS --region us-east-1

참고: AWS CLI 명령을 실행할 때 오류가 발생하면 최신 AWS CLI 버전을 사용하고 있는지 확인하세요.

2.    명령 출력에서 RecoverypointArn을 기록해 둡니다.

{
    "BackupJobs": [
        {
            "CompletionDate": 1583305453.7,
            "BackupVaultArn": "arn:aws:backup:us-east-1:111222333444:backup-vault:Default",
            "PercentDone": "0.0",
            "RecoveryPointArn": "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347",
            "ResourceType": "EFS",
            "BackupSizeInBytes": 73,
            "State": "COMPLETED",
            "IamRoleArn": "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole",
            "ResourceArn": "arn:aws:elasticfilesystem:us-east-1:111222333444:file-system/fs-6a1dcba2",
            "BackupJobId": "721ba96d-a656-4771-a1f4-78bcd0c930f8",
            "StartBy": 1583309035.684,
            "CreationDate": 1583305435.684,
            "BackupVaultName": "Default"
        }
    ]
}

3.    start-restore-job 명령을 실행하려면 EFS 인스턴스를 복원할 특정 메타데이터를 정의해야 합니다. 별도의 JSON 파일에 메타데이터를 정의하거나 명령 내에서 메타데이터를 매개 변수로 정의할 수 있습니다.

별도의 JSON 파일에 메타데이터를 정의하려면 다음과 비슷한 JSON 파일을 만드세요.

{"file-system-id": "fs-6a1dcba2", "newFileSystem": "false", "Encrypted": "false", "PerformanceMode":"generalPurpose"}

그런 다음 start-restore-job 명령을 실행합니다.

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole"  --metadata file://path_to_json_file

start-restore-job 명령 내에서 메타데이터를 매개 변수로 정의하려면 다음 형식으로 명령을 실행합니다.

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole" --metadata '{"file-system-id": "fs-6a1dcba2", "newFileSystem": "false", "Encrypted": "false", "PerformanceMode":"generalPurpose"}'

AWS 백업 복구 지점에서 새 EFS 파일 시스템 복원

1.    list-backup-jobs 명령을 실행하여 복원할 EFS 파일 시스템의 ARN을 가져옵니다. AWS Backup 복구 지점에서 EFS 파일 시스템 복원을 수행하려면 복구 지점 ARN이 있어야 합니다.

$ aws backup list-backup-jobs --by-resource-type EFS --region us-east-1

2.    명령 출력에서 RecoverypointArn을 기록해 둡니다.

{
    "BackupJobs": [
        {
            "CompletionDate": 1583305453.7,
            "BackupVaultArn": "arn:aws:backup:us-east-1:111222333444:backup-vault:Default",
            "PercentDone": "0.0",
            "RecoveryPointArn": "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347",
            "ResourceType": "EFS",
            "BackupSizeInBytes": 73,
            "State": "COMPLETED",
            "IamRoleArn": "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole",
            "ResourceArn": "arn:aws:elasticfilesystem:us-east-1:111222333444:file-system/fs-6a1dcba2",
            "BackupJobId": "721ba96d-a656-4771-a1f4-78bcd0c930f8",
            "StartBy": 1583309035.684,
            "CreationDate": 1583305435.684,
            "BackupVaultName": "Default"
        }
    ]
}

3.    새 EFS 파일 시스템으로 복원하려면 요청의 고유성(멱등성)을 적용하는 CreationToken 값을 생성하세요. CreationToken은 원하는 값일 수 있습니다. Linux 운영 체제에서는 uuid 명령을 실행하여 고유 식별자를 생성할 수 있습니다.

uuid -r

출력은 다음과 비슷한 범용 고유 식별자(UUID)입니다.

d0c12345-678d-4071-bf30-8e7e54ab65df

4.    start-restore-job 명령을 실행하려면 EFS 인스턴스를 복원할 특정 메타데이터를 정의해야 합니다. 별도의 JSON 파일에 메타데이터를 정의하거나 명령 내에서 메타데이터를 매개 변수로 정의할 수 있습니다.

별도의 JSON 파일에 메타데이터를 정의하려면 다음과 비슷한 JSON 파일을 만드세요.

참고: CreationToken의 경우 3단계에서 생성한 CreationToken 값을 사용하세요.

{"file-system-id": "fs-6a1dcba2", "Encrypted": "false", "PerformanceMode": "generalPurpose", "CreationToken": "d0c12345-678d-4071-bf30-8e7e54ab65df", "newFileSystem": "true"}

그런 다음 start-restore-job 명령을 실행합니다.

참고: --metadata에는 이전 단계에서 생성한 JSON 파일을 입력합니다.

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole"  --metadata file://path_to_json_file

start-restore-job 명령 내에서 메타데이터를 매개 변수로 정의하려면 다음 형식으로 명령을 실행합니다.

참고: CreationToken의 경우 3단계에서 생성한 CreationToken 값을 사용하세요.

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole" --metadata '{"file-system-id": "fs-6a1dcba2", "newFileSystem": "true", "CreationToken": "d0c12345-678d-4071-bf30-8e7e54ab65df", "Encrypted": "false", "PerformanceMode":"generalPurpose"}'

AWS Backup 복구 지점에서 항목 수준 EFS 파일 시스템 복원 수행

1.    list-backup-jobs 명령을 실행하여 복원할 EFS 파일 시스템의 Amazon 리소스 이름(ARN)을 가져옵니다. AWS Backup 복구 지점에서 EFS 파일 시스템 복원을 수행하려면 복구 지점 ARN이 있어야 합니다.

$ aws backup list-backup-jobs --by-resource-type EFS --region us-east-1

참고: AWS CLI 명령을 실행할 때 오류가 발생하면 최신 AWS CLI 버전을 사용하고 있는지 확인하세요.

2.    명령 출력에서 RecoverypointArn을 기록해 둡니다.

{
    "BackupJobs": [
        {
            "AccountId": "686948106210",
            "BackupJobId": "261f13d0-5ede-458e-a00e-d83ed5de0afe",
            "BackupVaultName": "Default",
            "BackupVaultArn": "arn:aws:backup:us-east-1:111222333444:backup-vault:Default",
            "RecoveryPointArn": "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347",
            "ResourceArn": "arn:aws:elasticfilesystem:us-east-1:111222333444:file-system/fs-6a1dcba2",
            "CreationDate": "2021-08-23T07:52:56.652000+00:00",
            "CompletionDate": "2021-08-23T07:53:09.547000+00:00",
            "State": "COMPLETED",
            "PercentDone": "100.0",
            "BackupSizeInBytes": 75,
            "IamRoleArn": "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole",
            "StartBy": "2021-08-23T08:52:56.652000+00:00",
            "ResourceType": "EFS"
        }

3.    start-restore-job 명령을 실행하려면 EFS 인스턴스를 복원할 특정 메타데이터를 정의해야 합니다. 별도의 JSON 파일에 메타데이터를 정의하거나 명령 내에서 메타데이터를 매개 변수로 정의할 수 있습니다.

별도의 JSON 파일에 메타데이터를 정의하려면 다음과 비슷한 JSON 파일을 만드세요.

{"file-system-id": "fs-6a1dcba2", "newFileSystem": "false", "Encrypted": "false", "PerformanceMode":"generalPurpose", "itemsToRestore":"[\"/my.test\"]"}

그런 다음 start-restore-job 명령을 실행합니다.

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole"  --metadata file://path_to_json_file

start-restore-job 명령 내에서 메타데이터를 매개 변수로 정의하려면 다음 형식으로 명령을 실행합니다.

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole" --metadata '{"file-system-id": "fs-6a1dcba2", "newFileSystem": "false", "Encrypted": "false", "PerformanceMode":"generalPurpose", "itemsToRestore":"[\"/my.test\"]"}'

---