Freight represents a collection of versioned artifacts.
Last changed in Kargo v1.12.0
Alias is a human-friendly alias for a piece of Freight. This is an optional field. A defaulting webhook will sync this field with the value of the kargo.akuity.io/alias label. When the alias label is not present or differs from the value of this field, the defaulting webhook will set the label to the value of this field. If the alias label is present and this field is empty, the defaulting webhook will set the value of this field to the value of the alias label. If this field is empty and the alias label is not present, the defaulting webhook will choose an available alias and assign it to both the field and label.
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
Artifacts describes specific versions of artifacts other than Git repository commits, container images, and Helm charts.
ArtifactType specifies the type of artifact this is. Often, but not always, it will be the media type (MIME type) of the artifact referenced by this ArtifactReference.
Metadata is a JSON object containing a mostly opaque collection of artifact attributes. (It must be an object. It may not be a list or a scalar value.) "Mostly" because Kargo may understand how to interpret some documented, well-known, top-level keys. Those aside, this metadata is only understood by a corresponding Subscriber implementation that created it.
SubscriptionName is the name of the Subscription that discovered this artifact.
Version identifies a specific revision of this artifact.
Charts describes specific versions of specific Helm charts.
Name specifies the name of the chart.
RepoURL specifies the URL of a Helm chart repository. Classic chart repositories (using HTTP/S) can contain differently named charts. When this field points to such a repository, the Name field will specify the name of the chart within the repository. In the case of a repository within an OCI registry, the URL implicitly points to a specific chart and the Name field will be empty.
SubscriptionName is the name of the subscription that discovered this chart. This field is only populated if the subscription was assigned a name.
Version specifies a particular version of the chart.
Commits describes specific Git repository commits.
Author is the author of the commit.
Branch denotes the branch of the repository where this commit was found.
Committer is the person who committed the commit.
ID is the ID of a specific commit in the Git repository specified by RepoURL.
Message is the message associated with the commit. At present, this only contains the first line (subject) of the commit message.
RepoURL is the URL of a Git repository.
SubscriptionName is the name of the subscription that discovered this commit. This field is only populated if the subscription was assigned a name.
Tag denotes a tag in the repository that matched selection criteria and resolved to this commit.
DiscoveredAt is the time at which this Freight was discovered/created. A defaulting webhook initializes this to the creation time of the Freight.
Images describes specific versions of specific container images.
Annotations is a map of arbitrary metadata for the image.
Digest identifies a specific version of the image in the repository specified by RepoURL. This is a more precise identifier than Tag.
RepoURL describes the repository in which the image can be found.
SubscriptionName is the name of the subscription that discovered this image. This field is only populated if the subscription was assigned a name.
Tag identifies a specific version of the image in the repository specified by RepoURL.
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
Origin describes a kind of Freight in terms of its origin.
Kind is the kind of resource from which Freight may have originated. At present, this can only be "Warehouse".
Name is the name of the resource of the kind indicated by the Kind field from which Freight may originate.
Status describes the current status of this Freight.
ApprovedFor describes the Stages for which this Freight has been approved preemptively/manually by a user. This is useful for hotfixes, where one might wish to promote a piece of Freight to a given Stage without transiting the entire pipeline.
ApprovedAt is the time at which the Freight was approved for the Stage.
CurrentlyIn describes the Stages in which this Freight is currently in use.
Since is the time at which the Stage most recently started using the Freight. This can be used to calculate how long the Freight has been in use by the Stage.
Metadata is a map of arbitrary metadata associated with the Freight. This is useful for storing additional information about the Freight or Promotion that can be shared across steps or stages.
VerifiedIn describes the Stages in which this Freight has been verified through promotion and subsequent health checks.
LongestCompletedSoak represents the longest definite time interval wherein the Freight was in CONTINUOUS use by the Stage. This value is updated as Freight EXITS the Stage. If the Freight is currently in use by the Stage, the time elapsed since the Freight ENTERED the Stage is its current soak time, which may exceed the value of this field.
VerifiedAt is the time at which the Freight was verified in the Stage.
Source: kargo.akuity.io_freights.yaml
Changes to Freight (kargo.akuity.io/v1alpha1) in each Kargo version, compared to the version before it.
3 properties have been added
Released · View Freight in v1.12.0
1 property has been added
Released · View Freight in v1.11.0
1 property has been added
Released · View Freight in v1.9.0
1 property has been removed
Released · View Freight in v1.7.0
1 property has been added
Released · View Freight in v1.6.0
1 property has changed the description
Released · View Freight in v1.5.0
1 property has been added
Released · View Freight in v1.4.0
1 property has been removed
Released · View Freight in v1.0.0
Freight was already present in this version of Kargo, the oldest one on kubespec.dev
Released · View Freight in v0.5.0
No examples of Freight yet. Contribute one on GitHub.
kubespec.dev