> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-docs-1917.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> データベース、ストレージ、Redis、IAM の設定用の環境変数を使用して、セルフマネージド W&B Server インストールを設定します。

# 環境変数を設定する

System Settings 管理 UI でインスタンスレベルの設定を行うだけでなく、W\&B では環境変数を使用してコード経由でこれらの値を設定することもできます。あわせて、[IAM の高度な設定](./iam/advanced_env_vars)を参照してください。

<div id="environment-variable-reference">
  ## 環境変数リファレンス
</div>

| 環境変数                                    | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `LICENSE`                               | お使いの wandb/local ライセンス                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `MYSQL`                                 | MySQL の接続文字列                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `BUCKET`                                | データ保存に使用する S3 / GCS バケット                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `BUCKET_QUEUE`                          | オブジェクト作成イベント用の SQS / Google PubSub キュー                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `NOTIFICATIONS_QUEUE`                   | run イベントを発行する SQS キュー                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `AWS_REGION`                            | バケットが配置されている AWS リージョン                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `HOST`                                  | インスタンスの FQD。たとえば `https://my.domain.net`                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `OIDC_ISSUER`                           | OpenID Connect アイデンティティ プロバイダーの URL。たとえば `https://cognito-idp.us-east-1.amazonaws.com/us-east-1_uiIFNdacd`                                                                                                                                                                                                                                                                                                                                                                                                     |
| `OIDC_CLIENT_ID`                        | アイデンティティ プロバイダー内のアプリケーションのクライアント ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `OIDC_AUTH_METHOD`                      | Implicit (デフォルト) または pkce。詳細は以下を参照してください。                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `SLACK_CLIENT_ID`                       | アラートに使用する Slack アプリケーションのクライアント ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `SLACK_SECRET`                          | アラートに使用する Slack アプリケーションのシークレット                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `LOCAL_RESTORE`                         | インスタンスにアクセスできない場合は、これを一時的に true に設定できます。一時的な認証情報については、コンテナーのログを確認してください。                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `REDIS`                                 | W\&B で外部 REDIS インスタンスを設定するために使用できます。                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `LOGGING_ENABLED`                       | true に設定すると、アクセスログが stdout にストリーミングされます。この変数を設定しなくても、sidecar コンテナーをマウントして `/var/log/gorilla.log` を tail することもできます。                                                                                                                                                                                                                                                                                                                                                                                             |
| `GORILLA_ALLOW_USER_TEAM_CREATION`      | true に設定すると、管理者以外のユーザーも新しいチームを作成できるようになります。デフォルトは false です。                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `GORILLA_CUSTOMER_SECRET_STORE_SOURCE`  | W\&B Weave で使用するチームシークレットを保存するシークレットマネージャーを設定します。サポートされるシークレットマネージャーは次のとおりです: <ul><li><b>内部シークレットマネージャー</b> (デフォルト) : <code>k8s-secretmanager://wandb-secret</code></li><li><b>AWS Secret Manager</b>: <code>aws-secretmanager</code></li><li><b>Google Cloud Secret Manager</b>: <code>gcp-secretmanager</code></li><li><b>Azure</b>: <code>az-secretmanger</code></li></ul>                                                                                                                                  |
| `GORILLA_DATA_RETENTION_PERIOD`         | 削除された Runs のデータを保持する期間を時間単位で指定します。削除された run データは復元できません。入力値には `h` を付けてください。たとえば `"24h"` です。                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `GORILLA_DISABLE_PERSONAL_ENTITY`       | true に設定すると、[personal entities](/ja/support/models/articles/what-is-the-difference-between-team-and-) を無効にします。個人 entity での新しい個人プロジェクトの作成を防ぎ、既存の個人プロジェクトへの書き込みも防止します。                                                                                                                                                                                                                                                                                                                                           |
| `GORILLA_GRAPHQL_DISABLE_INTROSPECTION` | true に設定すると、GraphQL introspection を無効にします。`__type` および `__schema` クエリはスキーマデータを返さなくなりますが、リクエスト自体は引き続き成功します。**セルフマネージド** では、Gorilla の設定フィールド `graphql-disable-introspection` を設定した場合も同じ効果があります。この変数は、`WeightsAndBiases` custom resource の `spec.values.global.extraEnv` に設定してください (Operator ガイドの [`global.extraEnv` example](/ja/platform/hosting/self-managed/operator#ldap) を参照) 。**すでに introspection が無効になっているデプロイに接続するクライアント アプリケーションには、[W\&B SDK v0.26.0](/ja/release-notes/sdk-releases#0-26-0) 以降が必要です**。 |
| `ENABLE_REGISTRY_UI`                    | true に設定すると、新しい W\&B Registry UI を有効にします。                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `GORILLA_ARTIFACT_GC_ENABLED`           | true に設定すると、削除された Artifacts のガベージコレクションを有効にします。セルフマネージド デプロイでは必須です。詳細は [Artifacts を削除する](/ja/models/artifacts/delete-artifacts) を参照してください。                                                                                                                                                                                                                                                                                                                                                                     |
| `WANDB_ARTIFACT_DIR`                    | ダウンロードしたすべての Artifacts の保存先です。未設定の場合、トレーニング スクリプトからの相対パスにある `artifacts` ディレクトリがデフォルトになります。このディレクトリが存在し、実行中のユーザーに書き込み権限があることを確認してください。これは生成されるメタデータファイルの保存場所は制御しません。メタデータファイルの保存場所は、`WANDB_DIR` 環境変数で設定できます。                                                                                                                                                                                                                                                                                                    |
| `WANDB_DATA_DIR`                        | Artifacts のアップロード時に使用するステージング先です。デフォルトの場所はプラットフォームに依存します。これは `platformdirs` Python パッケージの `user_data_dir` の値を使用するためです。このディレクトリが存在し、実行中のユーザーに書き込み権限があることを確認してください。                                                                                                                                                                                                                                                                                                                                              |
| `WANDB_DIR`                             | 生成されたすべてのファイルの保存先です。未設定の場合、トレーニング スクリプトからの相対パスにある `wandb` ディレクトリがデフォルトになります。このディレクトリが存在し、実行中のユーザーに書き込み権限があることを確認してください。これはダウンロードした Artifacts の保存場所は制御しません。Artifacts の保存場所は、`WANDB_ARTIFACT_DIR` 環境変数で設定できます。                                                                                                                                                                                                                                                                                                   |
| `WANDB_IDENTITY_TOKEN_FILE`             | [アイデンティティ フェデレーション](/ja/platform/hosting/iam/identity_federation/) で使用する、Java Web Tokens (JWTs) が保存されるローカルディレクトリへの絶対パスです。                                                                                                                                                                                                                                                                                                                                                                                      |

<Note>
  `GORILLA_DATA_RETENTION_PERIOD` 環境変数は、慎重に使用してください。これは**削除された run データ** (削除フロー後のメディアなど、run に関連付けられたファイルを含む) に適用されます。Artifacts は削除されません。Artifacts の削除については、[Delete an artifact](/ja/models/artifacts/delete-artifacts) で説明しているように、Artifacts の削除と `GORILLA_ARTIFACT_GC_ENABLED` を使用してください。run とファイルの削除が storage およびこの設定にどのように関係するかについては、**Delete runs** の [When deleted run data is removed from storage](/ja/models/runs/delete-runs#when-deleted-run-data-is-removed-from-storage) を参照してください。この変数を設定すると、保持期間のウィンドウに従ってデータが削除されます。この値を有効にするまたは変更する前に、データベースと storage バケット の両方をバックアップしてください。

  バケット からの object のバックグラウンド削除は**ベストエフォート**で実行されるため、特定の時間内に完了する保証はありません。想定される動作、トラブルシューティング、および storage コストとの関係については、[Manage bucket storage and costs](/ja/platform/hosting/managing-bucket-storage) を参照してください。
</Note>

<div id="advanced-reliability-settings">
  ## 信頼性の詳細設定
</div>

<div id="redis">
  ### Redis
</div>

外部 Redis サーバーの設定は必須ではありませんが、本番環境では推奨されます。Redis を使用すると、特に大規模なプロジェクトで、サービスの信頼性が向上し、キャッシュを有効にしてロード時間を短縮できます。高可用性 (HA) を備え、以下の仕様を満たす ElastiCache などのマネージド Redis サービスを使用してください。

* メモリは最小 4GB、推奨 8GB
* Redis バージョン 6.x
* 転送中暗号化
* 認証を有効化

W\&B で Redis インスタンスを設定するには、`http(s)://YOUR-W&B-SERVER-HOST/system-admin` の W\&B Settings ページにアクセスします。"Use an external Redis instance" オプションを有効にし、以下の形式で Redis の接続文字列を入力します。

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-1917/lIX_1lVVY6B5YU9v/images/hosting/configure_redis.png?fit=max&auto=format&n=lIX_1lVVY6B5YU9v&q=85&s=cc2db9eff207849a56a64a9505d0360d" alt="W&B で Redis を設定する" width="659" height="799" data-path="images/hosting/configure_redis.png" />
</Frame>

Redis は、コンテナー上または Kubernetes デプロイで環境変数 `REDIS` を使用して設定することもできます。あるいは、`REDIS` を Kubernetes シークレットとして設定することもできます。

このページでは、Redis インスタンスがデフォルトポート `6379` で実行されていることを前提としています。別のポートを設定し、認証も設定し、さらに `redis` インスタンスで TLS を有効にする場合、接続文字列の形式は次のようになります。`redis://$USER:$PASSWORD@$HOST:$PORT?tls=true`
