IBM Cloud Docs
VNC 또는 직렬 콘솔을 사용하여 가상 서버 인스턴스에 액세스

VNC 또는 직렬 콘솔을 사용하여 가상 서버 인스턴스에 액세스

IBM Cloud UI, API 요청 또는 IBM Cloud CLI(명령행 인터페이스)를 사용하여 VNC 또는 시리얼 콘솔에 연결함으로써 IBM Cloud 가상 서버 인스턴스에 액세스할 수 있습니다. 이 콘솔 서비스는 보안 쉘을 사용하지 않고 인스턴스와 상호 작용할 수 있는 신속하고 간단한 방법입니다.

z/OS 가상 서버 및 TDX 기밀 컴퓨팅을 사용하는 가상 서버 인스턴스만 해당: z/OS 또는 TDX 기밀 컴퓨팅 가상 서버 인스턴스를 VNC 콘솔에 연결하는 것은 지원되지 않습니다.

특히 사용자 정의 이미지를 사용할 때 부트 실패 또는 커널 충돌이 발생한 상황에 적용됩니다. 이러한 상황이 발생하면 콘솔 서비스를 사용하여 문제를 조사할 수 있습니다.

VNC 콘솔은 그래픽 사용자 인터페이스를 제공하고 마우스와 키보드 입력을 모두 허용합니다. 직렬 콘솔은 키보드 입력을 허용하는 텍스트 기반 콘솔을 제공합니다.

이 콘솔을 사용하여 GNU GRUB(GRand Unified Bootloader)와 같은 OS 로드 및 부팅 절차에 액세스할 수 있습니다.

이 콘솔은 지원되는 브라우저 중 하나를 사용하여 열 수 있습니다.

시작하기 전에

  1. 콘솔에 연결하려면 IAM(IBM Cloud Identity and Access Management)의 가상 서버 인스턴스에 대해 Operator(또는 그 이상) 및 Console Administrator 역할이 지정되어 있어야 합니다.

    Console Administrator 역할은 자동으로 적용되지 않습니다. 계정의 관리자인 경우 이 기능을 사용하려면 Console Administrator 역할을 자체적으로 지정해야 합니다.

    필요한 역할이 할당되었는지 확인하려면, IBM Cloud 콘솔의 IAM 사용자 페이지 로 이동하여 사용자 아래에서 계정을 선택한 다음, 액세스 정책을 선택합니다. Operator (또는 그 이상) 역할과 VirtualServerConsoleAdmin 역할을 대상 가상 서버 인스턴스의 리소스 속성에 할당하는 액세스 정책을 확인하십시오. 그렇지 않을 경우 계정 관리자에게 문의하여 다음 단계를 통해 사용자에게 역할을 지정해야 합니다.

    1. IBM Cloud 의 IAM 사용자 페이지 로 이동하여 대상 사용자를 선택합니다.
    2. 액세스 탭을 클릭하고 액세스 정책으로 스크롤합니다.
    3. 액세스 권한 지정 을 클릭하십시오.
    4. 정책 만들기 섹션으로 스크롤합니다.
    5. 서비스 섹션에서 _VPC 인프라 서비스_를 선택합니다. 그런 후 다음 을 클릭하십시오.
    6. 리소스 섹션에서 _모든 리소스_를 선택합니다.
    7. 역할 및 작업에서 다음 서비스 액세스 권한을 선택합니다:
      • 콘솔 관리자
    8. 그런 다음, 다음 플랫폼 액세스 중 하나를 선택합니다:
      • 운영자
      • 편집자
      • 관리자
    9. 다음 을 클릭하십시오.
    10. 원하는 경우 조건을 추가합니다.
    11. 검토를 클릭하십시오.
    12. 추가 를 클릭하십시오.
    13. 액세스 요약 측면 분할창을 검토하고 지정을 클릭하십시오.

    IAM 역할에 대한 자세한 내용은 IAM 시작하기를 참조하십시오.

  2. 일반적으로 IBM Cloud에서 제공하는 이미지에는 비밀번호가 없습니다. 콘솔을 사용하여 인스턴스에 액세스하려면 미리 Linux 이미지에 대한 비밀번호를 작성하거나 Windows 이미지에 대한 비밀번호를 검색해야 할 수 있습니다.

