activestorage 6.0.3.2 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of activestorage might be problematic. Click here for more details.

Files changed (62) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +149 -148
  3. data/MIT-LICENSE +1 -1
  4. data/README.md +35 -3
  5. data/app/controllers/active_storage/base_controller.rb +11 -0
  6. data/app/controllers/active_storage/blobs/proxy_controller.rb +14 -0
  7. data/app/controllers/active_storage/{blobs_controller.rb → blobs/redirect_controller.rb} +2 -2
  8. data/app/controllers/active_storage/direct_uploads_controller.rb +1 -1
  9. data/app/controllers/active_storage/disk_controller.rb +8 -20
  10. data/app/controllers/active_storage/representations/proxy_controller.rb +19 -0
  11. data/app/controllers/active_storage/{representations_controller.rb → representations/redirect_controller.rb} +2 -2
  12. data/app/controllers/concerns/active_storage/file_server.rb +18 -0
  13. data/app/controllers/concerns/active_storage/set_blob.rb +1 -1
  14. data/app/controllers/concerns/active_storage/set_current.rb +2 -2
  15. data/app/controllers/concerns/active_storage/set_headers.rb +12 -0
  16. data/app/jobs/active_storage/mirror_job.rb +15 -0
  17. data/app/models/active_storage/attachment.rb +18 -10
  18. data/app/models/active_storage/blob.rb +114 -59
  19. data/app/models/active_storage/blob/analyzable.rb +6 -2
  20. data/app/models/active_storage/blob/identifiable.rb +7 -6
  21. data/app/models/active_storage/blob/representable.rb +34 -4
  22. data/app/models/active_storage/preview.rb +31 -10
  23. data/app/models/active_storage/record.rb +7 -0
  24. data/app/models/active_storage/variant.rb +28 -41
  25. data/app/models/active_storage/variant_record.rb +8 -0
  26. data/app/models/active_storage/variant_with_record.rb +54 -0
  27. data/app/models/active_storage/variation.rb +25 -20
  28. data/config/routes.rb +58 -8
  29. data/db/migrate/20170806125915_create_active_storage_tables.rb +14 -5
  30. data/db/update_migrate/20190112182829_add_service_name_to_active_storage_blobs.rb +17 -0
  31. data/db/update_migrate/20191206030411_create_active_storage_variant_records.rb +11 -0
  32. data/lib/active_storage.rb +5 -2
  33. data/lib/active_storage/analyzer.rb +6 -0
  34. data/lib/active_storage/analyzer/image_analyzer.rb +3 -0
  35. data/lib/active_storage/analyzer/null_analyzer.rb +4 -0
  36. data/lib/active_storage/analyzer/video_analyzer.rb +14 -3
  37. data/lib/active_storage/attached/changes/create_many.rb +1 -0
  38. data/lib/active_storage/attached/changes/create_one.rb +17 -4
  39. data/lib/active_storage/attached/many.rb +4 -3
  40. data/lib/active_storage/attached/model.rb +77 -16
  41. data/lib/active_storage/attached/one.rb +4 -3
  42. data/lib/active_storage/engine.rb +25 -27
  43. data/lib/active_storage/gem_version.rb +3 -3
  44. data/lib/active_storage/log_subscriber.rb +6 -0
  45. data/lib/active_storage/previewer.rb +3 -2
  46. data/lib/active_storage/previewer/mupdf_previewer.rb +3 -3
  47. data/lib/active_storage/previewer/poppler_pdf_previewer.rb +3 -3
  48. data/lib/active_storage/previewer/video_previewer.rb +2 -2
  49. data/lib/active_storage/service.rb +36 -7
  50. data/lib/active_storage/service/azure_storage_service.rb +40 -35
  51. data/lib/active_storage/service/configurator.rb +3 -1
  52. data/lib/active_storage/service/disk_service.rb +36 -31
  53. data/lib/active_storage/service/gcs_service.rb +18 -16
  54. data/lib/active_storage/service/mirror_service.rb +31 -7
  55. data/lib/active_storage/service/registry.rb +32 -0
  56. data/lib/active_storage/service/s3_service.rb +53 -23
  57. data/lib/active_storage/transformers/image_processing_transformer.rb +13 -7
  58. data/lib/active_storage/transformers/transformer.rb +0 -3
  59. metadata +56 -20
  60. data/db/update_migrate/20180723000244_add_foreign_key_constraint_to_active_storage_attachments_for_blob_id.rb +0 -9
  61. data/lib/active_storage/downloading.rb +0 -47
  62. data/lib/active_storage/transformers/mini_magick_transformer.rb +0 -38
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 0201be845342ab029ab19a48aed55dc8e254a87611f32632df72c334ed071535
4
- data.tar.gz: 5b9f381db489cc918100e89ca125a0c91a0b8a02e950674e044732934ee14fbe
3
+ metadata.gz: 623160c71aa10ece4e5d6d190081b87af9820e5a588fafa76a75bf1b767aa79d
4
+ data.tar.gz: 3722a36a91ad23e172458149e6e7938f97567a572d627c724bd0139e44330623
5
5
  SHA512:
