{{ partial "breadcrumb.html" . }}
{{ partial "hero.html" . }}
{{ with $release.date }}
{{ $date := . | dateFormat "January 2, 2006" }}
{{ $date }}
{{ end }}
Upgrading Vector
When upgrading, we recommend stepping through minor versions as
these can each contain breaking changes while Vector is pre-1.0.
These breaking changes are noted in their respective upgrade
guides.
{{ with $release.known_issues }}
{{ if gt (len $release.known_issues) 0 }}
Known issues
{{ range . }}
{{ . | markdownify }}
{{ end }}
{{ end }}
{{ end }}
{{ with $highlights }}
{{ range . }}
{{ .Render "li" }}
{{ end }}
{{ end }}
{{ with $release.description }}
{{ . | markdownify }}
{{ end }}
{{ if gt (len $release.changelog) 0 }}
{{ partial "heading.html" (dict "text" "Vector Changelog" "level" 2) }}
{{ if and (gt (len $breakingTitled) 0) (gt (len $upgradeGuides) 0) }}
{{ $numBreaking := len $breakingTitled }}
{{ $breakingWord := cond (eq $numBreaking 1) "breaking change" "breaking changes" }}
{{ $breakingHeading := printf "%d %s" $numBreaking $breakingWord }}
{{ partial "heading.html" (dict "text" $breakingHeading "id" "breaking changes" "level" 3 "icon" false) }}
{{ end }}
{{ range $orderedGroups }}
{{ $key := . }}
{{ $value := index $groups $key }}
{{ $changes := where $release.changelog ".type" "eq" $key }}
{{ if $changes }}
{{ $numChanges := len $changes }}
{{ $heading := printf "%d %s" $numChanges $value }}
{{ partial "heading.html" (dict "text" $heading "id" $value "level" 3 "icon" false) }}
{{ end }}
{{ end }}
{{ else }}
{{ if gt (len $release.commits) 0 }}
{{ partial "heading.html" (dict "text" "Changelog" "level" 2) }}
{{ range $orderedGroups }}
{{ $key := . }}
{{ $value := index $groups $key }}
{{ $commits := where $release.commits ".type" "eq" $key }}
{{ if $commits }}
{{ $numCommits := len $commits }}
{{ $heading := printf "%d %s" $numCommits $value }}
{{ partial "heading.html" (dict "text" $heading "id" $value "level" 3 "icon" false) }}
{{ range $commits }}
{{ template "commit" . }}
{{ end }}
{{ end }}
{{ end }}
{{ end }}
{{ end }}
{{ with $release.vrl_changelog }}
{{ if ne . "" }}
{{ partial "heading.html" (dict "text" "VRL Changelog" "level" 2) }}
{{/* Prefix VRL heading IDs (and links to them) so VRL's "New Features",
"Enhancements", etc. do not collide with the Vector changelog anchors. */}}
{{ . | markdownify | replaceRE `(id="|href="#)` "${1}vrl-" | safeHTML }}
{{ end }}
{{ end }}
{{ with $release.whats_next }}
{{ partial "heading.html" (dict "text" "What's next" "level" 2) }}
{{ range . }}
{{ .title }}
{{ .description | markdownify }}
{{ end }}
{{ end }}
{{ partial "heading.html" (dict "text" (print "Download Version " $version) "level" 2) }}
{{ partial "download/download-matrix.html" (dict "version" $version) }}
{{ partial "releases/deprecations.html" (dict "version" $version) }}