(선택 사항) Session Manager Plugin 에 대해 AWS CLI - AWS 시스템 관리자

문서의 영문과 번역 사이에 충돌이 있는 경우에는 영문 버전을 따릅니다. 번역 버전은 기계 번역을 사용하여 제공합니다.

(선택 사항) Session Manager Plugin 에 대해 AWS CLI

사용하고자 하는 경우 AWS CLI 세션을 시작하고 종료하여 먼저 Session Manager plugin 로컬 시스템에서. 더 플러그인은 지원되는 버전의 Microsoft Windows, macOS, Linux, 및 Ubuntu Server.

최신 버전 사용 Session Manager Plugin

플러그인은 기능이 향상되어 업데이트되는 경우가 있습니다. 다음을 권장합니다. 최신 버전의 플러그인을 정기적으로 사용하고 있는지 확인합니다. 대상 자세한 내용은 Session Manager Plugin 최신 버전 및 릴리스 역사.

설치 전제 조건

AWS CLI 버전 1.16.12 또는 이후 버전이 로컬 기계에 연결한 후 Session Manager plugin.

설치 Session Manager Plugin 에 창문

설치 가능 Session Manager plugin Microsoft Windows Vista 또는 그 이후 버전에서 독립 실행형 설치 관리자.

업데이트가 릴리스되면 설치 프로세스를 반복하여 최신 버전의 Session Manager plugin.

참고

최상의 결과를 얻으려면 다음을 사용하여 Windows 클라이언트에서 세션을 시작하는 것이 좋습니다. Windows PowerShell 응용 프로그램 버전 5 이상. Microsoft Windows에서 명령 프롬프트는 또한 Session Manager 작업.

를 설치하려면 Session Manager plugin EXE 설치 프로그램 사용

  1. 다음 URL을 사용하여 설치 관리자를 다운로드합니다.

    https://s3.amazonaws.com/session-manager-downloads/plugin/latest/windows/SessionManagerPluginSetup.exe
  2. 다운로드한 설치 프로그램을 실행하고 화면의 지침.

    플러그인을 에 설치하려면 설치 위치 상자를 비워 두십시오. 기본 디렉터리:

    • C:\%PROGRAMFILES%\Amazon\SessionManagerPlugin\bin\

  3. 설치가 성공적으로 완료되었는지 확인합니다. 자세한 내용은 를 참조하십시오. 다음을 확인합니다. Session Manager Plugin 설치.

    참고

    Windows에서 실행 파일을 찾을 수 없는 경우 명령 프롬프트를 다시 열거나 PATH 환경 변수 수동. 대상 정보는 문제 해결 항목을 참조하십시오. Session Manager Plugin 자동으로 추가되지 않음 명령줄 경로로(Windows).

설치 및 제거 Session Manager Plugin 에 맥OS

설치 가능 Session Manager plugin macOS에서 번들 설치 관리자 를 사용합니다.

중요

번들된 설치 관리자는 다음을 포함하는 경로에 대한 설치를 지원하지 않습니다. 스페이스.

를 설치하려면 Session Manager plugin 번들 설치 관리자(macOS) 사용

  1. 번들 설치 관리자를 다운로드합니다.

    curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/sessionmanager-bundle.zip" -o "sessionmanager-bundle.zip"
  2. 소화물 압축 풀기:

    unzip sessionmanager-bundle.zip
  3. 설치 명령을 실행합니다.

    sudo ./sessionmanager-bundle/install -i /usr/local/sessionmanagerplugin -b /usr/local/bin/session-manager-plugin
    참고

    플러그인에 Python 2.6.5 이상 또는 Python 3.3 이상이 필요합니다. 작성자 설치 스크립트는 시스템 기본 버전인 파이톤 가죽. 대체 버전의 Python을 설치한 경우 를 사용하여 를 설치하려는 경우 Session Manager plugin, 설치 스크립트 실행 Python 실행 파일 에 대한 절대 경로로 해당 버전을 사용할 수 있습니다. 더 다음은 예제입니다.

    sudo /usr/local/bin/python3.6 sessionmanager-bundle/install -i /usr/local/sessionmanagerplugin -b /usr/local/bin/session-manager-plugin

    설치 관리자가 Session Manager plugin 에서 /usr/local/sessionmanagerplugin 그리고 sym링크 session-manager-plugin 에서 /usr/local/bin 디렉터리. 이렇게 하면 사용자의 $PATH 변수.

    에 대한 설명을 보려면 -i-b 옵션을 선택한 후 -h 옵션:

    ./sessionmanager-bundle/install -h
  4. 설치가 성공적으로 완료되었는지 확인합니다. 자세한 내용은 를 참조하십시오. 다음을 확인합니다. Session Manager Plugin 설치.