6
- metadata.gz: e5c89181fc7520514424d9b925ca7396a0bb867cc9a84ea3158c595dc3ad7f4306960c7aafbe3a1f7fbde00b8683a400847dd58c325e20630c665c4387fe0ccb
7
- data.tar.gz: 9273fdc303351ea90cdf9c888742336305c908f93469076d531879223d8329daf7bd1b340edf687bd53dba3a11111d58ae158ec4c469fcb94933aaa5e1e538a0
6
+ metadata.gz: aa33e53ae13fe387177b90a0ce3e0a6936ebaa2238c798993d3f884f01cec75d29cc926002e307613097a644eb69860347b233d881746213ecc3763ca39872bb
7
+ data.tar.gz: 383e9977c3e00b57cfbc05d92ab8ca323f9f185a4bf45f57fcb2e57b11304ab8a8ba4db50fcc11234f296b4f53ab3bbed35597a6d9741c3c4f468b05bb020079
@@ -1,240 +1,241 @@
1
- ## Rails 6.0.3.2 (June 17, 2020) ##
1
+ ## Rails 6.1.0 (December 09, 2020) ##
2
2
 
3
- * No changes.
3
+ * Change default queue name of the analysis (`:active_storage_analysis`) and
4
+ purge (`:active_storage_purge`) jobs to be the job adapter's default (`:default`).
4
5
 
6
+ *Rafael Mendonça França*
5
7
 
6
- ## Rails 6.0.3.1 (May 18, 2020) ##
8
+ * Implement `strict_loading` on ActiveStorage associations.
7
9
 
8
- * [CVE-2020-8162] Include Content-Length in signature for ActiveStorage direct upload
10
+ *David Angulo*
9
11
 
10
- ## Rails 6.0.3 (May 06, 2020) ##
12
+ * Remove deprecated support to pass `:combine_options` operations to `ActiveStorage::Transformers::ImageProcessing`.
11
13
 
12
- * No changes.
14
+ *Rafael Mendonça França*
13
15
 
16
+ * Remove deprecated `ActiveStorage::Transformers::MiniMagickTransformer`.
14
17
 
15
- ## Rails 6.0.2.2 (March 19, 2020) ##
18
+ *Rafael Mendonça França*
16
19
 
17
- * No changes.
20
+ * Remove deprecated `config.active_storage.queue`.
18
21
 
22
+ *Rafael Mendonça França*
19
23
 
20
- ## Rails 6.0.2.1 (December 18, 2019) ##
24
+ * Remove deprecated `ActiveStorage::Downloading`.
21
25
 
22
- * No changes.
26
+ *Rafael Mendonça França*
23
27
 
28
+ * Add per-environment configuration support
24
29
 
25
- ## Rails 6.0.2 (December 13, 2019) ##
30
+ *Pietro Moro*
26
31
 
27
- * No changes.
32
+ * The Poppler PDF previewer renders a preview image using the original
33
+ document's crop box rather than its media box, hiding print margins. This
34
+ matches the behavior of the MuPDF previewer.
28
35
 
36
+ *Vincent Robert*
29
37
 
30
- ## Rails 6.0.1 (November 5, 2019) ##
38
+ * Touch parent model when an attachment is purged.
31
39
 
32
- * `ActiveStorage::AnalyzeJob`s are discarded on `ActiveRecord::RecordNotFound` errors.
40
+ *Víctor Pérez Rodríguez*
33
41
 
34
- *George Claghorn*
35
-
36
- * Blobs are recorded in the database before being uploaded to the service.
37
- This fixes that generated blob keys could silently collide, leading to
38
- data loss.
42
+ * Files can now be served by proxying them from the underlying storage service
43
+ instead of redirecting to a signed service URL. Use the
44
+ `rails_storage_proxy_path` and `_url` helpers to proxy an attached file:
39
45
 
