메인 콘텐츠로 건너뛰기
tag 명령어를 사용하면 조직 수준에서 태그를 생성, 조회, 삭제할 수 있어요. 태그를 Job에 부착해서 분류와 필터링에 활용할 수 있어요.

create

조직에 새 태그를 생성해요.
vesslctl tag create <value>
인자설명
value태그의 표시 이름
플래그기본값설명
--color#808080태그 색상 (hex 형식, 예: #ff0000)
예시:
vesslctl tag create "experiment-v2" --color "#3b82f6"

list

조직의 모든 태그를 조회해요.
vesslctl tag 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]
인자설명
slugJob의 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]
인자설명
slugJob의 slug
tagValue해제할 태그 값
플래그단축설명
--slug-s값 대신 slug로 태그 해제
예시:
vesslctl job tag detach job-abc123 "nightly-run"
vesslctl job create --tag "my-tag"으로 Job 생성 시 태그를 함께 부착할 수 있어요. --tag 플래그는 반복 사용 가능하며, 존재하지 않는 태그는 자동 생성돼요.