특정 문서 버전을 사용하여 명령 실행 - AWS Systems Manager

특정 문서 버전을 사용하여 명령 실행

문서 버전 파라미터를 사용하여 명령 실행 시 사용할 AWS Systems Manager 문서 버전을 지정할 수 있습니다. 이 파라미터에는 다음 옵션 중 하나를 지정할 수 있습니다.

  • $DEFAULT

  • $LATEST

  • 버전 번호

문서 버전 파라미터를 실행하여 명령을 실행하려면 다음 절차를 사용합니다.

Linux
로컬 Linux 시스템에서 AWS CLI를 사용하여 명령을 실행하려면

  1. 아직 하지 않은 경우 AWS Command Line Interface(AWS CLI)를 설치하고 구성합니다.

    자세한 내용은 최신 버전의 AWS CLI 설치 또는 업데이트를 참조하세요.

  2. 사용할 수 있는 모든 문서 나열

    이 명령을 실행하면 AWS Identity and Access Management(IAM) 권한에 따라 계정에 사용할 수 있는 문서를 모두 나열합니다.

    aws ssm list-documents

  3. 다음 명령을 실행하여 문서의 여러 버전을 확인합니다. document name을 사용자의 정보로 바꿉니다.

    aws ssm list-document-versions \
    --name "document name"

  4. 다음 명령을 실행하여 SSM 문서 버전을 사용하는 명령을 실행합니다. 각 example resource placeholder를 사용자의 정보로 바꿉니다.

    aws ssm send-command \
    --document-name "AWS-RunShellScript" \
    --parameters commands="echo Hello" \
    --instance-ids instance-ID \
    --document-version '$LATEST'
Windows
로컬 Windows 시스템에서 AWS CLI를 사용하여 명령을 실행하려면

  1. 아직 하지 않은 경우 AWS Command Line Interface(AWS CLI)를 설치하고 구성합니다.

    자세한 내용은 최신 버전의 AWS CLI 설치 또는 업데이트를 참조하세요.

  2. 사용할 수 있는 모든 문서 나열

    이 명령을 실행하면 AWS Identity and Access Management(IAM) 권한에 따라 계정에 사용할 수 있는 문서를 모두 나열합니다.

    aws ssm list-documents

  3. 다음 명령을 실행하여 문서의 여러 버전을 확인합니다. document name을 사용자의 정보로 바꿉니다.

    aws ssm list-document-versions ^
    --name "document name"

  4. 다음 명령을 실행하여 SSM 문서 버전을 사용하는 명령을 실행합니다. 각 example resource placeholder를 사용자의 정보로 바꿉니다.

    aws ssm send-command ^
    --document-name "AWS-RunShellScript" ^
    --parameters commands="echo Hello" ^
    --instance-ids instance-ID ^
    --document-version "$LATEST"
PowerShell
Tools for PowerShell을 사용하여 명령을 실행하려면

  1. 아직 설치하지 않은 경우 AWS Tools for PowerShell(Tools for Windows PowerShell)을 설치하고 구성합니다.

    자세한 내용은 AWS Tools for PowerShell 설치를 참조하세요.

  2. 사용할 수 있는 모든 문서 나열

    이 명령을 실행하면 AWS Identity and Access Management(IAM) 권한에 따라 계정에 사용할 수 있는 문서를 모두 나열합니다.

    Get-SSMDocumentList

  3. 다음 명령을 실행하여 문서의 여러 버전을 확인합니다. document name을 사용자의 정보로 바꿉니다.

    Get-SSMDocumentVersionList `
    -Name "document name"

  4. 다음 명령을 실행하여 SSM 문서 버전을 사용하는 명령을 실행합니다. 각 example resource placeholder를 사용자의 정보로 바꿉니다.

    Send-SSMCommand `
    -DocumentName "AWS-RunShellScript" `
    -Parameter @{commands = "echo helloWorld"} `
    -InstanceIds "instance-ID" `
    -DocumentVersion $LATEST