참고

플러그인을 제거하려면 다음 두 명령을 실행합니다. 한 번에 하나씩:

sudo rm -rf /usr/local/sessionmanagerplugin
sudo rm /usr/local/bin/session-manager-plugin

설치 Session Manager Plugin Linux에서

  1. 다운로드 Session Manager plugin RPM 패키지:

    • 64비트:

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/linux_64bit/session-manager-plugin.rpm" -o "session-manager-plugin.rpm"
    • 32비트:

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/linux_32bit/session-manager-plugin.rpm" -o "session-manager-plugin.rpm"
    • ARM 64비트:

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/linux_arm64/session-manager-plugin.rpm" -o "session-manager-plugin.rpm"
  2. 설치 명령을 실행합니다.

    sudo yum install -y session-manager-plugin.rpm
  3. 설치가 성공적으로 완료되었는지 확인합니다. 자세한 내용은 를 참조하십시오. 다음을 확인합니다. Session Manager Plugin 설치.

참고

플러그인을 제거하려면 sudo yum erase session-manager-plugin -y

설치 Session Manager Plugin 에 Ubuntu Server

  1. 다운로드 Session Manager plugin DEB 패키지:

    • 64비트:

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_64bit/session-manager-plugin.deb" -o "session-manager-plugin.deb"
    • 32비트:

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_32bit/session-manager-plugin.deb" -o "session-manager-plugin.deb"
    • ARM 64비트:

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_arm64/session-manager-plugin.deb" -o "session-manager-plugin.deb"
  2. 설치 명령을 실행합니다.

    sudo dpkg -i session-manager-plugin.deb
  3. 설치가 성공적으로 완료되었는지 확인합니다. 자세한 내용은 를 참조하십시오. 다음을 확인합니다. Session Manager Plugin 설치.

참고

플러그인을 제거하려면 sudo dpkg -r session-manager-plugin

다음을 확인합니다. Session Manager Plugin 설치

다음 명령을 실행하여 Session Manager plugin 설치됨 성공적으로:

session-manager-plugin

설치가 성공적으로 완료되면 다음 메시지가 표시됩니다.

The Session Manager plugin is installed successfully. Use the AWS CLI to start a session.

다음 명령을 실행하여 설치를 테스트할 수도 있습니다. AWS CLI:

참고

이 명령은 Session Manager 관리자가 귀하에게 필요한 IAM 를 사용하여 대상 인스턴스에 액세스할 수 있는 권한 Session Manager.

aws ssm start-session --target id-of-an-instance-you-have-permissions-to-access

(선택 사항) enable Session Manager Plugin 로깅

더 Session Manager plugin 에는 실행하는 세션에 대해 로깅을 사용하도록 설정하는 옵션이 포함되어 있습니다. 기본적으로 로깅은 비활성화되어 있습니다.

로깅을 활성화하면 Session Manager plugin 두 애플리케이션에 대한 로그 파일 생성 활동(session-manager-plugin.log) 및 오류 (errors.log)을 클릭합니다.

에 대한 로깅 사용 Session Manager Plugin (창)

  1. 다음을 찾습니다. seelog.xml.template 파일 플러그인.

    기본 위치는 다음과 같습니다. C:\Program Files\Amazon\SessionManagerPlugin\seelog.xml.template.

  2. 파일 이름을 다음으로 변경합니다. seelog.xml.

  3. 파일을 열고 변경합니다. minlevel="off" ~까지 minlevel="info" 또는 minlevel="debug".

    참고

    기본적으로 데이터 채널 열기에 대한 항목을 기록하고 재연결 세션은 정보 수준에서 기록됩니다. 데이터 흐름 (패킷 및 승인) 입력사항은 DEBUG에 기록됩니다. 레벨.

  4. 수정할 다른 구성 옵션을 변경합니다. 선택 사항 다음과 같은 변화가 있을 수 있습니다.

    • 디버그 수준: 다음을 수행할 수 있습니다. 에서 디버그 수준 변경 formatid="fmtinfo" ~까지 outputs formatid="fmtdebug".

    • 로그 파일 옵션: 다음을 수행할 수 있습니다. 로그 파일 옵션을 변경합니다. 로그 파일 이름을 제외하고 로그가 저장됩니다.

      중요

      파일 이름을 변경하지 마십시오. 그렇지 않으면 로깅이 작동하지 않습니다. 올바르게 합니다.

      <rollingfile type="size" filename="C:\%PROGRAMDATA%\Amazon\SessionManagerPlugin\Logs\session-manager-plugin.log" maxsize="30000000" maxrolls="5"/> <filter levels="error,critical" formatid="fmterror"> <rollingfile type="size" filename="C:\%PROGRAMDATA%\Amazon\SessionManagerPlugin\Logs\errors.log" maxsize="10000000" maxrolls="5"/>
  5. 파일을 저장합니다.

