Systems Manager 명령 문서를 사용해 VSS 기반 스냅샷 만들기

Systems Manager 명령 문서를 사용해 VSS 기반 스냅샷 만들기 (Use Systems Manager command documents to create VSS based snapshots)

AWS Systems Manager 명령 문서를 사용해 VSS 기반 스냅샷을 만들 수 있어요. 다음 내용은 사용 가능한 명령 문서와 스냅샷을 만드는 데 문서가 사용하는 런타임 매개변수를 소개해요.

Systems Manager 명령 문서를 사용하기 전에 Windows VSS 기반 EBS 스냅샷을 만들기 위한 모든 사전 준비를 충족했는지 확인하세요.

주제 (Topics)

  • Systems Manager VSS 스냅샷 문서의 매개변수
  • Systems Manager VSS 스냅샷 명령 문서 실행

Systems Manager VSS 스냅샷 문서의 매개변수 (Parameters for Systems Manager VSS snapshot documents)

VSS 스냅샷을 만드는 Systems Manager 문서는 별도로 언급된 경우를 제외하고 모두 다음 매개변수를 사용해요:

  • AmiName (string, optional) — CreateAmi 옵션이 True로 설정된 경우 백업이 만들 AMI의 이름을 지정하세요.
  • description (string, optional) — 이 프로세스가 만드는 스냅샷 또는 이미지에 대한 설명을 지정하세요.
  • CollectDiagnosticLogs (string, optional) — 스냅샷 및 AMI 생성 단계에서 더 많은 정보를 수집하려면 이 매개변수를 "True"로 설정하세요. 이 매개변수의 기본값은 "False"예요. 통합된 진단 로그는 인스턴스의 다음 위치에 .zip 형식 보관 파일로 저장돼요: C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip
  • CopyOnly (string, optional) — 네이티브 SQL Server 백업과 함께 AWS VSS를 사용한다면 복사 전용(Copy-only) 백업을 수행하면 AWS VSS가 네이티브 차등 백업 체인을 깨뜨리지 않아요. 복사 전용 백업 작업을 수행하려면 이 매개변수를 True로 설정하세요. 이 매개변수의 기본값은 False이며, 이 경우 AWS VSS가 전체 백업 작업을 수행해요.
  • CreateAmi (string, optional) — 인스턴스를 백업하기 위해 VSS 기반 Amazon 머신 이미지(AMI)를 만들려면 이 매개변수를 True로 설정하세요. 이 매개변수의 기본값은 False이며, 이 경우 EBS 스냅샷으로 인스턴스를 백업해요. 인스턴스에서 AMI를 만드는 방법에 대한 자세한 내용은 'Amazon EBS 지원 AMI 만들기'를 참고하세요.
  • executionTimeout (string, optional) — 인스턴스에서 스냅샷 생성 프로세스를 실행하거나 인스턴스에서 AMI를 만드는 최대 시간(초)을 지정하세요. 이 시간 초과를 늘리면 명령이 VSS가 동결을 시작하고 생성하는 리소스의 태깅을 완료할 때까지 더 오래 기다릴 수 있어요. 이 시간 초과는 스냅샷 또는 AMI 생성 단계에만 적용돼요. AwsVssComponents 패키지를 설치하거나 업데이트하는 초기 단계는 시간 초과에 포함되지 않아요.
  • ExcludeBootVolume (string, optional) — 이 설정은 스냅샷을 만들 때 백업 프로세스에서 부팅 볼륨을 제외해요. 스냅샷에서 부팅 볼륨을 제외하려면 ExcludeBootVolume을 True로, CreateAmi를 False로 설정하세요. 백업에 AMI를 만드는 경우 이 매개변수는 False로 설정해야 해요. 이 매개변수의 기본값은 False예요.
  • NoWriters (string, optional) — 스냅샷 프로세스에서 애플리케이션 VSS writer를 제외하려면 이 매개변수를 True로 설정하세요. 애플리케이션 VSS writer를 제외하면 타사 VSS 백업 구성 요소와의 충돌을 해결하는 데 도움이 될 수 있어요. 이 매개변수의 기본값은 False예요. SaveVssMetadata가 True이면 이 매개변수는 False로 설정해야 해요.
  • SaveVssMetadata (string, optional) — 모든 스냅샷 중에 VSS 메타데이터 파일을 저장하려면 이 매개변수를 True로 설정하세요. 기본값은 False예요. 이러한 파일은 백업 작업에 어떤 구성 요소나 writer가 포함되었는지, 그리고 각 스냅샷의 관련 파일과 볼륨에 대한 통찰력을 제공하는 데 도움을 줘요. 메타데이터 파일은 VSS 복원 솔루션을 사용해 SQL 데이터베이스를 복원할 때 사용돼요. VSS 스냅샷에서 SQL 데이터베이스를 복원하는 방법에 대한 자세한 내용은 '자동화 런북을 사용해 AWS VSS 솔루션 스냅샷에서 데이터베이스 복원'을 참고하세요. 메타데이터 파일의 이름에는 관련 스냅샷 세트 ID가 포함돼요. 인스턴스에서 다음 위치에서 찾을 수 있어요:
