GitLab Secrets Manager 크레딧 사용량
GitLab v19.5Offering: GitLab.com, GitLab Self-Managed
요약
GitLab Secrets Manager 사용량은 두 가지 미터를 기준으로 GitLab Credits를 소비합니다: GitLab Secrets Manager에 사용되는 GitLab Credits는 최상위 그룹(네임스페이스) 또는 인스턴스 구독에서 사용할 수 있는 월간 커밋 풀과 온디맨드 크레딧에서 차감됩니다.
GitLab Secrets Manager 사용량은 두 가지 미터를 기준으로 GitLab Credits를 소비합니다:
- 저장된 시크릿: Secrets Manager에 보관된 시크릿 수이며, 시크릿당 월 단위로 측정합니다.
- 시크릿 작업: 시크릿을 가져오는 것(파이프라인, Kubernetes 클러스터 또는 API에서)이 하나의 작업입니다. 시크릿 업데이트와 삭제는 작업으로 계산하지 않습니다.
GitLab Credits 소비#
GitLab Secrets Manager에 사용되는 GitLab Credits는 최상위 그룹(네임스페이스) 또는 인스턴스 구독에서 사용할 수 있는 월간 커밋 풀과 온디맨드 크레딧에서 차감됩니다.
- GitLab.com에서는 하위 그룹과 프로젝트가 최상위 그룹의 크레딧을 소비합니다.
- GitLab Self-Managed에서는 하위 그룹과 프로젝트가 인스턴스 수준 크레딧을 소비합니다.
각 사용자에게 할당된 포함 크레딧은 GitLab Secrets Manager에 적용되지 않습니다.
GitLab Credits 사용량 상한은 Secrets Manager 사용을 제한하지 않습니다. 사용량이 개별 사용자에게 귀속되지 않으므로 사용자별 상한이 적용되지 않으며, 네임스페이스 지출 상한도 Secrets Manager 소비를 차단하지 않습니다.
시크릿 저장과 작업에는 다음 요율에 따라 크레딧이 소비됩니다:
| 유형 | 요율 | 크레딧 | 세부 정보 |
|---|---|---|---|
| 저장된 시크릿 | 시크릿 1개, 월 단위 | 1 | 크레딧 소비는 시크릿이 존재한 기간에 따라 일 단위로 일할 계산됩니다. 예를 들어 시크릿 2개를 반달 동안 저장하면 크레딧 1개를 소비합니다. |
| 시크릿 읽기 | 읽기 2,500회 | 1 | 모든 시크릿에 걸친 시크릿 읽기 작업. CI/CD job, Secrets Manager API 또는 통합(ESO, Terraform, OpenBao CLI)으로 시크릿을 가져오는 것을 포함합니다. |
크레딧 사용량은 GitLab Credits 대시보드에서 확인하고 관리합니다.
CI/CD job에서#
CI/CD job에서 성공적으로 가져온 각 시크릿은 job이 나중에 실패하더라도 읽기 작업 하나로 계산합니다. 시크릿을 여러 개 참조하는 job은 시크릿마다 읽기 작업을 한 번씩 수행합니다. job을 재시도하면 시크릿을 다시 가져옵니다.
읽기 작업이 실패하면 시크릿 작업은 크레딧을 소비하지 않습니다. 다음과 같은 경우가 포함됩니다:
- 참조한 시크릿이 없는 경우.
- 권한 오류로 읽기에 실패한 경우.
예시#
여러 상황에서 시크릿의 예상 월간 소비량을 가늠할 수 있도록 몇 가지 예시를 소개합니다:
- 시크릿 25개를 저장하고 월 500개 파이프라인을 실행하며 파이프라인당 시크릿 5개를 읽는 소규모 팀.
- 저장: 시크릿 25개 = 크레딧 25개
- 작업: 읽기 2,500회 = 크레딧 1개
- 월간 합계: 크레딧 26개
- 개발, 스테이징, 프로덕션 환경에 걸쳐 시크릿 120개를 저장하고 월 2,000개 파이프라인을 실행하며
파이프라인당 시크릿 5개를 읽는 다중 환경 애플리케이션.
- 저장: 시크릿 120개 = 크레딧 120개
- 작업: 읽기 10,000회 = 크레딧 4개
- 월간 합계: 크레딧 124개
- 시크릿 1,000개를 저장하고 월 50,000개 파이프라인을 실행하며
파이프라인당 시크릿 10개를 읽는 엔터프라이즈 규모 사용.
- 저장: 시크릿 1,000개 = 크레딧 1,000개
- 작업: 읽기 500,000회 = 크레딧 200개
- 월간 합계: 크레딧 1,200개
GitLab Self-Managed에서의 라이선스#
GitLab Self-Managed 고객은 클라우드 라이선스 또는 오프라인 라이선스로 GitLab Secrets Manager를 사용할 수 있습니다. 오프라인 라이선스 고객은 GitLab Secrets Manager 애드온을 구매해야 합니다.
이 애드온을 보유한 고객은 고객당 정액 요금으로 Enterprise License Agreement(ELA)에 따라 청구됩니다.
클라우드 라이선스 고객은 애드온 없이 Secrets Manager를 사용할 수 있으며 사용량에 따라 청구됩니다.
GitLab Secrets Manager 애드온(ELA)을 구매하려면 GitLab 영업팀에 문의합니다.
구독이 종료될 때#
네임스페이스의 Premium 또는 Ultimate 구독이 취소되거나 만료되면 Secrets Manager는 구독 종료일부터 14일의 유예 기간에 들어갑니다.
유예 기간 동안:
- 파이프라인과 서비스 계정은 시크릿 읽기 작업을 계속 수행할 수 있습니다.
- 시크릿을 만들거나 업데이트할 수 없지만, 세부 정보를 보고 시크릿을 삭제할 수는 있습니다.
유예 기간이 끝나면 시크릿 읽기 작업이 차단됩니다. GitLab은 시크릿을 삭제하지 않으며, 기존 시크릿의 세부 정보를 보거나 삭제할 수는 있습니다.
전체 액세스를 복원하려면 구독을 갱신합니다.
GitLab Self-Managed에서는 다음과 같습니다:
- 온라인 클라우드 라이선스에는 같은 14일 유예 기간이 적용됩니다. 유예 기간은 라이선스 또는 Secrets Manager 애드온이 종료되는 시점에 시작됩니다.
- 오프라인 라이선스에서는 라이선스에 GitLab Secrets Manager가 더 이상 포함되지 않는 즉시 시크릿 작업이 차단됩니다. 오프라인 라이선스에는 유예 기간이 없습니다. GitLab은 시크릿을 삭제하지 않으며, 기존 시크릿의 세부 정보를 보거나 삭제할 수는 있습니다.
베타 종료#
GitLab Secrets Manager 베타 사용은 GitLab Credits를 소비하지 않았습니다.
- GitLab.com 베타는 2026년 9월 21일에 종료되었습니다.
- GitLab Self-Managed 베타는 인스턴스를 GitLab 19.5 이상으로 업그레이드하면 종료됩니다.
GitLab.com에서 체험판을 시작하지 않았다면 GitLab Secrets Manager가 비활성화되고 시크릿은 읽기 전용이 됩니다. 기존 시크릿의 세부 정보를 보거나 삭제할 수 있습니다.
액세스를 복원하려면 체험판을 시작하거나 GitLab Credits로 GitLab Secrets Manager를 활성화합니다.
체험판 시작#
30일 무료 체험판으로 GitLab Secrets Manager를 평가할 수 있습니다. 체험판은 저장된 시크릿과 시크릿 작업에 사용할 수 있는 500개의 임시 평가용 크레딧 풀을 제공합니다.
체험판은 다음 중 먼저 발생하는 시점에 종료됩니다:
- 활성화한 지 30일이 지납니다.
- 임시 평가용 크레딧을 모두 소비합니다.
임시 평가용 크레딧은 사용자별로 할당되지 않고 네임스페이스 전체에서 공유됩니다. 이월되지 않으며 만료된 뒤에는 사용할 수 없습니다.
구독당 체험판은 한 번만 활성화할 수 있습니다. 네임스페이스가 이전에 체험판을 사용한 적이 있으면 다른 체험판을 활성화할 수 없습니다.
체험판 중에 GitLab Secrets Manager를 비활성화한 경우 체험 기간이 끝나기 전에는 언제든지 다시 활성화할 수 있습니다.
체험판이 끝나면:
- 구독에 사용 가능한 GitLab Credits가 있으면 월간 커밋 풀, 그다음 온디맨드 크레딧 순으로 차감하며 중단 없이 사용이 계속됩니다.
- GitLab Credits를 사용할 수 없으면 Secrets Manager 작업이 차단되어 읽기 작업과 이에 의존하는 파이프라인이 실패합니다. 액세스를 복원하려면 GitLab Credits를 구매해야 합니다.
GitLab.com에서#
사전 요구 사항:
- 최상위 그룹의 Owner 권한이 있어야 합니다.
체험판을 시작하려면 다음과 같이 합니다:
- 상단 바에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
- 왼쪽 사이드바에서 Secure > Secrets manager를 선택합니다.
- Start 30-day trial을 선택합니다.
- 확인 대화 상자에서 Start 30-day trial을 선택합니다.
GitLab Self-Managed에서#
관리자가 인스턴스의 체험판을 시작합니다. 체험판 크레딧은 인스턴스의 모든 그룹과 프로젝트가 공유합니다. 오프라인 인스턴스는 체험판을 시작할 수 없습니다.
사전 요구 사항:
- 관리자 액세스 권한이 있어야 합니다.
- Premium 또는 Ultimate 구독이 있어야 합니다.
- 인스턴스에 체험판을 사용한 적이 없는 온라인 클라우드 라이선스가 있어야 합니다.
체험판을 시작하려면 다음과 같이 합니다:
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- GitLab Secrets Manager를 확장합니다.
- Start 30-day trial을 선택합니다.
- 확인 대화 상자에서 Start 30-day trial을 선택합니다.