Systems Manager 명령 문서를 사용하여 VSS 기반 스냅샷 생성 - Amazon Elastic Compute Cloud
Systems Manager VSS 스냅샷 문서의 파라미터Systems Manager VSS 스냅샷 명령 문서 실행

Systems Manager 명령 문서를 사용하여 VSS 기반 스냅샷 생성

AWS Systems Manager 명령 문서를 사용하여 VSS 기반 스냅샷을 생성할 수 있습니다. 다음 콘텐츠에서는 사용 가능한 명령 문서 및 해당 문서에서 스냅샷을 생성하는 데 사용하는 런타임 파라미터를 소개합니다.

Systems Manager 명령 문서를 사용하기 전에 모든 Windows VSS 기반 EBS 스냅샷을 생성하기 위한 사전 조건을 충족하는지 확인합니다.

Systems Manager VSS 스냅샷 문서의 파라미터

VSS 스냅샷을 생성하는 Systems Manager 문서는 별도로 명시된 경우를 제외하고 다음 파라미터를 모두 사용합니다.

AmiName(문자열, 선택 사항)

CreateAmi 옵션이 True로 설정된 경우 백업에서 생성되는 AMI의 이름을 지정합니다.

description(문자열, 선택 사항)

이 프로세스에서 생성되는 스냅샷 또는 이미지에 대한 설명을 지정합니다.

CollectDiagnosticLogs(문자열, 선택 사항)

스냅샷 및 AMI 생성 단계에서 추가 정보를 수집하려면 이 파라미터를 “True“로 설정합니다. 이 파라미터의 기본값은 “False“입니다. 통합 진단 로그는 인스턴스의 다음 위치에 .zip 형식 아카이브로 저장됩니다.

C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip

CopyOnly(문자열, 선택 사항)

AWS VSS 외에 기본 SQL Server 백업을 사용하는 경우 복사 전용 백업을 수행하면 AWS VSS가 기본 차등 백업 체인을 끊지 않습니다. 복사 전용 백업 작업을 수행하려면 이 파라미터를 True로 설정합니다.

이 파라미터의 기본값은 False이며, 이 값을 지정하면 AWS VSS에서 전체 백업 작업을 수행합니다.

CreateAmi(문자열, 선택 사항)

인스턴스를 백업하기 위해 VSS 기반 Amazon Machine Image(AMI)를 생성하려면 이 파라미터를 True로 설정합니다. 이 파라미터의 기본값은 False이며, 이 값을 지정하면 대신 EBS 스냅샷으로 인스턴스가 백업됩니다.

인스턴스에서 AMI 생성하기에 대한 자세한 내용은 Amazon EBS 지원 AMI 생성 섹션을 참조하세요.

executionTimeout(문자열, 선택 사항)

인스턴스에서 스냅샷 생성 프로세스를 실행하거나 인스턴스에서 AMI를 생성하는 최대 시간(초)을 지정합니다. 이 제한 시간을 늘리면 VSS가 동결을 시작하고 생성된 리소스의 태그 지정을 완료할 때까지 명령이 더 오래 기다릴 수 있습니다. 이 제한 시간은 스냅샷 또는 AMI 생성 단계에만 적용됩니다. AwsVssComponents 패키지를 설치하거나 업데이트하는 초기 단계는 제한 시간에 포함되지 않습니다.

ExcludeBootVolume(문자열, 선택 사항)

이 설정은 스냅샷을 생성하는 경우 백업 프로세스에서 부팅 볼륨을 제외합니다. 스냅샷에서 부팅 볼륨을 제외하려면 ExcludeBootVolume을 True로 설정하고 CreateAmi를 False로 설정합니다.

백업용 AMI를 생성하는 경우 이 파라미터를 False로 설정해야 합니다. 이 파라미터의 기본값은 False입니다.

NoWriters(문자열, 선택 사항)

