Como faço para restaurar um sistema de arquivos do Amazon EFS a partir de um ponto de recuperação do AWS Backup usando a AWS CLI?

5 minuto de leitura
0

Quero usar a AWS Command Line Interface (AWS CLI) para restaurar um Amazon Elastic File System (Amazon EFS) a partir de um ponto de recuperação do AWS Backup.

Solução

Restauração local de um sistema de arquivos EFS a partir de um ponto de recuperação do AWS Backup

1.    Execute o comando list-backup-jobs para que o nome do recurso da Amazon (ARN) do sistema de arquivos EFS seja restaurado. Você deve ter o ARN do ponto de recuperação para realizar uma restauração do sistema de arquivos EFS a partir de um ponto de recuperação do AWS Backup.

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

Nota: Se você receber erros ao executar comandos da AWS CLI, verifique se você está usando a versão mais recente da AWS CLI.

2.    Na saída do comando, observe o 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.    Para executar o comando start-restore-job, você deve definir metadados específicos para restaurar uma instância do EFS. Você pode definir os metadados em um arquivo JSON separado ou definir os metadados como parâmetros dentro do comando.

Para definir os metadados em um arquivo JSON separado, crie um arquivo JSON semelhante ao seguinte:

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

Em seguida, execute o comando 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

Para definir os metadados como parâmetros no comando start-restore-job, execute o comando no seguinte formato:

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"}'

Restaure um novo sistema de arquivos EFS a partir de um ponto de recuperação do AWS Backup

1.    Execute o comando list-backup-jobs para restaurar o ARN do sistema de arquivos EFS. Você deve ter o ARN do ponto de recuperação para realizar uma restauração do sistema de arquivos EFS a partir de um ponto de recuperação do AWS Backup.

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

2.    Na saída do comando, observe o 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.    Para restaurar um novo sistema de arquivos EFS, gere um valor de CreationToken que reforce a exclusividade (idempotência) da solicitação. O CreationToken pode ser qualquer valor de sua escolha. Em um sistema operacional Linux, você pode executar o comandouuid para gerar um identificador exclusivo:

uuid -r

A saída é um identificador universal exclusivo (UUID) semelhante ao seguinte:

d0c12345-678d-4071-bf30-8e7e54ab65df

4.    Para executar o comando start-restore-job, você deve definir metadados específicos para restaurar uma instância do EFS. Você pode definir os metadados em um arquivo JSON separado ou definir os metadados como parâmetros dentro do comando.

Para definir os metadados em um arquivo JSON separado, crie um arquivo JSON semelhante ao seguinte:

Nota: Para CreationToken, use o valor de CreationToken que você gerou na etapa 3.

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

Em seguida, execute o comando start-restore-job:

Nota: Para --metadata, insira o arquivo JSON que você criou na etapa anterior.

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

Para definir os metadados como parâmetros no comando start-restore-job, execute o comando no seguinte formato:

Nota: Para CreationToken, use o valor de CreationToken que você gerou na etapa 3.

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"}'

Execute uma restauração do sistema de arquivos EFS em nível de item a partir de um ponto de recuperação do AWS Backup

1.    Execute o comando list-backup-jobs para que o nome do recurso da Amazon (ARN) do sistema de arquivos EFS seja restaurado. Você deve ter o ARN do ponto de recuperação para realizar uma restauração do sistema de arquivos EFS a partir de um ponto de recuperação do AWS Backup.

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

Nota: Se você receber erros ao executar comandos da AWS CLI, verifique se você está usando a versão mais recente da AWS CLI.

2.    Na saída do comando, observe o 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.    Para executar o comando start-restore-job, você deve definir metadados específicos para restaurar uma instância do EFS. Você pode definir os metadados em um arquivo JSON separado ou definir os metadados como parâmetros dentro do comando.

Para definir os metadados em um arquivo JSON separado, crie um arquivo JSON semelhante ao seguinte:

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

Em seguida, execute o comando 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

Para definir os metadados como parâmetros no comando start-restore-job, execute o comando no seguinte formato:

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\"]"}'

AWS OFICIAL
AWS OFICIALAtualizada há 2 anos