version

Documentation

Overview

Package version declares types for each string to keep strict coupling to the JSON schema

Index

• Variables
• type Platform
• type Release
• type ReleaseDate
• type ReleaseVersions
• type SHA256Sum
• type Tarball
• type TarballURL
• type Version

Variables

var LastKnownEnvoy = Version(lastKnownEnvoy)

LastKnownEnvoy is the last known Envoy Version, used to ensure help statements aren't out-of-date. This is derived from /site/envoy-versions.json, but not used directly because go:embed requires a file read from the current directory tree.

This is different than the "latestVersion" because this is built into the binary. For example, after the binary is built, a more recent "latestVersion" can be used, even if the help statements only know about the one from compile time.

Types

type Platform

type Platform string

Platform encodes 'runtime.GOOS/runtime.GOARCH'. Ex "darwin/amd64"

type Release

type Release struct {
	ReleaseDate ReleaseDate

	// Tarballs are the Tarballs available by Platform
	Tarballs map[Platform]TarballURL `json:"tarballs,omitempty"`
}

Release primarily maps available Tarballs for a Version

type ReleaseDate

type ReleaseDate string

ReleaseDate is the publish date of the release Version. Ex. "2021-05-11"

type ReleaseVersions

type ReleaseVersions struct {
	// LatestVersion is the latest stable Version
	LatestVersion Version `json:"latestVersion"`
	// Versions maps a Version to its Release
	Versions map[Version]Release `json:"versions"`
	// SHA256Sums maps a Tarball to its SHA256Sum
	SHA256Sums map[Tarball]SHA256Sum `json:"sha256sums"`
}

ReleaseVersions primarily maps Version to TarballURL and tracks the LatestVersion

type SHA256Sum

type SHA256Sum string

SHA256Sum is a SHA-256 lower-hex hash. Ex. "1274f55b3022bc1331aed41089f189094e00729981fe132ce00aac6272ea0770"

type Tarball

type Tarball string

Tarball is the name of the tar.gz or tar.xz archive. Ex. "envoy-v1.18.3-linux-amd64.tar.xz" Minimum contents are "${dist}/bin/envoy[.exe]" Ex. "envoy-v1.18.3-linux-amd64/bin/envoy"

type TarballURL

type TarballURL string

TarballURL is the HTTPS URL to the Tarball. SHA256Sums must include its base name.

type Version

type Version string

Version is a release version from https://github.com/envoyproxy/envoy/releases, without a 'v' prefix. Ex "1.18.3"