GitHub에서 이 파일을 읽지 마세요. 가이드는 https://guides.rubyonrails.org에서 제공됩니다.

Ruby on Rails 6.1 릴리스 노트

Rails 6.1의 주요 내용:

데이터베이스별 Connection Switching
Horizontal Sharding
Strict Loading Associations
Delegated Types
Destroy Associations Async

이 릴리스 노트는 주요 변경 사항만을 다룹니다. 다양한 버그 수정과 변경 사항에 대해 알아보시려면 변경 로그를 참조하거나 GitHub의 메인 Rails 저장소에서 커밋 목록을 확인하세요.

1 Rails 6.1로 업그레이드하기

기존 애플리케이션을 업그레이드하는 경우, 업그레이드를 진행하기 전에 충분한 테스트 커버리지를 확보하는 것이 좋습니다. 아직 Rails 6.0으로 업그레이드하지 않았다면 먼저 6.0으로 업그레이드하고, Rails 6.1로 업데이트를 시도하기 전에 애플리케이션이 예상대로 작동하는지 확인해야 합니다. 업그레이드 시 주의해야 할 사항 목록은 Ruby on Rails 업그레이드 가이드에서 확인할 수 있습니다.

2 주요 기능

2.1 Per-database 연결 전환

Rails 6.1은 데이터베이스별로 연결을 전환할 수 있는 기능을 제공합니다. 6.0에서는 reading role로 전환하면 모든 데이터베이스 연결도 reading role로 전환되었습니다. 이제 6.1에서는 configuration에서 legacy_connection_handling을 false로 설정하면, Rails는 해당 abstract class에서 connected_to를 호출하여 단일 데이터베이스에 대한 연결을 전환할 수 있게 해줍니다.

2.2 Horizontal Sharding

Rails 6.0은 데이터베이스를 기능적으로 분할(여러 파티션, 다른 스키마)할 수 있는 기능을 제공했지만 horizontal sharding(동일한 스키마, 여러 파티션)을 지원하지는 못했습니다. Active Record의 모델이 클래스당 역할당 하나의 연결만 가질 수 있었기 때문에 Rails는 horizontal sharding을 지원할 수 없었습니다. 이제 이 문제가 해결되어 Rails에서 horizontal sharding을 사용할 수 있게 되었습니다.

2.3 Strict Loading Associations

Strict loading associations을 사용하면 모든 association이 eager하게 로드되도록 보장하고 N+1 문제가 발생하기 전에 방지할 수 있습니다.

2.4 Delegated Types

Delegated Types는 단일 테이블 상속(single-table inheritance)의 대안입니다. 이는 슈퍼클래스가 자신의 테이블로 표현되는 구체적인 클래스가 될 수 있도록 하는 클래스 계층 구조를 표현하는데 도움을 줍니다. 각 서브클래스는 추가 속성을 위한 자체 테이블을 가집니다.

2.5 Destroy Associations Async

Destroy associations async는 애플리케이션이 background job에서 association을 destroy할 수 있는 기능을 추가합니다. 이를 통해 데이터를 삭제할 때 발생할 수 있는 timeout과 기타 성능 문제를 방지할 수 있습니다.

3 Railties

자세한 변경 사항은 Changelog를 참조하세요.

3.1 제거된 기능들

더 이상 사용되지 않는 rake notes task들이 제거되었습니다.
rails dbconsole 명령에서 더 이상 사용되지 않는 connection 옵션이 제거되었습니다.
rails notes에서 더 이상 사용되지 않는 SOURCE_ANNOTATION_DIRECTORIES 환경 변수 지원이 제거되었습니다.
rails server 명령에서 더 이상 사용되지 않는 server 인자가 제거되었습니다.
서버 IP를 지정하기 위해 HOST 환경 변수를 사용하는 더 이상 사용되지 않는 기능이 제거되었습니다.
더 이상 사용되지 않는 rake dev:cache task들이 제거되었습니다.
더 이상 사용되지 않는 rake routes task들이 제거되었습니다.
더 이상 사용되지 않는 rake initializers task들이 제거되었습니다.