시리얼 콘솔의 경우 -a root 플래그를 사용하여 비밀번호를 사용하지 않고 자동으로 로그인하도록 getty을(를) 구성할 수 있습니다.

사용자 정의 Linux 이미지의 경우 시리얼 콘솔 서비스를 사용으로 설정하려면 커널 명령행에 console=ttyS0 인수가 존재하는지 확인하십시오. 자세한 정보는 Linux 사용자 정의 이미지 작성1단계- qcow2 또는 VHD 형식의 단일 이미지 파일로 시작 을 참조하십시오.

IBM Cloud UI를 사용하여 콘솔에 연결

IBM Cloud UI를 사용하여 콘솔에 연결하려면 다음 단계를 수행하십시오.

  1. IBM Cloud 콘솔에서 탐색 메뉴 아이콘메뉴 아이콘 > 인프라 VPC 아이콘 컴퓨팅 > 가상 서버 인스턴스로 이동합니다.
  2. VPC용 가상 서버 인스턴스 목록에서 액세스해야 하는 데 필요한 인스턴스의 오버플로우 단추를 클릭한 후 VNC 콘솔 열기 또는 직렬 콘솔 열기를 클릭하십시오. 또는 인스턴스 세부사항 페이지의 오른쪽 상단에서 조치를 클릭한 후 VNC 콘솔 열기 또는 직렬 콘솔 열기를 클릭하십시오.
  3. (시리얼 콘솔 전용) 시리얼 콘솔을 사용하는 경우 세션 열기 강제 실행 여부를 확인하는 프롬프트가 표시됩니다. 이 조치는 다른 사용자 세션의 연결을 끊습니다.
  4. 신임 정보를 입력한 후 프롬프트의 요청에 따라 인스턴스에 로그인하십시오.

콘솔 창의 오른쪽 상단에서 인스턴스 종료 또는 인스턴스 재부팅을 클릭하여 인스턴스를 중지하거나 다시 시작할 수 있습니다.

API를 사용하여 콘솔에 연결

API 요청을 사용하여 VNC 또는 직렬 콘솔에 연결하려면 IAM 토큰을 가져와서 엔드포인트를 변수로 저장하고 VPC API 서비스에 액세스할 수 있는지 확인해야 합니다. 자세한 정보는 API 전제조건을 참조하십시오.

API를 사용하여 VNC 콘솔에 연결

  1. 인스턴스에 대한 콘솔 액세스 토큰을 작성하십시오. 페이로드에서 "console_type":"VNC"을(를) 지정하십시오.

      curl -X POST \
      "$vpc_api_endpoint/v1/instances/$instance_id/console_access_token?version=2021-01-26&generation=2" \
      -H "Authorization: $iam_token" \
      -d '{
            "console_type": "vnc"
      	  }'
    

    액세스 토큰은 3분 후 무효화됩니다.

  2. 응답에 "href" 값을 저장하십시오.

  3. 브라우저에서 noVNC 포털을 엽니다.

  4. 설정을 클릭한 후 고급 > 웹소켓을 펼치십시오.

  5. 암호화를 선택하고 2단계에서 저장한 URL의 API 엔드포인트 부분을 **호스트:**에 붙여넣으십시오. "wss://를 포함하지 말고 포트를 "443"으로 설정하여 2단계에서 저장한 URL의 경로 부분을 경로에 붙여넣으십시오.

    • API 엔드포인트 예: us-south.iaas.cloud.ibm.com
    • 경로 예제:v1/instances/<instance_id>/console?access_token=<access_token>&version=2020-12-06&generation=2
  6. 연결을 클릭합니다.

  7. 인스턴스에 로그인하십시오.

