dockerversions

type Arch struct {
	// Env is the environment the artifact runs on, or nil if it's a source archive.
	Env *ArchEnv `json:"env,omitempty"`

	// SHA256 is the SHA256 checksum of the artifact as a hex string.
	SHA256 string `json:"sha256"`

	// Supported indicates this artifact should have a Docker image generated for it. The name
	// "Supported" comes from upstream Go image infrastructure.
	Supported bool `json:"supported,omitempty"`

	// URL is a URL from which the artifact can be downloaded. The artifact may be a build of Go or
	// a source tarball, determined by Env.
	URL string `json:"url"`

	// SHA256ChecksumURL is the URL of a file containing the SHA256 checksum in a format that works
	// with "sha256sum -c" and similar tools.
	//
	// If not specified, the file can be reached by appending ".sha256" to the URL.
	SHA256ChecksumURL string `json:"sha256ChecksumUrl,omitempty"`

	// PGPSignatureURL is the URL of a PGP signature file for this artifact, commonly verified using
	// the "gpg" tool.
	//
	// If not specified, the file can be reached by appending ".sig" to the URL.
	PGPSignatureURL string `json:"pgpSignatureUrl,omitempty"`
}

type ArchEnv struct {
	GOARCH string `json:",omitempty"`
	GOARM  string `json:",omitempty"`
	GOOS   string `json:",omitempty"`
}

type MajorMinorVersion struct {
	// Arches is the list of architectures that should be built.
	Arches map[string]*Arch `json:"arches"`
	// Variants lists OS variants that should be built. It must be provided in dependency order.
	Variants []string `json:"variants"`
	// Version is the current major.minor.patch version of this major.minor version.
	Version string `json:"version"`

	// Revision extends the upstream model by adding the Microsoft revision of the Go version. The
	// Microsoft build might get new versions that aren't associated with an upstream version bump.
	Revision string `json:"revision,omitempty"`

	// PreferredMajor extends the upstream model by marking this major version as "preferred" over
	// other major versions. This is used when generating the manifest to create the "latest" tags.
	PreferredMajor bool `json:"preferredMajor,omitempty"`
	// PreferredMinor extends the upstream model by marking this minor version as "preferred" over
	// other minor versions. For example, if "1.42" is preferred, this would generate a "1" tag in
	// the manifest that people can use to pull "1.42" rather than "1.41".
	PreferredMinor bool `json:"preferredMinor,omitempty"`
	// PreferredVariant extends the upstream model and specifies the variant that should be
	// "preferred" in the tagging structure. For example, if buster is preferred over stretch, the
	// generated "1.16.6" tag will point at a buster image.
	PreferredVariant string `json:"preferredVariant,omitempty"`

	// TagPrefix extends the upstream model, specifying a prefix to include in every tag when
	// generating the 'manifest.json' file.
	//
	// This field is intended to be used for dev branches. When creating a dev branch, filter the
	// Versions entries down the ones that are necessary and add a TagPrefix to each one to
	// distinguish them from the main branch.
	TagPrefix string `json:"tagPrefix,omitempty"`

	// BranchSuffix	extends the upstream model by indicating a suffix on the Versions key that is
	// related to the branch this build came from, such as "-fips". This suffix must be removed
	// before interpreting the Versions key as a Go version.
	//
	// This field is intended to be used for stable branches that have forked from the release
	// branches in microsoft/go and are maintained in the main branch in microsoft/go-images. A
	// BranchSuffix allows 1.17 and 1.17-fips to have distinct Versions objects, for example, which
	// is necessary to have different arches and variants for each branch.
	BranchSuffix string `json:"branchSuffix,omitempty"`
}

type Versions map[string]*MajorMinorVersion