3.2 사용 중단(Deprecations)

ActiveRecord::Base#find_each는 ActiveRecord::Batches#find_each 대신 사용되어 왔으며, 자동으로 대체될 것입니다.
after_commit 특별 콜백에서 has_many through 관계를 사용하면 경고가 발생됩니다. 레코드와 연결된 상태는 트랜잭션의 일부로 먼저 업데이트 되어야 하므로 after_commit에서 읽으면 오래된 결과가 반환될 수 있습니다. 가능하다면 다른 콜백이나 after_save_commit을 대신 사용하십시오.
validates_comparison_of로 검증된 BigDecimal 속성에는 경고가 표시됩니다. Rails 7.2에서는 2.0이나 0.5와 같은 Rational 비교자가 문자열이나 숫자로 변환될 때 반올림 대신 자동으로 정확한 소수점 값으로 변환됩니다.
pluralize, singularize, camelize, underscore, humanize, titleize, titlecase, tableize, classify, dasherize, parameterize, deconstantize, foreign_key, constantize의 코어 확장 버전은 더 이상 사용되지 않습니다. 대신 String 클래스의 직접 호출이나 Object#send을 사용하세요.
트랜잭션 내에서 strict_loading이 활성화된 레코드의 지연된 preload는 경고를 발생시키고 Rails 7.2에서는 에러가 발생합니다. 트랜잭션 내에서는 지연된 preload가 안전하지 않습니다. 대신 eager loading을 사용하세요.

3.3 주목할 만한 변경사항

4 Action Cable

자세한 변경사항은 Changelog를 참조해 주세요.

4.1 삭제

4.2 지원 중단 내용

액션의 암묵적 렌더링은 deprecated 되었습니다. render 호출(implicit render 포함)을 선언하지 않은 경우 현재는 경고 메시지를 표시하고, 나중에는 새로운 메이저 버전에서 404 오류를 발생시킬 예정입니다. link
ActionDispatch::Request#formats 호출시 Accept 헤더의 와일드카드 유형 지원이 지원 중단(deprecated)됩니다. Content negotiation에 기반하여 구체적인 포맷을 지정해야 합니다. link
ActionDispatch::Request#formats에서 지원하지 않는 mime type를 고려하는 것이 deprecated 됩니다. Content negotiation에 기반하여 실제로 지원하는 포맷을 지정해야 합니다. link
Rails.application.executor.wrap이 deprecated 되었으며, Rails.application.executor.active로 대체되었습니다. link

4.3 주요 변경사항

5 Action Pack

자세한 변경사항은 Changelog를 참조하세요.

5.1 삭제 사항

더 이상 사용되지 않는 ActionDispatch::Http::ParameterFilter가 제거되었습니다.
더 이상 사용되지 않는 controller 레벨의 force_ssl이 제거되었습니다.

5.2 폐기 예정

config.action_dispatch.return_only_media_type_on_content_type 설정은 폐기될 예정입니다.

5.3 주요 변경사항

ActionDispatch::Response#content_type이 전체 Content-Type 헤더를 반환하도록 변경되었습니다.

6 Action View

자세한 변경사항은 Changelog를 참조하세요.

6.1 제거된 기능