API를 사용하여 직렬 콘솔에 연결

  1. 인스턴스에 대한 콘솔 액세스 토큰을 작성하고, 페이로드에 "console_type": "serial""force": true를 지정하십시오.

      curl -X POST \
      "$vpc_api_endpoint/v1/instances/$instance_id/console_access_token?version=2020-01-26&generation=2" \
      -H "Authorization: $token" \
      -d '{
         "console_type":"serial",
         "force": true
      }'
    

    "force"을(를) true(으)로 지정하는 경우 다른 사용자가 해당 콘솔을 사용하는 경우에도 시리얼 콘솔에 연결할 수 있습니다. 기본값은 콘솔을 사용 중인 경우 연결을 설정할 수 없음을 의미하는 false입니다.

  2. 응답에 "href" 값을 저장하십시오.

  3. URL을 사용하여 시리얼 콘솔 프로그램을 시작하십시오.

    websocat을 사용하는 경우 명령에 --binary 플래그를 지정하십시오. 예: websocat --binary "wss://us-south.iaas.cloud.ibm.com/v1/instances/<instance_id>/console?access_token=<access_token>&version=2020-12-06&generation=2"

  4. 신임 정보를 입력한 후 프롬프트의 요청에 따라 인스턴스에 로그인하십시오.

CLI를 사용하여 콘솔에 연결

CLI 전제조건을 수행하여 CLI 환경을 설정했는지 확인하십시오.

  1. 다음 명령을 실행하여 콘솔에 연결하십시오.

    ibmcloud is instance-console $instance_id [-q, --quiet]
    

    이 명령은 기본적으로 시리얼 콘솔을 엽니다. VNC 콘솔을 열려면 [--vnc] 플래그를 명령에 추가하여 콘솔의 URL을 검색하십시오.

  2. 사용 중인 콘솔에 따라 다음 단계 중 하나를 수행하십시오.

    • VNC 콘솔의 경우, API를 사용하여 VNC 콘솔에 연결2단계 - 7단계를 따르십시오.
    • 시리얼 콘솔의 경우 신임 정보를 입력한 후 프롬프트의 요청에 따라 인스턴스에 로그인하십시오.

콘솔에서 연결 끊기

콘솔이 완료되면 터미널 또는 브라우저를 닫아서 연결을 끊을 수 있습니다.

콘솔 서비스에 대한 참고사항

  1. 유휴 시간 10분이 지나면 콘솔 세션이 만료됩니다. 활동 여부에 관계없이 60분 후에는 종료됩니다.

    일부 운영 체제의 콘솔에는 플래시 커서가 존재합니다(예: Ubuntu 18.04). VNC 콘솔을 사용하여 이러한 운영 체제를 사용하는 인스턴스에 액세스하는 경우 플래시 커서는 콘솔 세션이 10분 동안 유휴 상태를 유지한 후에도 활성 상태로 유지됩니다. 콘솔 세션은 여전히 활동 여부에 관계없이 60분 후에 종료됩니다.

  2. 인스턴스의 전원이 꺼진 경우 콘솔에서 연결이 끊어집니다. 인스턴스가 다시 시작될 때까지 연결을 재설정할 수 없습니다.

  3. 다시 시작, 재설정 또는 인스턴스의 스케줄 조정이 발생하지 않는 다른 조작 시에는 콘솔 연결이 유지됩니다.

  4. 인스턴스당 활성 VNC 콘솔 수는 2개로 제한됩니다. 인스턴스당 활성 시리얼 콘솔 수는 1개로 제한됩니다.

  5. 직렬 콘솔을 사용하여 Linux 가상 서버 인스턴스의 문제를 해결하는 방법에 대한 자세한 내용은 직렬 콘솔에서 Linux SysRq 키를 사용하여 Linux 가상 서버 인스턴스 문제를 해결하려면 어떻게 해야 하나요? 참조하세요.