Project
kargo.akuity.io / v1alpha1
apiVersion: kargo.akuity.io/v1alpha1
kind: Project
metadata:
name: example
apiVersion
string
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
string
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
metadata
object
spec object
Spec describes a Project.
Deprecated: Create a ProjectConfig resource with the same name as the
Project resource in the Project's namespace. The ProjectConfig resource
can be used to configure the Project.
promotionPolicies []object
PromotionPolicies defines policies governing the promotion of Freight to
specific Stages within the Project.
autoPromotionEnabled
boolean
AutoPromotionEnabled indicates whether new Freight can automatically be
promoted into the Stage referenced by the Stage field. Note: There are may
be other conditions also required for an auto-promotion to occur. This
field defaults to false, but is commonly set to true for Stages that
subscribe to Warehouses instead of other, upstream Stages. This allows
users to define Stages that are automatically updated as soon as new
artifacts are detected.
stage
string
Stage is the name of the Stage to which this policy applies.
Deprecated: Use StageSelector instead.
pattern:
^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$stageSelector object
StageSelector is a selector that matches the Stage resource to which
this policy applies.
matchExpressions []object
matchExpressions is a list of label selector requirements. The requirements are ANDed.
key
string required
key is the label key that the selector applies to.
operator
string required
operator represents a key's relationship to a set of values.
Valid operators are In, NotIn, Exists and DoesNotExist.
values
[]string
values is an array of string values. If the operator is In or NotIn,
the values array must be non-empty. If the operator is Exists or DoesNotExist,
the values array must be empty. This array is replaced during a strategic
merge patch.
matchLabels
object
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions, whose key field is "key", the
operator is "In", and the values array contains only "value". The requirements are ANDed.
name
string
Name is the name of the resource to which this policy applies.
It can be an exact name, a regex pattern (with prefix "regex:"), or a
glob pattern (with prefix "glob:").
When both Name and LabelSelector are specified, the Name is ANDed with
the LabelSelector. I.e., the resource must match both the Name and
LabelSelector to be selected by this policy.
NOTE: Using a specific exact name is the most secure option. Pattern
matching via regex or glob can be exploited by users with permissions to
match promotion policies that weren't intended to apply to their
resources. For example, a user could create a resource with a name
deliberately crafted to match the pattern, potentially bypassing intended
promotion controls.
status object
Status describes the Project's current status.
conditions []object
Conditions contains the last observations of the Project's current
state.
lastTransitionTime
string required
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.
format:
date-time
message
string required
message is a human readable message indicating details about the transition.
This may be an empty string.
maxLength:
32768
observedGeneration
integer
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.
format:
int64minimum:
0
reason
string required
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.
pattern:
^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$minLength:
1maxLength:
1024
status
string required
status of the condition, one of True, False, Unknown.
enum:
True, False, Unknown
type
string required
type of condition in CamelCase or in foo.example.com/CamelCase.
pattern:
^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$maxLength:
316stats object
Stats contains a summary of the collective state of a Project's
constituent resources.
stages object
Stages contains a summary of the collective state of the Project's Stages.
count
integer
Count contains the total number of Stages in the Project.
format:
int64health object
Health contains a summary of the collective health of a Project's Stages.
healthy
integer
Healthy contains the number of resources that are explicitly healthy.
format:
int64warehouses object
Warehouses contains a summary of the collective state of the Project's
Warehouses.
count
integer
Count contains the total number of Warehouses in the Project.
format:
int64health object
Health contains a summary of the collective health of a Project's
Warehouses.
healthy
integer
Healthy contains the number of resources that are explicitly healthy.
format:
int64No matches. Try .spec.promotionPolicies for an exact path