Files
skillshare/website/i18n/ja/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

17 KiB
Raw Blame History

sidebar_position
sidebar_position
2

環境変数

skillshare が認識するすべての環境変数です。

設定

SKILLSHARE_CONFIG

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

データディレクトリ(バックアップ、trash)を上書きします。

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 はバックアップ、trash、ログについて XDG Base Directory Specification に 従います。古いバージョンからアップグレードする場合、これらのディレクトリは初回実行時に ~/.config/skillshare/ から正しい XDG の場所へ自動的に移行されます。 :::


SKILLSHARE_GITLAB_HOSTS

ネストされたサブグループに対応させるセルフマネージドの GitLab ホスト名のカンマ区切りリストです。 config ファイルがない場合がある CI/CD で便利です。

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

環境変数と config ファイルの gitlab_hosts の 両方が設定されている場合、それらの値はマージされます(重複排除)。無効なエントリ(scheme、パス、 ポートを含む、または空のもの)は黙ってスキップされます。

デフォルト: なし(config ファイルの値のみが使われる)


SKILLSHARE_AZURE_HOSTS

セルフホストの Azure DevOps Server ホスト名のカンマ区切りリストです。

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

環境変数と config ファイルの azure_hosts の 両方が設定されている場合、それらの値はマージされます(重複排除)。環境変数内の無効なエントリは 黙ってスキップされます。

デフォルト: (なし)

SKILLSHARE_GITEA_HOSTS

セルフホストの Gitea ホスト名のカンマ区切りリストです。名前に gitea を含むホストはこれがなくても 検出されます。

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

config ファイルの gitea_hosts とマージされます。

デフォルト: (なし)

SKILLSHARE_CNB_HOSTS

セルフホストの CNB ホスト名のカンマ区切りリストです。cnb.cool はこれがなくても検出されます。

SKILLSHARE_CNB_HOSTS=cnb.company.com

config ファイルの cnb_hosts とマージされます。

デフォルト: (なし)


Web UI

SKILLSHARE_UI_BASE_PATH

リバースプロキシの背後で Web ダッシュボードを配信するための 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 の personal access token です。

用途:

  • GitHub API リクエスト(skillshare search、skillshare upgrade、バージョンチェック)
  • Git clone 認証 — HTTPS 経由でプライベートリポジトリをインストールする際に自動的に注入される

トークンの作成方法:

  1. https://github.com/settings/tokens にアクセスする
  2. 新しいトークン(classic)を生成する
  3. スコープ: プライベートリポジトリには repo、公開リポジトリにはなし
  4. トークンをコピーする

公式ドキュメント: Managing your personal access tokens

使い方:

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 の personal access token または CI job token です。GitLab がホストするプライベートリポジトリの HTTPS clone に使われます。

トークンの作成方法:

  1. https://gitlab.com/-/user_settings/personal_access_tokens にアクセスする
  2. 新しいトークンを追加する
  3. スコープ: read_repository(pull のみ)または read_repository + write_repository(push と pull)
  4. トークン(glpat- プレフィックス)をコピーする

公式ドキュメント: Token overview

:::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 のリポジトリアクセストークン、または app password です。Bitbucket がホストするプライベート リポジトリの HTTPS clone に使われます。

トークンの作成方法(リポジトリアクセストークン):

  1. Repository → Settings → Access tokens に移動する
  2. Read 権限(pull のみ)または Read + Write(push と pull)でトークンを作成する
  3. トークンをコピーする — x-token-auth を自動的に使用(ユーザー名は不要)

トークンの作成方法(app password):

  1. https://bitbucket.org/account/settings/app-passwords/ にアクセスする
  2. Repositories: Read(pull のみ)または Repositories: Read + Write(push と pull)で app password を作成する
  3. BITBUCKET_USERNAME も設定する(または URL に https://<username>@bitbucket.org/... として含める)

公式ドキュメント: Access tokens

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 が app password の場合に、それと一緒に使われる 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 の Personal Access Token(PAT)です。Azure DevOps がホストするプライベートリポジトリの HTTPS clone に使われます。

トークンの作成方法:

  1. https://dev.azure.com/{org}/_usersSettings/tokens に移動する
  2. + New Token を選択する
  3. スコープ: Code → Read(pull のみ)または Code → Read & Write(push と pull)
  4. トークン(AZDO シグネチャ付きの84文字の文字列)をコピーする

公式ドキュメント: Use Personal Access Tokens

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、およびフルクローンなしでサブディレクトリをインストールする際の 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

リポジトリへの読み取り権限を持つ 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 検証を無効化すると、中間者攻撃に対して脆弱になります。適切な 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 ファイルのパス ~/.config/skillshare/config.yaml
SKILLSHARE_UI_BASE_PATH リバースプロキシ用の Web UI サブパス なし
SKILLSHARE_GITLAB_HOSTS カスタム GitLab ホスト名(カンマ区切り) なし
SKILLSHARE_AZURE_HOSTS カスタム Azure DevOps Server ホスト名(カンマ区切り) なし
SKILLSHARE_GITEA_HOSTS カスタム Gitea ホスト名(カンマ区切り) なし
SKILLSHARE_CNB_HOSTS カスタム CNB ホスト名(カンマ区切り) なし
XDG_CONFIG_HOME ベースとなる config ディレクトリ ~/.config(Linux/macOS)、%AppData%(Windows)
XDG_DATA_HOME データディレクトリ(バックアップ、trash) ~/.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 app password 認証用の 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

関連項目