Capistrano3/トラブルシューティング の履歴(No.10)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• Capistrano3/トラブルシューティング へ行く。
  • 1 (2016-06-17 (金) 02:41:28)
  • 2 (2016-06-17 (金) 02:44:03)
  • 3 (2016-10-15 (土) 02:31:41)
  • 4 (2017-02-06 (月) 07:40:19)
  • 5 (2017-02-07 (火) 07:09:35)
  • 6 (2017-02-24 (金) 11:08:10)
  • 7 (2017-03-01 (水) 06:18:56)
  • 8 (2017-04-12 (水) 15:18:07)
  • 9 (2020-04-10 (金) 15:10:04)
  • 10 (2021-04-23 (金) 17:53:04)
  • 11 (2021-06-17 (木) 15:54:08)
  • 12 (2021-12-31 (金) 17:20:50)

---

Capistrano3

Tag: Capistrano3/トラブルシューティング

目次†

関連ページ†

• Capistrano3

参考情報†

トラブルシューティング方法†

listタスクを実行してみる†

• 全く動かない場合deploy.rbに以下のようなタスクを追加しておき「bundle exec cap staging list」で実行してみるとよい。

  task :list do
    on roles(:web) do |host|
      execute "ls"
    end
  end
  
  

ログのデバッグ出力†

• traceオプションを追加するとより詳細なログが表示される

  bundle exec cap production deploy --trace

• それでも足らないときはdeploy.rbに以下を追加。

  set :log_level, :debug

• さらにlogs/capistrano.logも利用できる。

gem installがうまくいっていない場合†

• ログからコマンドを抜き出し ssh xxx 'コマンド'を実行してみると良いかも。-quietオプションは除去するとよい。

  ssh remotehost 'cd /Users/sora/www/myapp/releases/20160616053411 && ( export RBENV_ROOT="$HOME/.rbenv" RBENV_VERSION="2.3.1" ; $HOME/.rbenv/bin/rbenv exec bundle install --path /Users/sora/www/myapp/shared/bundle --without development test --deployment --)'

環境変数の確認†

• sshで実行している際リモートの環境変数が原因でうまくRubyGemがインストールできない場合もある(rmagickとか)
• この場合以下のようなタスクを作成しておき実行する。

  task :printenv do
    on roles(:web) do |host|
      execute "printenv"
    end
  end
  

• タスクの呼び出し

  bundle exec cap production printenv

実行時エラー†

本番環境でmigrationが実行されない†

• 本番環境に実行した際、なぜかmigrationが実行されない。production用dbじゃなくdevelopment用dbでは実行されている。
• 最初はステージング環境だけで実行されているので「set :rails_env, "staging"」のせいかと思ったけど
• ruby on rails - Capistrano 3 deploy:migrate not executing due to missing primary - Stack Overflowにあるように、serverに対して"db"ロールが設定されていないせい？
• 実際は以下のようにdbロールを設定しただけで、serverのrolesには何も設定しなくてもいけた

  server 'myserver', user: 'sora', roles: %w{web}, my_property: :my_value
  
  role :app, %w{myserver}
  role :web, %w{myserver}
  role :db, %w{myserver}
  
  

その他エラー対策†

デプロイ時にmysql2のgemがインストールできない。†

• bundle stderr: Gem::Ext::BuildError: ERROR: Failed to build gem native extensionのようなエラーが発生し、mysql2のgemがインストールできない。
• macportsの場合、default_envでmysqlのパスを指定し、さらにbundle_configでライブラリのパスを指定する。

  set :default_env, {
    'PATH' => "/opt/local/bin:/opt/local/lib/mysql8/bin:$PATH"
  }
  
  set :bundle_config, {
    'build.mysql2' => '--with-ldflags=-L/opt/local/lib'
  }
  

デプロイ時に「incompatible library version」†