40
- *Julik Tarkhanov*
46
+ ```erb
47
+ <%= image_tag rails_storage_proxy_path(@user.avatar) %>
48
+ ```
41
49
 
50
+ To proxy by default, set `config.active_storage.resolve_model_to_route`:
42
51
 
43
- ## Rails 6.0.0 (August 16, 2019) ##
52
+ ```ruby
53
+ # Proxy attached files instead.
54
+ config.active_storage.resolve_model_to_route = :rails_storage_proxy
55
+ ```
44
56
 
45
- * No changes.
57
+ ```erb
58
+ <%= image_tag @user.avatar %>
59
+ ```
46
60
 
61
+ To redirect to a signed service URL when the default file serving strategy
62
+ is set to proxying, use the `rails_storage_redirect_path` and `_url` helpers:
47
63
 
48
- ## Rails 6.0.0.rc2 (July 22, 2019) ##
64
+ ```erb
65
+ <%= image_tag rails_storage_redirect_path(@user.avatar) %>
66
+ ```
49
67
 
50
- * No changes.
68
+ *Jonathan Fleckenstein*
51
69
 
70
+ * Add `config.active_storage.web_image_content_types` to allow applications
71
+ to add content types (like `image/webp`) in which variants can be processed,
72
+ instead of letting those images be converted to the fallback PNG format.
52
73
 
53
- ## Rails 6.0.0.rc1 (April 24, 2019) ##
74
+ *Jeroen van Haperen*
54
75
 
55
- * Don't raise when analyzing an image whose type is unsupported by ImageMagick.
76
+ * Add support for creating variants of `WebP` images out of the box.
56
77
 
57
- Fixes #36065.
78
+ *Dino Maric*
58
79
 
59
- *Guilherme Mansur*
80
+ * Only enqueue analysis jobs for blobs with non-null analyzer classes.
60
81
 
61
- * Permit generating variants of BMP images.
82
+ *Gannon McGibbon*
62
83
 
63
- *Younes Serraj*
84
+ * Previews are created on the same service as the original blob.
64
85
 
86
+ *Peter Zhu*
65
87
 
66
- ## Rails 6.0.0.beta3 (March 11, 2019) ##
88
+ * Remove unused `disposition` and `content_type` query parameters for `DiskService`.
67
89
 
68
- * No changes.
90
+ *Peter Zhu*
69
91
 
92
+ * Use `DiskController` for both public and private files.
70
93
 
71
- ## Rails 6.0.0.beta2 (February 25, 2019) ##
94
+ `DiskController` is able to handle multiple services by adding a
95
+ `service_name` field in the generated URL in `DiskService`.
72
96
 
73
- * No changes.
97
+ *Peter Zhu*
74
98
 
99
+ * Variants are tracked in the database to avoid existence checks in the storage service.
75
100
 
76
- ## Rails 6.0.0.beta1 (January 18, 2019) ##
101
+ *George Claghorn*
77
102
 
