設定
Semaphore は、いくつかの方法で設定できます。
- オンライン設定ツール — 設定をオンラインで生成するための Web インターフェースです。
- 設定ファイル — Semaphore を設定するための主要かつ最も柔軟な方法です。
- 環境変数 — コンテナ環境やクラウドネイティブなデプロイに便利です。
設定オプション
利用可能な設定オプションの一覧です。
| 設定ファイルのオプション / 環境変数 | 説明 |
|---|---|
| 共通 | |
git_client SEMAPHORE_GIT_CLIENT | Git クライアントの種類。cmd_git(デフォルト)または go_git を指定できます。 |
git_attempts SEMAPHORE_GIT_ATTEMPTS | タスクが失敗するまでに git clone または pull を試行する回数。試行の間隔には指数バックオフ(1 秒、次に 2 秒、4 秒、… 最大 60 秒)が使用されます。デフォルト: 4。1 に設定すると再試行が無効になります。 |
ssh_config_path SEMAPHORE_SSH_PATH | カスタム SSH 設定ファイルへのパス。デフォルト: ~/.ssh/config。 |
port SEMAPHORE_PORT | Web インターフェースを公開する TCP ポート。デフォルト: :3000 |
interface SEMAPHORE_INTERFACE | バインドアドレス(空 = すべてのインターフェース)。サーバーに複数のネットワークインターフェースがある場合に便利です。 |
tmp_path SEMAPHORE_TMP_PATH | クローンされたリポジトリや生成されたファイルを保存するディレクトリへのパス。デフォルト: /tmp/semaphore |
dirs.secrets SEMAPHORE_SECRETS_PATH | シークレット(たとえば Vault の token ファイル)を保存するディレクトリへのパス。デフォルト: /tmp/semaphore。dirs.secrets が未設定またはデフォルトのままの場合は、従来のトップレベルの secrets_path も引き続き使用できます。 |
dirs.repos SEMAPHORE_REPOS_DIR | リポジトリを保存するディレクトリへのパス。 |
dirs.ssh_agent_sockets SEMAPHORE_SSH_AGENT_SOCKETS_DIR | SSH エージェントのソケットを保存するディレクトリへのパス。デフォルト: /tmp/semaphore |
home_dir_mode SEMAPHORE_HOME_DIR_MODE | タスクの HOME 環境変数の設定方法を制御します。オプション: template_dir(デフォルト)、project_home、user_home。 |
max_parallel_tasks SEMAPHORE_MAX_PARALLEL_TASKS | サーバー上で同時に実行できるタスクの最大数。デフォルト: 9999 |
max_task_duration_sec SEMAPHORE_MAX_TASK_DURATION_SEC | タスクの最大実行時間(秒)。 |
max_tasks_per_templateSEMAPHORE_MAX_TASKS_PER_TEMPLATE | テンプレートごとにデータベースへ保存される最近のタスクの最大数。 |
schedule.timezone SEMAPHORE_SCHEDULE_TIMEZONE | タスクのスケジュールおよび cron ジョブに使用されるタイムゾーン。デフォルト: UTC |
oidc_providers SEMAPHORE_OIDC_PROVIDERS | OpenID プロバイダーの設定。複数の OpenID プロバイダーを指定できます。OpenID の設定の詳細は OpenID を参照してください。 |
password_login_disable SEMAPHORE_PASSWORD_LOGIN_DISABLED | パスワードによるログインを拒否します。 |
non_admin_can_create_project SEMAPHORE_NON_ADMIN_CAN_CREATE_PROJECT | 管理者以外のユーザーにプロジェクトの作成を許可します。 |
env_vars SEMAPHORE_ENV_VARS | タスク実行に公開される環境変数を含む JSON マップ。 |
forwarded_env_vars SEMAPHORE_FORWARDED_ENV_VARS | タスク実行に転送されるホストの環境変数の JSON 配列。 |
apps SEMAPHORE_APPS | アプリの設定を含む JSON マップ。 |
use_remote_runner SEMAPHORE_USE_REMOTE_RUNNER | リモート runner を使用する場合に有効にします。 |
runner_registration_token SEMAPHORE_RUNNER_REGISTRATION_TOKEN | runner がサーバーに登録する際に使用するブートストラップ token。 |
| サブスクリプション | |
subscription.key SEMAPHORE_SUBSCRIPTION_KEY | サブスクリプションキーまたは token。設定すると Web UI からのアクティベーションが無効になります。 |
subscription.key_file SEMAPHORE_SUBSCRIPTION_KEY_FILE | サブスクリプションキーまたは token ファイルへのパス。 |
subscription.server_url SEMAPHORE_SUBSCRIPTION_SERVER_URL | サブスクリプション / 課金サーバーの URL。デフォルト: https://portal.semaphoreui.com/billing |
| JWT | |
jwt.enabled SEMAPHORE_JWT_ENABLED | 有効にすると、Semaphore はタスク実行ごとに短命な JWT を発行し、その公開鍵を /.well-known/jwks.json で公開します。 |
jwt.issuer SEMAPHORE_JWT_ISSUER | 発行される JWT の iss クレームに出力される値。 |
jwt.default_ttl SEMAPHORE_JWT_DEFAULT_TTL | 発行されるタスク JWT のデフォルトの有効期間。Go の duration 形式(例: 30m、1h)で指定します。デフォルト: 1h |
jwt.max_ttl SEMAPHORE_JWT_MAX_TTL | テンプレートごとの JWT TTL の上限。Go の duration 形式で指定します。デフォルト: 24h |
| Runner | |
runner.registration_token_file SEMAPHORE_RUNNER_REGISTRATION_TOKEN_FILE | runner 登録 token を含むファイルへのパス。 |
runner.token SEMAPHORE_RUNNER_TOKEN | runner の認証 token。runner.token_file とは同時に指定できません。 |
runner.token_file SEMAPHORE_RUNNER_TOKEN_FILE | runner 登録用の token ファイルへのパス。 |
runner.private_key_file SEMAPHORE_RUNNER_PRIVATE_KEY_FILE | runner の秘密鍵ファイルへのパス。 |
runner.one_off SEMAPHORE_RUNNER_ONE_OFF | runner が 1 つのジョブを処理して終了します。動的な runner に便利です。 |
runner.enabled SEMAPHORE_RUNNER_ENABLED | runner を有効にします。 |
runner.webhook SEMAPHORE_RUNNER_WEBHOOK | runner 用の webhook URL。 |
runner.name SEMAPHORE_RUNNER_NAME | runner の名前。 |
runner.tags SEMAPHORE_RUNNER_TAGS | runner のタグの JSON 配列。 |
runner.max_parallel_tasks SEMAPHORE_RUNNER_MAX_PARALLEL_TASKS | runner で同時に実行できるタスクの最大数。デフォルト: 9999。 |
runner.check_interval_seconds SEMAPHORE_RUNNER_CHECK_INTERVAL_SECONDS | runner が新しいジョブをサーバーにポーリングし、進捗を報告する間隔(秒)。デフォルト: 1。値を大きくするとリクエスト量が減りますが、ジョブの取得がわずかに遅くなります。 |
runner.project_id SEMAPHORE_RUNNER_PROJECT_ID | runner を単一のプロジェクトに制限します。 |
runner.connection.server_ca_cert_file SEMAPHORE_RUNNER_SERVER_CA_CERT_FILE | システムのトラストストアに加えて、Semaphore サーバーの証明書を検証するために使用する PEM バンドル。サーバーが自己署名証明書または内部 CA の証明書を使用している場合に設定します。 |
runner.connection.skip_tls_verify SEMAPHORE_RUNNER_SKIP_TLS_VERIFY | サーバー証明書の検証を完全に無効にします。安全ではありません(MITM 攻撃に脆弱です)。テスト目的でのみ使用してください。 |
runner.executor SEMAPHORE_RUNNER_EXECUTOR | runner の executor 設定全体(type とネストされた docker または k8s の設定)を含む JSON オブジェクト。executor ブロック全体を 1 つの環境変数で設定したい場合に使用します。 |
runner.executor.type — | runner が各タスクを実行するために使用する方式: local(デフォルト)、k8s または docker。 |
runner.executor.k8s.kubeconfig SEMAPHORE_RUNNER_K8S_KUBECONFIG | kubeconfig ファイルへのパス。空 = クラスター内設定。 |
runner.executor.k8s.namespace SEMAPHORE_RUNNER_K8S_NAMESPACE | 一時的なタスク Pod を作成する Namespace。デフォルト: semaphore |
runner.executor.k8s.image SEMAPHORE_RUNNER_K8S_IMAGE | ビルドコンテナのデフォルトのコンテナイメージ。デフォルト: semaphoreui/job:latest |
runner.executor.k8s.helper_image SEMAPHORE_RUNNER_K8S_HELPER_IMAGE | git clone 用の init コンテナに使用するイメージ。デフォルト: semaphoreui/helper:latest |
runner.executor.k8s.service_account SEMAPHORE_RUNNER_K8S_SERVICE_ACCOUNT | タスク Pod を実行するサービスアカウント。デフォルト: default |
runner.executor.k8s.pull_secrets SEMAPHORE_RUNNER_K8S_PULL_SECRETS | 各 Pod に付与する imagePullSecrets のカンマ区切りリスト。 |
runner.executor.k8s.poll_interval_seconds SEMAPHORE_RUNNER_K8S_POLL_INTERVAL_SECONDS | executor が Pod の状態をポーリングする間隔(秒)。デフォルト: 3 |
runner.executor.k8s.cleanup_grace_seconds SEMAPHORE_RUNNER_K8S_CLEANUP_GRACE_SECONDS | Pod を削除する際の猶予期間(秒)。デフォルト: 30 |
runner.executor.docker.host SEMAPHORE_RUNNER_DOCKER_HOST | Docker デーモンの URL(unix://、tcp:// または npipe://)。空 = 標準の環境(DOCKER_HOST)とプラットフォームのデフォルトソケット。 |
runner.executor.docker.tls_verify SEMAPHORE_RUNNER_DOCKER_TLS_VERIFY | tcp:// 接続で TLS 証明書の検証を有効にします。 |
runner.executor.docker.cert_path SEMAPHORE_RUNNER_DOCKER_CERT_PATH | 相互 TLS 用の ca.pem、cert.pem、key.pem を格納するディレクトリ。 |
runner.executor.docker.image SEMAPHORE_RUNNER_DOCKER_IMAGE | ビルドコンテナのデフォルトイメージ。デフォルト: semaphoreui/job:latest |
runner.executor.docker.helper_image SEMAPHORE_RUNNER_DOCKER_HELPER_IMAGE | 一時的な git clone コンテナに使用するイメージ。デフォルト: semaphoreui/helper:latest |
runner.executor.docker.network SEMAPHORE_RUNNER_DOCKER_NETWORK | ビルドコンテナが参加する Docker ネットワーク。デフォルト: bridge |
runner.executor.docker.pull_policy SEMAPHORE_RUNNER_DOCKER_PULL_POLICY | イメージの pull ポリシー: always、if-not-present(デフォルト)または never。 |
runner.executor.docker.cpu_limit SEMAPHORE_RUNNER_DOCKER_CPU_LIMIT | 0 より大きい場合、ビルドコンテナの CPU を制限します(--cpus として渡されます)。 |
runner.executor.docker.memory_limit SEMAPHORE_RUNNER_DOCKER_MEMORY_LIMIT | 空でない場合、ビルドコンテナのメモリを制限します(例: 2g)。 |
runner.executor.docker.poll_interval_seconds SEMAPHORE_RUNNER_DOCKER_POLL_INTERVAL_SECONDS | コンテナの状態をポーリングする間 隔(秒)。デフォルト: 2 |
runner.executor.docker.cleanup_grace_seconds SEMAPHORE_RUNNER_DOCKER_CLEANUP_GRACE_SECONDS | docker stop に渡すタイムアウト(秒)。デフォルト: 30 |
runner.executor.docker.privileged SEMAPHORE_RUNNER_DOCKER_PRIVILEGED | ビルドコンテナを --privileged で実行します。危険です。デフォルトでは無効です。 |
| Runners(サーバー側のフリート) | |
runners.offline_timeout_sec SEMAPHORE_RUNNERS_OFFLINE_TIMEOUT_SEC | この秒数以上ハートビートが途絶えた runner はオフラインと見なされます。その runner の「starting」状態のタスクは再割り当てされます。デフォルト: 120 |
runners.task_fail_timeout_sec SEMAPHORE_RUNNERS_TASK_FAIL_TIMEOUT_SEC | この秒数以上ハートビートが途絶えた runner の「running」状態のタスクは失敗として扱われます。offline_timeout_sec 未満の値はその値に切り上げられます。デフォルト: 420 |
runners.reconcile_interval_sec SEMAPHORE_RUNNERS_RECONCILE_INTERVAL_SEC | ディスパッチ済みのタスクを runner の生存状態と照合する間隔(秒)。デフォルト: 30 |
| チーム | |
teams.invites_enabled SEMAPHORE_TEAMS_INVITES_ENABLED | ユーザーがチームにメンバーを招待できるようにします。 |
teams.invite_type SEMAPHORE_TEAMS_INVITE_TYPE | 招待の種類: username(デフォルト)、email、both。 |
teams.members_can_leave SEMAPHORE_TEAMS_MEMBERS_CAN_LEAVE | メンバーがチームから離脱できるようにします。 |
| データベース | |
sqlite.host SEMAPHORE_DB_HOST | SQLite データベースファイルへのパス。 |
mysql.host SEMAPHORE_DB_HOST | MySQL データベースのホスト。 |
mysql.name SEMAPHORE_DB_NAME | MySQL データベース(スキーマ)名。 |
mysql.user SEMAPHORE_DB_USER | MySQL のユーザー名。 |
mysql.pass SEMAPHORE_DB_PASS | MySQL ユーザーのパスワード。 |
postgres.host SEMAPHORE_DB_HOST | Postgres データベースのホスト。 |
postgres.name SEMAPHORE_DB_NAME | Postgres データベース(スキーマ)名。 |
postgres.user SEMAPHORE_DB_USER | Postgres のユーザー名。 |
postgres.pass SEMAPHORE_DB_PASS | Postgres ユーザーのパスワード。 |
dialect SEMAPHORE_DB_DIALECT | sqlite(デフォルト)、postgres または mysql を指定できます。 |
*.options SEMAPHORE_DB_OPTIONS | データベース接続オプションを含む JSON マップ。 |
| セキュリティ | |
access_key_encryption SEMAPHORE_ACCESS_KEY_ENCRYPTION | データベースに保存されるアクセスキーの暗号化に使用する Base64 エンコードされたキー。詳細は データベース暗号化リファレンス を参照してください。 |
option_encryption SEMAPHORE_OPTION_ENCRYPTION | 従来の単一キー方式(ローテーションなし)で DB オプション(JWT 署名キー)を暗号化するために使用する Base64 エンコードされたキー。未設定の場合はアクセスキーが使用されます。 |
cookie_hash SEMAPHORE_COOKIE_HASH | Cookie の署名に使用する Base64 エンコードされた HMAC キー。 |
cookie_encryption SEMAPHORE_COOKIE_ENCRYPTION | Cookie の暗号化に使用する Base64 エンコードされたキー。 |
web_host SEMAPHORE_WEB_ROOT | Semaphore をサブパスで使用したい場合に便利です。例: http://yourdomain.com/semaphore。末尾に / を付けないでください。 |
tls.enabled SEMAPHORE_TLS_ENABLED | Semaphore サーバーとの安全な通信のために TLS(HTTPS)を有効または無効にします。 |
tls.cert_file SEMAPHORE_TLS_CERT_FILE | TLS 証明書ファイルへのパス。 |
tls.key_file SEMAPHORE_TLS_KEY_FILE | TLS 鍵ファイルへのパス。 |
tls.http_redirect_addr SEMAPHORE_TLS_HTTP_REDIRECT_ADDR | HTTP→HTTPS リダイレクトリスナーのアドレス(host[:port])。tls.http_redirect_port とは同時に指定できません。 |
tls.http_redirect_port SEMAPHORE_TLS_HTTP_REDIRECT_PORT | HTTP トラフィックを HTTPS にリダイレクトするポート。tls.http_redirect_addr とは同時に指定できません。 |
mfa.totp.enabled SEMAPHORE_TOTP_ENABLED | TOTP を使用した二要素認証を有効にします。 |
mfa.totp.app_name SEMAPHORE_TOTP_ISSUER | TOTP 認証アプリに表示される発行者ラベル(Semaphore のタイトル)。 |
mfa.totp.allow_recovery SEMAPHORE_TOTP_ALLOW_RECOVERY | ユーザーがリカバリーコードを使用して TOTP をリセットできるようにします。 |
mfa.email.enabled SEMAPHORE_EMAIL_2TP_ENABLED | メールベースの多要素認証を有効にします。 |
mfa.email.allow_login_as_external_user SEMAPHORE_EMAIL_2TP_ALLOW_LOGIN_AS_EXTERNAL_USER | 外部(メールのみの)ユーザーとしてのログインを許可します。 |
mfa.email.allow_create_external_user SEMAPHORE_EMAIL_2TP_ALLOW_CREATE_EXTERNAL_USER | 初回ログイン時に外部ユーザーの作成を許可します。 |
mfa.email.allowed_domains SEMAPHORE_EMAIL_2TP_ALLOWED_DOMAINS | 許可するメールドメインの JSON 配列。 |
mfa.email.disable_for_oidc SEMAPHORE_EMAIL_2TP_DISABLE_FOR_OIDC | OIDC で認証されたユーザーに対してメール MFA を無効にします。 |
| 暗号化 | |
encryption.keys_file SEMAPHORE_ENCRYPTION_KEYS_FILE | 暗号化キーリング(YAML または JSON)を保持する別ファイルへのパス。変更が監視され、編集内容はサーバーを再起動せずに適用されます。未設定の場合は、従来の access_key_encryption フィールドが使用されます。 |
encryption.keys_poll_interval SEMAPHORE_ENCRYPTION_KEYS_POLL_INTERVAL | keys_file の変更をポーリングする間隔(15s のような Go の duration 形式)。0 でポーリングが無効になります(SIGHUP による再読み込みは引き続き可能です)。デフォルト: 15s |
| プロセス | |
process.user SEMAPHORE_PROCESS_USER | ラップされたプロセス(Ansible、Terraform、OpenTofu など)を実行するユーザー。 |
process.uid SEMAPHORE_PROCESS_UID | ラップされたプロセス(Ansible、Terraform、OpenTofu など)を実行するユーザーの ID。 |
process.gid SEMAPHORE_PROCESS_GID | ラップされたプロセス(Ansible、Terraform、OpenTofu など)を実行するグループの ID。 |
process.chroot SEMAPHORE_PROCESS_CHROOT | ラップされたプロセス用の chroot ディレクトリ。 |
process.no_new_privs SEMAPHORE_PROCESS_NO_NEW_PRIVS | ラップされたプロセスが新しい権限を取得できないように no_new_privs フラグを設定します。 |
process.app_namespaces.user SEMAPHORE_PROCESS_APP_NS_USER | アプリ実行の UID/GID を分離します(CLONE_NEWUSER)。Linux のみ。 |
process.app_namespaces.mount SEMAPHORE_PROCESS_APP_NS_MOUNT | アプリ実行からシークレット用 tmpfs などのホストのマウントポイントを隠します(CLONE_NEWNS)。Linux のみ。 |
process.app_namespaces.pid SEMAPHORE_PROCESS_APP_NS_PID | アプリ実行からホストのプロセスを隠します(CLONE_NEWPID)。Linux のみ。 |
process.app_namespaces.ipc SEMAPHORE_PROCESS_APP_NS_IPC | アプリ実行の SysV IPC と POSIX メッセージキューを分離します(CLONE_NEWIPC)。Linux のみ。 |
process.app_namespaces.uts SEMAPHORE_PROCESS_APP_NS_UTS | アプリ実行のホスト名とドメインを分離します(CLONE_NEWUTS)。Linux のみ。 |
| メール | |
email_sender SEMAPHORE_EMAIL_SENDER | 送信者のメールアドレス。 |
email_host SEMAPHORE_EMAIL_HOST | SMTP サーバーのホスト名。 |
email_port SEMAPHORE_EMAIL_PORT | SMTP サーバーのポート。 |
email_secure SEMAPHORE_EMAIL_SECURE | 暗号化されていない SMTP 接続を安全な暗号化接続にアップグレードする StartTLS を有効にします。 |
email_tls SEMAPHORE_EMAIL_TLS | SMTP サーバーとの通信に SSL または TLS 接続を使用します。 |
email_tls_min_version SEMAPHORE_EMAIL_TLS_MIN_VERSION | 接続に使用する TLS の最小バージョン。 |
email_username SEMAPHORE_EMAIL_USERNAME | SMTP サーバー認証用のユーザー名。 |
email_password SEMAPHORE_EMAIL_PASSWORD | SMTP サーバー認証用のパスワード。 |
email_alert SEMAPHORE_EMAIL_ALERT | メールアラートを有効にするフラグ。 |
| メッセンジャー | |
telegram_alert SEMAPHORE_TELEGRAM_ALERT | Telegram へのアラート送信を有効にするには True に設定します。telegram_chat および telegram_token と組み合わせて使用します。 |
telegram_chat SEMAPHORE_TELEGRAM_CHAT | アラートの送信先チャットの Chat ID を設定します。詳細は Telegram 通知の設定 を参照してください。 |
telegram_token SEMAPHORE_TELEGRAM_TOKEN | アラートのペイロードを受け取るボットの Authorization Token を設定します。詳細は Telegram 通知の設定 を参照してください。 |
slack_alert SEMAPHORE_SLACK_ALERT | Slack へのアラート送信を有効にするには True に設定します。slack_url と組み合わせて使用します。 |
slack_url SEMAPHORE_SLACK_URL | Slack の webhook URL。Semaphore はこの URL に Slack 形式の JSON アラートを POST します。 |
microsoft_teams_alert SEMAPHORE_MICROSOFT_TEAMS_ALERT | Microsoft Teams アラートを有効にするフラグ。 |
microsoft_teams_url SEMAPHORE_MICROSOFT_TEAMS_URL | Microsoft Teams の webhook URL。 |
rocketchat_alert SEMAPHORE_ROCKETCHAT_ALERT | Rocket.Chat へのアラート送信を有効にするには True に設定します。rocketchat_url と組み合わせて使用します。v2.9.56 以降で利用可能です。 |
rocketchat_url SEMAPHORE_ROCKETCHAT_URL | Rocket.Chat の webhook URL。Semaphore はこの URL に Rocket.Chat 形式の JSON アラートを POST します。v2.9.56 以降で利用可能です。 |
dingtalk_alert SEMAPHORE_DINGTALK_ALERT | Dingtalk アラートを有効にします。 |
dingtalk_url SEMAPHORE_DINGTALK_URL | Dingtalk メッセンジャーの webhook URL。 |
gotify_alert SEMAPHORE_GOTIFY_ALERT | Gotify アラートを有効にします。 |
gotify_url SEMAPHORE_GOTIFY_URL | Gotify サーバーの URL。 |
gotify_token SEMAPHORE_GOTIFY_TOKEN | Gotify サーバーの token。 |
| LDAP | |
ldap_enable SEMAPHORE_LDAP_ENABLE | LDAP 認証を有効にするフラグ。 |
ldap_needtls SEMAPHORE_LDAP_NEEDTLS | LDAP 接続の TLS を有効または無効にするフラグ。 |
ldap_binddn SEMAPHORE_LDAP_BIND_DN | 認証のために LDAP サーバーへバインドする際に使用する識別名(DN)。 |
ldap_bindpassword SEMAPHORE_LDAP_BIND_PASSWORD | 認証のために LDAP サーバーへバインドする際に使用するパスワード。 |
ldap_server SEMAPHORE_LDAP_SERVER | LDAP サーバーのホスト名とポート(例: ldap-server.com:1389)。 |
ldap_searchdn SEMAPHORE_LDAP_SEARCH_DN | LDAP ディレクトリでユーザーを検索する際に使用するベース識別名(DN)(例: dc=example,dc=org)。 |
ldap_searchfilter SEMAPHORE_LDAP_SEARCH_FILTER | LDAP ディレクトリでユーザーを検索する際に使用するフィルター(例: (&(objectClass=inetOrgPerson)(uid=%s)))。 |
ldap_mappings.dn SEMAPHORE_LDAP_MAPPING_DN | ユーザー認証で識別名(DN)のマッピングとして使用する LDAP 属性。 |
ldap_mappings.mail SEMAPHORE_LDAP_MAPPING_MAIL | ユーザー認証でメールアドレスのマッピングとして使用する LDAP 属性。 |
ldap_mappings.uid SEMAPHORE_LDAP_MAPPING_UID | ユーザー認証でユーザー ID(UID)のマッピングとして使用する LDAP 属性。 |
ldap_mappings.cn SEMAPHORE_LDAP_MAPPING_CN | ユーザー認証で共通名(CN)のマッピングとして使用する LDAP 属性。 |
| ロギング | |
log.events.format SEMAPHORE_EVENT_LOG_FORMAT | イベントログの形式。json またはテキストの場合は空を指定します。 |
log.events.enabled SEMAPHORE_EVENT_LOG_ENABLED | イベントログを有効または無効にします。 |
log.events.logger SEMAPHORE_EVENT_LOGGER | イベントロガーの設定を含む JSON マップ。 |
log.tasks.format SEMAPHORE_TASK_LOG_FORMAT | タスクログの形式。json またはテキストの場合は空を指定します。 |
log.tasks.enabled SEMAPHORE_TASK_LOG_ENABLED | タスクログを有効または無効にします。 |
log.tasks.logger SEMAPHORE_TASK_LOGGER | タスクロガーの設定を含む JSON マップ。 |
log.tasks.result_logger SEMAPHORE_TASK_RESULT_LOGGER | タスク結果ロガーの設定を含む JSON マップ。 |
syslog.enabled SEMAPHORE_SYSLOG_ENABLED | 設定した syslog サーバーへのログ書き込みを有効または無効にします。 |
syslog.network SEMAPHORE_SYSLOG_NETWORK | Syslog サーバーへの接続に使用するプロトコル: udp または tcp。 |
syslog.address SEMAPHORE_SYSLOG_ADDRESS | Syslog サーバーのホスト名とポート。例: localhost:514。 |
syslog.tag SEMAPHORE_SYSLOG_TAG | Syslog サーバー上で Semaphore UI のレ コードを識別するために使用するタグ。 |
syslog.format SEMAPHORE_SYSLOG_FORMAT | Syslog メッセージの形式。rfc5424 またはデフォルトの場合は空を指定します。 |
| デバッグ | |
debugging.api_delay SEMAPHORE_API_DELAY | API レスポンスに遅延を追加します(デバッグ目的)。 |
debugging.pprof_dump_dir SEMAPHORE_PPROF_DUMP_DIR | pprof ダンプファイル用のディレクトリ。 |
| 高可用性(HA) | |
ha.enabled SEMAPHORE_HA_ENABLED | 高可用性(HA)モードを有効にします。 |
ha.node_id SEMAPHORE_HA_NODE_ID | HA ノードの一意の識別子。 |
ha.redis.addr SEMAPHORE_HA_REDIS_ADDR | HA に使用する Redis サーバーのアドレス。例: localhost:6379。 |
ha.redis.db SEMAPHORE_HA_REDIS_DB | Redis のデータベース番号。 |
ha.redis.pass SEMAPHORE_HA_REDIS_PASS | Redis サーバーのパスワード。 |
ha.redis.user SEMAPHORE_HA_REDIS_USER | Redis サーバーのユーザー名。 |
ha.redis.tls SEMAPHORE_HA_REDIS_TLS | Redis 接続の TLS を有効にします。 |
ha.redis.tls_skip_verify SEMAPHORE_HA_REDIS_TLS_SKIP_VERIFY | Redis 接続の TLS 証明書検証をスキップします。 |
よくある質問
1. Semaphore UI の公開 URL を設定するには
Semaphore の前段に nginx などの Web サーバーを使用する場合は、設定オプション web_host を指定する必要があります。
たとえば、サー バー上で Semaphore へリクエストをプロキシする NGINX を設定したとします。
サーバーのアドレスが https://example.com で、https://example.com/semaphore へのすべてのリクエストを Semaphore にプロキシしているとします。
この場合、web_host は https://example.com/semaphore になります。