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

トラブルシューティング

Runner がエラー 404 を出力する​

対処方法​

Runner から 401 エラーコードが返される

localhost での Gathering Facts の問題​

この問題は、Snap または Docker でインストールした Semaphore UI で発生することがあります。

4:10:16 PM
TASK [Gathering Facts] *********************************************************
4:10:17 PM
fatal: [localhost]: FAILED! => changed=false

原因​

Ansible での localhost の使用について詳しくは、Implicit 'localhost' の記事を参照してください。

Ansible はローカルでファクトを収集しようとしますが、Ansible は制限された分離コンテナ内にあるため、これが許可されません。

対処方法​

2 つの方法があります。

  1. ファクトの収集を無効にする:
- hosts: localhost
  gather_facts: False
  roles:
    - ...
  1. 接続タイプを明示的に ssh に設定する:
[localhost]
127.0.0.1 ansible_connection=ssh ansible_ssh_user=your_localhost_user

panic: pq: SSL is not enabled on the server​

これは、お使いの Postgres が SSL で動作していないことを意味します。

対処方法​

設定ファイルにオプション sslmode=disable を追加します。

	"postgres": {
		"host": "localhost",
		"user": "postgres",
		"pass": "pwd",
		"name": "semaphore",
		"options": {
			"sslmode": "disable"
		}
	},

fatal: bad numeric config value '0' for 'GIT_TERMINAL_PROMPT': invalid unit​

これは、認証が必要なリポジトリに HTTPS でアクセスしようとしていることを意味します。

対処方法​

  • キーストア画面に移動します。
  • Login with password タイプの新しいキーを作成します。
  • GitHub/BitBucket などのログイン名を指定します。
  • パスワードを指定します。GitHub/BitBucket ではアカウントのパスワードは使用できないため、代わりに Personal Access Token (PAT) を使用する必要があります。詳細はこちらを参照してください。
  • キーを作成したら、リポジトリ画面に移動し、対象のリポジトリを見つけてキーを指定します。

Git のクローンまたはプルが断続的に失敗する​

タスクログに Git pull failed (...), retrying in 2s のようなメッセージが表示され、その後に成功するか、数回の試行の後に最終的に失敗することがあります。

原因​

Git サーバー (GitHub、GitLab、Bitbucket、またはセルフホストのインスタンス) に一時的に到達できなかったか、一時的な HTTP エラーが返されたか、Semaphore とサーバーの間のネットワークに短時間の障害が発生しました。Semaphore はタスクを失敗にする前に、クローンとプルの操作を自動的に再試行します。

対処方法​

  1. 一時的な障害: 通常は自動的に解消します。Semaphore は試行の間に指数バックオフを挟みながら、最大 git_attempts 回 (デフォルト 4) 再試行します。
  2. 頻繁な失敗: 設定で試行回数の上限を増やします。
{
  "git_attempts": 8
}

または環境変数で指定します。

export SEMAPHORE_GIT_ATTEMPTS=8
  1. 即座に一貫して失敗する: 再試行では解決しません。リポジトリの URL、ブランチ名、アクセスキー、および Semaphore サーバーまたは runner ホストからのネットワーク接続を確認してください。

git_client と git_attempts の詳細については、Git 操作を参照してください。

Bash スクリプトの出力が欠落または不完全​

Bash タスクは正常に完了するものの、ログに echo、printf などのコマンドの出力がほとんど、またはまったく表示されない — 特にスクリプトがすぐに終了する場合に発生します。

原因​

Semaphore はシェルコマンドの実行中に stdout と stderr をキャプチャします。非常に短いスクリプトは、バッファリングされた出力がすべて読み取られる前に終了することがあり、その場合は最後の数行がタスクログから欠落する可能性があります。

対処方法​

  1. アップグレード: 最近の Semaphore バージョンでは、タスクを完了としてマークする前にプロセスの出力を読み切ります。古いリリースを使用している場合は、サーバーと runner を更新してください。
  2. 確実な出力が必要な場合は、スクリプト内で出力をフラッシュする:
#!/bin/bash
echo "Starting deploy"
echo "Done" >&2

重要な診断情報については、リポジトリのワークスペース内のファイルに書き込み、スクリプトの最後に cat してください。 3. 無言の早期終了を避ける: 出力が少ない場合でも失敗が見えるように、set -euo pipefail と明示的なエラーメッセージを使用してください。

unable to read LDAP response packet: unexpected EOF​

おそらく、LDAP サーバーが安全な接続 (TLS 経由) を想定しているにもかかわらず、安全でない方法で接続しようとしています。

対処方法​

config.json ファイルで TLS を有効にします。

...
"ldap_needtls": true
...

LDAP Result Code 49 "Invalid Credentials"​

パスワードまたは binddn が間違っています。

対処方法​

ldapwhoami ツールを使用して、binddn が機能するか確認します。

ldapwhoami\
  -H ldap://ldap.com:389\
  -D "CN=/your/ldap_binddn/value/in/config/file"\
  -x\
  -W

パスワードの入力を対話的に求められ、コード 0 を返して、指定した DN を出力するはずです。

次の記事も参考になります:

LDAP Result Code 32 "No Such Object"​

近日公開予定です。