Warehouse is a source of Freight.
Last changed in Kargo v1.10.0
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
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
Spec describes sources of artifacts.
FreightCreationCriteria defines criteria that must be satisfied for Freight to be created automatically from new artifacts following discovery. This field has no effect when the FreightCreationPolicy is `Manual`.
Expression is an expr-lang expression that must evaluate to true for Freight to be created automatically from new artifacts following discovery.
FreightCreationPolicy describes how Freight is created by this Warehouse. This field is optional. When left unspecified, the field is implicitly treated as if its value were "Automatic". Accepted values: - "Automatic": New Freight is created automatically when any new artifact is discovered. - "Manual": New Freight is never created automatically.
Interval is the reconciliation interval for this Warehouse. On each reconciliation, the Warehouse will discover new artifacts and optionally produce new Freight. This field is optional. When left unspecified, the field is implicitly treated as if its value were "5m0s".
Shard is the name of the shard that this Warehouse belongs to. This is an optional field. If not specified, the Warehouse will belong to the default shard. A defaulting webhook will sync this field with the value of the kargo.akuity.io/shard label. When the shard 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 shard label is present and this field is empty, the defaulting webhook will set the value of this field to the value of the shard label.
Subscriptions describes sources of artifacts to be included in Freight produced by this Warehouse.
Status describes the Warehouse's most recently observed state.
Conditions contains the last observations of the Warehouse's current state.
lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
message is a human readable message indicating details about the transition. This may be an empty string.
observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
status of the condition, one of True, False, Unknown.
type of condition in CamelCase or in foo.example.com/CamelCase.
DiscoveredArtifacts holds the artifacts discovered by the Warehouse.
Charts holds the charts discovered by the Warehouse for the chart subscriptions.
Name is the name of the Helm chart, as specified in the ChartSubscription.
RepoURL is the repository URL of the Helm chart, as specified in the ChartSubscription.
SemverConstraint is the constraint for which versions were discovered. This field is optional, and only populated if the ChartSubscription specifies a SemverConstraint.
Versions is a list of versions discovered by the Warehouse for the ChartSubscription. An empty list indicates that the discovery operation was successful, but no versions matching the ChartSubscription criteria were found.
DiscoveredAt is the time at which the Warehouse discovered the artifacts.
Git holds the commits discovered by the Warehouse for the Git subscriptions.
Commits is a list of commits discovered by the Warehouse for the GitSubscription. An empty list indicates that the discovery operation was successful, but no commits matching the GitSubscription criteria were found.
Author is the author of the commit.
Branch is the branch in which the commit was found. This field is optional, and populated based on the CommitSelectionStrategy of the GitSubscription.
Committer is the person who committed the commit.
CreatorDate is the commit creation date as specified by the commit, or the tagger date if the commit belongs to an annotated tag.
ID is the identifier of the commit. This typically is a SHA-1 hash.
Subject is the subject of the commit (i.e. the first line of the commit message).
Tag is the tag that resolved to this commit. This field is optional, and populated based on the CommitSelectionStrategy of the GitSubscription.
RepoURL is the repository URL of the GitSubscription.
Images holds the image references discovered by the Warehouse for the image subscriptions.
Platform is the target platform constraint of the ImageSubscription for which references were discovered. This field is optional, and only populated if the ImageSubscription specifies a Platform.
References is a list of image references discovered by the Warehouse for the ImageSubscription. An empty list indicates that the discovery operation was successful, but no images matching the ImageSubscription criteria were found.
Annotations is a map of key-value pairs that provide additional information about the image.
CreatedAt is the time the image was created. This field is optional, and not populated for every ImageSelectionStrategy.
Digest is the digest of the image.
Tag is the tag of the image.
RepoURL is the repository URL of the image, as specified in the ImageSubscription.
Results holds the artifact references discovered by the Warehouse.
ArtifactReferences is a list of references to specific versions of an artifact.
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.
SubscriptionName is the name of the Subscription that discovered these results.
LastFreightID is a reference to the system-assigned identifier (name) of the most recent Freight produced by the Warehouse.
LastHandledRefresh holds the value of the most recent AnnotationKeyRefresh annotation that was handled by the controller. This field can be used to determine whether the request to refresh the resource has been handled.
ObservedGeneration represents the .metadata.generation that this Warehouse was reconciled against.
Source: kargo.akuity.io_warehouses.yaml
Changes to Warehouse (kargo.akuity.io/v1alpha1) in each Kargo version, compared to the version before it.
1 property has changed the description
Released · View Warehouse in v1.10.0
1 property has been added
Released · View Warehouse in v1.8.0
1 property has been added
2 properties have been removed
1 property has changed the description
Released · View Warehouse in v1.7.0
1 property has been added
4 properties have changed the description
Released · View Warehouse in v1.6.0
2 properties have changed the description
Released · View Warehouse in v1.5.0
1 property has been added
Released · View Warehouse in v1.4.0
1 property has changed the description
Released · View Warehouse in v1.1.2
3 properties have changed the description
Released · View Warehouse in v1.0.4
1 property is no longer required
Released · View Warehouse in v0.8.0
5 properties have been added
1 property has been removed
2 properties have changed the description
Released · View Warehouse in v0.6.0
Warehouse was already present in this version of Kargo, the oldest one on kubespec.dev
Released · View Warehouse in v0.5.0
No examples of Warehouse yet. Contribute one on GitHub.
kubespec.dev