Files
skillshare/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/appendix/environment-variables.md
T
Willie 21ae12c792 feat(website): translate how-to, learn, reference, and troubleshooting docs
Completes zh-Hant, zh-Hans, ja, and ko translation of the final 50
pages (how-to/, learn/, reference/targets/, reference/appendix/,
reference/filtering.md, reference/index.md, troubleshooting/),
bringing all four locales to full parity with the English docs tree.
Anchor ids added in the previous commit are propagated to every
translated heading they land on, and one zh-Hans same-file link that
pointed at the pre-translation auto-slug is repointed at the pinned
id.
2026-09-20 12:15:13 +08:00

15 KiB

sidebar_position
sidebar_position
2

환경 변수

skillshare가 인식하는 모든 환경 변수입니다.

설정

SKILLSHARE_CONFIG

설정 파일 경로를 재정의합니다.

SKILLSHARE_CONFIG=~/custom-config.yaml skillshare status

기본값: ~/.config/skillshare/config.yaml


XDG_CONFIG_HOME

XDG Base Directory Specification에 따라 기본 설정 디렉터리를 재정의합니다.

export XDG_CONFIG_HOME=~/my-config
# skillshare는 ~/my-config/skillshare/를 사용합니다

기본 동작:

플랫폼 기본값
Linux ~/.config/skillshare/
macOS ~/.config/skillshare/
Windows %AppData%\skillshare\

우선순위: SKILLSHARE_CONFIG > XDG_CONFIG_HOME > 플랫폼 기본값.

:::note 초기 설정 이후 XDG_CONFIG_HOME을 설정한 경우, 기존 ~/.config/skillshare/ 디렉터리를 새 위치로 직접 이동해야 합니다. :::


XDG_DATA_HOME

데이터 디렉터리(백업, 휴지통)를 재정의합니다.

export XDG_DATA_HOME=~/my-data
# skillshare는 ~/my-data/skillshare/backups/ 및 ~/my-data/skillshare/trash/를 사용합니다

기본값: ~/.local/share/skillshare/


XDG_STATE_HOME

상태 디렉터리(작업 로그)를 재정의합니다.

export XDG_STATE_HOME=~/my-state
# skillshare는 ~/my-state/skillshare/logs/를 사용합니다

기본값: ~/.local/state/skillshare/


XDG_CACHE_HOME

캐시 디렉터리(버전 확인 캐시, UI dist 캐시)를 재정의합니다.

export XDG_CACHE_HOME=~/my-cache
# skillshare는 ~/my-cache/skillshare/를 사용합니다

기본값: ~/.cache/skillshare/

:::tip 자동 마이그레이션 v0.13.0부터 skillshare는 백업, 휴지통, 로그에 대해 XDG Base Directory Specification을 따릅니다. 이전 버전에서 업그레이드하는 경우, 첫 실행 시 이 디렉터리들이 ~/.config/skillshare/에서 올바른 XDG 위치로 자동 마이그레이션됩니다. :::


SKILLSHARE_GITLAB_HOSTS

중첩된 하위 그룹(subgroup)을 지원하는 방식으로 처리할, 자체 관리형 GitLab 호스트명을 쉼표로 구분한 목록입니다. 설정 파일이 없을 수도 있는 CI/CD 환경에서 유용합니다.

SKILLSHARE_GITLAB_HOSTS=git.company.com,code.internal.io skillshare install git.company.com/team/frontend/ui

환경 변수와 설정 파일의 gitlab_hosts가 모두 설정된 경우, 두 값은 병합됩니다(중복 제거). 잘못된 항목(스킴, 경로, 포트를 포함하거나 비어 있는 경우)은 조용히 건너뜁니다.

기본값: 없음 (설정 파일의 값만 사용됨)


SKILLSHARE_AZURE_HOSTS

자체 호스팅 Azure DevOps Server 호스트명을 쉼표로 구분한 목록입니다.

SKILLSHARE_AZURE_HOSTS=azuredevops.mycompany.com,tfs.internal.io

환경 변수와 설정 파일의 azure_hosts가 모두 설정된 경우, 두 값은 병합됩니다(중복 제거). 환경 변수 내 잘못된 항목은 조용히 건너뜁니다.

기본값: (없음)

SKILLSHARE_GITEA_HOSTS

