Ctrlk
HomepageSystem Status
For the complete documentation index, see llms.txt. This page is also available as Markdown.

ゲートウェイの環境構成

カスタムゲートウェイ環境の構成手順

概要

ゲートウェイエージェントはデフォルト設定で動作します。必要に応じて、内部機能の追加や削除のためにカスタマイズできます。このガイドでは、ゲートウェイのインストール方式に応じた設定変更の手順を取り扱います。

ゲートウェイへの設定適用や機能追加には、以下の2つの方法があります。

  • 環境変数 (Docker、Windows、Linux)

  • CLI引数 (Windows、Linux)

一部の機能は環境変数でのみ設定できます。いずれの方法で利用できる項目については、ゲートウェイの環境変数をご参照ください。

環境変数

環境変数を設定すると、ゲートウェイの設定や機能を定義できます。Dockerインストールでは、環境変数がゲートウェイを構成する唯一の方法です。

Dockerインストール

  1. docker-compose.yml ファイルを更新します。

vi docker-compose.yml

  1. ゲートウェイサービスの environment ブロックに環境変数を追加または削除します。

services:
  keeper-gateway:
    platform: linux/amd64
    image: keeper/gateway:latest
    shm_size: 2g
    restart: unless-stopped
    security_opt:
      - seccomp:docker-seccomp.json
      - apparmor:gateway-apparmor-profile
    environment:
      ACCEPT_EULA: Y
      GATEWAY_CONFIG: ey...
      KEEPER_GATEWAY_...: true    # ← New variable

  1. Dockerコンテナを再起動します。

Linuxインストール

Linuxネイティブのゲートウェイは、systemd サービスとして動作します。

  1. サービスファイルを更新します。

  1. サービス構成に環境変数を追加または削除します。

  1. systemd デーモンを再読み込みします。

  1. Keeperゲートウェイを再起動します。

Windowsインストール

Windowsネイティブのゲートウェイは、デフォルトでWindowsサービスとして動作します。マシン単位で環境変数を設定すると、サービスにも適用され、ユーザーセッションをまたいでも保持されます。

  1. PowerShellで、Keeperゲートウェイの環境変数を定義します。

  1. Keeperゲートウェイサービスを再起動します。

Windowsゲートウェイサービスの再起動

CLI引数

ゲートウェイは、サービスまたはコンテナの開始時に実行されるプログラムで、デフォルトではいくつかのCLI引数付きで起動します。追加の引数を指定すると、設定の変更や機能の追加ができます。

Dockerインストール

Dockerコンテナは再作成されると状態が失われるため、CLIでゲートウェイ構成を更新しても、コンテナの再起動後に変更は保持されません。ただし、ゲートウェイのバージョン確認など、一時的なコマンドの実行にはCLIを使えます。

Linuxインストール

Linuxネイティブのゲートウェイは systemd サービスとして動作し、サービス起動時に gateway start コマンドを実行します。以下の手順で、起動コマンドにCLI引数を追加できます。

  1. サービスファイルを更新します。

  1. サービス構成の起動コマンドにCLI引数を追加または削除します。

  1. systemd デーモンを再読み込みします。

  1. Keeperゲートウェイを再起動します。

Windowsインストール

Windowsネイティブのゲートウェイは、デフォルトでWindowsサービスとして動作し、サービス起動時に gateway start コマンドを実行します。以下の手順で、起動コマンドにCLI引数を追加できます。

  1. Keeperゲートウェイサービスのプロパティ画面を開き、「開始パラメーター」の入力欄に引数を追加します (先にサービスを停止しておく必要があります)。

  1. 必ずこの画面の [開始] からサービスを開始してください ([OK] は押さないでください)。[OK] だけだと、新しい引数が反映されません。

前へヘルスチェック次へゲートウェイの環境変数

最終更新