에 대한 로깅 사용 Session Manager Plugin (Linux 및 macOS)

  1. 다음을 찾습니다. seelog.xml.template 파일 플러그인.

    기본 위치는 다음과 같습니다. /usr/local/sessionmanagerplugin/seelog.xml.template.

  2. 파일 이름을 다음으로 변경합니다. seelog.xml.

  3. 파일을 열고 변경합니다. minlevel="off" ~까지 minlevel="info" 또는 minlevel="debug".

    참고

    기본적으로 데이터 채널 열기에 대한 항목을 기록하고 재연결 세션은 정보 수준에서 기록됩니다. 데이터 흐름 (패킷 및 승인) 입력사항은 DEBUG에 기록됩니다. 레벨.

  4. 수정할 다른 구성 옵션을 변경합니다. 선택 사항 다음과 같은 변화가 있을 수 있습니다.

    • 디버그 수준: 다음을 수행할 수 있습니다. 에서 디버그 수준 변경 formatid="fmtinfo" ~까지 outputs formatid="fmtdebug"

    • 로그 파일 옵션: 다음을 수행할 수 있습니다. 로그 파일 옵션을 변경합니다. 로그 파일 이름을 제외하고 로그가 저장됩니다.

      중요

      파일 이름을 변경하지 마십시오. 그렇지 않으면 로깅이 작동하지 않습니다. 올바르게 합니다.

      <rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/session-manager-plugin.log" maxsize="30000000" maxrolls="5"/> <filter levels="error,critical" formatid="fmterror"> <rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/errors.log" maxsize="10000000" maxrolls="5"/>
      중요

      지정된 기본 디렉터리를 사용하여 logs를 사용하는 경우 sudo 또는 디렉토리에 플러그인이 전체 읽기 및 쓰기 권한으로 설치됩니다. 이러한 제한 사항을 무시하려면 로그가 저장됩니다.

  5. 파일을 저장합니다.

Session Manager Plugin 최신 버전 및 릴리스 역사

로컬 컴퓨터에서 지원되는 버전의 을(를) 실행하고 있어야 합니다. Session Manager plugin. 만약 이전 버전을 실행 중인 경우 Session Manager 작업이 성공하지 못할 수 있습니다.

현재 지원되는 최소 버전은 다음과 같습니다. 1.1.17.0.

최신 버전이 있는지 확인하려면 AWS CLI:

참고

이 명령은 플러그인이 기본값인 운영 체제 유형 에 대한 설치 디렉터리입니다. 또한 해당 버전의 내용을 VERSION 파일 플러그인을 설치한 디렉터리입니다.

session-manager-plugin --version

다음 표에는 모든 릴리스가 나와 있습니다. Session Manager plugin 기능 및 각 버전 에 포함된 개선 사항.

버전 출시 날짜 세부 정보
1.1.61.0

2020년 4월 17일

향상: 추가된 ARM 리눅스 및 Ubuntu Server.

1.1.54.0

2020년 1월 6일

버그 수정: 핸들 레이스 패킷이 삭제될 때의 조건 시나리오 Session Manager plugin 이(가) 준비되지 않았습니다.

1.1.50.0

2019년 11월 19일

향상: 추가됨 로컬 UNIX 소켓으로 포트 전달 지원

1.1.35.0

2019년 11월 7일

향상: (포트 세션 전달에만 해당) 종료 세션 명령 전송 대상 SSM 에이전트 로컬 사용자가 Ctrl+C.

1.1.33.0 2019년 9월 26일 향상: (포트 포워딩 세션만 해당) 서버에 연결 끊기 신호 전송 클라이언트가 TCP 연결을 끊을 때
1.1.31.0 2019년 9월 6일 향상: 유지할 업데이트 원격 서버가 connection.

1.1.26.0

2019년 7월 30일

향상: 다음으로 업데이트 세션 동안 데이터 전송 속도를 제한합니다.

1.1.23.0

2019년 7월 9일

향상: 추가됨 세션을 사용한 SSH 세션 실행 지원 관리자.

1.1.17.0 2019년 4월 4일

향상: 추가됨 를 사용하여 세션 데이터의 추가 암호화 지원 AWS Key Management Service (AWS KMS).

1.0.37.0 2018년 9월 20일

향상: 버그 수정 Windows 버전.

1.0.0.0 2018년 9월 11일

초기 릴리스 Session Manager plugin.