Skip to content

Commit 268f881

Browse files
committed
Merge branch '4.2' into 4.3
* 4.2: [Encore] Added some comments about asset versioning and deployment
2 parents ed4712e + 30c8fcb commit 268f881

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

frontend/encore/versioning.rst

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,23 @@ like normal:
6868

6969
<img src="{{ asset('build/images/logo.png') }}">
7070

71+
Troubleshooting
72+
---------------
73+
74+
Asset Versioning and Deployment
75+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
76+
77+
When deploying a new version of your application, versioned assets will include
78+
a new hash, making the previous assets no longer available. This is usually not
79+
a problem when deploying applications using a rolling update, blue/green or
80+
symlink strategies.
81+
82+
However, even when applying those techniques, there could be a lapse of time
83+
when some publicly/privately cached response requests the previous version of
84+
the assets. If your application can't afford to serve any broken asset, the best
85+
solution is to use a CDN (or custom made service) that keeps all the old assets
86+
cached for some time.
87+
7188
Learn more
7289
----------
7390

0 commit comments

Comments
 (0)