ActionView::Template::Handlers::ERB에서 deprecated된 escape_whitelist 제거.
ActionView::Resolver에서 deprecated된 find_all_anywhere 제거.
ActionView::Template::HTML에서 deprecated된 formats 제거.
ActionView::Template::RawFile에서 deprecated된 formats 제거.
ActionView::Template::Text에서 deprecated된 formats 제거.
ActionView::PathSet에서 deprecated된 find_file 제거.
ActionView::LookupContext에서 deprecated된 rendered_format 제거.
ActionView::ViewPaths에서 deprecated된 find_file 제거.
ActionView::Base#initialize의 첫 번째 인자로 ActionView::LookupContext가 아닌 객체를 전달하는 deprecated된 지원 제거.
ActionView::Base#initialize에서 deprecated된 format 인자 제거.
deprecated된 ActionView::Template#refresh 제거.
deprecated된 ActionView::Template#original_encoding 제거.
deprecated된 ActionView::Template#variants 제거.
deprecated된 ActionView::Template#formats 제거.
deprecated된 ActionView::Template#virtual_path= 제거.
deprecated된 ActionView::Template#updated_at 제거.
ActionView::Template#initialize에서 필수였던 deprecated된 updated_at 인자 제거.
deprecated된 ActionView::Template.finalize_compiled_template_methods 제거.
deprecated된 config.action_view.finalize_compiled_template_methods 제거.
블록과 함께 ActionView::ViewPaths#with_fallback을 호출하는 deprecated된 지원 제거.
render template:에 절대 경로를 전달하는 deprecated된 지원 제거.
render file:에 상대 경로를 전달하는 deprecated된 지원 제거.
두 개의 인자를 받지 않는 template handler에 대한 지원 제거.
ActionView::Template::PathResolver에서 deprecated된 pattern 인자 제거.
일부 view helper에서 object의 private method를 호출하는 deprecated 지원이 제거되었습니다.

6.2 Deprecations(지원 중단)

Rails의 한 버전에서 다른 버전으로 복잡한 패턴을 지원하는 것은 어려운 일입니다. Deprecation cycle은 삭제된 기능이 있는 코드를 업데이트하기 위한 시간을 제공하기 위해 존재합니다.

Feature가 deprecate된다는 것은 다음 주요 버전에서 이 feature가 완전히 제거될 것임을 의미합니다. Deprecation warning은 이 feature가 제거되기 전에 해당 코드를 업데이트할 수 있도록 알림을 제공합니다.

Deprecation warning은 Rails 어플리케이션의 config.active_support.deprecation 설정으로 제어할 수 있습니다. deprecation warning을 조정할 수 있는 몇 가지 선택지가 있습니다:

:silent - deprecation warning을 기록하지 않습니다.
:notify - deprecation warning을 ActiveSupport::Deprecation.behavior에 등록된 알림(notification) 처리기로 보냅니다. 기본적으로 이것은 deprecation message를 stderr로 보냅니다.
:log - deprecated된 호출을 logger에 기록합니다.
:raise - deprecated된 코드가 사용될 때 예외를 발생시킵니다.

production에서는 기본값으로 :log가, development와 test에서는 :stderr가 각각 기본값으로 설정되어 있습니다.

6.3 주목할 만한 변경사항

ActionView::Base 하위 클래스에서 #compiled_method_container를 구현하도록 요구합니다.
ActionView::Template#initialize에서 locals 인자가 필수로 변경되었습니다.
javascript_include_tag와 stylesheet_link_tag asset helper들이 모던 브라우저에게 asset 프리로딩에 대한 힌트를 제공하는 link 헤더를 생성합니다. 이는 config.action_view.preload_links_header를 false로 설정하여 비활성화할 수 있습니다.

7 Action Mailer

자세한 변경사항은 Changelog를 참조하세요.

7.1 제거 항목

더 이상 사용되지 않는 ActionMailer::Base.receive를 제거하고 Action Mailbox를 사용하도록 변경되었습니다.

