メインコンテンツまでスキップ

設定

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 秒)が使用されます。デフォルト: 41 に設定すると再試行が無効になります。

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/semaphoredirs.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_homeuser_home

max_parallel_tasks
SEMAPHORE_MAX_PARALLEL_TASKS

サーバー上で同時に実行できるタスクの最大数。デフォルト: 9999

max_task_duration_sec
SEMAPHORE_MAX_TASK_DURATION_SEC

タスクの最大実行時間(秒)。

max_tasks_per_template
SEMAPHORE_MAX_TASKS_PER_TEMPLATE

テンプレートごとにデータベースへ保存される最近のタスクの最大数。

schedule.timezone
SEMAPHORE_SCHEDULE_TIMEZONE

タスクのスケジュールおよび cron ジョブに使用されるタイムゾーン。デフォルト: UTC

oidc_providers Static Badge
SEMAPHORE_OIDC_PROVIDERS

OpenID プロバイダーの設定。複数の OpenID プロバイダーを指定できます。OpenID の設定の詳細は OpenID を参照してください。

password_login_disable
SEMAPHORE_PASSWORD_LOGIN_DISABLED

Static Badge

パスワードによるログインを拒否します。

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 形式(例: 30m1h)で指定します。デフォルト: 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 ポリシー: alwaysif-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(デフォルト)、emailboth

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 Static Badge
SEMAPHORE_TOTP_ISSUER Static Badge

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 Static Badge
SEMAPHORE_EVENT_LOG_FORMAT

イベントログの形式。json またはテキストの場合は空を指定します。

log.events.enabled Static Badge
SEMAPHORE_EVENT_LOG_ENABLED

イベントログを有効または無効にします。

log.events.logger Static Badge
SEMAPHORE_EVENT_LOGGER

イベントロガーの設定を含む JSON マップ。

log.tasks.format Static Badge
SEMAPHORE_TASK_LOG_FORMAT

タスクログの形式。json またはテキストの場合は空を指定します。

log.tasks.enabled Static Badge
SEMAPHORE_TASK_LOG_ENABLED

タスクログを有効または無効にします。

log.tasks.logger Static Badge
SEMAPHORE_TASK_LOGGER

タスクロガーの設定を含む JSON マップ。

log.tasks.result_logger Static Badge
SEMAPHORE_TASK_RESULT_LOGGER

タスク結果ロガーの設定を含む JSON マップ。

syslog.enabled Static Badge
SEMAPHORE_SYSLOG_ENABLED

設定した syslog サーバーへのログ書き込みを有効または無効にします。

syslog.network Static Badge
SEMAPHORE_SYSLOG_NETWORK

Syslog サーバーへの接続に使用するプロトコル: udp または tcp

syslog.address Static Badge
SEMAPHORE_SYSLOG_ADDRESS

Syslog サーバーのホスト名とポート。例: localhost:514

syslog.tag Static Badge
SEMAPHORE_SYSLOG_TAG

Syslog サーバー上で Semaphore UI のレコードを識別するために使用するタグ。

syslog.format Static Badge
SEMAPHORE_SYSLOG_FORMAT

Syslog メッセージの形式。rfc5424 またはデフォルトの場合は空を指定します。
デバッグ

debugging.api_delay
SEMAPHORE_API_DELAY

API レスポンスに遅延を追加します(デバッグ目的)。

debugging.pprof_dump_dir
SEMAPHORE_PPROF_DUMP_DIR

pprof ダンプファイル用のディレクトリ。
高可用性(HA)

ha.enabled Static Badge
SEMAPHORE_HA_ENABLED

高可用性(HA)モードを有効にします。

ha.node_id Static Badge
SEMAPHORE_HA_NODE_ID

HA ノードの一意の識別子。

ha.redis.addr Static Badge
SEMAPHORE_HA_REDIS_ADDR

HA に使用する Redis サーバーのアドレス。例: localhost:6379

ha.redis.db Static Badge
SEMAPHORE_HA_REDIS_DB

Redis のデータベース番号。

ha.redis.pass Static Badge
SEMAPHORE_HA_REDIS_PASS

Redis サーバーのパスワード。

ha.redis.user Static Badge
SEMAPHORE_HA_REDIS_USER

Redis サーバーのユーザー名。

ha.redis.tls Static Badge
SEMAPHORE_HA_REDIS_TLS

Redis 接続の TLS を有効にします。

ha.redis.tls_skip_verify Static Badge
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_hosthttps://example.com/semaphore になります。