tag 명령어를 사용하면 조직 수준에서 태그를 생성, 조회, 삭제할 수 있어요. 태그를 Job에 부착해서 분류와 필터링에 활용할 수 있어요.
create
조직에 새 태그를 생성해요.
vesslctl tag create <value>
| 플래그 | 기본값 | 설명 |
|---|
--color | #808080 | 태그 색상 (hex 형식, 예: #ff0000) |
예시:
vesslctl tag create "experiment-v2" --color "#3b82f6"
list
조직의 모든 태그를 조회해요.
출력 예시:
SLUG VALUE COLOR CREATOR CREATED
tag-abc123 experiment-v2 #3b82f6 wayne 2026-04-15T09:00:00Z
tag-def456 baseline #808080 alice 2026-04-14T15:30:00Z
delete
값 또는 slug로 태그를 삭제해요.
vesslctl tag delete [value]
| 인자 | 설명 |
|---|
value | 삭제할 태그 값 (--slug과 함께 사용 불가) |
| 플래그 | 단축 | 설명 |
|---|
--slug | -s | 값 대신 slug로 태그 삭제 |
예시:
# 값으로 삭제
vesslctl tag delete "experiment-v2"
# slug로 삭제
vesslctl tag delete -s tag-abc123
Job 태그 명령어
vesslctl job tag를 사용하면 Job에 태그를 부착하거나 해제할 수 있어요. 존재하지 않는 태그 값을 부착하면 자동으로 생성돼요.
job tag attach
Job에 태그를 부착해요.
vesslctl job tag attach <slug> [tagValue]
| 인자 | 설명 |
|---|
slug | Job의 slug |
tagValue | 부착할 태그 값 (미존재 시 자동 생성) |
| 플래그 | 단축 | 설명 |
|---|
--slug | -s | 값 대신 slug로 태그 부착 |
예시:
# 값으로 부착 (태그 자동 생성)
vesslctl job tag attach job-abc123 "nightly-run"
# slug로 부착
vesslctl job tag attach job-abc123 -s tag-def456
job tag detach
Job에서 태그를 해제해요.
vesslctl job tag detach <slug> [tagValue]
| 인자 | 설명 |
|---|
slug | Job의 slug |
tagValue | 해제할 태그 값 |
| 플래그 | 단축 | 설명 |
|---|
--slug | -s | 값 대신 slug로 태그 해제 |
예시:
vesslctl job tag detach job-abc123 "nightly-run"
vesslctl job create --tag "my-tag"으로 Job 생성 시 태그를 함께 부착할 수 있어요. --tag 플래그는 반복 사용 가능하며, 존재하지 않는 태그는 자동 생성돼요.