자체 호스팅 Gitea 호스트명을 쉼표로 구분한 목록입니다. 이름에 gitea가 포함된 호스트는 이 값 없이도 감지됩니다.

SKILLSHARE_GITEA_HOSTS=git.company.com,code.internal.io

설정 파일의 gitea_hosts와 병합됩니다.

기본값: (없음)

SKILLSHARE_CNB_HOSTS

자체 호스팅 CNB 호스트명을 쉼표로 구분한 목록입니다. cnb.cool은 이 값 없이도 감지됩니다.

SKILLSHARE_CNB_HOSTS=cnb.company.com

설정 파일의 cnb_hosts와 병합됩니다.

기본값: (없음)


웹 UI

SKILLSHARE_UI_BASE_PATH

리버스 프록시 뒤에서 웹 대시보드를 제공할 URL 하위 경로를 설정합니다.

SKILLSHARE_UI_BASE_PATH=/skillshare skillshare ui --host 0.0.0.0 --no-open

--base-path /skillshare와 동일합니다. 둘 다 설정된 경우 플래그가 우선합니다.

기본값: 없음 (대시보드는 루트 /에서 제공됨)

Nginx 및 Caddy 예제는 리버스 프록시를 참고하세요.


GitHub API

GITHUB_TOKEN

GitHub 개인 액세스 토큰입니다.

사용처:

  • GitHub API 요청(skillshare search, skillshare upgrade, 버전 확인)
  • Git clone 인증 — HTTPS를 통해 비공개 저장소를 설치할 때 자동으로 주입됩니다

토큰 생성 방법:

  1. https://github.com/settings/tokens 로 이동
  2. 새 토큰 생성 (classic)
  3. Scope: 비공개 저장소는 repo, 공개 저장소는 없음
  4. 토큰 복사

공식 문서: 개인 액세스 토큰 관리

사용법:

export GITHUB_TOKEN=ghp_your_token_here
skillshare install https://github.com/org/private-skills.git --track

Windows:

# 현재 세션
$env:GITHUB_TOKEN = "ghp_your_token"

# 영구 설정
[Environment]::SetEnvironmentVariable("GITHUB_TOKEN", "ghp_your_token", "User")

GH_TOKEN

대체 GitHub 토큰 변수입니다. GitHub CLI (gh)에서 사용되며 skillshare에서도 대체 값으로 인식합니다.

토큰 확인 순서: GITHUB_TOKEN → GH_TOKEN → gh auth token

이미 gh를 사용 중이고 gh auth login으로 인증했다면, skillshare가 별도의 환경 변수 없이 자동으로 토큰을 가져옵니다.

export GH_TOKEN=ghp_your_token_here
skillshare search "react patterns"

Git 인증

이 변수들은 비공개 저장소에 대한 HTTPS 인증을 활성화합니다. 설정되어 있으면 skillshare는 install과 update 시 URL 수정 없이 토큰을 자동으로 주입합니다.

자세한 내용과 CI/CD 예제는 비공개 저장소를 참고하세요.

GITLAB_TOKEN

GitLab 개인 액세스 토큰 또는 CI job 토큰입니다. GitLab에 호스팅된 비공개 저장소를 HTTPS로 clone할 때 사용됩니다.

토큰 생성 방법:

  1. https://gitlab.com/-/user_settings/personal_access_tokens 로 이동
  2. 새 토큰 추가
  3. Scope: read_repository(pull 전용) 또는 read_repository + write_repository(push & pull)
  4. 토큰 복사 (접두사 glpat-)

공식 문서: 토큰 개요

:::warning 토큰 유형 git 작업에는 Personal Access Token(glpat-)과 Project/Group Access Token만 사용할 수 있습니다. Feed Token(glft-)은 git 접근 권한이 없습니다. :::

export GITLAB_TOKEN=glpat-xxxxxxxxxxxxxxxxxxxx
skillshare install https://gitlab.com/org/skills.git --track

Windows:

$env:GITLAB_TOKEN = "glpat-xxxxxxxxxxxxxxxxxxxx"

BITBUCKET_TOKEN

Bitbucket 저장소 액세스 토큰, 또는 앱 비밀번호입니다. Bitbucket에 호스팅된 비공개 저장소를 HTTPS로 clone할 때 사용됩니다.

토큰 생성 방법 (저장소 액세스 토큰):

  1. Repository → Settings → Access tokens로 이동
  2. Read 권한(pull 전용) 또는 Read + Write(push & pull)로 토큰 생성
  3. 토큰 복사 — x-token-auth를 자동으로 사용합니다(사용자 이름 불필요)