스냅샷 프로세스에서 애플리케이션 VSS 작성자를 제외하려면 이 파라미터를 True로 설정합니다. 애플리케이션 VSS 작성자를 제외하면 타사 VSS 백업 구성 요소와의 갈등을 해결하는 데 도움이 될 수 있습니다. 이 파라미터의 기본값은 False입니다.

SaveVssMetadata가 True인 경우 파라미터를 False로 설정해야 합니다.

SaveVssMetadata(문자열, 선택 사항)

모든 스냅샷 중에 VSS 메타데이터 파일을 저장하려면 이 파라미터를 True로 설정하세요. 기본값은 False입니다. VSS 메타데이터 파일은 백업 작업에 포함된 구성 요소 또는 작성자와 각 구성 요소의 관련 파일에 대한 인사이트를 제공하는 데 도움이 됩니다.

메타데이터 파일 이름에는 연결된 스냅샷 세트 ID가 있으며 이는 인스턴스의 다음 위치에서 찾을 수 있습니다.

C:\ProgramData\Amazon\AwsVss\VssMetadata\
주의

  • VSS 메타데이터 파일을 저장하려면 AwsVssComponents 패키지 버전 2.4.0 이상이 필요합니다. 인스턴스에 이전 버전이 설치되어 있는 경우 SaveVssMetadata를 True로 설정하면 스냅샷 생성이 실패합니다.

  • NoWriters 파라미터와 SaveVssMetadata 파라미터는 함께 사용할 수 없습니다. 둘 다 True로 설정하면 스냅샷 생성이 실패합니다.

tags(문자열, 선택 사항)

리소스를 찾고 관리하는 데 도움이 되도록 스냅샷과 이미지에 태그를 지정하는 것이 좋습니다(예: 스냅샷 목록에서 볼륨을 복원하는 경우). 시스템은 출력 스냅샷 또는 이미지에 적용할 이름을 지정할 수 있는 빈 값과 함께 Name 키를 추가합니다.

태그를 추가로 지정하려면 세미콜론을 사용해 태그를 구분합니다. 예: Key=Environment,Value=Test;Key=User,Value=TestUser1.

기본적으로 시스템은 VSS 기반 스냅샷 및 이미지에 대해 다음과 같은 예약된 태그를 추가합니다.

  • 디바이스 - VSS 기반 스냅샷의 경우 스냅샷이 캡처하는 EBS 볼륨의 디바이스 이름입니다.

  • AppConsistent - 이 태그는 VSS 기반 스냅샷 또는 AMI를 생성했음을 나타냅니다.

  • AwsVssConfig - VSS가 활성화된 상태로 생성된 스냅샷 및 AMI를 식별합니다. 태그에는 AwsVssComponents 버전 및 스냅샷 세트 ID와 같은 메타 정보가 포함됩니다.

주의

파라미터 목록에 이러한 예약된 태그를 지정하면 오류가 발생합니다.

VssVersion(문자열, 선택 사항)

AWSEC2-VssInstallAndSnapshot 문서의 경우에만 VssVersion 파라미터를 지정하여 인스턴스에 특정 버전의 AwsVssComponents 패키지를 설치할 수 있습니다. 권장 기본 버전을 설치하려면 이 파라미터를 비워 둡니다.

지정된 버전의 AwsVssComponents 패키지가 이미 설치된 경우 스크립트는 설치 단계를 건너뛰고 백업 단계로 이동합니다. AwsVssComponents 패키지 버전 및 운영 지원 목록은 AWS VSS 솔루션 버전 기록 섹션을 참조하세요.

Systems Manager VSS 스냅샷 명령 문서 실행

다음과 같이 AWS Systems Manager 명령 문서를 사용하여 VSS 기반 EBS 스냅샷을 생성할 수 있습니다.

