AWS Systems Manager
사용 설명서

콘솔에서 명령 실행

콘솔에서 Run Command를 사용하여 각 인스턴스에 로그인하지 않고도 인스턴스를 구성할 수 있습니다. 이 단원에서는 Run Command를 사용하여 인스턴스에서 SSM 에이전트를 업데이트하는 방법을 보여주는 예제를 제공합니다.

시작하기 전에

Run Command를 사용하여 명령을 전송하기 전에 인스턴스가 Systems Manager 요구 사항을 충족하는지 확인합니다.

Run Command를 사용하여 명령을 전송하려면

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

  2. 탐색 창에서 Run Command를 선택합니다.

    -또는-

    AWS Systems Manager 홈 페이지를 처음 열면 메뉴 아이콘( )을 선택하여 탐색 창을 연 다음 Run Command를 선택합니다.

  3. 명령 문서 목록에서 Systems Manager 문서를 선택합니다.

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

    참고

    인스턴스를 수동으로 선택할 생각인데 예상한 인스턴스가 목록에 없으면 제 인스턴스는 어디에 있나요?에서 문제 해결 팁을 확인하십시오.

  5. 명령 파라미터 섹션에서 필요한 파라미터의 값을 지정합니다.

  6. 다른 파라미터:

    • 설명에는 명령에 대한 정보를 입력합니다.

    • 제한 시간(초)에서 전체 명령 실행이 실패할 때까지 시스템이 기다리는 시간을 초 단위로 지정합니다.

  7. (선택 사항) 속도 제어:

    • 동시성에서 명령을 동시에 실행할 인스턴스의 백분율 또는 개수를 지정합니다.

      참고

      관리형 인스턴스에 적용할 태그를 지정하거나, AWS 리소스 그룹을 지정하여 대상을 선택하였지만 대상으로 지정할 인스턴스 수를 잘 모를 경우에는 백분율을 지정하여 동시에 문서를 실행할 수 있는 인스턴스 수를 제한하십시오.

    • 오류 임계값에서, 명령이 인스턴스의 개수 또는 백분율에서 실패한 후 다른 인스턴스에서 해당 명령의 실행을 중지할 시간을 지정합니다. 예를 들어 세 오류를 지정하면 네 번째 오류를 받았을 때 Systems Manager가 명령 전송을 중지합니다. 여전히 명령을 처리 중인 인스턴스도 오류를 전송할 수 있습니다.

  8. 출력 옵션 섹션에서, 명령 출력을 파일에 저장하려면 명령 출력을 Amazon S3 버킷에 쓰기를 선택합니다. 텍스트 상자에 버킷 및 접두사(폴더) 이름을 입력합니다.

    참고

    데이터를 S3 버킷에 쓰는 기능을 부여하는 S3 권한은 이 작업을 수행하는 IAM 사용자의 권한이 아닌 인스턴스에 할당된 인스턴스 프로파일의 권한입니다. 자세한 내용은 Systems Manager에 대한 IAM 인스턴스 프로파일 만들기를 참조하십시오.

  9. SNS 알림 섹션에서, 명령 실행 상태에 대한 알림이 전송되도록 하려면 SNS 알림 활성화 확인란을 선택합니다.

    Run Command에 대해 Amazon SNS 알림을 구성하는 방법에 대한 자세한 내용은 AWS Systems Manager에 대한 Amazon SNS 알림 구성 단원을 참조하십시오.

  10. 실행을 선택합니다.

명령을 취소하는 방법에 대한 자세한 정보는 명령 취소 단원을 참조하십시오.

Run Command를 사용하여 SSM 에이전트 업데이트

다음 절차에서는 Windows 및 Linux 인스턴스에서 실행 중인 SSM 에이전트를 빠르게 업데이트하는 방법을 설명합니다. 최신 버전으로 업데이트하거나 이전 버전으로 다운그레이드할 수 있습니다. 명령을 실행하면 시스템은 AWS에서 버전을 다운로드하여 설치한 다음, 명령을 실행하기 이전에 있었던 버전을 제거합니다. 이 프로세스 중에 오류가 발생하면, 서버에서 명령을 실행하기 이전의 버전으로 롤백하며 명령 상태에 명령이 실패했다고 표시됩니다.

