InfoGrab DocsInfoGrab Docs

서버 자동 검색 문제 해결

요약

이 페이지는 서버 자동 검색을 설정할 때 발생할 수 있는 일반적인 문제와 해결 또는 우회 방법을 설명합니다. tctl discovery nodes 명령은 Teleport가 최근에 클라우드 인스턴스를 등록하려고 시도한 내역을 나열하고 각 시도의 성공 여부를 보고합니다.

이 페이지는 서버 자동 검색을 설정할 때 발생할 수 있는 일반적인 문제와 해결 또는 우회 방법을 설명합니다.

tctl discovery nodes 명령은 Teleport가 최근에 클라우드 인스턴스를 등록하려고 시도한 내역을 나열하고 각 시도의 성공 여부를 보고합니다. 이 명령은 Discovery 서비스가 발생시키는 등록 감사 이벤트(AWS는 ssm.run, Azure는 azure.run)를 읽습니다.

--last를 사용하면 감사 이벤트 조회 기간을 기본값인 1시간보다 넓힐 수 있습니다. 이 플래그는 Go 방식의 기간 표기(예: --last=30m, --last=24h)를 받습니다. 기본 조회 기간보다 오래된 실패를 조사할 때 값을 늘립니다.

AWS EC2#

설치가 실패로 표시되거나 인스턴스가 나타나지 않는 경우, AWS System Manager -> Node Management -> Run Command에서 Command 이력을 확인하십시오. Target의 instance-id를 선택하여 오류를 검토하십시오.

cannot unmarshal object into Go struct field#

다음과 유사한 오류가 발생하는 경우:

invalid format in plugin properties map[destinationPath:/tmp/installTeleport.sh sourceInfo:map[url:[https://example.teleport.sh:443/webapi/scripts/installer/preprod-installer](https://example.teleport.sh/webapi/scripts/installer/preprod-installer)] sourceType:HTTP];
error json: cannot unmarshal object into Go struct field DownloadContentPlugin.sourceInfo of type string

이는 오래된 버전의 SSM agent를 실행하고 있을 가능성이 높습니다. 이 문제를 해결하려면 SSM agent 버전 3.1 이상으로 업그레이드하십시오.

InvalidInstanceId: Instances [[i-123]] not in a valid state for account 456#

다음과 같은 문제로 인해 이 오류가 발생할 수 있습니다:

  • Discovery Service에 관리 노드에 접근할 권한이 없습니다.
  • AWS Systems Manager Agent(SSM Agent)가 실행되고 있지 않습니다. SSM Agent가 실행 중인지 확인하십시오.
  • SSM Agent가 SSM 엔드포인트에 등록되어 있지 않습니다. SSM Agent를 재설치해 보십시오.
  • 발견된 인스턴스에 SSM 명령을 수신할 권한이 없습니다. 인스턴스에 AmazonSSMManagedInstanceCore IAM 정책이 포함되어 있는지 확인하십시오.

자세한 내용은 AWS 문서의 SSM RunCommand 오류 코드 및 문제 해결 정보를 참조하십시오:

Azure VM#

Note

이 섹션의 내용은 원문 문서를 참조하세요. (azure-vm-troubleshooting.mdx)

서버 자동 검색 문제 해결

Teleport v18.11
원문 보기

요약

이 페이지는 서버 자동 검색을 설정할 때 발생할 수 있는 일반적인 문제와 해결 또는 우회 방법을 설명합니다. tctl discovery nodes 명령은 Teleport가 최근에 클라우드 인스턴스를 등록하려고 시도한 내역을 나열하고 각 시도의 성공 여부를 보고합니다.

이 페이지는 서버 자동 검색을 설정할 때 발생할 수 있는 일반적인 문제와 해결 또는 우회 방법을 설명합니다.

tctl discovery nodes 명령은 Teleport가 최근에 클라우드 인스턴스를 등록하려고 시도한 내역을 나열하고 각 시도의 성공 여부를 보고합니다. 이 명령은 Discovery 서비스가 발생시키는 등록 감사 이벤트(AWS는 ssm.run, Azure는 azure.run)를 읽습니다.

--last를 사용하면 감사 이벤트 조회 기간을 기본값인 1시간보다 넓힐 수 있습니다. 이 플래그는 Go 방식의 기간 표기(예: --last=30m, --last=24h)를 받습니다. 기본 조회 기간보다 오래된 실패를 조사할 때 값을 늘립니다.

AWS EC2#

설치가 실패로 표시되거나 인스턴스가 나타나지 않는 경우, AWS System Manager -> Node Management -> Run Command에서 Command 이력을 확인하십시오. Target의 instance-id를 선택하여 오류를 검토하십시오.

cannot unmarshal object into Go struct field#

다음과 유사한 오류가 발생하는 경우:

invalid format in plugin properties map[destinationPath:/tmp/installTeleport.sh sourceInfo:map[url:[https://example.teleport.sh:443/webapi/scripts/installer/preprod-installer](https://example.teleport.sh/webapi/scripts/installer/preprod-installer)] sourceType:HTTP];
error json: cannot unmarshal object into Go struct field DownloadContentPlugin.sourceInfo of type string

이는 오래된 버전의 SSM agent를 실행하고 있을 가능성이 높습니다. 이 문제를 해결하려면 SSM agent 버전 3.1 이상으로 업그레이드하십시오.

InvalidInstanceId: Instances [[i-123]] not in a valid state for account 456#

다음과 같은 문제로 인해 이 오류가 발생할 수 있습니다:

  • Discovery Service에 관리 노드에 접근할 권한이 없습니다.
  • AWS Systems Manager Agent(SSM Agent)가 실행되고 있지 않습니다. SSM Agent가 실행 중인지 확인하십시오.
  • SSM Agent가 SSM 엔드포인트에 등록되어 있지 않습니다. SSM Agent를 재설치해 보십시오.
  • 발견된 인스턴스에 SSM 명령을 수신할 권한이 없습니다. 인스턴스에 AmazonSSMManagedInstanceCore IAM 정책이 포함되어 있는지 확인하십시오.

자세한 내용은 AWS 문서의 SSM RunCommand 오류 코드 및 문제 해결 정보를 참조하십시오:

Azure VM#

Note

이 섹션의 내용은 원문 문서를 참조하세요. (azure-vm-troubleshooting.mdx)