• 理由は不明ながら共通bundleを削除すれば復活した。例えば以下のように。

  rm -rf /Users/sora/www/demo/shared/bundle/*

デプロイ後にassetsがプリコンパイルされない†

• Capfileでrequire 'capistrano/rails/assets'が有効になっているかどうか確認する。

デプロイ後ExecJS and could not find a JavaScript runtimeエラーが発生†

• ruby on rails 3.1 - ExecJS and could not find a JavaScript runtime - Stack Overflowによると、サーバー環境にNode.jsをインストールする。

  sudo apt-get install nodejs
  sudo yum install nodejs
  

デプロイ後「fatal: Not a git repository (or any of the parent directories): .git」と言われてしまう†

• Gemfileにローカルフォルダで管理しているgemファイルを追加していて、そのgemspecで以下のようにgitを使っているから。

  gem.files         = `git ls-files`.split($\)

• deploy先に.gitフォルダが存在しないためこのような減少が発生する模様。
• ローカルフォルダでgemを管理するのはやめたほうが良いかもしれない。
• もしくはgemspecでgit ls-filesを使わないようにするか。　`git ls-files` in gemspec template is bad practice. · Issue #2287 · bundler/bundler

「Command: [ -d /var/www/myapp/releases/20140211033611/public/assets ]」のようなわけのわからないエラーが発生†

• ruby on rails - Capistrano 3 process failing - Stack Overflowによるととりあえず気にしなくても良いのだろうか。

「Command : [ -L ...]」が exit status 1 (failed).で失敗する†

• ruby - Capistrano 3 deploy failed messages - exit status 1 (failed) - Stack Overflow
• 致命的エラーならばCapistranoが止まるはずなので気にしなくてよい(のか?)

Too many authentication failuresが発生†

• sshをコマンドラインから使うと問題ない。SSHKitの問題？とりあえず以下で一時的に解決できる

  ssh-add -D

rbenv: 2.3.1 is not installed or not found in $HOME/.rbenv/versions/2.3.1†

• リモートに該当するRubyのバージョンがインストールされていないのが原因。rbenv installする。

rmagickがインストールできない†

• deploy時にrmagickのインストールに失敗する。Capistrano からの bundle install で rmagick のインストールが失敗するときの対処方法 - Shred IT!!!!
• 原因は環境変数がうまく設定されていないせいだった。
• 相手さきがMacPortsを導入しているMacだったのでpathが/opt/local/binに通っていないのが原因。以下の設定をproduction.rbに追加したところうまくいった。

  set :default_env, {
  #    'PKG_CONFIG_PATH' => '/opt/local/bin'
    'PATH' => "/opt/local/bin:$PATH"
  }
  

rmagickがインストールできない: その2†

• deploy時に失敗する。エラーメッセージは以下の通り。

  Gem Load Error is: This installation of RMagick was configured with ImageMagick 6.9.4 but ImageMagick 6.9.6-0 is in use

• リモートでportを更新したら発生するようになった(rmagickがインストールされなおしていないのが原因?)
• とりあえずmacportsでrmagickのバージョンを元に戻して解決。
• さらに調査した結果/shared/bundleの下に古いキャッシュが存在しているのが原因のようだった。shared/bundle/rubyを削除して、deployしなおしたらうまくいった模様。

nokogiriがインストールできない†

• macOSにインストールした際にエラーが起きる場合、deploy.rbなどに以下を追加する。

  set :bundle_env_variables, { nokogiri_use_system_libraries: 1 }
  

• さらにdeploy先でMacPortsを使っている場合、pkg-configのパスも指定しないといけない。staging.rb/production.rbなどでパスを指定。

  set :default_env, {
  #    'PKG_CONFIG_PATH' => '/opt/local/bin'
    'PATH' => "/opt/local/bin:$PATH"
  }
  

SocketError: getaddrinfo: nodename nor servname provided, or not known†

• 仮想環境にdeployしようとしたときに発生。.ssh/configでHostnameのところにIPアドレスを指定すればよくなった。Hostnameのところに仮想ホスト名を記述すすると例え/etc/hostsに記述してある名前でもうまくいかない。この場合Capistrano関係なく、pingはいけてもsshがいけない状態となっているのでそこから確認する。

deploy:symlink:linked_dirsのエラー†

• lnが失敗している模様。ディレクトリの削除がいっていないのでうまくいっていない？
• 原因は不明だが、デプロイファイル(staging.rb)で、serverで指定したホスト名と、roleで指定したホスト名が一致していなかったのが原因だったのかも(serverのほうがホスト名で、roleのほうがIPアドレスになっていた)。

openssh(sshクライアント)でログインしたあとCapistranoでデプロイしようとするとHostKeyMissmatchが発生†

• CentOS 7相手に発生。応急的には~/.ssh/known_hostsを削除すればいいのだが気になる。
• Possible issue with Cap 1.4.1 and net-ssh 1.1.0? - Google グループによるともう一つの応急処置として以下の方法がある。

  set :ssh_options, {
    paranoid: false
  }
  

• 根本原因は不明。

$HOME/.rbenv/bin/rbenv exec bundle check --pathがfailedになっている。†

• その後の処理でInstall missing gems with `bundle install`によってたらないgemsがインストールされている。すなわち正常な処理かも。