C:\ProgramData\Amazon\AwsVss\VssMetadata\

경고

  • VSS 메타데이터 파일 저장에는 AwsVssComponents 패키지 버전 2.4.0 이상이 필요해요. 인스턴스에 이전 버전이 설치되어 있다면 SaveVssMetadata를 True로 설정하면 스냅샷 생성이 실패해요.
  • NoWriters 및 SaveVssMetadata 매개변수는 상호 배타적이에요. 둘 다 True로 설정하면 스냅샷 생성이 실패해요.
  • tags (string, optional) — 스냅샷과 이미지에 태그를 지정해 리소스를 찾고 관리하는 데 도움을 줄 것을 권장해요. 예를 들어 스냅샷 목록에서 볼륨을 복원할 수 있어요. 시스템은 Name 키를 빈 값과 함께 추가하며, 여기에 출력 스냅샷이나 이미지에 적용할 이름을 지정할 수 있어요. 추가 태그를 지정하려면 태그를 세미콜론으로 구분하세요. 예: Key=Environment,Value=Test;Key=User,Value=TestUser1.

참고 태그 키와 값은 영숫자 문자와 다음 특수 문자만 포함해야 해요: () ./\-"'@_+:={}. 기본적으로 시스템은 VSS 기반 스냅샷과 이미지에 대해 다음 예약 태그를 추가해요.

  • Device — VSS 기반 스냅샷의 경우 스냅샷이 캡처하는 EBS 볼륨의 디바이스 이름.
  • AppConsistent — 이 태그는 VSS 기반 스냅샷 또는 AMI의 성공적인 생성을 나타내요.
  • AwsVssConfig — VSS가 활성화된 스냅샷과 AMI를 식별해요. 태그에는 AwsVssComponents 버전 및 스냅샷 세트 ID 같은 메타 정보가 포함돼요.

경고 매개변수 목록에서 이러한 예약 태그 중 하나를 지정하면 오류가 발생해요.

  • VssVersion (string, optional) — AWSEC2-VssInstallAndSnapshot 문서에만 해당하며, VssVersion 매개변수를 지정해 인스턴스에 특정 버전의 AwsVssComponents 패키지를 설치할 수 있어요. 이 매개변수를 비워 두면 권장 기본 버전이 설치돼요. 지정된 버전의 AwsVssComponents 패키지가 이미 설치되어 있다면 스크립트는 설치 단계를 건너뛰고 백업 단계로 진행해요. AwsVssComponents 패키지 버전 목록과 운영 체제 지원은 'AWS VSS 솔루션 버전 기록'을 참고하세요.

Systems Manager VSS 스냅샷 명령 문서 실행 (Run Systems Manager VSS snapshot command documents)

다음과 같이 AWS Systems Manager 명령 문서를 사용해 VSS 기반 EBS 스냅샷을 만들 수 있어요.

AWS Systems Manager로 AWSEC2-VssInstallAndSnapshot 문서를 실행하면 스크립트가 다음 단계를 실행해요.

  • 스크립트는 먼저 인스턴스에 AwsVssComponents 패키지를 설치하거나 업데이트해요(이미 설치되어 있는지에 따라 다름).
  • 첫 번째 단계가 완료된 후 스크립트는 애플리케이션 일치(application-consistent) 스냅샷을 만들어요.

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

콘솔 (Console)

