워크로드 클러스터
Teleport v18.11요약
workload_cluster 리소스를 사용하면 Teleport Cloud 클러스터를 자동으로 프로비저닝하고 프로비저닝 해제할 수 있습니다. 이 가이드에서는 다음 방법을 다룹니다. 상위 Teleport Cloud 클러스터에 workload_cluster 리소스를 생성하면 Teleport Cloud가 하위 Teleport Cloud 클러스터를 프로비저닝합니다.
workload_cluster 리소스를 사용하면 Teleport Cloud 클러스터를 자동으로 프로비저닝하고
프로비저닝 해제할 수 있습니다. 워크로드 클러스터를 생성하면 Teleport Cloud는
프로비저닝된 Teleport Cloud 클러스터에 Bot, 토큰, 역할도 함께 생성하여
자동화 작업이 해당 클러스터의 사용자와 역할을 생성, 조회, 업데이트할 수 있도록 합니다.
이 가이드에서는 다음 방법을 다룹니다.
- 상위 Teleport Cloud 클러스터에
workload_cluster리소스를 생성합니다. - 하위 Teleport Cloud 클러스터가 활성화될 때까지 기다립니다.
tbot이 하위 Teleport Cloud 클러스터에 조인하도록 구성합니다.tbot이 생성한 아이덴티티를 사용하여tctl로 하위 Teleport Cloud 클러스터의 사용자와 역할을 생성, 조회, 업데이트합니다.
작동 방식#
상위 Teleport Cloud 클러스터에 workload_cluster 리소스를 생성하면
Teleport Cloud가 하위 Teleport Cloud 클러스터를 프로비저닝합니다.
하위 Teleport Cloud 클러스터는 수명 주기를 상위 Teleport Cloud 클러스터에서 관리하는 별도의 Teleport Cloud 클러스터입니다. 트러스티드 클러스터와는 다릅니다.
상위 Teleport Cloud 클러스터의 변경 사항은 하위 Teleport Cloud 클러스터에 영향을 주지 않습니다. 상위 Teleport Cloud 클러스터는 하위 Teleport Cloud 클러스터를 프로비저닝하고 프로비저닝 해제하는 작업만 수행할 수 있습니다.
하위 Teleport Cloud 클러스터가 프로비저닝되면 Teleport Cloud는 다음도 함께 생성합니다.
- 하위 Teleport Cloud 클러스터의 Bot
- 해당 Bot의 조인 토큰
- 해당 Bot의 역할
이후 해당 Bot은 tbot을 통한 IAM 조인으로 하위 Teleport Cloud 클러스터에 조인할 수
있습니다. tbot이 생성한 아이덴티티로 하위 Teleport Cloud 클러스터의 사용자와
역할을 생성, 조회, 업데이트할 수 있습니다.
사전 요구사항#
workload_cluster는 현재 IAM 조인만 지원하므로 이 가이드는 하위 Teleport Cloud
클러스터 Bot에 AWS IAM 조인을 사용합니다. IAM 조인에 대한 자세한 내용은
조인 방식 레퍼런스를
참조하십시오.
- 상위 클러스터로 사용할 Teleport Cloud 클러스터.
Teleport Cloud 고객은 워크로드 클러스터 기능을 활성화하려면 support@goteleport.com으로 지원팀에 문의해야 합니다.
tctl과tbot이 설치되어 있어야 합니다. 설치 및 배포 안내는 Machine & Workload Identity 배포 가이드를 참조하십시오.- 하위 Teleport Cloud 클러스터 Bot에 구성된 IAM 조인 토큰 규칙과 일치하는 AWS 아이덴티티.
1/5단계. 상위 클러스터에서 RBAC 구성#
workload_cluster 리소스를 생성하고 삭제하려면 상위 클러스터의 Teleport 사용자에게
해당 리소스 유형을 관리할 권한이 필요합니다.
사용자가 이미 workload_cluster 리소스를 관리할 수 있다면 이 단계를 건너뜁니다.
workload-cluster-editor.yaml 파일을 생성합니다.
kind: role
version: v8
metadata:
name: workload-cluster-editor
spec:
allow:
rules:
- resources:
- workload_cluster
verbs:
- create
- delete
- list
- read
- update
tctl을 사용하여 역할을 생성합니다.
$ tctl create -f workload-cluster-editor.yaml
상위 클러스터의 사용자에게 역할을 할당합니다. alice를 Teleport 사용자 이름으로
바꾸고 해당 사용자에게 이미 필요한 역할도 포함합니다.
$ tctl users update --set-roles editor,workload-cluster-editor alice
2/5단계. 워크로드 클러스터 생성#
workload-cluster.yaml 파일을 생성합니다.
kind: workload_cluster
version: v1
metadata:
name: company-organization
spec:
regions:
- name: us-west-2
bot:
name: example-iam
token:
join_method: iam
allow:
- aws_account: "123456789012"
aws_arn: "arn:aws:sts::123456789012:assumed-role/example-tbot-role/session-name"
다음 값을 바꿉니다.
company-organization을 Teleport Cloud가 생성할 Teleport Cloud 클러스터의 이름으로 바꿉니다.us-west-2를 하위 Teleport Cloud 클러스터의 Teleport Cloud 리전으로 바꿉니다. 사용 가능한 Auth 리전은 Teleport Cloud 아키텍처를 참조하십시오.example-iam을tbot이 사용할 Bot 및 토큰 이름으로 바꿉니다.123456789012와arn:aws:sts::123456789012:assumed-role/example-tbot-role/session-name을tbot이 조인할 AWS 아이덴티티와 일치하는 값으로 바꿉니다.
tctl을 사용하여 상위 클러스터에 리소스를 생성합니다.
$ tctl --auth-server parent.teleport.sh:443 create -f workload-cluster.yaml
워크로드 클러스터 구성은 생성한 후에는 수정할 수 없습니다.
Teleport Cloud 클러스터 도메인은 리소스 이름에서 파생됩니다. 이 예시에서
하위 Teleport Cloud 클러스터는 company-organization.teleport.sh 도메인을 사용합니다.
3/5단계. 하위 Teleport Cloud 클러스터가 활성화될 때까지 대기#
status.state 필드가 active가 될 때까지 리소스를 조회합니다.
$ tctl --auth-server parent.teleport.sh:443 get workload_cluster/company-organization
출력 예시:
kind: workload_cluster
version: v1
metadata:
name: company-organization
spec:
regions:
- name: us-west-2
bot:
name: example-iam
token:
join_method: iam
allow:
- aws_account: "123456789012"
aws_arn: "arn:aws:sts::123456789012:assumed-role/example-tbot-role/session-name"
status:
domain: company-organization.teleport.sh
state: active
리소스가 활성화되면 tbot과 tctl을 하위 Teleport Cloud 클러스터에 연결할 때
status.domain 값을 사용합니다.
4/5단계. tbot을 사용하여 하위 Teleport Cloud 클러스터에 조인#
tbot.yaml 파일을 생성합니다.
version: v2
oneshot: true
proxy_server: company-organization.teleport.sh:443
onboarding:
join_method: iam
token: example-iam
storage:
type: memory
services:
- type: identity
destination:
type: directory
path: ./tbot-output
다음 값을 바꿉니다.
company-organization.teleport.sh:443을status.domain에서 확인한 하위 Teleport Cloud 클러스터의 프록시 주소로 바꿉니다.example-iam을spec.bot.name의 Bot 이름으로 바꿉니다.
tbot을 실행하기 전에 토큰의 IAM 조인 규칙을 만족하는 아이덴티티로 AWS에 인증합니다.
그런 다음 tbot을 실행합니다.
$ tbot start -c ./tbot.yaml
이 명령은 ./tbot-output/identity에 아이덴티티 파일을 기록합니다. 이 아이덴티티를
tctl과 함께 사용하여 하위 Teleport Cloud 클러스터의 사용자와 역할을 생성, 조회,
업데이트합니다.
5/5단계. 하위 Teleport Cloud 클러스터에서 사용자와 역할 관리#
child-role.yaml에 하위 Teleport Cloud 클러스터용 역할 정의를 작성합니다.
kind: role
version: v8
metadata:
name: child-auditor
spec:
allow:
rules:
- resources:
- role
- user
verbs:
- list
- read
tbot이 생성한 아이덴티티를 사용하여 하위 Teleport Cloud 클러스터에 역할을
생성합니다.
$ tctl --auth-server company-organization.teleport.sh:443 -i ./tbot-output/identity create -f child-role.yaml
이제 하위 Teleport Cloud 클러스터에 사용자를 생성하고 새 역할을 할당합니다.
$ tctl --auth-server company-organization.teleport.sh:443 -i ./tbot-output/identity users add --roles child-auditor example-user
같은 아이덴티티로 하위 Teleport Cloud 클러스터의 역할을 조회할 수도 있습니다.
$ tctl --auth-server company-organization.teleport.sh:443 -i ./tbot-output/identity get role/child-auditor
워크로드 클러스터 삭제#
하위 Teleport Cloud 클러스터가 더 이상 필요하지 않으면 상위 클러스터에서
workload_cluster 리소스를 제거합니다.
$ tctl --auth-server parent.teleport.sh:443 rm workload_cluster/company-organization
workload_cluster 리소스를 삭제한 후에도 Teleport Cloud는 하위 Teleport Cloud
클러스터를 14일의 유예 기간 동안 유지합니다. 이 기간에는 클러스터 이름을 다시 사용할 수
없습니다. 클러스터 접근 권한을 복원하거나 신속한 삭제를 요청하려면
support@goteleport.com으로
지원팀에 문의합니다.
tctl 대신 Go SDK 사용#
tctl 같은 클라이언트 도구에 의존하는 대신 Teleport의 Go SDK로 이 워크플로를
자동화할 수 있습니다.
Teleport API에 대한 일반 안내는 Teleport API 사용하기와 Teleport API 시작하기를 참조하십시오.
Teleport 리포지터리에는 Go SDK를 사용하여 다음을 수행하는 예제가 포함되어 있습니다.
- 상위 Teleport Cloud 클러스터에 연결된 Teleport API 클라이언트를 생성합니다.
- 상위 Teleport Cloud 클러스터에
workload_cluster리소스를 생성합니다. workload_cluster리소스가active상태로 보고될 때까지 기다립니다.tbot바이너리를 사용하여 하위 Teleport Cloud 클러스터의 아이덴티티 파일을 가져옵니다.- 하위 Teleport Cloud 클러스터에 역할과 사용자를 생성합니다.
- 새 사용자의 초대 링크를 생성합니다.
- 상위 Teleport Cloud 클러스터의
workload_cluster리소스를 삭제합니다.
워크로드 클러스터 Go 예제를 실행하려면 다음 단계를 따릅니다.
-
상위 Teleport Cloud 클러스터에 로그인합니다(
parent.teleport.sh를 Teleport Cloud 클러스터의 주소로 바꿉니다).$ tsh login --proxy parent.teleport.sh -
Teleport 리포지터리를 클론합니다.
$ git clone --depth=1 https://github.com/gravitational/teleport -
워크로드 클러스터 예제로 이동합니다.
$ cd ./teleport/examples/workload-clusters/ -
main.go에서parent.teleport.sh,company-organization,account,arn을 각각 상위 Teleport Cloud 클러스터 주소, 원하는 워크로드 클러스터 이름, 유효한 AWS 계정 ID,tbot이 IAM 조인에 사용할 수 있는 유효한 AWS ARN으로 바꿉니다. -
workload_cluster리소스에서 참조하는 아이덴티티로 AWS에 인증한 다음 Go 프로그램을 실행합니다.$ go run ./
다음 단계#
- 전체 스키마는 워크로드 클러스터 리소스 레퍼런스를 참조하십시오.
- 더 많은
tbot옵션은 Machine & Workload Identity 구성 레퍼런스를 참조하십시오. - 상위 및 하위 Teleport Cloud 클러스터에서 더 정밀한 RBAC를 정의하려면 역할 리소스 레퍼런스를 검토하십시오.