AWS Systems Manager를 사용하여 AWSEC2-VssInstallAndSnapshot 문서를 실행하면 스크립트는 다음 단계를 실행합니다.

  1. 스크립트는 먼저 AwsVssComponents 패키지가 이미 설치되어 있는지 여부에 따라 인스턴스에 이 패키지를 설치하거나 업데이트합니다.

  2. 스크립트는 첫 번째 단계가 완료된 후 애플리케이션에 일관되게 적용되는 스냅샷을 생성합니다.

AWSEC2-VssInstallAndSnapshot 문서를 실행하려면 원하는 환경에 맞는 단계를 따르세요.

Console
콘솔에서 VSS 기반 EBS 스냅샷 생성

  1. AWS Systems Manager 콘솔(https://console.aws.amazon.com/systems-manager/)을 엽니다.

  2. 탐색 창에서 Run Command를 선택합니다. 해당하는 경우 계정에서 현재 실행 중인 명령 목록이 표시됩니다.

  3. Run command(Run 명령)를 선택합니다. 액세스할 수 있는 명령 문서 목록이 열립니다.

  4. 명령 문서 목록에서 AWSEC2-VssInstallAndSnapshot을 선택합니다. 결과를 간소화하기 위해 문서 이름 전체 또는 일부를 입력할 수 있습니다. 소유자, 플랫폼 유형 또는 태그로 필터링할 수도 있습니다.

    명령 문서를 선택하면 목록 아래에 세부 정보가 채워집니다.

  5. 문서 버전 목록에서 Default version at runtime을 선택합니다.

  6. 명령 파라미터를 구성하여 AWSEC2-VssInstallAndSnapshot이 AwsVssComponents 패키지를 설치하고 VSS 스냅샷 또는 AMI를 사용하여 백업하는 방법을 정의합니다. 파라미터 세부 정보는 Systems Manager VSS 스냅샷 문서의 파라미터 섹션을 참조하세요.

  7. 대상 선택에서 태그를 지정하거나 인스턴스를 수동으로 선택하여 이 작업을 실행할 인스턴스를 식별합니다.

    참고

    인스턴스를 수동으로 선택할 때 예상한 인스턴스가 목록에 없는 경우 내 인스턴스는 어디에 있나요?에서 문제 해결 팁을 확인하세요.

  8. 속도 제어와 같은 Systems Manager Run Command 동작을 정의하는 추가 파라미터에 대해 콘솔에서 명령 실행에 설명된 대로 값을 입력합니다.

  9. 실행을 선택합니다.

    성공적으로 실행되면 명령은 EBS 스냅샷 목록에 새로운 스냅샷을 입력합니다. 지정한 태그를 검색하거나 AppConsistent를 검색하여 EBS 스냅샷 목록에서 이 스냅샷을 찾을 수 있습니다. 명령 실행에 실패하면 Systems Manager 명령 출력을 보고 명령이 실패한 이유에 대한 세부 정보를 확인합니다. 명령이 성공적으로 완료되었지만 특정 볼륨의 백업이 실패한 경우 EBS 볼륨 목록에서 문제를 해결할 수 있습니다.

AWS CLI

AWS CLI에서 다음 명령을 실행하여 VSS 기반 EBS 스냅샷을 생성하고 스냅샷 생성 상태를 가져올 수 있습니다.

VSS 기반 EBS 스냅샷 생성

다음 명령을 실행하여 VSS 기반 EBS 스냅샷을 생성합니다. 스냅샷을 생성하려면 --instance-ids 파라미터로 인스턴스를 식별해야 합니다. 추가할 수 있는 다른 파라미터에 대한 자세한 내용은 Systems Manager VSS 스냅샷 문서의 파라미터 섹션을 참조하세요.

aws ssm send-command \
	--document-name "AWSEC2-VssInstallAndSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"],"VssVersion":[""]}'

성공적으로 실행되면 명령 문서에서 EBS 스냅샷 목록을 새로운 스냅샷으로 채웁니다. 지정한 태그를 검색하거나 AppConsistent를 검색하여 EBS 스냅샷 목록에서 이 스냅샷을 찾을 수 있습니다. 명령 실행에 실패하면 명령 출력을 보고 명령이 실패한 이유에 대한 세부 정보를 확인합니다.