콘솔에서 VSS 기반 EBS 스냅샷 만들기:

  • AWS Systems Manager 콘솔(https://console.aws.amazon.com/systems-manager/)을 엽니다.
  • 탐색 창에서 Run Command를 선택하세요. 이렇게 하면 계정에서 현재 실행 중인 명령 목록이 표시돼요(해당하는 경우).
  • Run command를 선택하세요. 이렇게 하면 액세스할 수 있는 명령 문서 목록이 열려요.
  • 명령 문서 목록에서 AWSEC2-VssInstallAndSnapshot을 선택하세요. 결과를 간소화하려면 문서 이름의 전체 또는 일부를 입력할 수 있어요. 소유자, 플랫폼 유형, 태그로 필터링할 수도 있어요. 명령 문서를 선택하면 목록 아래에 세부 정보가 표시돼요.
  • 문서 버전 목록에서 런타임 시 기본 버전(Default version at runtime)을 선택하세요.
  • 명령 매개변수(Command parameters)를 구성해 AWSEC2-VssInstallAndSnapshot이 AwsVssComponents 패키지를 설치하고 VSS 스냅샷 또는 AMI로 백업하는 방식을 정의하세요. 매개변수 세부 정보는 Systems Manager VSS 스냅샷 문서의 매개변수를 참고하세요.
  • 대상 선택(Target selection)에 대해 이 작업을 실행할 인스턴스를 식별하도록 태그를 지정하거나 인스턴스를 수동으로 선택하세요.

참고 인스턴스를 수동으로 선택했는데 목록에 있어야 할 인스턴스가 포함되어 있지 않다면 문제 해결 팁은 '내 인스턴스는 어디에 있나요?'를 참고하세요.

  • Rate control 같은 Systems Manager Run Command 동작을 정의하는 추가 매개변수는 '콘솔에서 명령 실행'에 설명된 대로 값을 입력하세요.
  • 실행(Run)을 선택하세요.
  • 성공하면 명령이 새 스냅샷으로 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 스냅샷을 만들고 출력 생성의 현재 런타임 상태를 가져올 수 있어요. 스냅샷 프로세스의 동작을 수정하려면 앞선 목록에 설명된 매개변수를 지정하세요.

Tools for 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 스냅샷 만들기:

  • AWS Systems Manager 콘솔(https://console.aws.amazon.com/systems-manager/)을 엽니다.
  • 탐색 창에서 Run Command를 선택하세요. 이렇게 하면 계정에서 현재 실행 중인 명령 목록이 표시돼요(해당하는 경우).
  • Run command를 선택하세요. 이렇게 하면 액세스할 수 있는 명령 문서 목록이 열려요.
  • 명령 문서 목록에서 AWSEC2-CreateVssSnapshot을 선택하세요. 결과를 간소화하려면 문서 이름의 전체 또는 일부를 입력할 수 있어요. 소유자, 플랫폼 유형, 태그로 필터링할 수도 있어요. 명령 문서를 선택하면 목록 아래에 세부 정보가 표시돼요.
  • 문서 버전 목록에서 런타임 시 기본 버전(Default version at runtime)을 선택하세요.
  • 명령 매개변수(Command parameters)를 구성해 AWSEC2-CreateVssSnapshot이 VSS 스냅샷 또는 AMI로 백업하는 방식을 정의하세요. 매개변수 세부 정보는 Systems Manager VSS 스냅샷 문서의 매개변수를 참고하세요.
  • 대상 선택(Target selection)에 대해 이 작업을 실행할 인스턴스를 식별하도록 태그를 지정하거나 인스턴스를 수동으로 선택하세요.

참고 인스턴스를 수동으로 선택했는데 목록에 있어야 할 인스턴스가 포함되어 있지 않다면 문제 해결 팁은 '내 인스턴스는 어디에 있나요?'를 참고하세요.

  • Rate control 같은 Systems Manager Run Command 동작을 정의하는 추가 매개변수는 '콘솔에서 명령 실행'에 설명된 대로 값을 입력하세요.
  • 실행(Run)을 선택하세요.
  • 성공하면 명령이 새 스냅샷으로 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 스냅샷을 만들 수 있어요.

Tools for 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 사용 설명서의 '유지 관리 창 작업(콘솔)'을 참고하세요.

더 알아보기 (Learn more)