토큰 생성 방법 (앱 비밀번호):

  1. https://bitbucket.org/account/settings/app-passwords/ 로 이동
  2. Repositories: Read(pull 전용) 또는 Repositories: Read + Write(push & pull)로 앱 비밀번호 생성
  3. BITBUCKET_USERNAME도 함께 설정하세요 (또는 URL에 https://<username>@bitbucket.org/... 형태로 포함)

공식 문서: 액세스 토큰

export BITBUCKET_USERNAME=your_bitbucket_username
export BITBUCKET_TOKEN=your_app_password
skillshare install https://bitbucket.org/team/skills.git --track

Windows:

$env:BITBUCKET_USERNAME = "your_bitbucket_username"
$env:BITBUCKET_TOKEN = "your_app_password"

BITBUCKET_USERNAME

BITBUCKET_TOKEN이 앱 비밀번호일 때 함께 사용하는 Bitbucket 사용자 이름입니다.

export BITBUCKET_USERNAME=your_bitbucket_username
export BITBUCKET_TOKEN=your_app_password
skillshare install https://bitbucket.org/team/skills.git --track

AZURE_DEVOPS_TOKEN

Azure DevOps 개인 액세스 토큰(PAT)입니다. Azure DevOps에 호스팅된 비공개 저장소를 HTTPS로 clone할 때 사용됩니다.

토큰 생성 방법:

  1. https://dev.azure.com/{org}/_usersSettings/tokens로 이동
  2. + New Token 선택
  3. Scope: Code → Read(pull 전용) 또는 Code → Read & Write(push & pull)
  4. 토큰 복사 (AZDO 시그니처가 포함된 84자 문자열)

공식 문서: 개인 액세스 토큰 사용하기

export AZURE_DEVOPS_TOKEN=your_pat_here
skillshare install https://dev.azure.com/org/project/_git/repo --track

Windows:

$env:AZURE_DEVOPS_TOKEN = "your_pat_here"

GITEA_TOKEN

Gitea 액세스 토큰입니다. gitea.com 및 자체 호스팅 Gitea의 비공개 저장소를 HTTPS로 clone할 때, 그리고 전체 clone 없이 하위 디렉터리를 설치할 때 Gitea Contents API에 사용됩니다.

토큰 생성 방법:

  1. Gitea에서 Settings → Applications로 이동
  2. 새 토큰 생성
  3. 권한: repository: Read(pull 전용) 또는 repository: Read and Write(push & pull)
export GITEA_TOKEN=your_token
skillshare install https://gitea.com/org/skills.git --track

Windows:

$env:GITEA_TOKEN = "your_token"

토큰은 설치 대상 호스트에만 전송됩니다. 이름에 gitea가 포함되지 않은 자체 호스팅 인스턴스는 gitea_hosts 설정이 필요하며, 그렇지 않으면 해당 호스트에는 SKILLSHARE_GIT_TOKEN이 사용됩니다.

CNB_TOKEN

저장소에 대한 read 권한을 가진 CNB 액세스 토큰입니다. cnb.cool 및 자체 호스팅 CNB의 비공개 저장소를 HTTPS로 clone할 때 사용됩니다.

export CNB_TOKEN=your_token
skillshare install https://cnb.cool/org/skills --track

Windows:

$env:CNB_TOKEN = "your_token"

다른 도메인에 있는 비공개 배포에는 cnb_hosts 설정이 필요합니다.

SKILLSHARE_GIT_TOKEN

모든 HTTPS git 호스트에 사용할 수 있는 범용 대체 토큰입니다. 플랫폼별 토큰이 설정되지 않은 경우 사용됩니다.

export SKILLSHARE_GIT_TOKEN=your_token
skillshare install https://git.example.com/org/skills.git --track

Windows:

$env:SKILLSHARE_GIT_TOKEN = "your_token"

토큰 우선순위: 플랫폼별 토큰(GITHUB_TOKEN, GITLAB_TOKEN, BITBUCKET_TOKEN, AZURE_DEVOPS_TOKEN, GITEA_TOKEN, CNB_TOKEN) > SKILLSHARE_GIT_TOKEN.


Git SSL / TLS

이 표준 Git 환경 변수들은 모든 git 작업에 전달됩니다. 자체 서명 인증서나 내부 CA를 사용하는 자체 호스팅 Git 서버(GitLab, Gitea 등)에서 유용합니다.

GIT_SSL_CAINFO

커스텀 CA 인증서 번들의 경로입니다. 자체 호스팅 Git 서버가 내부 CA로 서명된 인증서를 사용하는 경우 사용하세요.

export GIT_SSL_CAINFO=/path/to/ca-bundle.crt
skillshare install https://gitlab.internal.company.com/team/skills.git --track

GIT_SSL_NO_VERIFY

SSL 인증서 검증을 완전히 비활성화합니다. CA 인증서 설정이 불가능할 때 최후의 수단으로만 사용하세요.

:::warning 보안 위험 SSL 검증을 비활성화하면 연결이 중간자 공격(man-in-the-middle)에 취약해집니다. 가급적 적절한 CA 번들과 함께 GIT_SSL_CAINFO를 사용하거나, SSH를 사용하세요. :::

GIT_SSL_NO_VERIFY=true skillshare install https://gitlab.internal.company.com/team/skills.git --track

대안: SSL을 아예 사용하지 않으려면 SSH를 사용하세요:

skillshare install git@gitlab.internal.company.com:team/skills.git --track

테스트

SKILLSHARE_TEST_BINARY

통합 테스트에서 사용할 CLI 바이너리 경로를 재정의합니다.

SKILLSHARE_TEST_BINARY=/path/to/skillshare go test ./tests/integration

기본값: 프로젝트 루트의 bin/skillshare


사용 예시

임시 재정의

# 단일 명령어
SKILLSHARE_CONFIG=/tmp/test-config.yaml skillshare status

# 여러 명령어
export SKILLSHARE_CONFIG=/tmp/test-config.yaml
skillshare status
skillshare list
unset SKILLSHARE_CONFIG

영구 설정 (macOS/Linux)

~/.bashrc 또는 ~/.zshrc에 추가:

export GITHUB_TOKEN="ghp_your_token_here"

영구 설정 (Windows)

[Environment]::SetEnvironmentVariable("GITHUB_TOKEN", "ghp_your_token", "User")

요약

변수 용도 기본값
SKILLSHARE_CONFIG 설정 파일 경로 ~/.config/skillshare/config.yaml
SKILLSHARE_UI_BASE_PATH 리버스 프록시용 웹 UI 하위 경로 없음
SKILLSHARE_GITLAB_HOSTS 커스텀 GitLab 호스트명 (쉼표로 구분) 없음
SKILLSHARE_AZURE_HOSTS 커스텀 Azure DevOps Server 호스트명 (쉼표로 구분) 없음
SKILLSHARE_GITEA_HOSTS 커스텀 Gitea 호스트명 (쉼표로 구분) 없음
SKILLSHARE_CNB_HOSTS 커스텀 CNB 호스트명 (쉼표로 구분) 없음
XDG_CONFIG_HOME 기본 설정 디렉터리 ~/.config (Linux/macOS), %AppData% (Windows)
XDG_DATA_HOME 데이터 디렉터리 (백업, 휴지통) ~/.local/share
XDG_STATE_HOME 상태 디렉터리 (로그) ~/.local/state
XDG_CACHE_HOME 캐시 디렉터리 (버전 확인, UI) ~/.cache
GITHUB_TOKEN GitHub API + git clone 인증 없음
GH_TOKEN GitHub API (GITHUB_TOKEN의 대체 값) 없음
GITLAB_TOKEN GitLab git clone 인증 없음
BITBUCKET_TOKEN Bitbucket git clone 인증 없음
BITBUCKET_USERNAME 앱 비밀번호 인증용 Bitbucket 사용자 이름 없음
AZURE_DEVOPS_TOKEN Azure DevOps git clone 인증 없음
GITEA_TOKEN Gitea git clone + Contents API 인증 없음
CNB_TOKEN CNB git clone + contents API 인증 없음
SKILLSHARE_GIT_TOKEN 범용 git clone 인증 (대체 값) 없음
GIT_SSL_CAINFO 커스텀 CA 인증서 번들 경로 시스템 기본값
GIT_SSL_NO_VERIFY SSL 인증서 검증 비활성화 false
SKILLSHARE_TEST_BINARY 테스트 바이너리 경로 bin/skillshare

관련 문서