서버 V2 참조
요약
Kind: node Version: v2 Teleport 클러스터 내 노드, 앱, 데이터베이스, 프록시 또는 인증 서비스 인스턴스를 나타냅니다. EC2 인스턴스에 매칭할 속성을 포함합니다. 서버가 실행 중인 클라우드 인스턴스에 대한 정보를 포함합니다(있는 경우).
Kind: node
Version: v2
Teleport 클러스터 내 노드, 앱, 데이터베이스, 프록시 또는 인증 서비스 인스턴스를 나타냅니다.
최상위 필드#
예시:
kind: "string"
sub_kind: "string"
version: "string"
metadata: # [...]
spec: # [...]
scope: "string"
| 필드명 | 설명 | 타입 |
|---|---|---|
| kind | 리소스 종류 | string |
| metadata | 리소스 메타데이터 | Metadata |
| scope | 할당 후 변경할 수 없는 서버의 광고된 범위. | string |
| spec | 서버 사양 | Server Spec V2 |
| sub_kind | 일부 리소스에서 사용되는 선택적 리소스 하위 종류 | string |
| version | 버전 | string |
AWS 정보 (AWS Info)#
EC2 인스턴스에 매칭할 속성을 포함합니다.
예시:
account_id: "string"
instance_id: "string"
region: "string"
vpc_id: "string"
integration: "string"
subnet_id: "string"
| 필드명 | 설명 | 타입 |
|---|---|---|
| account_id | AWS 계정 ID. | string |
| instance_id | EC2 인스턴스 ID. | string |
| integration | 이 노드를 추가한 통합 이름. 연결 시 이 통합을 사용하여 연결 설정을 위한 AWS API 호출을 수행합니다. 여기에는 SSH 키 전송 후 Teleport가 연결할 수 있도록 터널 열기(EC2 Instance Connect Endpoint)가 포함됩니다. | string |
| region | AWS EC2 인스턴스 리전. | string |
| subnet_id | 인스턴스가 사용하는 서브넷 ID. | string |
| vpc_id | 인스턴스가 실행 중인 AWS VPC ID. | string |
클라우드 메타데이터 (Cloud Metadata)#
서버가 실행 중인 클라우드 인스턴스에 대한 정보를 포함합니다(있는 경우).
예시:
aws: # [...]
| 필드명 | 설명 | 타입 |
|---|---|---|
| aws | EC2 인스턴스에 매칭할 속성을 포함합니다. | AWS Info |
명령 레이블 V2 (Command Label V2)#
명령 실행으로 생성된 출력을 값으로 갖는 레이블입니다(예: hostname).
예시:
period: # [...]
command:
- "string"
- "string"
- "string"
result: "string"
| 필드명 | 설명 | 타입 |
|---|---|---|
| command | 실행할 명령 | []string |
| period | 명령 실행 간격 | Duration |
| result | 표준 출력 캡처 | string |
컴포넌트 기능 ID (Component Feature ID)#
Teleport 컴포넌트가 지원하는 특정 기능의 식별자입니다.
컴포넌트 기능 (Component Features)#
주어진 Teleport 컴포넌트가 지원하는 기능 세트를 나타냅니다.
예시:
features:
- # [...]
- # [...]
- # [...]
| 필드명 | 설명 | 타입 |
|---|---|---|
| features | 지원되는 기능 식별자 목록. | []Component Feature ID |
기간 (Duration)#
사용자 지정 마샬/언마샬 설정을 위한 기간 래퍼
GitHub 서버 메타데이터 (GitHub Server Metadata)#
각 서버가 GitHub 조직을 나타내는 GitHub 프록시에 대한 정보를 포함합니다.
예시:
organization: "string"
integration: "string"
| 필드명 | 설명 | 타입 |
|---|---|---|
| integration | 이 서버와 연결된 통합. | string |
| organization | GitHub 통합의 조직 이름을 지정합니다. | string |
메타데이터 (Metadata)#
리소스 메타데이터
예시:
name: "string"
description: "string"
labels:
"string": "string"
"string": "string"
"string": "string"
expires: # 설명 참조
revision: "string"
| 필드명 | 설명 | 타입 |
|---|---|---|
| description | 객체 설명 | string |
| expires | 시스템 내 모든 리소스에 설정할 수 있는 전역 만료 시간 헤더. | |
| labels | 레이블 세트 | map[string]string |
| name | 객체 이름 | string |
| revision | 시간 경과에 따른 리소스 버전을 추적하는 불투명한 식별자. 클라이언트는 이 값을 무시하고 변경하지 않아야 하지만 리소스 업데이트 시 revision을 반환해야 합니다. | string |
로테이션 (Rotation)#
인증 기관 인증서 로테이션 상태
예시:
state: "string"
phase: "string"
mode: "string"
current_id: "string"
started: # 설명 참조
grace_period: # [...]
last_rotated: # 설명 참조
schedule: # [...]
| 필드명 | 설명 | 타입 |
|---|---|---|
| current_id | 로테이션 시도를 구분하기 위한 로테이션 작업의 ID. | string |
| grace_period | 이전 CA와 새 CA 모두 검사 목적으로 유효하지만 새 CA만 인증서를 발급하는 기간. | Duration |
| last_rotated | 완료된 로테이션의 마지막 시간을 지정합니다. | |
| mode | 수동 또는 자동 로테이션 모드를 설정합니다. | string |
| phase | 현재 로테이션 단계. | string |
| schedule | 자동 모드에서 단계 전환에 사용되는 로테이션 일정. | Rotation Schedule |
| started | 로테이션 상태가 "in_progress"인 경우 로테이션이 시작된 시간으로 설정됩니다. | |
| state | "init" 또는 "in_progress" 중 하나일 수 있습니다. | string |
로테이션 일정 (Rotation Schedule)#
다양한 단계의 시간 전환을 설정하는 로테이션 일정입니다.
예시:
update_clients: # 설명 참조
update_servers: # 설명 참조
standby: # 설명 참조
| 필드명 | 설명 | 타입 |
|---|---|---|
| standby | "Standby" 단계로 전환할 시간을 지정합니다. | |
| update_clients | "Update clients" 단계로 전환할 시간을 지정합니다. | |
| update_servers | "Update servers" 단계로 전환할 시간을 지정합니다. |
서버 사양 V2 (Server Spec V2)#
V2 서버 사양
예시:
addr: "string"
hostname: "string"
cmd_labels:
"string": # [...]
"string": # [...]
"string": # [...]
rotation: # [...]
use_tunnel: true
version: "string"
peer_addr: "string"
proxy_ids:
- "string"
- "string"
- "string"
public_addrs:
- "string"
- "string"
- "string"
cloud_metadata: # [...]
github: # [...]
relay_group: "string"
relay_ids:
- "string"
- "string"
- "string"
component_features: # [...]
immutable_labels:
"string": "string"
"string": "string"
"string": "string"
| 필드명 | 설명 | 타입 |
|---|---|---|
| addr | 이 서버에 접근할 수 있는 host:port 주소. | string |
| cloud_metadata | 서버가 실행 중인 클라우드 인스턴스에 대한 정보(있는 경우). | Cloud Metadata |
| cmd_labels | 서버 동적 레이블 | map[string]Command Label V2 |
| component_features | 이 서버가 지원하는 기능을 나타냅니다. | Component Features |
| github | 각 서버가 GitHub 조직을 나타내는 GitHub 프록시에 대한 정보. | GitHub Server Metadata |
| hostname | 서버 호스트명 | string |
| immutable_labels | 서버 참가 시 할당된 변경 불가 레이블. 이 레이블의 해시는 서버 인증서에 포함된 해시와 일치해야 합니다. | map[string]string |
| peer_addr | 프록시 서버가 피어 프록시에서 도달할 수 있는 주소. | string |
| proxy_ids | 이 서버가 연결될 것으로 예상되는 프록시 ID 목록. | []string |
| public_addrs | 이 서버에 접근할 수 있는 공개 주소 목록. | []string |
| relay_group | 서버가 연결된 릴레이 그룹 이름 | string |
| relay_ids | 서버가 연결된 릴레이 호스트 ID 목록 | []string |
| rotation | 서버 로테이션 지정 | Rotation |
| use_tunnel | 이 서버에 대한 연결이 역방향 터널을 통해 이루어져야 함을 나타냅니다. | Boolean |
| version | TeleportVersion은 서버가 실행 중인 Teleport 버전입니다. | string |