78
- * [Rename npm package](https://github.com/rails/rails/pull/34905) from
79
- [`activestorage`](https://www.npmjs.com/package/activestorage) to
80
- [`@rails/activestorage`](https://www.npmjs.com/package/@rails/activestorage).
103
+ * Deprecate `service_url` methods in favour of `url`.
81
104
 
82
- *Javan Makhmali*
105
+ Deprecate `Variant#service_url` and `Preview#service_url` to instead use
106
+ `#url` method to be consistent with `Blob`.
83
107
 
84
- * Replace `config.active_storage.queue` with two options that indicate which
85
- queues analysis and purge jobs should use, respectively:
108
+ *Peter Zhu*
86
109
 
87
- * `config.active_storage.queues.analysis`
88
- * `config.active_storage.queues.purge`
110
+ * Permanent URLs for public storage blobs.
89
111
 
90
- `config.active_storage.queue` is preferred over the new options when it's
91
- set, but it is deprecated and will be removed in Rails 6.1.
112
+ Services can be configured in `config/storage.yml` with a new key
113
+ `public: true | false` to indicate whether a service holds public
114
+ blobs or private blobs. Public services will always return a permanent URL.
92
115
 
93
- *George Claghorn*
116
+ Deprecates `Blob#service_url` in favor of `Blob#url`.
94
117
 
95
- * Permit generating variants of TIFF images.
118
+ *Peter Zhu*
96
119
 
97
- *Luciano Sousa*
120
+ * Make services aware of configuration names.
98
121
 
99
- * Use base36 (all lowercase) for all new Blob keys to prevent
100
- collisions and undefined behavior with case-insensitive filesystems and
101
- database indices.
122
+ *Gannon McGibbon*
102
123
 
103
- *Julik Tarkhanov*
124
+ * The `Content-Type` header is set on image variants when they're uploaded to third-party storage services.
104
125
 
105
- * It doesn’t include an `X-CSRF-Token` header if a meta tag is not found on
106
- the page. It previously included one with a value of `undefined`.
126
+ *Kyle Ribordy*
107
127
 
108
- *Cameron Bothner*
128
+ * Allow storage services to be configured per attachment.
109
129
 
110
- * Fix `ArgumentError` when uploading to amazon s3
130
+ ```ruby
131
+ class User < ActiveRecord::Base
132
+ has_one_attached :avatar, service: :s3
133
+ end
111
134
 
112
- *Hiroki Sanpei*
135
+ class Gallery < ActiveRecord::Base
136
+ has_many_attached :photos, service: :s3
137
+ end
138
+ ```
113
139
 
114
- * Add progressive JPG to default list of variable content types
140
+ *Dmitry Tsepelev*
115
141
 
116
- *Maurice Kühlborn*
142
+ * You can optionally provide a custom blob key when attaching a new file:
117
143
 
118
- * Add `ActiveStorage.routes_prefix` for configuring generated routes.
144
+ ```ruby
145
+ user.avatar.attach key: "avatars/#{user.id}.jpg",
146
+ io: io, content_type: "image/jpeg", filename: "avatar.jpg"
147
+ ```
119
148
 
120
- *Chris Bisnett*
149
+ Active Storage will store the blob's data on the configured service at the provided key.
121
150
 
122
- * `ActiveStorage::Service::AzureStorageService` only handles specifically
123
- relevant types of `Azure::Core::Http::HTTPError`. It previously obscured
124
- other types of `HTTPError`, which is the azure-storage gem’s catch-all
125
- exception class.
151
+ *George Claghorn*
126
152
 
127
- *Cameron Bothner*
153
+ * Replace `Blob.create_after_upload!` with `Blob.create_and_upload!` and deprecate the former.
128
154
 
129
- * `ActiveStorage::DiskController#show` generates a 404 Not Found response when
130
- the requested file is missing from the disk service. It previously raised
131
- `Errno::ENOENT`.
155
+ `create_after_upload!` has been removed since it could lead to data
156
+ corruption by uploading to a key on the storage service which happened to
157
+ be already taken. Creating the record would then correctly raise a
158
+ database uniqueness exception but the stored object would already have
159
+ overwritten another. `create_and_upload!` swaps the order of operations
160
+ so that the key gets reserved up-front or the uniqueness error gets raised,
161
+ before the upload to a key takes place.
132
162
 
133
- *Cameron Bothner*
163
+ *Julik Tarkhanov*
134
164
 
135
- * `ActiveStorage::Blob#download` and `ActiveStorage::Blob#open` raise
136
- `ActiveStorage::FileNotFoundError` when the corresponding file is missing
137
- from the storage service. Services translate service-specific missing object
138
- exceptions (e.g. `Google::Cloud::NotFoundError` for the GCS service and
139
- `Errno::ENOENT` for the disk service) into
140
- `ActiveStorage::FileNotFoundError`.
165
+ * Set content disposition in direct upload using `filename` and `disposition` parameters to `ActiveStorage::Service#headers_for_direct_upload`.
141
166
 
142
- *Cameron Bothner*
167
+ *Peter Zhu*
143
168
 
144
- * Added the `ActiveStorage::SetCurrent` concern for custom Active Storage
145
- controllers that can't inherit from `ActiveStorage::BaseController`.
169
+ * Allow record to be optionally passed to blob finders to make sharding
170
+ easier.
146
171
 
147
- *George Claghorn*
172
+ *Gannon McGibbon*
148
173
 
149
- * Active Storage error classes like `ActiveStorage::IntegrityError` and
150
- `ActiveStorage::UnrepresentableError` now inherit from `ActiveStorage::Error`
151
- instead of `StandardError`. This permits rescuing `ActiveStorage::Error` to
152
- handle all Active Storage errors.
174
+ * Switch from `azure-storage` gem to `azure-storage-blob` gem for Azure service.
153
175
 
154
- *Andrei Makarov*, *George Claghorn*
176
+ *Peter Zhu*
155
177
 
156
- * Uploaded files assigned to a record are persisted to storage when the record
157
- is saved instead of immediately.
178
+ * Add `config.active_storage.draw_routes` to disable Active Storage routes.
158
179
 
159
- In Rails 5.2, the following causes an uploaded file in `params[:avatar]` to
160
- be stored:
180
+ *Gannon McGibbon*
161
181
 
162
- ```ruby
163
- @user.avatar = params[:avatar]
164
- ```
182
+ * Image analysis is skipped if ImageMagick returns an error.
165
183
 
166
- In Rails 6, the uploaded file is stored when `@user` is successfully saved.
184
+ `ActiveStorage::Analyzer::ImageAnalyzer#metadata` would previously raise a
185
+ `MiniMagick::Error`, which caused persistent `ActiveStorage::AnalyzeJob`
186
+ failures. It now logs the error and returns `{}`, resulting in no metadata
187
+ being added to the offending image blob.
167
188
 
168
189
  *George Claghorn*
169
190
 
170
- * Add the ability to reflect on defined attachments using the existing
171
- ActiveRecord reflection mechanism.
191
+ * Method calls on singular attachments return `nil` when no file is attached.
172
192
 
173
- *Kevin Deisz*
174
-
175
- * Variant arguments of `false` or `nil` will no longer be passed to the
176
- processor. For example, the following will not have the monochrome
177
- variation applied:
193
+ Previously, assuming the following User model, `user.avatar.filename` would
194
+ raise a `Module::DelegationError` if no avatar was attached:
178
195
 
179
196
  ```ruby
180
- avatar.variant(monochrome: false)
197
+ class User < ApplicationRecord
198
+ has_one_attached :avatar
199
+ end
181
200
  ```
182
201
 
183
- *Jacob Smith*
202
+ They now return `nil`.
184
203
 
185
- * Generated attachment getter and setter methods are created
186
- within the model's `GeneratedAssociationMethods` module to
187
- allow overriding and composition using `super`.
204
+ *Matthew Tanous*
188
205
 
189
- *Josh Susser*, *Jamon Douglas*
206
+ * The mirror service supports direct uploads.
190
207
 
191
- * Add `ActiveStorage::Blob#open`, which downloads a blob to a tempfile on disk
192
- and yields the tempfile. Deprecate `ActiveStorage::Downloading`.
208
+ New files are directly uploaded to the primary service. When a
209
+ directly-uploaded file is attached to a record, a background job is enqueued
210
+ to copy it to each secondary service.
193
211
 
194
- *David Robertson*, *George Claghorn*
212
+ Configure the queue used to process mirroring jobs by setting
213
+ `config.active_storage.queues.mirror`. The default is `:active_storage_mirror`.
195
214
 
196
- * Pass in `identify: false` as an argument when providing a `content_type` for
197
- `ActiveStorage::Attached::{One,Many}#attach` to bypass automatic content
198
- type inference. For example:
215
+ *George Claghorn*
199
216
 
200
- ```ruby
201
- @message.image.attach(
202
- io: File.open('/path/to/file'),
203
- filename: 'file.pdf',
204
- content_type: 'application/pdf',
205
- identify: false
206
- )
217
+ * The S3 service now permits uploading files larger than 5 gigabytes.
218
+
219
+ When uploading a file greater than 100 megabytes in size, the service
220
+ transparently switches to [multipart uploads](https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html)
221
+ using a part size computed from the file's total size and S3's part count limit.
222
+
223
+ No application changes are necessary to take advantage of this feature. You
224
+ can customize the default 100 MB multipart upload threshold in your S3
225
+ service's configuration:
226
+
227
+ ```yaml
228
+ production:
229
+ service: s3
230
+ access_key_id: <%= Rails.application.credentials.dig(:aws, :access_key_id) %>
231
+ secret_access_key: <%= Rails.application.credentials.dig(:aws, :secret_access_key) %>
232
+ region: us-east-1
233
+ bucket: my-bucket
234
+ upload:
235
+ multipart_threshold: <%= 250.megabytes %>
207
236
  ```
208
237
 
209
- *Ryan Davidson*
210
-
211
- * The Google Cloud Storage service properly supports streaming downloads.
212
- It now requires version 1.11 or newer of the google-cloud-storage gem.
213
-
214
238
  *George Claghorn*
215
239
 
216
- * Use the [ImageProcessing](https://github.com/janko-m/image_processing) gem
217
- for Active Storage variants, and deprecate the MiniMagick backend.
218
-
219
- This means that variants are now automatically oriented if the original
220
- image was rotated. Also, in addition to the existing ImageMagick
221
- operations, variants can now use `:resize_to_fit`, `:resize_to_fill`, and
222
- other ImageProcessing macros. These are now recommended over raw `:resize`,
223
- as they also sharpen the thumbnail after resizing.
224
-
225
- The ImageProcessing gem also comes with a backend implemented on
226
- [libvips](http://jcupitt.github.io/libvips/), an alternative to
227
- ImageMagick which has significantly better performance than
228
- ImageMagick in most cases, both in terms of speed and memory usage. In
229
- Active Storage it's now possible to switch to the libvips backend by
230
- changing `Rails.application.config.active_storage.variant_processor` to
231
- `:vips`.
232
-
233
- *Janko Marohnić*
234
-
235
- * Rails 6 requires Ruby 2.5.0 or newer.
236
-
237
- *Jeremy Daer*, *Kasper Timm Hansen*
238
-
239
240
 
240
- Please check [5-2-stable](https://github.com/rails/rails/blob/5-2-stable/activestorage/CHANGELOG.md) for previous changes.
241
+ Please check [6-0-stable](https://github.com/rails/rails/blob/6-0-stable/activestorage/CHANGELOG.md) for previous changes.
@@ -1,4 +1,4 @@
1
- Copyright (c) 2017-2019 David Heinemeier Hansson, Basecamp
1
+ Copyright (c) 2017-2020 David Heinemeier Hansson, Basecamp
2
2
 
3
3
  Permission is hereby granted, free of charge, to any person obtaining
4
4
  a copy of this software and associated documentation files (the
data/README.md CHANGED
@@ -16,7 +16,7 @@ A key difference to how Active Storage works compared to other attachment soluti
16
16
 
17
17
  ## Installation
18
18
 
19
- Run `rails active_storage:install` to copy over active_storage migrations.
19
+ Run `bin/rails active_storage:install` to copy over active_storage migrations.
20
20
 
21
21
  NOTE: If the task cannot be found, verify that `require "active_storage/engine"` is present in `config/application.rb`.
22
22
 
@@ -55,7 +55,7 @@ url_for(user.avatar)
55
55
 
56
56
  class AvatarsController < ApplicationController
57
57
  def update
58
- # params[:avatar] contains a ActionDispatch::Http::UploadedFile object
58
+ # params[:avatar] contains an ActionDispatch::Http::UploadedFile object
59
59
  Current.user.avatar.attach(params.require(:avatar))
60
60
  redirect_to Current.user
61
61
  end
@@ -106,6 +106,37 @@ Variation of image attachment:
106
106
  <%= image_tag user.avatar.variant(resize_to_limit: [100, 100]) %>
107
107
  ```
108
108
 
109
+ ## File serving strategies
110
+
111
+ Active Storage supports two ways to serve files: redirecting and proxying.
112
+
113
+ ### Redirecting
114
+
115
+ Active Storage generates stable application URLs for files which, when accessed, redirect to signed, short-lived service URLs. This relieves application servers of the burden of serving file data. It is the default file serving strategy.
116
+
117
+ When the application is configured to proxy files by default, use the `rails_storage_redirect_path` and `_url` route helpers to redirect instead:
118
+
119
+ ```erb
120
+ <%= image_tag rails_storage_redirect_path(@user.avatar) %>
121
+ ```
122
+
123
+ ### Proxying
124
+
125
+ Optionally, files can be proxied instead. This means that your application servers will download file data from the storage service in response to requests. This can be useful for serving files from a CDN.
126
+
127
+ Explicitly proxy attachments using the `rails_storage_proxy_path` and `_url` route helpers:
128
+
129
+ ```erb
130
+ <%= image_tag rails_storage_proxy_path(@user.avatar) %>
131
+ ```
132
+
133
+ Or configure Active Storage to use proxying by default:
134
+
135
+ ```ruby
136
+ # config/initializers/active_storage.rb
137
+ Rails.application.config.active_storage.resolve_model_to_route = :rails_storage_proxy
138
+ ```
139
+
109
140
  ## Direct uploads
110
141
 
111
142
  Active Storage, with its included JavaScript library, supports uploading directly from the client to the cloud.
@@ -120,7 +151,8 @@ Active Storage, with its included JavaScript library, supports uploading directl
120
151
  ```
121
152
  Using the npm package:
122
153
  ```js
123
- require("@rails/activestorage").start()
154
+ import * as ActiveStorage from "@rails/activestorage"
155
+ ActiveStorage.start()
124
156
  ```
125
157
  2. Annotate file inputs with the direct upload URL.
126
158