Stage is the Kargo API's main type.
Last changed in Kargo v0.6.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 Freight used by the Stage and how to incorporate Freight into the Stage.
PromotionMechanisms describes how to incorporate Freight into the Stage. This is an optional field as it is sometimes useful to aggregates available Freight from multiple upstream Stages without performing any actions. The utility of this is to allow multiple downstream Stages to subscribe to a single upstream Stage where they may otherwise have subscribed to multiple upstream Stages.
ArgoCDAppUpdates describes updates that should be applied to Argo CD Application resources to incorporate Freight into the Stage. This field is optional, as such actions are not required in all cases. Note that all updates specified by the GitRepoUpdates field, if any, are applied BEFORE these.
AppName specifies the name of an Argo CD Application resource to be updated.
AppNamespace specifies the namespace of an Argo CD Application resource to be updated. If left unspecified, the namespace of this Application resource will use the value of ARGOCD_NAMESPACE or "argocd"
SourceUpdates describes updates to be applied to various sources of the specified Argo CD Application resource.
Chart along with the RepoURL field identifies which of an Argo CD Application's sources this update is intended for. Note: As of Argo CD 2.6, Applications can use multiple sources. When the source to be updated references a Helm chart repository, the values of the RepoURL and Chart fields should exactly match the values of the fields of the same names in the source. i.e. Do not match the values of these two fields to your Warehouse; match them to the Application source you wish to update.
Helm describes updates to the source's Helm-specific attributes.
Images describes how specific image versions can be incorporated into an Argo CD Application's Helm parameters.
Image specifies a container image (without tag). This is a required field.
Key specifies a key within an Argo CD Application's Helm parameters that is to be updated. This is a required field.
Value specifies the new value for the specified key in the Argo CD Application's Helm parameters. Valid values are: - ImageAndTag: Replaces the value of the specified key with <image name>:<tag> - Tag: Replaces the value of the specified key with just the new tag - ImageAndDigest: Replaces the value of the specified key with <image name>@<digest> - Digest: Replaces the value of the specified key with just the new digest. This is a required field.
Kustomize describes updates to the source's Kustomize-specific attributes.
Images describes how specific image versions can be incorporated into an Argo CD Application's Kustomize parameters.
Image specifies a container image (without tag). This is a required field.
UseDigest specifies whether the image's digest should be used instead of its tag.
RepoURL along with the Chart field identifies which of an Argo CD Application's sources this update is intended for. Note: As of Argo CD 2.6, Applications can use multiple sources. When the source to be updated references a Helm chart repository, the values of the RepoURL and Chart fields should exactly match the values of the fields of the same names in the source. i.e. Do not match the values of these two fields to your Warehouse; match them to the Application source you wish to update. This is a required field.
UpdateTargetRevision is a bool indicating whether the source should be updated such that its TargetRevision field points at the most recently git commit (if RepoURL references a git repository) or chart version (if RepoURL references a chart repository).
GitRepoUpdates describes updates that should be applied to Git repositories to incorporate Freight into the Stage. This field is optional, as such actions are not required in all cases.
Helm describes how to use Helm to incorporate Freight into the Stage. This is mutually exclusive with the Render and Kustomize fields.
Charts describes how specific chart versions can be incorporated into an umbrella chart.
ChartPath is the path to an umbrella chart.
Name along with Repository identifies a subchart of the umbrella chart at ChartPath whose version should be updated. The values of both fields should exactly match the values of the fields of the same names in a dependency expressed in the Chart.yaml of the umbrella chart at ChartPath. i.e. Do not match the values of these two fields to your Warehouse; match them to the Chart.yaml. This is a required field.
Repository along with Name identifies a subchart of the umbrella chart at ChartPath whose version should be updated. The values of both fields should exactly match the values of the fields of the same names in a dependency expressed in the Chart.yaml of the umbrella chart at ChartPath. i.e. Do not match the values of these two fields to your Warehouse; match them to the Chart.yaml. This is a required field.
Images describes how specific image versions can be incorporated into Helm values files.
Image specifies a container image (without tag). This is a required field.
Key specifies a key within the Helm values file that is to be updated. This is a required field.
Value specifies the new value for the specified key in the specified Helm values file. Valid values are: - ImageAndTag: Replaces the value of the specified key with <image name>:<tag> - Tag: Replaces the value of the specified key with just the new tag - ImageAndDigest: Replaces the value of the specified key with <image name>@<digest> - Digest: Replaces the value of the specified key with just the new digest. This is a required field.
ValuesFilePath specifies a path to the Helm values file that is to be updated. This is a required field.
InsecureSkipTLSVerify specifies whether certificate verification errors should be ignored when connecting to the repository. This should be enabled only with great caution.
Kustomize describes how to use Kustomize to incorporate Freight into the Stage. This is mutually exclusive with the Render and Helm fields.
Images describes images for which `kustomize edit set image` should be executed and the paths in which those commands should be executed.
Image specifies a container image (without tag). This is a required field.
Path specifies a path in which the `kustomize edit set image` command should be executed. This is a required field.
UseDigest specifies whether the image's digest should be used instead of its tag.
PullRequest will generate a pull request instead of making the commit directly
GitHub indicates git provider is GitHub
GitLab indicates git provider is GitLab
ReadBranch specifies a particular branch of the repository from which to locate contents that will be written to the branch specified by the WriteBranch field. This field is optional. When not specified, the ReadBranch is implicitly the repository's default branch AND in cases where a Freight includes a GitCommit, that commit's ID will supersede the value of this field. Therefore, in practice, this field is only used to clarify what branch of a repository can be treated as a source of manifests or other configuration when a Stage has no subscription to that repository.
Render describes how to use Kargo Render to incorporate Freight into the Stage. This is mutually exclusive with the Kustomize and Helm fields.
Images describes how images can be incorporated into a Stage using Kargo Render. If this field is omitted, all images in the Freight being promoted will be passed to Kargo Render in the form <image name>:<tag>. (e.g. Will not use digests by default.)
Image specifies a container image (without tag). This is a required field.
UseDigest specifies whether the image's digest should be used instead of its tag.
RepoURL is the URL of the repository to update. This is a required field.
WriteBranch specifies the particular branch of the repository to be updated. This is a required field.
Shard is the name of the shard that this Stage belongs to. This is an optional field. If not specified, the Stage will belong to the default shard. A defaulting webhook will sync the value of the kargo.akuity.io/shard label with the value of this field. When this field is empty, the webhook will ensure that label is absent.
Subscriptions describes the Stage's sources of Freight. This is a required field.
UpstreamStages identifies other Stages as potential sources of Freight for this Stage. This field is mutually exclusive with the Repos field.
Name specifies the name of a Stage.
Warehouse is a subscription to a Warehouse. This field is mutually exclusive with the UpstreamStages field.
Verification describes how to verify a Stage's current Freight is fit for promotion downstream.
AnalysisRunMetadata contains optional metadata that should be applied to all AnalysisRuns.
Additional annotations to apply to an AnalysisRun.
Additional labels to apply to an AnalysisRun.
AnalysisTemplates is a list of AnalysisTemplates from which AnalysisRuns should be created to verify a Stage's current Freight is fit to be promoted downstream.
Name is the name of the AnalysisTemplate in the same project/namespace as the Stage.
Args lists arguments that should be added to all AnalysisRuns.
Name is the name of the argument.
Value is the value of the argument.
Status describes the Stage's current and recent Freight, health, and more.
CurrentFreight is a simplified representation of the Stage's current Freight describing what is currently deployed to the Stage.
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.
Version specifies a particular version of the chart.
Commits describes specific Git repository commits.
Author is the git commit author
Branch denotes the branch of the repository where this commit was found.
HealthCheckCommit is the ID of a specific commit. When specified, assessments of Stage health will used this value (instead of ID) when determining if applicable sources of Argo CD Application resources associated with the Stage are or are not synced to this commit. Note that there are cases (as in that of Kargo Render being utilized as a promotion mechanism) wherein the value of this field may differ from the commit ID found in the ID field.
ID is the ID of a specific commit in the Git repository specified by RepoURL.
Message is the git commit message
RepoURL is the URL of a Git repository.
Tag denotes a tag in the repository that matched selection criteria and resolved to this commit.
Images describes specific versions of specific container images.
Digest identifies a specific version of the image in the repository specified by RepoURL. This is a more precise identifier than Tag.
GitRepoURL specifies the URL of a Git repository that contains the source code for the image repository referenced by the RepoURL field if Kargo was able to infer it.
RepoURL describes the repository in which the image can be found.
Tag identifies a specific version of the image in the repository specified by RepoURL.
Name is system-assigned identifier that is derived deterministically from the contents of the Freight. i.e. Two pieces of Freight can be compared for equality by comparing their Names.
VerificationHistory is a stack of recent VerificationInfo. By default, the last ten VerificationInfo are stored.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
VerificationInfo is information about any verification process that was associated with this Freight for this Stage.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
Warehouse is the name of the Warehouse that created this Freight.
CurrentPromotion is a reference to the currently Running promotion.
Freight is the freight being promoted
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.
Version specifies a particular version of the chart.
Commits describes specific Git repository commits.
Author is the git commit author
Branch denotes the branch of the repository where this commit was found.
HealthCheckCommit is the ID of a specific commit. When specified, assessments of Stage health will used this value (instead of ID) when determining if applicable sources of Argo CD Application resources associated with the Stage are or are not synced to this commit. Note that there are cases (as in that of Kargo Render being utilized as a promotion mechanism) wherein the value of this field may differ from the commit ID found in the ID field.
ID is the ID of a specific commit in the Git repository specified by RepoURL.
Message is the git commit message
RepoURL is the URL of a Git repository.
Tag denotes a tag in the repository that matched selection criteria and resolved to this commit.
Images describes specific versions of specific container images.
Digest identifies a specific version of the image in the repository specified by RepoURL. This is a more precise identifier than Tag.
GitRepoURL specifies the URL of a Git repository that contains the source code for the image repository referenced by the RepoURL field if Kargo was able to infer it.
RepoURL describes the repository in which the image can be found.
Tag identifies a specific version of the image in the repository specified by RepoURL.
Name is system-assigned identifier that is derived deterministically from the contents of the Freight. i.e. Two pieces of Freight can be compared for equality by comparing their Names.
VerificationHistory is a stack of recent VerificationInfo. By default, the last ten VerificationInfo are stored.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
VerificationInfo is information about any verification process that was associated with this Freight for this Stage.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
Warehouse is the name of the Warehouse that created this Freight.
Name is the name of the Promotion
Status is the (optional) status of the promotion
Freight is the detail of the piece of freight that was referenced by this promotion.
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.
Version specifies a particular version of the chart.
Commits describes specific Git repository commits.
Author is the git commit author
Branch denotes the branch of the repository where this commit was found.
HealthCheckCommit is the ID of a specific commit. When specified, assessments of Stage health will used this value (instead of ID) when determining if applicable sources of Argo CD Application resources associated with the Stage are or are not synced to this commit. Note that there are cases (as in that of Kargo Render being utilized as a promotion mechanism) wherein the value of this field may differ from the commit ID found in the ID field.
ID is the ID of a specific commit in the Git repository specified by RepoURL.
Message is the git commit message
RepoURL is the URL of a Git repository.
Tag denotes a tag in the repository that matched selection criteria and resolved to this commit.
Images describes specific versions of specific container images.
Digest identifies a specific version of the image in the repository specified by RepoURL. This is a more precise identifier than Tag.
GitRepoURL specifies the URL of a Git repository that contains the source code for the image repository referenced by the RepoURL field if Kargo was able to infer it.
RepoURL describes the repository in which the image can be found.
Tag identifies a specific version of the image in the repository specified by RepoURL.
Name is system-assigned identifier that is derived deterministically from the contents of the Freight. i.e. Two pieces of Freight can be compared for equality by comparing their Names.
VerificationHistory is a stack of recent VerificationInfo. By default, the last ten VerificationInfo are stored.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
VerificationInfo is information about any verification process that was associated with this Freight for this Stage.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
Warehouse is the name of the Warehouse that created this Freight.
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.
Message is a display message about the promotion, including any errors preventing the Promotion controller from executing this Promotion. i.e. If the Phase field has a value of Failed, this field can be expected to explain why.
Metadata holds arbitrary metadata set by promotion mechanisms (e.g. for display purposes, or internal bookkeeping)
Phase describes where the Promotion currently is in its lifecycle.
Health is the Stage's last observed health.
ArgoCDApps describes the current state of any related ArgoCD Applications.
HealthStatus is the health of the ArgoCD Application.
Name is the name of the ArgoCD Application.
Namespace is the namespace of the ArgoCD Application.
SyncStatus is the sync status of the ArgoCD Application.
Issues clarifies why a Stage in any state other than Healthy is in that state. This field will always be the empty when a Stage is Healthy.
Status describes the health of the Stage.
History is a stack of recent Freight. By default, the last ten Freight are stored.
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.
Version specifies a particular version of the chart.
Commits describes specific Git repository commits.
Author is the git commit author
Branch denotes the branch of the repository where this commit was found.
HealthCheckCommit is the ID of a specific commit. When specified, assessments of Stage health will used this value (instead of ID) when determining if applicable sources of Argo CD Application resources associated with the Stage are or are not synced to this commit. Note that there are cases (as in that of Kargo Render being utilized as a promotion mechanism) wherein the value of this field may differ from the commit ID found in the ID field.
ID is the ID of a specific commit in the Git repository specified by RepoURL.
Message is the git commit message
RepoURL is the URL of a Git repository.
Tag denotes a tag in the repository that matched selection criteria and resolved to this commit.
Images describes specific versions of specific container images.
Digest identifies a specific version of the image in the repository specified by RepoURL. This is a more precise identifier than Tag.
GitRepoURL specifies the URL of a Git repository that contains the source code for the image repository referenced by the RepoURL field if Kargo was able to infer it.
RepoURL describes the repository in which the image can be found.
Tag identifies a specific version of the image in the repository specified by RepoURL.
Name is system-assigned identifier that is derived deterministically from the contents of the Freight. i.e. Two pieces of Freight can be compared for equality by comparing their Names.
VerificationHistory is a stack of recent VerificationInfo. By default, the last ten VerificationInfo are stored.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
VerificationInfo is information about any verification process that was associated with this Freight for this Stage.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
Warehouse is the name of the Warehouse that created this Freight.
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.
LastPromotion is a reference to the last completed promotion.
Freight is the freight being promoted
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.
Version specifies a particular version of the chart.
Commits describes specific Git repository commits.
Author is the git commit author
Branch denotes the branch of the repository where this commit was found.
HealthCheckCommit is the ID of a specific commit. When specified, assessments of Stage health will used this value (instead of ID) when determining if applicable sources of Argo CD Application resources associated with the Stage are or are not synced to this commit. Note that there are cases (as in that of Kargo Render being utilized as a promotion mechanism) wherein the value of this field may differ from the commit ID found in the ID field.
ID is the ID of a specific commit in the Git repository specified by RepoURL.
Message is the git commit message
RepoURL is the URL of a Git repository.
Tag denotes a tag in the repository that matched selection criteria and resolved to this commit.
Images describes specific versions of specific container images.
Digest identifies a specific version of the image in the repository specified by RepoURL. This is a more precise identifier than Tag.
GitRepoURL specifies the URL of a Git repository that contains the source code for the image repository referenced by the RepoURL field if Kargo was able to infer it.
RepoURL describes the repository in which the image can be found.
Tag identifies a specific version of the image in the repository specified by RepoURL.
Name is system-assigned identifier that is derived deterministically from the contents of the Freight. i.e. Two pieces of Freight can be compared for equality by comparing their Names.
VerificationHistory is a stack of recent VerificationInfo. By default, the last ten VerificationInfo are stored.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
VerificationInfo is information about any verification process that was associated with this Freight for this Stage.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
Warehouse is the name of the Warehouse that created this Freight.
Name is the name of the Promotion
Status is the (optional) status of the promotion
Freight is the detail of the piece of freight that was referenced by this promotion.
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.
Version specifies a particular version of the chart.
Commits describes specific Git repository commits.
Author is the git commit author
Branch denotes the branch of the repository where this commit was found.
HealthCheckCommit is the ID of a specific commit. When specified, assessments of Stage health will used this value (instead of ID) when determining if applicable sources of Argo CD Application resources associated with the Stage are or are not synced to this commit. Note that there are cases (as in that of Kargo Render being utilized as a promotion mechanism) wherein the value of this field may differ from the commit ID found in the ID field.
ID is the ID of a specific commit in the Git repository specified by RepoURL.
Message is the git commit message
RepoURL is the URL of a Git repository.
Tag denotes a tag in the repository that matched selection criteria and resolved to this commit.
Images describes specific versions of specific container images.
Digest identifies a specific version of the image in the repository specified by RepoURL. This is a more precise identifier than Tag.
GitRepoURL specifies the URL of a Git repository that contains the source code for the image repository referenced by the RepoURL field if Kargo was able to infer it.
RepoURL describes the repository in which the image can be found.
Tag identifies a specific version of the image in the repository specified by RepoURL.
Name is system-assigned identifier that is derived deterministically from the contents of the Freight. i.e. Two pieces of Freight can be compared for equality by comparing their Names.
VerificationHistory is a stack of recent VerificationInfo. By default, the last ten VerificationInfo are stored.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
VerificationInfo is information about any verification process that was associated with this Freight for this Stage.
Actor is the name of the entity that initiated or aborted the Verification process.
AnalysisRun is a reference to the Argo Rollouts AnalysisRun that implements the Verification process.
Name is the name of the AnalysisRun.
Namespace is the namespace of the AnalysisRun.
Phase is the last observed phase of the AnalysisRun referenced by Name.
FinishTime is the time at which the Verification process finished.
ID is the identifier of the Verification process.
Message may contain additional information about why the verification process is in its current phase.
Phase describes the current phase of the Verification process. Generally, this will be a reflection of the underlying AnalysisRun's phase, however, there are exceptions to this, such as in the case where an AnalysisRun cannot be launched successfully.
StartTime is the time at which the Verification process was started.
Warehouse is the name of the Warehouse that created this Freight.
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.
Message is a display message about the promotion, including any errors preventing the Promotion controller from executing this Promotion. i.e. If the Phase field has a value of Failed, this field can be expected to explain why.
Metadata holds arbitrary metadata set by promotion mechanisms (e.g. for display purposes, or internal bookkeeping)
Phase describes where the Promotion currently is in its lifecycle.
Message describes any errors that are preventing the Stage controller from assessing Stage health or from finding new Freight.
ObservedGeneration represents the .metadata.generation that this Stage status was reconciled against.
Phase describes where the Stage currently is in its lifecycle.
Source: kargo.akuity.io_stages.yaml
Changes to Stage (kargo.akuity.io/v1alpha1) in each Kargo version, compared to the version before it.
16 properties have been added
3 properties have been removed
1 property has changed the description
Released · View Stage in v0.6.0
Stage was already present in this version of Kargo, the oldest one on kubespec.dev
Released · View Stage in v0.5.0
No examples of Stage yet. Contribute one on GitHub.
kubespec.dev