Secrets

​

자주 쓰는 예시

​

동작 방식

• 전송 전에 암호화돼요: Secret을 만들 때 값이 사용자 컴퓨터에서 조직 공개 키로 봉인(sealed-box)돼서, 평문이 요청 본문이나 접근 로그에 남지 않아요. VESSL Cloud는 저장할 때 master key로 다시 암호화해서 암호문만 보관해요.
• 제출 시점에 주입돼요: 워크로드를 제출하면 VESSL Cloud가 서버에서 값을 복호화해 Kubernetes Secret으로 컨테이너에 전달하고, 컨테이너가 시작될 때 환경 변수로 주입돼요.
• 값은 다시 볼 수 없어요: Secret을 저장하고 나면 VESSL Cloud는 값을 멤버든 admin이든 누구에게도 다시 보여주지 않아요. 목록과 상세 화면에는 메타데이터만 보여요. 값을 바꾸려면 admin이 새 값으로 덮어써야 해요(rotation). 이전 값은 다시 가져올 수 없어요.
• 조직 단위로 공유돼요: 한 조직 안의 모든 팀이 같은 Secret을 공유해요. 조직 내 어떤 배치 잡에서든 이름으로 참조할 수 있어요.
• 생성은 누구나, 변경은 관리자만 할 수 있어요: 조직에 속한 누구나 Secret을 조회하고 새로 만들 수 있어요. 수정과 삭제는 Organization admin만 할 수 있고, 멤버가 만든 Secret도 마찬가지예요. 멤버 화면의 Secret 목록에는 수정과 삭제 메뉴가 보이지 않아요.

​

Secret 만들기

​

GUI

1. 사이드바에서 Settings를 선택해요.
2. Account 메뉴에서 Secrets를 선택해요.
3. New Secret을 클릭해요.
4. Secret name, Key, Value를 입력해요.
5. Create를 눌러 등록해요.

​

CLI

# 대화형 프롬프트로 입력(터미널일 때 마스킹 처리)
vesslctl secret create HF_TOKEN HF_TOKEN

# 환경 변수에서 값 읽기
vesslctl secret create HF_TOKEN HF_TOKEN --from-env LOCAL_HF_TOKEN

# 표준 입력에서 값 읽기
echo "$HF_TOKEN" | vesslctl secret create HF_TOKEN HF_TOKEN --from-stdin

# 설명 추가
vesslctl secret create HF_TOKEN HF_TOKEN -d "Hugging Face 토큰(프로덕션)"

​

Job에서 Secret 사용하기

​

GUI

​

CLI

# HF_TOKEN 환경 변수로 주입(같은 이름의 Secret을 참조)
vesslctl job create ... --secret HF_TOKEN

# OPENAI_API_KEY 환경 변수로 주입(openai-prod라는 이름의 Secret을 참조)
vesslctl job create ... --secret OPENAI_API_KEY=openai-prod

# 여러 개 동시에 주입
vesslctl job create ... --secret HF_TOKEN --secret OPENAI_API_KEY

• --secret NAME은 Secret을 같은 이름의 환경 변수로 주입해요.
• --secret KEY=NAME은 KEY라는 환경 변수로 주입하고, NAME이라는 Secret을 참조해요.
• 같은 환경 변수 키를 --env와 --secret에서 둘 다 지정할 수는 없어요. CLI가 명령을 거부하니 키마다 한쪽 플래그만 사용하세요.

​

Secret 목록 보기

# 활성 Secret 목록
vesslctl secret list

# 소프트 삭제된 Secret까지 포함
vesslctl secret list --include-deleted

​

FAQ