Руководство по обновлению Capistrano 3.7.0

Переменная :scm устарела

До сих пор конфигурация SCM Capistrano выполнялась с использованием переменной :scm:

# Это теперь устарело
set :scm, :svn

Чтобы избежать предупреждений об устаревании:

1. Удалите set :scm, ... из конфигурации Capistrano.
2. Добавьте один из следующих объявлений SCM в ваш Capfile после require "capistrano/deploy":

# Для использования Git
require "capistrano/scm/git"
install_plugin Capistrano::SCM::Git

# Для использования Mercurial
require "capistrano/scm/hg"
install_plugin Capistano::SCM::Hg

# Для использования Subversion
require "capistrano/scm/svn"
install_plugin Capistrano::SCM::Svn

Это последний выпуск, где Git является автоматическим по умолчанию

Если вы не укажете SCM, Capistrano предполагает использование Git. Однако это поведение теперь устарело. Добавьте это в свой Capfile, чтобы избежать предупреждений о устаревании:

require "capistrano/scm/git"
install_plugin Capistrano::SCM::Git

:git_strategy, :hg_strategy и :svn_strategy удалены

В Capistrano версии 3.7.0 переписана система SCM, которая опирается на «плагины». Эта система более гибкая, чем старая система «стратегии», которая позволяла настраивать только определённые части задач SCM.

Если ваше развёртывание зависит от пользовательской стратегии SCM, вам нужно будет переписать эту стратегию, чтобы она стала полноценным плагином SCM вместо этого. Существует довольно простой путь миграции: напишите свой плагин как подкласс встроенного SCM, который вы хотите настроить. Например:

require "capistrano/scm/git"

class MyCustomGit < Capistrano::SCM::Git
  # Переопределите методы, которые вы хотите настроить, например:
  def clone_repo
    # ...
  end
end

Затем используйте свой плагин, загрузив его в Capfile:

require_relative "path/to/my_custom_git.rb"
install_plugin MyCustomGit

Существующие сторонние SCM устарели

Если вы используете сторонний SCM, вы можете продолжать использовать его без изменений, но вы увидите предупреждения об устаревании. Свяжитесь с сопровождающим стороннего SCM-гем и спросите их о модификации гема для работы с новой системой плагинов Capistrano версии 3.7.0.

Удален remote_file

Метод remote_file больше не используется в Capistrano версии 3.7.0. Вы можете прочитать обсуждение, которое привело к его удалению здесь: issue 762.

Прямой замены нет. Чтобы перейти на версию 3.7.0, вам потребуется переписать любые части вашего развёртывания, использующие remote_file, чтобы использовать другой механизм для загрузки файлов. Рассмотрите возможность использования метода upload! напрямую в процедурном стиле.