Bot Instance 참조
Teleport v18.11요약
Kind: bot_instance Version: v1 bot_instance 리소스는 Teleport 클러스터에 등록된 Machine ID 봇의 내부 상태를 추적합니다. tbot 서비스의 상태 정상 여부를 설명합니다.
Kind: bot_instance
Version: v1
bot_instance 리소스는 Teleport 클러스터에 등록된 Machine ID 봇의 내부 상태를 추적합니다.
tctl로 bot_instance 리소스를 조회하고 목록으로 확인할 수는 있지만, 생성·수정·삭제할 수는 없습니다.
최상위 필드#
예시:
kind: "string"
sub_kind: "string"
version: "string"
metadata: # [...]
spec: # [...]
status: # [...]
scope: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| kind | 표현되는 리소스의 종류입니다. | string |
| metadata | 모든 리소스가 공통으로 가지는 메타데이터입니다. | Metadata |
| scope | BotInstance의 범위입니다. 이 인스턴스와 연결된 Bot의 범위를 기준으로 결정되며, BotInstance 리소스에 대한 범위 지정 RBAC에 사용될 수 있습니다. | string |
| spec | BotInstance에 구성된 속성입니다. | Bot Instance Spec |
| status | 작업 결과로 서버가 설정하는 필드입니다. 사용자가 수정해서는 안 됩니다. | Bot Instance Status |
| sub_kind | 같은 종류 내의 변형을 구분합니다. 값이 채워지지 않더라도 모든 리소스는 이 필드를 가져야 합니다. | string |
| version | 표현되는 리소스의 버전입니다. | string |
Bot Instance Health Status#
tbot 서비스의 상태 정상 여부를 설명합니다.
Bot Instance Service Health#
tbot 서비스 상태의 스냅샷입니다.
예시:
service: # [...]
status: # [...]
reason: "string"
updated_at: # See description
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| reason | 서비스 상태에 대한 사람이 읽을 수 있는 설명입니다. 오류 메시지가 포함될 수 있습니다. | string |
| service | 서비스를 식별합니다. | Bot Instance Service Identifier |
| status | 서비스의 상태 정상 여부를 설명합니다. | Bot Instance Health Status |
| updated_at | 서비스 상태가 마지막으로 변경된 시각입니다. |
Bot Instance Service Identifier#
tbot 서비스를 고유하게 식별합니다.
예시:
type: "string"
name: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| name | 서비스의 이름으로, 사용자가 지정하거나 자동으로 생성됩니다. | string |
| type | 서비스의 유형입니다(예: database-tunnel, ssh-multiplexer). | string |
Bot Instance Spec#
다음 필드를 포함합니다.
예시:
bot_name: "string"
instance_id: "string"
previous_instance_id: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| bot_name | 이 인스턴스와 연결된 봇의 이름입니다. | string |
| instance_id | 이 인스턴스의 고유 식별자입니다. | string |
| previous_instance_id | 이전 인스턴스 ID이며, 있는 경우에만 설정됩니다. 이전 아이덴티티가 만료된 후 봇이 다시 인증할 때 설정됩니다. 현재는 bound-keypair 재조인 중에만 설정됩니다. | string |
Bot Instance Status#
BotInstance의 상태를 담고 있습니다.
예시:
initial_authentication: # [...]
latest_authentications:
- # [...]
- # [...]
- # [...]
initial_heartbeat: # [...]
latest_heartbeats:
- # [...]
- # [...]
- # [...]
service_health:
- # [...]
- # [...]
- # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| initial_authentication | 이 봇 인스턴스의 최초 인증 상태입니다. | Bot Instance Status Authentication |
| initial_heartbeat | 이 봇 인스턴스의 최초 하트비트 상태입니다. | Bot Instance Status Heartbeat |
| latest_authentications | 이 봇 인스턴스의 최근 N개 인증 상태 레코드입니다. | []Bot Instance Status Authentication |
| latest_heartbeats | 이 봇 인스턴스의 최근 N개 하트비트입니다. | []Bot Instance Status Heartbeat |
| service_health | tbot이 실행 중인 서비스와 출력의 상태입니다. |
[]Bot Instance Service Health |
Bot Instance Status Authentication#
조인 또는 갱신에 대한 정보를 담고 있습니다. 이 정보는 전적으로 Teleport Auth Service에서 가져오므로 신뢰할 수 있습니다.
예시:
authenticated_at: # See description
join_method: "string"
join_token: "string"
metadata: # See description
generation: 1
public_key: BASE64_STRING
join_attrs: # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| authenticated_at | Teleport Auth Service가 조인 또는 갱신을 인증한 타임스탬프입니다. | |
| generation | 갱신할 때마다 이 generation 값이 증가합니다. 위임형 조인 방식에서는 갱신 중에 이 카운터를 확인하지 않습니다. token 조인 방식에서는 갱신 중에 이 카운터를 확인하며, 인증서의 카운터가 마지막 인증의 카운터와 일치하지 않으면 Bot이 잠깁니다. |
number |
| join_attrs | 조인 과정에서 생성된 속성입니다. 일반적으로 조인 증명 과정 자체에서 얻은 정보입니다. 이 필드는 구조가 없는 metadata 필드를 대체할 예정입니다. |
Join Attrs |
| join_method | 이번 조인 또는 갱신에 사용된 조인 방식입니다. 더 이상 사용되지 않음: join_attrs.meta.join_method 사용을 권장합니다 | string |
| join_token | 이번 조인 또는 갱신에 사용된 조인 토큰입니다. token 조인 방식의 값은 민감 정보이므로, 위임형 조인 방식에서만 채워집니다. 더 이상 사용되지 않음: join_attrs.meta.join_token_name 사용을 권장합니다 |
string |
| metadata | 조인 방식에서 가져온 메타데이터입니다. 더 이상 사용되지 않음: join_attrs 사용을 권장합니다. | |
| public_key | Bot 인스턴스의 공개 키입니다. PEM으로 감싼 PKIX DER 인코딩 공개 키여야 합니다. 이를 통해 일관성을 확보하고 여러 종류의 공개 키 알고리즘을 지원합니다. | base64-encoded string |
Bot Instance Status Heartbeat#
Bot 인스턴스가 자체 보고한 정보를 담고 있습니다. 이 정보는 서버가 검증하지 않으므로 신뢰해서는 안 됩니다.
예시:
recorded_at: # See description
is_startup: true
version: "string"
hostname: "string"
uptime: # See description
join_method: "string"
one_shot: true
architecture: "string"
os: "string"
external_updater: "string"
external_updater_version: "string"
updater_info: # [...]
kind: # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| architecture | tbot이 실행 중인 호스트의 아키텍처이며, runtime.GOARCH로 결정됩니다. |
string |
| external_updater | 외부 업데이터 프로세스를 식별합니다. | string |
| external_updater_version | 외부 업데이터의 버전을 식별합니다. 업데이터가 구성되지 않은 경우 비어 있습니다. | string |
| hostname | tbot이 실행 중인 호스트의 호스트 이름입니다. |
string |
| is_startup | tbot이 시작할 때 제출한 하트비트인지 여부를 나타냅니다. |
Boolean |
| join_method | 현재 구성된 join_method입니다. | string |
| kind | 봇이 tbot 바이너리에서 실행 중인지, 다른 구성 요소에 내장되어 실행 중인지를 식별합니다. | Bot Kind |
| one_shot | tbot이 원샷 모드로 실행 중인지 여부를 나타냅니다. |
Boolean |
| os | tbot이 실행 중인 호스트의 OS이며, runtime.GOOS로 결정됩니다. |
string |
| recorded_at | Teleport Auth Service가 하트비트를 기록한 타임스탬프입니다. tbot이 이 필드에 제출한 값은 무시됩니다. |
|
| updater_info | 업데이트 그룹과 업데이터 상태를 포함해 외부 업데이터가 제공한 정보입니다. | Updater V2Info |
| uptime | tbot이 이 하트비트를 제출한 시점까지 실행된 기간입니다. |
|
| version | 이 하트비트를 제출한 tbot의 버전입니다. |
string |
Bot Kind#
봇이 tbot 바이너리인지, 다른 구성 요소에 내장되어 있는지를 식별합니다.
Join Attrs#
조인 과정에서 생성되는 속성의 모음입니다.
예시:
meta: # [...]
gitlab: # [...]
github: # [...]
iam: # [...]
tpm: # [...]
azure: # [...]
circleci: # [...]
bitbucket: # [...]
terraform_cloud: # [...]
spacelift: # [...]
gcp: # [...]
kubernetes: # [...]
oracle: # [...]
azure_devops: # [...]
env0: # [...]
generic_oidc: # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| azure | Azure(azure) 조인 방식에만 해당하는 속성입니다. |
Join Attrs Azure |
| azure_devops | Azure Devops(azure_devops) 조인 방식에만 해당하는 속성입니다. |
Join Attrs Azure Devops |
| bitbucket | Bitbucket(bitbucket) 조인 방식에만 해당하는 속성입니다. |
Join Attrs Bitbucket |
| circleci | CircleCI(circleci) 조인 방식에만 해당하는 속성입니다. |
Join Attrs CircleCI |
| env0 | Env0(env0) 조인 방식에만 해당하는 속성입니다. |
Join Attrs Env0 |
| gcp | GCP(gcp) 조인 방식에만 해당하는 속성입니다. |
Join Attrs GCP |
| generic_oidc | 일반 OIDC(generic_oidc) 조인 방식에만 해당하는 속성입니다. |
Join Attrs Generic OIDC |
| github | GitHub(github) 조인 방식에만 해당하는 속성입니다. |
Join Attrs GitHub |
| gitlab | GitLab(gitlab) 조인 방식에만 해당하는 속성입니다. |
Join Attrs GitLab |
| iam | AWS IAM(iam) 조인 방식에만 해당하는 속성입니다. |
Join Attrs AWS IAM |
| kubernetes | 쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다. |
Join Attrs Kubernetes |
| meta | 조인 과정에서 생성되지만 특정 조인 방식에 한정되지 않는 속성의 모음입니다. | Join Attrs Meta |
| oracle | Oracle(oracle) 조인 방식에만 해당하는 속성입니다. |
Join Attrs Oracle |
| spacelift | Spacelift(spacelift) 조인 방식에만 해당하는 속성입니다. |
Join Attrs Spacelift |
| terraform_cloud | Terraform Cloud(terraform_cloud) 조인 방식에만 해당하는 속성입니다. |
Join Attrs Terraform Cloud |
| tpm | TPM(tpm) 조인 방식에만 해당하는 속성입니다. |
Join Attrs TPM |
Join Attrs AWS IAM#
AWS IAM(iam) 조인 방식에만 해당하는 속성입니다. 일반적으로 조인 과정에서 호출하는 STS GetCallerIdentity 호출 결과에서 그대로 가져옵니다.
예시:
account: "string"
arn: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| account | 조인하는 엔티티가 속한 계정의 식별자입니다. 예: 123456789012 |
string |
| arn | 조인하는 엔티티의 AWS ARN입니다. 예: arn:aws:sts::123456789012:assumed-role/my-role-name/my-role-session-name |
string |
Join Attrs Azure#
Azure(azure) 조인 방식에만 해당하는 속성입니다.
예시:
subscription: "string"
resource_group: "string"
tenant: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| resource_group | 조인하는 엔티티가 속한 Azure 계정의 리소스 그룹입니다. | string |
| subscription | 조인하는 엔티티가 속한 Azure 계정의 구독 ID입니다. | string |
| tenant | 조인하는 엔티티가 속한 Azure 계정의 테넌트 ID입니다. | string |
Join Attrs Azure Devops#
Azure Devops(azure_devops) 조인 방식에만 해당하는 속성입니다.
예시:
pipeline: # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| pipeline | 파이프라인 ID 토큰으로 발생하는 조인에만 해당하는 속성입니다. | Join Attrs Azure Devops Pipeline |
Join Attrs Azure Devops Pipeline#
인증에 파이프라인 ID 토큰을 사용하는 경우 Azure DevOps 조인 방식에만 해당하는 속성입니다.
예시:
sub: "string"
organization_name: "string"
project_name: "string"
pipeline_name: "string"
organization_id: "string"
project_id: "string"
definition_id: "string"
repository_id: "string"
repository_version: "string"
repository_ref: "string"
run_id: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| definition_id | 실행 중인 파이프라인의 ID입니다. | string |
| organization_id | 파이프라인이 실행되는 조직의 ID입니다. | string |
| organization_name | 파이프라인이 실행되는 조직의 이름입니다. | string |
| pipeline_name | 실행 중인 파이프라인의 이름입니다. | string |
| project_id | 파이프라인이 실행되는 프로젝트의 ID입니다. | string |
| project_name | 파이프라인이 실행되는 프로젝트의 이름입니다. | string |
| repository_id | 파이프라인이 실행되는 리포지터리의 ID입니다. | string |
| repository_ref | 파이프라인이 실행 대상으로 삼는 리포지터리의 ref입니다. | string |
| repository_version | 파이프라인이 실행 대상으로 삼는 리포지터리의 버전입니다. Git의 경우 커밋 SHA입니다. | string |
| run_id | 실행 중인 런의 ID입니다. | string |
| sub | 조인에 사용된 Azure DevOps 파이프라인 ID 토큰의 sub 클레임입니다. |
string |
Join Attrs Bitbucket#
Bitbucket(bitbucket) 조인 방식에만 해당하는 속성입니다. BitBucket이 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://support.atlassian.com/bitbucket-cloud/docs/integrate-pipelines-with-resource-servers-using-oidc/ 에 문서화되어 있습니다.
예시:
sub: "string"
step_uuid: "string"
repository_uuid: "string"
pipeline_uuid: "string"
workspace_uuid: "string"
deployment_environment_uuid: "string"
branch_name: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| branch_name | 파이프라인이 실행 대상으로 삼는 브랜치의 이름입니다. | string |
| deployment_environment_uuid | 파이프라인이 실행 대상으로 삼는 배포 환경의 UUID입니다. | string |
| pipeline_uuid | 스텝이 실행되는 파이프라인의 UUID입니다. | string |
| repository_uuid | 파이프라인 스텝이 실행되는 리포지터리의 UUID입니다. | string |
| step_uuid | 파이프라인 스텝의 UUID입니다. | string |
| sub | 조인에 사용된 Bitbucket JWT의 sub 클레임입니다. |
string |
| workspace_uuid | 파이프라인이 속한 워크스페이스의 UUID입니다. | string |
Join Attrs CircleCI#
CircleCI(circleci) 조인 방식에만 해당하는 속성입니다. CircleCI가 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://circleci.com/docs/openid-connect-tokens/ 에 문서화되어 있습니다.
예시:
sub: "string"
context_ids:
- "string"
- "string"
- "string"
project_id: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| context_ids | 작업에서 사용된 컨텍스트의 UUID입니다. | []string |
| project_id | 작업이 실행되는 프로젝트의 UUID입니다. | string |
| sub | 조인에 사용된 CircleCI JWT의 sub 클레임입니다. 예: org/ORGANIZATION_ID/project/PROJECT_ID/user/USER_ID |
string |
Join Attrs Env0#
Env0(env0) 조인 방식에만 해당하는 속성입니다.
예시:
sub: "string"
organization_id: "string"
project_id: "string"
project_name: "string"
template_id: "string"
template_name: "string"
environment_id: "string"
environment_name: "string"
workspace_name: "string"
deployment_log_id: "string"
deployment_type: "string"
deployer_email: "string"
env0_tag: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| deployer_email | 배포를 트리거한 사람의 이메일이며, Env0 OIDC 토큰의 deployerEmail에 해당합니다. |
string |
| deployment_log_id | 이 배포의 고유 ID이며, Env0 OIDC 토큰의 deploymentLogId에 해당합니다. |
string |
| deployment_type | "deploy", "destroy" 등 env0 배포 유형입니다. Env0 OIDC 토큰의 deploymentType에 해당합니다. |
string |
| env0_tag | ENV0_OIDC_TAG가 설정된 경우의 사용자 지정 태그 값이며, env0Tag에 해당합니다. |
string |
| environment_id | Env0 환경의 고유 식별자이며, Env0 OIDC 토큰의 environmentId에 해당합니다. |
string |
| environment_name | Env0 환경의 이름이며, Env0 OIDC 토큰의 environmentName에 해당합니다. |
string |
| organization_id | 조직의 고유 식별자이며, Env0 OIDC 토큰의 organizationId에 해당합니다. |
string |
| project_id | 프로젝트의 고유 식별자이며, Env0 OIDC 토큰의 projectId에 해당합니다. |
string |
| project_name | 작업이 실행된 프로젝트의 이름이며, Env0 OIDC 토큰의 projectName에 해당합니다. |
string |
| sub | Env0 OIDC 토큰의 sub 클레임입니다. |
string |
| template_id | Env0 템플릿의 고유 식별자이며, Env0 OIDC 토큰의 templateId에 해당합니다. |
string |
| template_name | Env0 템플릿의 이름이며, Env0 OIDC 토큰의 templateName에 해당합니다. |
string |
| workspace_name | Env0 워크스페이스의 이름이며, Env0 OIDC 토큰의 workspaceName에 해당합니다. |
string |
Join Attrs GCP#
GCP(gcp) 조인 방식에만 해당하는 속성입니다. JWT 인스턴스 아이덴티티 토큰의 클레임에서 가져오며, 해당 클레임은 https://cloud.google.com/compute/docs/instances/verifying-instance-identity#payload 에 문서화되어 있습니다.
예시:
service_account: "string"
gce: # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| gce | 조인하는 엔티티가 GCE 인스턴스에 있는 경우 GCP 조인 방식에만 해당하는 속성입니다. 조인하는 엔티티가 GCE에 있지 않으면 존재하지 않을 수 있습니다. | Join Attrs GCP GCE |
| service_account | 인스턴스가 실행되는 서비스 계정의 이메일입니다. | string |
Join Attrs GCP GCE#
조인하는 엔티티가 GCE 인스턴스에 있는 경우 GCP 조인 방식에만 해당하는 속성입니다.
예시:
name: "string"
zone: "string"
id: "string"
project: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| id | 조인하는 엔티티가 실행 중인 GCE 인스턴스의 ID입니다. | string |
| name | 조인하는 엔티티가 실행 중인 GCE 인스턴스의 이름입니다. | string |
| project | 인스턴스가 실행되는 GCP 프로젝트의 프로젝트 ID입니다. | string |
| zone | 조인하는 엔티티가 실행 중인 GCE 인스턴스의 영역입니다. | string |
Join Attrs Generic OIDC#
일반 OIDC(generic_oidc) 조인 방식에만 해당하는 속성입니다.
예시:
claims: # See description
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| claims | 토큰 클레임의 전체 집합입니다. |
Join Attrs GitHub#
GitHub(github) 조인 방식에만 해당하는 속성입니다. 일반적으로 조인에 사용된 GitHub JWT의 클레임에서 그대로 가져옵니다. 해당 클레임에 대한 문서는 https://docs.github.com/en/actions/security-for-github-actions/security-hardening-your-deployments/about-security-hardening-with-openid-connect#understanding-the-oidc-token 에서 확인할 수 있습니다.
예시:
sub: "string"
actor: "string"
environment: "string"
ref: "string"
ref_type: "string"
repository: "string"
repository_owner: "string"
workflow: "string"
event_name: "string"
sha: "string"
run_id: "string"
enterprise: "string"
enterprise_id: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| actor | 워크플로 실행을 시작한 액터의 사용자 이름입니다. | string |
| enterprise | 리포지터리가 속한 엔터프라이즈의 이름이며, 있는 경우에만 설정됩니다. | string |
| enterprise_id | 리포지터리가 속한 엔터프라이즈의 ID이며, 있는 경우에만 설정됩니다. | string |
| environment | 워크플로가 실행 대상으로 삼는 환경의 이름이며, 있는 경우에만 설정됩니다. | string |
| event_name | 워크플로 실행을 트리거한 이벤트의 이름입니다. | string |
| ref | 워크플로가 실행 대상으로 삼는 ref입니다. | string |
| ref_type | 워크플로가 실행 대상으로 삼는 ref의 유형입니다. 예: branch. |
string |
| repository | 워크플로가 실행되는 리포지터리의 이름입니다. | string |
| repository_owner | 워크플로가 실행되는 리포지터리 소유자의 이름입니다. | string |
| run_id | 이 GitHub Actions 워크플로 실행의 ID입니다. | string |
| sha | 워크플로 실행을 트리거한 커밋의 SHA입니다. | string |
| sub | 조인에 사용된 GitHub JWT의 sub 클레임입니다. |
string |
| workflow | 실행 중인 워크플로의 이름입니다. | string |
Join Attrs GitLab#
GitLab 조인 방식에만 해당하는 속성입니다. 일반적으로 조인에 사용된 GitLab JWT의 클레임에서 그대로 가져옵니다. 해당 클레임에 대한 문서는 https://docs.gitlab.com/ee/ci/secrets/id_token_authentication.html#token-payload 에서 확인할 수 있습니다.
예시:
sub: "string"
ref: "string"
ref_type: "string"
ref_protected: true
namespace_path: "string"
project_path: "string"
user_login: "string"
user_email: "string"
pipeline_id: "string"
pipeline_source: "string"
environment: "string"
environment_protected: true
runner_id: 1
runner_environment: "string"
sha: "string"
ci_config_ref_uri: "string"
ci_config_sha: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| ci_config_ref_uri | 파이프라인을 구성하는 CI 구성의 ref URI입니다. | string |
| ci_config_sha | 파이프라인을 구성하는 CI 구성 ref의 Git SHA입니다. | string |
| environment | 파이프라인이 실행 대상으로 삼는 환경이며, 있는 경우에만 설정됩니다. | string |
| environment_protected | 파이프라인이 보호된 환경을 대상으로 실행되는지 여부입니다. 구성된 환경이 없으면 이 필드는 false입니다. | Boolean |
| namespace_path | 파이프라인이 실행되는 프로젝트의 네임스페이스 경로입니다. 예: mygroup |
string |
| pipeline_id | 파이프라인의 ID입니다. | string |
| pipeline_source | 파이프라인의 소스입니다. 예: push 또는 web |
string |
| project_path | 파이프라인이 실행되는 프로젝트의 정규화된 전체 경로입니다. 네임스페이스 경로를 포함합니다. 예: mygroup/my-project |
string |
| ref | 파이프라인이 실행 대상으로 삼는 ref입니다. 예: main |
string |
| ref_protected | 파이프라인이 실행 대상으로 삼는 ref가 보호되어 있는지 여부입니다. | Boolean |
| ref_type | 파이프라인이 실행 대상으로 삼는 ref의 유형입니다. 일반적으로 branch 또는 tag입니다. |
string |
| runner_environment | 파이프라인을 처리하는 러너의 유형입니다. gitlab-hosted 또는 self-hosted 중 하나입니다. |
string |
| runner_id | 이 파이프라인이 실행되는 러너의 ID입니다. | number |
| sha | 파이프라인 실행을 트리거한 커밋의 SHA입니다. | string |
| sub | 조인에 사용된 GitLab JWT의 sub 클레임입니다. 예: project_path:mygroup/my-project:ref_type:branch:ref:main |
string |
| user_email | 파이프라인 실행을 트리거한 사용자의 이메일입니다. | string |
| user_login | 파이프라인 실행을 트리거한 사용자의 이름입니다. | string |
Join Attrs Kubernetes#
쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다.
예시:
subject: "string"
service_account: # [...]
pod: # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| pod | 조인하는 엔티티가 Pod에 바인딩된 서비스 계정 토큰인 경우 쿠버네티스 조인 방식에만 해당하는 속성입니다. 조인하는 엔티티가 서비스 계정이고 토큰이 Pod에 바인딩된 경우에만 존재합니다. | Join Attrs Kubernetes Pod |
| service_account | 조인하는 엔티티가 서비스 계정 토큰인 경우 쿠버네티스 조인 방식에만 해당하는 속성입니다. 조인하는 엔티티가 (사람 사용자 등이 아닌) 서비스 계정인 경우에만 존재합니다. | Join Attrs Kubernetes Service Account |
| subject | 쿠버네티스 토큰을 기준으로 한 엔티티의 정규화된 식별자입니다. 서비스 계정의 경우 system:serviceaccount:\<namespace\>:\<service-account-name\> 형식입니다. |
string |
Join Attrs Kubernetes Pod#
Pod에 바인딩된 서비스 계정 토큰을 사용하는 경우 쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다.
예시:
name: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| name | 조인하는 엔티티가 실행되는 서비스 계정의 이름입니다. | string |
Join Attrs Kubernetes Service Account#
서비스 계정 토큰을 사용하는 경우 쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다.
예시:
name: "string"
namespace: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| name | 조인하는 엔티티가 실행되는 서비스 계정의 이름입니다. | string |
| namespace | 조인하는 엔티티가 실행되는 서비스 계정의 네임스페이스입니다. | string |
Join Attrs Meta#
조인 과정에서 생성되지만 특정 조인 방식에 한정되지 않는 속성의 모음입니다.
예시:
join_token_name: "string"
join_method: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| join_method | 조인에 사용된 조인 방식의 이름입니다. 예: gitlab |
string |
| join_token_name | 조인에 사용된 조인 토큰의 이름입니다. 조인에 사용된 조인 토큰이 token 방식이면 조인 토큰의 이름이 민감 정보이므로 이 필드는 생략됩니다. 예: my-gitlab-join-token |
string |
Join Attrs Oracle#
Oracle(oracle) 조인 방식에만 해당하는 속성입니다.
예시:
tenancy_id: "string"
compartment_id: "string"
instance_id: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| compartment_id | 인스턴스가 속한 컴파트먼트의 ID입니다. | string |
| instance_id | 인스턴스의 ID입니다. | string |
| tenancy_id | 인스턴스가 속한 테넌트의 ID입니다. | string |
Join Attrs Spacelift#
Spacelift(spacelift) 조인 방식에만 해당하는 속성입니다. Spacelift가 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://docs.spacelift.io/integrations/cloud-providers/oidc/#standard-claims 에 문서화되어 있습니다.
예시:
sub: "string"
space_id: "string"
caller_type: "string"
caller_id: "string"
run_type: "string"
run_id: "string"
scope: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| caller_id | 런을 생성한 호출자의 ID입니다. | string |
| caller_type | 런을 소유한 호출자의 유형이며, stack 또는 module 중 하나입니다. |
string |
| run_id | 런의 ID입니다. | string |
| run_type | 런의 유형이며, PROPOSED, TRACKED, TASK, TESTING, DESTROY 중 하나입니다. |
string |
| scope | 토큰에 구성된 범위이며, read 또는 write 중 하나입니다. |
string |
| space_id | 런이 실행되는 스페이스의 ID입니다. | string |
| sub | 조인에 사용된 Spacelift JWT의 sub 클레임입니다. |
string |
Join Attrs TPM#
TPM(tpm) 조인 방식에만 해당하는 속성입니다.
예시:
ek_pub_hash: "string"
ek_cert_serial: "string"
ek_cert_verified: true
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| ek_cert_serial | EK 인증서의 일련번호이며, 있는 경우에만 설정됩니다. | string |
| ek_cert_verified | EK 인증서가 인증 기관을 기준으로 검증되었는지 여부입니다. | Boolean |
| ek_pub_hash | PKIX 형식 EK 공개 키의 SHA256 해시를 16진수로 인코딩한 값입니다. 사실상 특정 TPM을 식별합니다. | string |
Join Attrs Terraform Cloud#
Terraform Cloud(terraform_cloud) 조인 방식에만 해당하는 속성입니다. Terraform Cloud가 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://developer.hashicorp.com/terraform/enterprise/workspaces/dynamic-provider-credentials/workload-identity-tokens 에 문서화되어 있습니다.
예시:
sub: "string"
organization_name: "string"
project_name: "string"
workspace_name: "string"
full_workspace: "string"
run_id: "string"
run_phase: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| full_workspace | 조직과 프로젝트 이름을 포함한 정규화된 워크스페이스 경로입니다. 예: organization:\<name\>:project:\<name\>:workspace:\<name\> |
string |
| organization_name | 프로젝트와 워크스페이스가 속한 조직의 이름입니다. | string |
| project_name | 워크스페이스가 속한 프로젝트의 이름입니다. | string |
| run_id | 실행 중인 런의 ID입니다. | string |
| run_phase | 실행 중인 런의 단계이며, plan 또는 apply 중 하나입니다. |
string |
| sub | 조인에 사용된 Terraform Cloud JWT의 sub 클레임입니다. |
string |
| workspace_name | plan/apply가 실행되는 워크스페이스의 이름입니다. | string |
Metadata#
리소스 메타데이터입니다.
예시:
name: "string"
namespace: "string"
description: "string"
labels:
"string": "string"
"string": "string"
"string": "string"
expires: # See description
revision: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| description | 객체에 대한 설명입니다. | string |
| expires | 시스템의 모든 리소스에 설정할 수 있는 전역 만료 시간 헤더입니다. | |
| labels | 라벨의 집합입니다. | map[string]string |
| name | 객체의 이름입니다. | string |
| namespace | 객체의 네임스페이스입니다. 이 필드는 Teleport 2.4에서 반환될 때 "namespace"라는 이름이어야 합니다. | string |
| revision | 시간에 따른 리소스 버전을 추적하는 불투명 식별자입니다. 클라이언트는 이 값을 무시하고 변경해서는 안 되며, 리소스를 업데이트할 때는 반드시 이 리비전을 그대로 반환해야 합니다. | string |
Updater Status#
에이전트가 판단한 자동 업데이트 상태를 나타냅니다. 1: 업데이터 상태가 정상입니다. 2: 자동 업데이트가 비활성화되었거나 일시 중지된 것으로 보입니다. 3: 특정 버전이 고정되어 있습니다. 4: 에이전트가 업데이트 상태를 읽지 못했습니다.
Updater V2Info#
Teleport 업데이터의 동작 상태에 대한 정보를 Teleport에 전달하는 데 사용됩니다.
예시:
UpdateGroup: "string"
UpdateUUID: BASE64_STRING
UpdaterStatus: # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| UpdateGroup | 에이전트의 업데이터가 속한 업데이트 그룹입니다. autoupdate_agent_rollout 리소스가 그룹별 업데이트 시점을 제어합니다. Hello에 업데이트 그룹을 보고하면 그룹별 업데이트 진행 상황을 추적할 수 있습니다. 자세한 내용은 RFD 184를 참고하십시오. | string |
| UpdateUUID | 에이전트 업데이터의 UUID입니다. 각 업데이터는 UUID를 가지며, 다음 두 경우에 사용할 수 있습니다. - 카나리 업데이트 시 개별 에이전트를 업데이트하는 경우 - 점진적 롤아웃 시 교착 상태를 피하기 위해 업데이트되지 않은 가장 낮은 버전의 에이전트를 추적하는 경우 | base64-encoded string |
| UpdaterStatus | Teleport 클러스터가 알아야 하는 업데이터 관련 상태 정보를 나타냅니다. 예를 들어 업데이터가 비활성화되었거나, 버전이 고정되었거나, 업데이터가 실행 중이 아닌 것으로 보이는 경우입니다. | Updater Status |