명령 상태 가져오기

스냅샷의 현재 상태를 확인하려면 send-command에서 반환된 명령 ID를 사용하여 다음 명령을 실행합니다.

aws ssm get-command-invocation
	--instance-ids "i-01234567890abcdef" \
	--command-id "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
	--plugin-name "CreateVssSnapshot"
PowerShell

AWS Tools for Windows PowerShell에서 다음 명령을 실행하여 VSS 기반 EBS 스냅샷을 생성하고 출력 생성에 대한 현재 런타임 상태를 확인합니다. 이전 목록에 설명된 파라미터를 지정하여 스냅샷 프로세스의 동작을 수정합니다.

Windows PowerShell용 도구로 VSS 기반 EBS 스냅샷 생성

다음 명령을 실행하여 VSS 기반 EBS 스냅샷 또는 AMI를 생성합니다.

Send-SSMCommand -DocumentName "AWSEC2-VssInstallAndSnapshot" -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value';'VssVersion'=''}
명령 상태 가져오기

스냅샷의 현재 상태를 확인하려면 Send-SSMCommand에서 반환된 명령 ID를 사용하여 다음 명령을 실행합니다.

Get-SSMCommandInvocationDetail -InstanceId "i-01234567890abcdef" -CommandId "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" -PluginName "CreateVssSnapshot"

성공적으로 실행되면 명령은 EBS 스냅샷 목록에 새로운 스냅샷을 입력합니다. 지정한 태그를 검색하거나 AppConsistent를 검색하여 EBS 스냅샷 목록에서 이 스냅샷을 찾을 수 있습니다. 명령 실행에 실패하면 명령 출력을 보고 명령이 실패한 이유에 대한 세부 정보를 확인합니다.

AWSEC2-CreateVssSnapshot 문서를 실행하려면 원하는 환경에 맞는 단계를 따르세요.

Console
콘솔에서 VSS 기반 EBS 스냅샷 생성

  1. AWS Systems Manager 콘솔(https://console.aws.amazon.com/systems-manager/)을 엽니다.

  2. 탐색 창에서 Run Command를 선택합니다. 해당하는 경우 계정에서 현재 실행 중인 명령 목록이 표시됩니다.

  3. Run command(Run 명령)를 선택합니다. 액세스할 수 있는 명령 문서 목록이 열립니다.

  4. 명령 문서 목록에서 AWSEC2-CreateVssSnapshot을 선택합니다. 결과를 간소화하기 위해 문서 이름 전체 또는 일부를 입력할 수 있습니다. 소유자, 플랫폼 유형 또는 태그로 필터링할 수도 있습니다.

    명령 문서를 선택하면 목록 아래에 세부 정보가 채워집니다.

  5. 문서 버전 목록에서 Default version at runtime을 선택합니다.

  6. AWSEC2-CreateVssSnapshot을 통해 VSS 스냅샷 또는 AMI에서 백업하는 방법을 정의하도록 명령 파라미터를 구성합니다. 파라미터 세부 정보는 Systems Manager VSS 스냅샷 문서의 파라미터 섹션을 참조하세요.

  7. 대상 선택에서 태그를 지정하거나 인스턴스를 수동으로 선택하여 이 작업을 실행할 인스턴스를 식별합니다.

    참고

    인스턴스를 수동으로 선택할 때 예상한 인스턴스가 목록에 없는 경우 내 인스턴스는 어디에 있나요?에서 문제 해결 팁을 확인하세요.

  8. 속도 제어와 같은 Systems Manager Run Command 동작을 정의하는 추가 파라미터에 대해 콘솔에서 명령 실행에 설명된 대로 값을 입력합니다.

  9. 실행을 선택합니다.

    성공적으로 실행되면 명령은 EBS 스냅샷 목록에 새로운 스냅샷을 입력합니다. 지정한 태그를 검색하거나 AppConsistent를 검색하여 EBS 스냅샷 목록에서 이 스냅샷을 찾을 수 있습니다. 명령 실행에 실패하면 Systems Manager 명령 출력을 보고 명령이 실패한 이유에 대한 세부 정보를 확인합니다. 명령이 성공적으로 완료되었지만 특정 볼륨의 백업이 실패한 경우 EBS 볼륨 목록에서 문제를 해결할 수 있습니다.

AWS CLI

AWS CLI에서 다음 명령을 실행하여 VSS 기반 EBS 스냅샷을 생성합니다.

VSS 기반 EBS 스냅샷 생성

다음 명령을 실행하여 VSS 기반 EBS 스냅샷을 생성합니다. 스냅샷을 생성하려면 --instance-ids 파라미터로 인스턴스를 식별해야 합니다. 추가할 수 있는 다른 파라미터에 대한 자세한 내용은 Systems Manager VSS 스냅샷 문서의 파라미터 섹션을 참조하세요.

aws ssm send-command \
	--document-name "AWSEC2-CreateVssSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"]}'