참고

SSM 에이전트 업데이트에 대해 알림을 수신하려면 GitHub에서 SSM 에이전트 출시 정보 페이지를 구독합니다.

Run Command를 사용하여 SSM 에이전트를 업데이트하려면

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

  2. 탐색 창에서 Run Command를 선택합니다.

    -또는-

    AWS Systems Manager 홈 페이지를 처음 열면 메뉴 아이콘( )을 선택하여 탐색 창을 연 다음 Run Command를 선택합니다.

  3. 명령 문서 목록에서 AWS-UpdateSSMAgent를 선택합니다.

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

    참고

    인스턴스를 수동으로 선택할 생각인데 예상한 인스턴스가 목록에 없으면 제 인스턴스는 어디에 있나요?에서 문제 해결 팁을 확인하십시오.

  5. 명령 파라미터 섹션에서, 원하는 경우 다음 파라미터의 값을 지정합니다.

    1. (선택 사항) 설치할 SSM 에이전트의 버전을 버전에 입력합니다. 이전 버전의 에이전트를 설치할 수 있습니다. 버전을 지정하지 않으면 최신 버전으로 설치됩니다.

    2. (선택 사항) 이전 버전의 SSM 에이전트를 설치하려면 Allow Downgrade(다운그레이드 허용)에서 true를 선택합니다. 이 옵션을 선택하는 경우 이전 버전 번호를 지정해야 합니다. 최신 서비스 버전을 설치하려면 false를 선택합니다.

  6. 다른 파라미터:

    • 설명에는 명령에 대한 정보를 입력합니다.

    • 제한 시간(초)에서 전체 명령 실행이 실패할 때까지 시스템이 기다리는 시간을 초 단위로 지정합니다.

  7. (선택 사항) 속도 제어:

    • 동시성에서 명령을 동시에 실행할 인스턴스의 백분율 또는 개수를 지정합니다.

      참고

      관리형 인스턴스에 적용할 태그를 지정하거나, AWS 리소스 그룹을 지정하여 대상을 선택하였지만 대상으로 지정할 인스턴스 수를 잘 모를 경우에는 백분율을 지정하여 동시에 문서를 실행할 수 있는 인스턴스 수를 제한하십시오.

    • 오류 임계값에서, 명령이 인스턴스의 개수 또는 백분율에서 실패한 후 다른 인스턴스에서 해당 명령의 실행을 중지할 시간을 지정합니다. 예를 들어 세 오류를 지정하면 네 번째 오류를 받았을 때 Systems Manager가 명령 전송을 중지합니다. 여전히 명령을 처리 중인 인스턴스도 오류를 전송할 수 있습니다.

  8. 출력 옵션 섹션에서, 명령 출력을 파일에 저장하려면 명령 출력을 Amazon S3 버킷에 쓰기를 선택합니다. 텍스트 상자에 버킷 및 접두사(폴더) 이름을 입력합니다.

    참고

    데이터를 S3 버킷에 쓰는 기능을 부여하는 S3 권한은 이 작업을 수행하는 IAM 사용자의 권한이 아닌 인스턴스에 할당된 인스턴스 프로파일의 권한입니다. 자세한 내용은 Systems Manager에 대한 IAM 인스턴스 프로파일 만들기를 참조하십시오.

  9. SNS 알림 섹션에서, 명령 실행 상태에 대한 알림이 전송되도록 하려면 SNS 알림 활성화 확인란을 선택합니다.

    Run Command에 대해 Amazon SNS 알림을 구성하는 방법에 대한 자세한 내용은 AWS Systems Manager에 대한 Amazon SNS 알림 구성 단원을 참조하십시오.

  10. 실행을 선택합니다.