ActiveRecord::ConnectionAdapters::DatabaseLimits에서 deprecated된 메서드들을 제거했습니다.
column_name_length table_name_length columns_per_table indexes_per_table columns_per_multicolumn_index sql_query_length joins_per_query
deprecated된 ActiveRecord::ConnectionAdapters::AbstractAdapter#supports_multi_insert?를 제거했습니다.
deprecated된 ActiveRecord::ConnectionAdapters::AbstractAdapter#supports_foreign_keys_in_create?를 제거했습니다.
deprecated된 ActiveRecord::ConnectionAdapters::PostgreSQLAdapter#supports_ranges?를 제거했습니다.
deprecated된 ActiveRecord::Base#update_attributes와 ActiveRecord::Base#update_attributes!를 제거했습니다.
ActiveRecord::ConnectionAdapter::SchemaStatements#assume_migrated_upto_version에서 deprecated된 migrations_path 인자를 제거했습니다.
deprecated된 config.active_record.sqlite3.represent_boolean_as_integer를 제거했습니다.
ActiveRecord::DatabaseConfigurations에서 deprecated된 메서드들을 제거했습니다.
fetch each first values []=
deprecated된 ActiveRecord::Result#to_hash 메서드를 제거했습니다.
ActiveRecord::Relation 메서드에서 안전하지 않은 raw SQL 사용에 대한 deprecated된 지원을 제거했습니다.

8.2 사용 중단 예정(Deprecations)

ActiveRecord::Base.allow_unsafe_raw_sql이 사용 중단 예정입니다.
connected_to의 database kwarg가 사용 중단 예정입니다.
legacy_connection_handling이 false로 설정된 경우 connection_handlers가 사용 중단 예정입니다.

8.3 주목할 만한 변경사항

MySQL: Uniqueness validator가 이제 데이터베이스 기본 collation을 따르며, 더 이상 기본적으로 대소문자를 구분하는 비교를 강제하지 않습니다.

relation.create가 더 이상 초기화 블록과 callback에서 클래스 레벨 쿼리 메서드로 scope를 유출하지 않습니다.

User.where(name: "John").create do |john| 
  User.find_by(name: "David") # => nil
end

이후:

User.where(name: "John").create do |john|
  User.find_by(name: "David") # => #<User name: "David", ...>
end

Named scope chain이 더 이상 클래스 레벨 쿼리 메서드로 scope를 유출하지 않습니다.

class User < ActiveRecord::Base
  scope :david, -> { User.where(name: "David") }
end

User.where(name: "John").david
# SELECT * FROM users WHERE name = 'John' AND name = 'David'

이후:

User.where(name: "John").david
# SELECT * FROM users WHERE name = 'David'

where.not이 이제 NOR 대신 NAND 조건을 생성합니다.
이전:

User.where.not(name: "Jon", role: "admin")
# SELECT * FROM users WHERE name != 'Jon' AND role != 'admin'

이후:

User.where.not(name: "Jon", role: "admin") 
# SELECT * FROM users WHERE NOT (name = 'Jon' AND role = 'admin')

새로운 데이터베이스별 connection 처리를 사용하기 위해서는 애플리케이션에서 legacy_connection_handling을 false로 변경하고 connection_handlers의 deprecated된 접근자를 제거해야 합니다. connects_to와 connected_to의 public 메서드는 변경이 필요하지 않습니다.

9 Active Storage

자세한 변경사항은 Changelog를 참조하세요.

9.1 삭제된 기능

ActiveStorage::Transformers::ImageProcessing에 :combine_options 작업을 전달하는 deprecated된 지원이 제거되었습니다.
deprecated된 ActiveStorage::Transformers::MiniMagickTransformer가 제거되었습니다.
deprecated된 config.active_storage.queue가 제거되었습니다.
deprecated된 ActiveStorage::Downloading이 제거되었습니다.

9.2 Deprecations

Blob.create_after_upload가 Blob.create_and_upload로 교체되어 Deprecate됩니다. (Pull Request)

9.3 주목할 만한 변경사항

새로운 blob을 생성하고 주어진 io를 서비스에 업로드하는 Blob.create_and_upload를 추가했습니다. (Pull Request)
ActiveStorage::Blob#service_name 컬럼이 추가되었습니다. 업그레이드 후 마이그레이션을 실행해야 합니다. 해당 마이그레이션을 생성하려면 bin/rails app:update를 실행하세요.