성공적으로 실행되면 명령 문서에서 EBS 스냅샷 목록을 새로운 스냅샷으로 채웁니다. 지정한 태그를 검색하거나 AppConsistent를 검색하여 EBS 스냅샷 목록에서 이 스냅샷을 찾을 수 있습니다. 명령 실행에 실패하면 명령 출력을 보고 명령이 실패한 이유에 대한 세부 정보를 확인합니다.

PowerShell

AWS Tools for Windows PowerShell에서 다음 명령을 실행하여 VSS 기반 EBS 스냅샷을 생성합니다.

Windows PowerShell용 도구로 VSS 기반 EBS 스냅샷 생성

다음 명령을 실행하여 VSS 기반 EBS 스냅샷을 생성합니다. 스냅샷을 생성하려면 InstanceId 파라미터로 인스턴스를 식별해야 합니다. 스냅샷을 생성할 인스턴스를 둘 이상 지정할 수 있습니다. 추가할 수 있는 다른 파라미터에 대한 자세한 내용은 Systems Manager VSS 스냅샷 문서의 파라미터 섹션을 참조하세요.

Send-SSMCommand -DocumentName AWSEC2-CreateVssSnapshot -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value'}

성공적으로 실행되면 명령은 EBS 스냅샷 목록에 새로운 스냅샷을 입력합니다. 지정한 태그를 검색하거나 AppConsistent를 검색하여 EBS 스냅샷 목록에서 이 스냅샷을 찾을 수 있습니다. 명령 실행에 실패하면 명령 출력을 보고 명령이 실패한 이유에 대한 세부 정보를 확인합니다. 명령이 성공적으로 완료되었지만 특정 볼륨의 백업이 실패한 경우 EBS 스냅샷 목록에서 문제를 해결할 수 있습니다.

이전 섹션에서 설명한 모든 명령줄 절차를 사용하여 VSS 기반 스냅샷을 생성할 수 있습니다. 명령 문서(AWSEC2-VssInstallAndSnapshot 또는 AWSEC2-CreateVssSnapshot)는 클러스터의 프라이머리 노드에서 실행되어야 합니다. 보조 노드에서는 공유 디스크에 대한 액세스가 없으므로 문서가 실패합니다. 프라이머리 노드와 보조 노드가 동적으로 변경되는 경우 명령이 프라이머리 노드에서는 성공하고 보조 노드에서는 실패할 것으로 예상하면서 여러 노드에서 AWS Systems Manager Run Command 문서를 실행할 수 있습니다.

참고

백업을 자동화하려면 AWSEC2-VssInstallAndSnapshot 문서를 사용하는 AWS Systems Manager 유지 관리 기간 작업을 생성하여 할 수 있습니다. 자세한 내용은 AWS Systems Manager 사용 설명서에서 유지 관리 기간 작업(콘솔)을 참조하세요.