forked from varnish/Varnish-Book
-
Notifications
You must be signed in to change notification settings - Fork 0
/
NEWS
276 lines (213 loc) · 8.71 KB
/
NEWS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
New in 4.7
----------
- Tiny content adjustments.
- Remove history-section
- Add ReqEnd to the log tag overview
- In 4.6, two exercises were missing on the slide deck but present in the
hand out. This is now fixed.
New in 4.6
----------
Released: Monday Jun 11 2012
No content changes.
- The tar-ball for instructors now contains an img/ directory with request
flow graphics.
- The (broken) links for the request flow graphs are removed.
New in 4.5
----------
Released: Thursday Jun 7 2012
No content changes, just build system.
New in 4.4
----------
Released: Tue May 29 2012
Nothing new. Technical fudgeup in 4.3.
New in 4.3
----------
Released: Tue May 29 2012
No big structural changes.
- We now only use the Varnish Book (all slides). Course-specific chapters
start out with a big bold notice about it.
- Several minor clarifications and rephrases throughout the book.
- Mention Anders Berg and the VML in the introduction. See
http://phk.freebsd.dk/VML/ for VML-info.
- VCL: vcl_recv: Mention security briefly. Including security.vcl. Don't
invest too much time in this subject.
- VCL: Switch the Accept-Encoding example with a simple device detection
example. Note that the handout suggests sending ``Vary: User-Agent``
/from/ varnish if you do this, to avoid confused upstream caches.
- VCL Functions: mention bereq in vcl_miss and how it can be used to remove
X-Varnish headers from the backend request...
- Varnishlog: Add a slide for different log tags to illustrate that Tx is
sent from varnish and Rx* received by varnish.
- Varnish Programs moved to appendix.
New in 4.2
----------
Released: Fri Apr 27 2012
No big structural changes.
- A good bit of rephrasing and clarification on details. Also reduction of
(now) historic details.
- Getting started: Added a table of varnishlog example-tags in the handout
to emphasise the Rx/Tx nature.
- Getting started: Added a table of interesting varnsihstat-counters to the
handout.
- In VCL: A slide discussing the initial value of beresp.ttl (e.g:
s-maxage/max-age/Expires).
- Tuning: Move the Param-slide up.
New in 4.1
----------
Released: Mon Mar 12 2012
Almost exclusively technical and typographic changes. Released hours after
4.0 to get a version where webdev-content is mostly OK too.
New in 4.0
----------
Released: Mon Mar 12 2012
First version to integrate the web development course, and preparing to go
public. The material in the sysadmin course is left almost untouched, save
for an added exercise and some restructuring of "Getting Started". NO ESI
IN SYSADMIN.
New chapters, only affects webdev:
- HTTP, Content Composition (ESI is merged into Content Composition)
Getting Started-changes:
- More focus on using proper mechanisms. We use "service varnish
reload/restart" (which is the same as /etc/init.d/varnish restart, so to
speak).
- No 'start varnishd by hand' stuff.
- Skim through the slides.
Other content changes:
- Added a single exercise to the "Cache Invalidation" chapter, based on the
material found in material/
- Removed Streaming and GZip from "Finishing words"
WebDev changes:
- HTTP:
The HTTP chapter discusses various cache headers. It is meant to give a
solid overview of HTTP caching mechanisms, not only Varnish-related
headers.
- Content Composition:
This chapter discusses how to make a site use Varnish fully. It discusses
Cookies in detail, Vary-vs-hash_data(), ESI, ESI and cookies and a bit of
AJAX-magic.
Practical changes:
- Several code snippets for the new chapters are provided in the material/
directory.
- There are now three sets of PDFs. Handout PDF and slides for webdev,
sysadmin and tutorial. Tutorial contains all chapters.
New in 3.0
----------
Released: Mon Nov 28 2011
Big reorganization effort. Much of the content is the same, but moved
around between different chapters. Reading the TOC is a must. Skimming the
chapters with new names is strongly recommended. The gist of the changes is
that it is more task-oriented than feature-oriented.
Some specific changes(unlikely to be complete):
- Remove the "Testing your Varnish Setup" chapter (never quite what I had
hoped)
- Split 'Programs' in two: Varnishlog+varnishstat goes in 'Getting started'
while the rest goes in the second to last chapter (For now).
- Remove the 3.0 sub-chapter in the intro
- Move design philosophy to the introduction chapter (downplay)
- No more usemod-wiki! (It's been a while since it was actually used)
- Getting started has become bigger and the exercises are less fragmented
- Merge Tunable parameters and Architecture into one chapter
- Storage backends are now discussed in the Tuning-chapter
- VCL: Renamed from intro to basics
- VCL: A state engine sub-chapter
- VCL: Merge some of the simpler exercises together
- VCL functions: The PURGE-example is stolen by the new cache
invalidation-chapter.
- Merge the chapter on bans and advanced VCL into "Saving the request"
- Stick streaming and gzip in 'finishing words'
In "Tuning"(new chapter):
- More general discussion of threads before parameters are introduced
- Worker threads, the existence of special-purpose threads
- The balancing of worker threads is NOT part of the general
thread-subchapter, but left for the old thread-param-discussion for
practical reasons.
- Added a shmlog-chapter, just saying "put it in tmpfs" and explaining the
I/O-issue. The tools are discussed later as usual.
In "Cache Invalidation":
- Discusses banning as before
- Discusses purge;, and points out that obj.ttl=0s is obsolete
- req.hash_always_miss
- Smart bans is a sub-chapter not just a tip.
In "Saving the request":
- The "Advanced VCL" chapter and Bans merged
- More focus on the core of Grace, including an exercise
- There's a slide for a demo, prepare!
- This might still need some work, particular with regards to timing and
exercises.
New in 2.1
----------
Released: Mon Nov 7 2011
- Trivial fixes after 2.0 was tried out
New in 2.0
----------
Released: Thu Sep 29 2011
- Update all VCL for Varnish 3.0 (Tested for 3.0.2)
- Attempt to convert everything to 3.0 (I might have missed some parts)
- Remove the "Monitoring Varnish" and "Common problems" sub-chapters during
the wrap-up.
- Add a table of Varnish 2.1->3.0 changes during the wrap-up chapter.
- Change the intro-chapter "2.1" to "3.0" (and change the text, of course)
- Remove several references to specific 2.x-versions and up the
recommendation for course-version to 3.0.0 or newer.
All 2.0 is the first Varnish 3.0 course.
New in 1.7
----------
Released: Mon Aug 8 2011
- Language fixes.
- Slide-pdf
New in 1.6
----------
Released: Mon Feb 11 2011
- No new content, just build-fixes and typo-cleanups.
New in 1.5
----------
Released: Mon Jan 10 2011
Major re-work. It's strongly advised to skim through the doc prior to
presenting it. At least from the VCL chapters.
- "debug harder" dropped: it's a 2.0-thing.
- Mention connect_timeout with regards to remote backend servers with high
latency.
- Mention shmlog size and how it's somewhat delayed.
- Chapter "Testing your Varnish setup" added
- Combine the Configuration and Getting started chapter
- Varnish 2.1.5 varnishncsa can do output formating
- Move backend declaration in VCL to the Getting started chapter
- Use repo.varnish-cache.org and www.varnish-cache.org instead of
repo.varnish-software.com and sourceforge for installtion-urls.
- Elaborate on why 2.0.4 and later can be used during the course (see
Install Varnish)
- Secret-file mentioned several-places and explained.
- Major rewrite of VCL in general. Now split in two sections.
- Note the existence of varnishtest and varnishreplay (no details)
- Add Accept-Encoding example to VCL
- Add new vcl_recv exercises and rework the VCL recv-part of VCL
- Default VCL-slide for vcl_recv, vcl_fetch
- Update default vcl (notably the X-Forwarded-For header).
- Table for variable-accessibility
- PURGE example
- ACL, restarts and backend properties mentioned
- Health checks and directors are separate
New in 1.4
----------
Never released.
- Add additional information and a few varnish to the VCL exercises
- Remove obsolete warnings in Troubleshooting
- Explain ESI and warn about deflate
- Added Finishing Words, consisting of monitoring,
troubleshooting(condensed) and resources/links
New in 1.3
----------
Released: Thu Aug 19 2010
- No content changes, only build system/release method
New in 1.2
----------
Released: Wed Aug 18 2010
- Change the PURGE exercise to use cache-control instead of the invalid
obj.ttl.
- Add a note regarding a bug in 2.1.x on purges, where varnish tries to
escape "\.css" on purge, instead of letting it fall through to pcre.
- (Re-)Added exercise for for timeouts
- munin/ directory added (anonyminized from vgnett)
- The NEWS file
Version 1.1, released: Mon Aug 16 2010
Version 1.0, released: Thu Aug 12 2010