추후 삭제될 예정인 ActiveRecord::ModelSchema::ClassMethods#sequence_name= 대신 ActiveRecord::Base.sequence_name=를 사용하세요.
추후 삭제될 예정인 ActiveRecord::Base.lookup_ancestors= 대신에 ActiveRecord::Base.allow_deprecated_singular_associations_name=를 사용하세요.
Rails.application.config.active_record.use_yaml_unsafe_load는 사용되지 않으며 제거될 예정입니다. config.active_record.use_yaml_unsafe_load = true를 config.active_record.yaml_column_permitted_classes로 대체하세요.
Rails 7.0에서 폐기 예정이었던 ActiveRecord::Base.filter_attributes는 삭제될 예정입니다. ActiveRecord::Base.default_filter_attributes를 대신 사용하세요.
Rails 7.0에서 폐기 예정이었던 ActiveRecord::Base.filter_parameters는 삭제될 예정입니다. ActiveRecord::Base.default_filter_parameters를 대신 사용하세요.
rewhere가 내부적으로 사용되지 않는다는 점과 더 명확한 대안이 있다는 점 때문에 rewhere는 폐기 예정입니다. unscope(:where).where 또는 except(:where).where를 대신 사용하세요.
rewhere!가 내부적으로 사용되지 않는다는 점과 더 명확한 대안이 있다는 점 때문에 rewhere!는 폐기 예정입니다. unscope!(:where).where! 또는 except!(:where).where!를 대신 사용하세요.
where.not이 지원 중단되면서 where.not은 폐기 예정입니다. where 메소드에서 직접 부정 조건을 정의하세요.

10.3 주목할 만한 변경사항

Active Model의 error들이 이제 객체가 되어, 애플리케이션에서 모델이 발생시킨 error들을 더 쉽게 다루고 상호작용할 수 있는 인터페이스를 제공합니다. 이 기능은 query 인터페이스를 포함하고, 더 정확한 테스팅과 error 세부사항에 대한 접근을 가능하게 합니다.

11 Active Support

자세한 변경사항은 Changelog를 참조하세요.

11.1 Removals

config.i18n.fallbacks가 비어있을 때 I18n.default_locale로 폴백하는 deprecated된 기능 제거.
deprecated된 LoggerSilence 상수 제거.
deprecated된 ActiveSupport::LoggerThreadSafeLevel#after_initialize 제거.
deprecated된 Module#parent_name, Module#parent, Module#parents 제거.
deprecated된 active_support/core_ext/module/reachable 파일 제거.
deprecated된 active_support/core_ext/numeric/inquiry 파일 제거.
deprecated된 active_support/core_ext/array/prepend_and_append 파일 제거.
deprecated된 active_support/core_ext/hash/compact 파일 제거.
deprecated된 active_support/core_ext/hash/transform_values 파일 제거.
deprecated된 active_support/core_ext/range/include_range 파일 제거.
deprecated된 ActiveSupport::Multibyte::Chars#consumes?와 ActiveSupport::Multibyte::Chars#normalize 제거.
deprecated된 ActiveSupport::Multibyte::Unicode.pack_graphemes, ActiveSupport::Multibyte::Unicode.unpack_graphemes, ActiveSupport::Multibyte::Unicode.normalize, ActiveSupport::Multibyte::Unicode.downcase, ActiveSupport::Multibyte::Unicode.upcase, ActiveSupport::Multibyte::Unicode.swapcase 제거.
deprecated된 ActiveSupport::Notifications::Instrumenter#end= 제거.

11.2 Deprecations

ActiveSupport::Multibyte::Unicode.default_normalization_form이 Deprecate 되었습니다.

The assert_template/assert_no_template assertions in controllers and integration tests were moved to a gem at rails/rails-controller-testing. (Pull Request)
컨트롤러와 통합 테스트에서 assert_template/assert_no_template assertion이 rails/rails-controller-testing gem으로 이동되었습니다. (Pull Request)
Removed deprecated assigns() and assert_assigns_not in functional tests. (Pull Request)
기능 테스트에서 더 이상 사용되지 않는 assigns()와 assert_assigns_not가 제거되었습니다. (Pull Request)
Removed deprecated xml_http_request() and xhr() methods in integration tests, and use get() / post() / etc with the xhr: true parameter. (Pull Request)
통합 테스트에서 더 이상 사용되지 않는 xml_http_request()와 xhr() 메서드가 제거되었으며, 대신 xhr: true 파라미터와 함께 get() / post() / 기타 메서드를 사용하세요. (Pull Request)
Removed deprecated find_each argument conditions in ActiveRecord::Batches. (Pull Request)
ActiveRecord::Batches에서 더 이상 사용되지 않는 find_each 인자 conditions가 제거되었습니다. (Pull Request)
Removed deprecated behaviour allowing nested arrays to be passed as query values in ActiveRecord::Relation#where. (Pull Request)
ActiveRecord::Relation#where에서 query 값으로 중첩 배열을 전달할 수 있었던 더 이상 사용되지 않는 동작이 제거되었습니다. (Pull Request)
Removed deprecated ActiveRecord::Base.disable_implicit_join_references=. (Pull Request)
더 이상 사용되지 않는 ActiveRecord::Base.disable_implicit_join_references=가 제거되었습니다. (Pull Request)
The only_path option is no longer supported in *_path route helper methods. Call url_for instead. (Pull Request)
*_path 라우트 헬퍼 메서드에서 only_path 옵션이 더 이상 지원되지 않습니다. 대신 url_for를 호출하세요. (Pull Request)

12.2 Deprecation

config.active_job.return_false_on_aborted_enqueue가 Deprecate되었습니다.

12.3 주목할 만한 변경사항

Job enqueuing이 중단된 경우 false를 반환합니다.

Rich text content의 존재 여부를 확인하기 위해 rich text 속성 이름 뒤에 ?를 추가하는 메서드가 추가되었습니다. (Pull Request)
trix editor를 찾아 주어진 HTML 콘텐츠를 채우는 fill_in_rich_text_area system test case 헬퍼가 추가되었습니다. (Pull Request)
데이터베이스 fixture에서 <action-text-attachment> 요소를 생성하는 ActionText::FixtureSet.attachment가 추가되었습니다. (Pull Request)

14 Action Mailbox

자세한 변경사항은 Changelog를 참조하세요.

14.1 제거

ActionDispatch::Http::ParameterFilter는 제거되었습니다. 대신 ActiveSupport::ParameterFilter를 사용하세요. (Pull Request)
ActiveRecord::ConnectionAdapters::SQLite3Adapter#valid_alter_table_type? 메서드가 제거되었습니다. (Pull Request)
suffix가 없는 Top Level HashWithIndifferentAccess 클래스가 제거되었습니다. ActiveSupport::HashWithIndifferentAccess를 대신 사용하세요. (Pull Request)
config.action_view.raise_on_missing_translations 설정이 제거되었습니다. config.i18n.raise_on_missing_translations 설정을 대신 사용하세요. (Commit)
rake dev:cache 태스크가 제거되었습니다. rails dev:cache를 대신 사용하세요. (Pull Request)
draft? 메서드를 호출했을 때 deprecation warning 없이 실패하는 대신, draft_status 메서드를 제거했습니다. (Pull Request)
Mode::CLASSES가 "Class already defined" 에러가 발생하지 않도록 제거되었습니다. (Pull Request)
Model.reorder(nil)이 Model.reorder({})처럼 동작하던 것이 제거되었습니다. (Pull Request)

14.2 Deprecation 알림

Rails.application.credentials.action_mailbox.api_key와 MAILGUN_INGRESS_API_KEY가 deprecated되었습니다. 대신 Rails.application.credentials.action_mailbox.signing_key와 MAILGUN_INGRESS_SIGNING_KEY를 사용하세요.