v1beta1

package
v1.6.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 28, 2017 License: Apache-2.0 Imports: 23 Imported by: 0

Documentation

Overview

Package v1beta1 is a generated protocol buffer package.

It is generated from these files:

k8s.io/kubernetes/pkg/apis/apps/v1beta1/generated.proto

It has these top-level messages:

Deployment
DeploymentCondition
DeploymentList
DeploymentRollback
DeploymentSpec
DeploymentStatus
DeploymentStrategy
RollbackConfig
RollingUpdateDeployment
Scale
ScaleSpec
ScaleStatus
StatefulSet
StatefulSetList
StatefulSetSpec
StatefulSetStatus

Index

Constants

View Source
const (
	// DefaultDeploymentUniqueLabelKey is the default key of the selector that is added
	// to existing RCs (and label key that is added to its pods) to prevent the existing RCs
	// to select new pods (and old pods being select by new RC).
	DefaultDeploymentUniqueLabelKey string = "pod-template-hash"
)
View Source
const GroupName = "apps"

GroupName is the group name use in this package

View Source
const (
	// StatefulSetInitAnnotation if present, and set to false, indicates that a Pod's readiness should be ignored.
	StatefulSetInitAnnotation = "pod.alpha.kubernetes.io/initialized"
)

Variables

View Source
var (
	ErrInvalidLengthGenerated = fmt.Errorf("proto: negative length found during unmarshaling")
	ErrIntOverflowGenerated   = fmt.Errorf("proto: integer overflow")
)
View Source
var (
	SchemeBuilder = runtime.NewSchemeBuilder(addKnownTypes, addDefaultingFuncs, addConversionFuncs)
	AddToScheme   = SchemeBuilder.AddToScheme
)
View Source
var SchemeGroupVersion = schema.GroupVersion{Group: GroupName, Version: "v1beta1"}

SchemeGroupVersion is group version used to register these objects

Functions

func Convert_apps_StatefulSetList_To_v1beta1_StatefulSetList

func Convert_apps_StatefulSetList_To_v1beta1_StatefulSetList(in *apps.StatefulSetList, out *StatefulSetList, s conversion.Scope) error

func Convert_apps_StatefulSetSpec_To_v1beta1_StatefulSetSpec

func Convert_apps_StatefulSetSpec_To_v1beta1_StatefulSetSpec(in *apps.StatefulSetSpec, out *StatefulSetSpec, s conversion.Scope) error

func Convert_apps_StatefulSetStatus_To_v1beta1_StatefulSetStatus

func Convert_apps_StatefulSetStatus_To_v1beta1_StatefulSetStatus(in *apps.StatefulSetStatus, out *StatefulSetStatus, s conversion.Scope) error

func Convert_apps_StatefulSet_To_v1beta1_StatefulSet

func Convert_apps_StatefulSet_To_v1beta1_StatefulSet(in *apps.StatefulSet, out *StatefulSet, s conversion.Scope) error

func Convert_extensions_DeploymentSpec_To_v1beta1_DeploymentSpec added in v1.6.0

func Convert_extensions_DeploymentSpec_To_v1beta1_DeploymentSpec(in *extensions.DeploymentSpec, out *DeploymentSpec, s conversion.Scope) error

func Convert_extensions_DeploymentStrategy_To_v1beta1_DeploymentStrategy added in v1.6.0

func Convert_extensions_DeploymentStrategy_To_v1beta1_DeploymentStrategy(in *extensions.DeploymentStrategy, out *DeploymentStrategy, s conversion.Scope) error

func Convert_extensions_RollingUpdateDeployment_To_v1beta1_RollingUpdateDeployment added in v1.6.0

func Convert_extensions_RollingUpdateDeployment_To_v1beta1_RollingUpdateDeployment(in *extensions.RollingUpdateDeployment, out *RollingUpdateDeployment, s conversion.Scope) error

func Convert_extensions_ScaleStatus_To_v1beta1_ScaleStatus added in v1.6.0

func Convert_extensions_ScaleStatus_To_v1beta1_ScaleStatus(in *extensions.ScaleStatus, out *ScaleStatus, s conversion.Scope) error

func Convert_v1beta1_DeploymentSpec_To_extensions_DeploymentSpec added in v1.6.0

func Convert_v1beta1_DeploymentSpec_To_extensions_DeploymentSpec(in *DeploymentSpec, out *extensions.DeploymentSpec, s conversion.Scope) error

func Convert_v1beta1_DeploymentStrategy_To_extensions_DeploymentStrategy added in v1.6.0

func Convert_v1beta1_DeploymentStrategy_To_extensions_DeploymentStrategy(in *DeploymentStrategy, out *extensions.DeploymentStrategy, s conversion.Scope) error

func Convert_v1beta1_RollingUpdateDeployment_To_extensions_RollingUpdateDeployment added in v1.6.0

func Convert_v1beta1_RollingUpdateDeployment_To_extensions_RollingUpdateDeployment(in *RollingUpdateDeployment, out *extensions.RollingUpdateDeployment, s conversion.Scope) error

func Convert_v1beta1_ScaleStatus_To_extensions_ScaleStatus added in v1.6.0

func Convert_v1beta1_ScaleStatus_To_extensions_ScaleStatus(in *ScaleStatus, out *extensions.ScaleStatus, s conversion.Scope) error

func Convert_v1beta1_StatefulSetList_To_apps_StatefulSetList

func Convert_v1beta1_StatefulSetList_To_apps_StatefulSetList(in *StatefulSetList, out *apps.StatefulSetList, s conversion.Scope) error

func Convert_v1beta1_StatefulSetSpec_To_apps_StatefulSetSpec

func Convert_v1beta1_StatefulSetSpec_To_apps_StatefulSetSpec(in *StatefulSetSpec, out *apps.StatefulSetSpec, s conversion.Scope) error

func Convert_v1beta1_StatefulSetStatus_To_apps_StatefulSetStatus

func Convert_v1beta1_StatefulSetStatus_To_apps_StatefulSetStatus(in *StatefulSetStatus, out *apps.StatefulSetStatus, s conversion.Scope) error

func Convert_v1beta1_StatefulSet_To_apps_StatefulSet

func Convert_v1beta1_StatefulSet_To_apps_StatefulSet(in *StatefulSet, out *apps.StatefulSet, s conversion.Scope) error

func DeepCopy_v1beta1_Deployment added in v1.6.0

func DeepCopy_v1beta1_Deployment(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_DeploymentCondition added in v1.6.0

func DeepCopy_v1beta1_DeploymentCondition(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_DeploymentList added in v1.6.0

func DeepCopy_v1beta1_DeploymentList(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_DeploymentRollback added in v1.6.0

func DeepCopy_v1beta1_DeploymentRollback(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_DeploymentSpec added in v1.6.0

func DeepCopy_v1beta1_DeploymentSpec(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_DeploymentStatus added in v1.6.0

func DeepCopy_v1beta1_DeploymentStatus(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_DeploymentStrategy added in v1.6.0

func DeepCopy_v1beta1_DeploymentStrategy(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_RollbackConfig added in v1.6.0

func DeepCopy_v1beta1_RollbackConfig(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_RollingUpdateDeployment added in v1.6.0

func DeepCopy_v1beta1_RollingUpdateDeployment(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_Scale added in v1.6.0

func DeepCopy_v1beta1_Scale(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_ScaleSpec added in v1.6.0

func DeepCopy_v1beta1_ScaleSpec(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_ScaleStatus added in v1.6.0

func DeepCopy_v1beta1_ScaleStatus(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_StatefulSet

func DeepCopy_v1beta1_StatefulSet(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_StatefulSetList

func DeepCopy_v1beta1_StatefulSetList(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_StatefulSetSpec

func DeepCopy_v1beta1_StatefulSetSpec(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_v1beta1_StatefulSetStatus

func DeepCopy_v1beta1_StatefulSetStatus(in interface{}, out interface{}, c *conversion.Cloner) error

func RegisterConversions

func RegisterConversions(scheme *runtime.Scheme) error

RegisterConversions adds conversion functions to the given scheme. Public to allow building arbitrary schemes.

func RegisterDeepCopies

func RegisterDeepCopies(scheme *runtime.Scheme) error

RegisterDeepCopies adds deep-copy functions to the given scheme. Public to allow building arbitrary schemes.

func RegisterDefaults

func RegisterDefaults(scheme *runtime.Scheme) error

RegisterDefaults adds defaulters functions to the given scheme. Public to allow building arbitrary schemes. All generated defaulters are covering - they call all nested defaulters.

func Resource added in v1.6.0

func Resource(resource string) schema.GroupResource

Resource takes an unqualified resource and returns a Group qualified GroupResource

func SetDefaults_Deployment added in v1.6.0

func SetDefaults_Deployment(obj *Deployment)

SetDefaults_Deployment sets additional defaults compared to its counterpart in extensions. These addons are: - MaxUnavailable during rolling update set to 25% (1 in extensions) - MaxSurge value during rolling update set to 25% (1 in extensions) - RevisionHistoryLimit set to 2 (not set in extensions) - ProgressDeadlineSeconds set to 600s (not set in extensions)

func SetDefaults_StatefulSet

func SetDefaults_StatefulSet(obj *StatefulSet)

func SetObjectDefaults_Deployment added in v1.6.0

func SetObjectDefaults_Deployment(in *Deployment)

func SetObjectDefaults_DeploymentList added in v1.6.0

func SetObjectDefaults_DeploymentList(in *DeploymentList)

func SetObjectDefaults_StatefulSet

func SetObjectDefaults_StatefulSet(in *StatefulSet)

func SetObjectDefaults_StatefulSetList

func SetObjectDefaults_StatefulSetList(in *StatefulSetList)

Types

type Deployment added in v1.6.0

type Deployment struct {
	metav1.TypeMeta `json:",inline"`
	// Standard object metadata.
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`

	// Specification of the desired behavior of the Deployment.
	// +optional
	Spec DeploymentSpec `json:"spec,omitempty" protobuf:"bytes,2,opt,name=spec"`

	// Most recently observed status of the Deployment.
	// +optional
	Status DeploymentStatus `json:"status,omitempty" protobuf:"bytes,3,opt,name=status"`
}

Deployment enables declarative updates for Pods and ReplicaSets.

func (*Deployment) CodecDecodeSelf added in v1.6.0

func (x *Deployment) CodecDecodeSelf(d *codec1978.Decoder)

func (*Deployment) CodecEncodeSelf added in v1.6.0

func (x *Deployment) CodecEncodeSelf(e *codec1978.Encoder)

func (*Deployment) Descriptor added in v1.6.0

func (*Deployment) Descriptor() ([]byte, []int)

func (*Deployment) Marshal added in v1.6.0

func (m *Deployment) Marshal() (data []byte, err error)

func (*Deployment) MarshalTo added in v1.6.0

func (m *Deployment) MarshalTo(data []byte) (int, error)

func (*Deployment) ProtoMessage added in v1.6.0

func (*Deployment) ProtoMessage()

func (*Deployment) Reset added in v1.6.0

func (m *Deployment) Reset()

func (*Deployment) Size added in v1.6.0

func (m *Deployment) Size() (n int)

func (*Deployment) String added in v1.6.0

func (this *Deployment) String() string

func (Deployment) SwaggerDoc added in v1.6.0

func (Deployment) SwaggerDoc() map[string]string

func (*Deployment) Unmarshal added in v1.6.0

func (m *Deployment) Unmarshal(data []byte) error

type DeploymentCondition added in v1.6.0

type DeploymentCondition struct {
	// Type of deployment condition.
	Type DeploymentConditionType `json:"type" protobuf:"bytes,1,opt,name=type,casttype=DeploymentConditionType"`
	// Status of the condition, one of True, False, Unknown.
	Status v1.ConditionStatus `json:"status" protobuf:"bytes,2,opt,name=status,casttype=k8s.io/kubernetes/pkg/api/v1.ConditionStatus"`
	// The last time this condition was updated.
	LastUpdateTime metav1.Time `json:"lastUpdateTime,omitempty" protobuf:"bytes,6,opt,name=lastUpdateTime"`
	// Last time the condition transitioned from one status to another.
	LastTransitionTime metav1.Time `json:"lastTransitionTime,omitempty" protobuf:"bytes,7,opt,name=lastTransitionTime"`
	// The reason for the condition's last transition.
	Reason string `json:"reason,omitempty" protobuf:"bytes,4,opt,name=reason"`
	// A human readable message indicating details about the transition.
	Message string `json:"message,omitempty" protobuf:"bytes,5,opt,name=message"`
}

DeploymentCondition describes the state of a deployment at a certain point.

func (*DeploymentCondition) CodecDecodeSelf added in v1.6.0

func (x *DeploymentCondition) CodecDecodeSelf(d *codec1978.Decoder)

func (*DeploymentCondition) CodecEncodeSelf added in v1.6.0

func (x *DeploymentCondition) CodecEncodeSelf(e *codec1978.Encoder)

func (*DeploymentCondition) Descriptor added in v1.6.0

func (*DeploymentCondition) Descriptor() ([]byte, []int)

func (*DeploymentCondition) Marshal added in v1.6.0

func (m *DeploymentCondition) Marshal() (data []byte, err error)

func (*DeploymentCondition) MarshalTo added in v1.6.0

func (m *DeploymentCondition) MarshalTo(data []byte) (int, error)

func (*DeploymentCondition) ProtoMessage added in v1.6.0

func (*DeploymentCondition) ProtoMessage()

func (*DeploymentCondition) Reset added in v1.6.0

func (m *DeploymentCondition) Reset()

func (*DeploymentCondition) Size added in v1.6.0

func (m *DeploymentCondition) Size() (n int)

func (*DeploymentCondition) String added in v1.6.0

func (this *DeploymentCondition) String() string

func (DeploymentCondition) SwaggerDoc added in v1.6.0

func (DeploymentCondition) SwaggerDoc() map[string]string

func (*DeploymentCondition) Unmarshal added in v1.6.0

func (m *DeploymentCondition) Unmarshal(data []byte) error

type DeploymentConditionType added in v1.6.0

type DeploymentConditionType string
const (
	// Available means the deployment is available, ie. at least the minimum available
	// replicas required are up and running for at least minReadySeconds.
	DeploymentAvailable DeploymentConditionType = "Available"
	// Progressing means the deployment is progressing. Progress for a deployment is
	// considered when a new replica set is created or adopted, and when new pods scale
	// up or old pods scale down. Progress is not estimated for paused deployments or
	// when progressDeadlineSeconds is not specified.
	DeploymentProgressing DeploymentConditionType = "Progressing"
	// ReplicaFailure is added in a deployment when one of its pods fails to be created
	// or deleted.
	DeploymentReplicaFailure DeploymentConditionType = "ReplicaFailure"
)

These are valid conditions of a deployment.

func (*DeploymentConditionType) CodecDecodeSelf added in v1.6.0

func (x *DeploymentConditionType) CodecDecodeSelf(d *codec1978.Decoder)

func (DeploymentConditionType) CodecEncodeSelf added in v1.6.0

func (x DeploymentConditionType) CodecEncodeSelf(e *codec1978.Encoder)

type DeploymentList added in v1.6.0

type DeploymentList struct {
	metav1.TypeMeta `json:",inline"`
	// Standard list metadata.
	// +optional
	metav1.ListMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`

	// Items is the list of Deployments.
	Items []Deployment `json:"items" protobuf:"bytes,2,rep,name=items"`
}

DeploymentList is a list of Deployments.

func (*DeploymentList) CodecDecodeSelf added in v1.6.0

func (x *DeploymentList) CodecDecodeSelf(d *codec1978.Decoder)

func (*DeploymentList) CodecEncodeSelf added in v1.6.0

func (x *DeploymentList) CodecEncodeSelf(e *codec1978.Encoder)

func (*DeploymentList) Descriptor added in v1.6.0

func (*DeploymentList) Descriptor() ([]byte, []int)

func (*DeploymentList) Marshal added in v1.6.0

func (m *DeploymentList) Marshal() (data []byte, err error)

func (*DeploymentList) MarshalTo added in v1.6.0

func (m *DeploymentList) MarshalTo(data []byte) (int, error)

func (*DeploymentList) ProtoMessage added in v1.6.0

func (*DeploymentList) ProtoMessage()

func (*DeploymentList) Reset added in v1.6.0

func (m *DeploymentList) Reset()

func (*DeploymentList) Size added in v1.6.0

func (m *DeploymentList) Size() (n int)

func (*DeploymentList) String added in v1.6.0

func (this *DeploymentList) String() string

func (DeploymentList) SwaggerDoc added in v1.6.0

func (DeploymentList) SwaggerDoc() map[string]string

func (*DeploymentList) Unmarshal added in v1.6.0

func (m *DeploymentList) Unmarshal(data []byte) error

type DeploymentRollback added in v1.6.0

type DeploymentRollback struct {
	metav1.TypeMeta `json:",inline"`
	// Required: This must match the Name of a deployment.
	Name string `json:"name" protobuf:"bytes,1,opt,name=name"`
	// The annotations to be updated to a deployment
	// +optional
	UpdatedAnnotations map[string]string `json:"updatedAnnotations,omitempty" protobuf:"bytes,2,rep,name=updatedAnnotations"`
	// The config of this deployment rollback.
	RollbackTo RollbackConfig `json:"rollbackTo" protobuf:"bytes,3,opt,name=rollbackTo"`
}

DeploymentRollback stores the information required to rollback a deployment.

func (*DeploymentRollback) CodecDecodeSelf added in v1.6.0

func (x *DeploymentRollback) CodecDecodeSelf(d *codec1978.Decoder)

func (*DeploymentRollback) CodecEncodeSelf added in v1.6.0

func (x *DeploymentRollback) CodecEncodeSelf(e *codec1978.Encoder)

func (*DeploymentRollback) Descriptor added in v1.6.0

func (*DeploymentRollback) Descriptor() ([]byte, []int)

func (*DeploymentRollback) Marshal added in v1.6.0

func (m *DeploymentRollback) Marshal() (data []byte, err error)

func (*DeploymentRollback) MarshalTo added in v1.6.0

func (m *DeploymentRollback) MarshalTo(data []byte) (int, error)

func (*DeploymentRollback) ProtoMessage added in v1.6.0

func (*DeploymentRollback) ProtoMessage()

func (*DeploymentRollback) Reset added in v1.6.0

func (m *DeploymentRollback) Reset()

func (*DeploymentRollback) Size added in v1.6.0

func (m *DeploymentRollback) Size() (n int)

func (*DeploymentRollback) String added in v1.6.0

func (this *DeploymentRollback) String() string

func (DeploymentRollback) SwaggerDoc added in v1.6.0

func (DeploymentRollback) SwaggerDoc() map[string]string

func (*DeploymentRollback) Unmarshal added in v1.6.0

func (m *DeploymentRollback) Unmarshal(data []byte) error

type DeploymentSpec added in v1.6.0

type DeploymentSpec struct {
	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty" protobuf:"varint,1,opt,name=replicas"`

	// Label selector for pods. Existing ReplicaSets whose pods are
	// selected by this will be the ones affected by this deployment.
	// +optional
	Selector *metav1.LabelSelector `json:"selector,omitempty" protobuf:"bytes,2,opt,name=selector"`

	// Template describes the pods that will be created.
	Template v1.PodTemplateSpec `json:"template" protobuf:"bytes,3,opt,name=template"`

	// The deployment strategy to use to replace existing pods with new ones.
	// +optional
	Strategy DeploymentStrategy `json:"strategy,omitempty" protobuf:"bytes,4,opt,name=strategy"`

	// Minimum number of seconds for which a newly created pod should be ready
	// without any of its container crashing, for it to be considered available.
	// Defaults to 0 (pod will be considered available as soon as it is ready)
	// +optional
	MinReadySeconds int32 `json:"minReadySeconds,omitempty" protobuf:"varint,5,opt,name=minReadySeconds"`

	// The number of old ReplicaSets to retain to allow rollback.
	// This is a pointer to distinguish between explicit zero and not specified.
	// Defaults to 2.
	// +optional
	RevisionHistoryLimit *int32 `json:"revisionHistoryLimit,omitempty" protobuf:"varint,6,opt,name=revisionHistoryLimit"`

	// Indicates that the deployment is paused.
	// +optional
	Paused bool `json:"paused,omitempty" protobuf:"varint,7,opt,name=paused"`

	// The config this deployment is rolling back to. Will be cleared after rollback is done.
	// +optional
	RollbackTo *RollbackConfig `json:"rollbackTo,omitempty" protobuf:"bytes,8,opt,name=rollbackTo"`

	// The maximum time in seconds for a deployment to make progress before it
	// is considered to be failed. The deployment controller will continue to
	// process failed deployments and a condition with a ProgressDeadlineExceeded
	// reason will be surfaced in the deployment status. Once autoRollback is
	// implemented, the deployment controller will automatically rollback failed
	// deployments. Note that progress will not be estimated during the time a
	// deployment is paused. Defaults to 600s.
	ProgressDeadlineSeconds *int32 `json:"progressDeadlineSeconds,omitempty" protobuf:"varint,9,opt,name=progressDeadlineSeconds"`
}

DeploymentSpec is the specification of the desired behavior of the Deployment.

func (*DeploymentSpec) CodecDecodeSelf added in v1.6.0

func (x *DeploymentSpec) CodecDecodeSelf(d *codec1978.Decoder)

func (*DeploymentSpec) CodecEncodeSelf added in v1.6.0

func (x *DeploymentSpec) CodecEncodeSelf(e *codec1978.Encoder)

func (*DeploymentSpec) Descriptor added in v1.6.0

func (*DeploymentSpec) Descriptor() ([]byte, []int)

func (*DeploymentSpec) Marshal added in v1.6.0

func (m *DeploymentSpec) Marshal() (data []byte, err error)

func (*DeploymentSpec) MarshalTo added in v1.6.0

func (m *DeploymentSpec) MarshalTo(data []byte) (int, error)

func (*DeploymentSpec) ProtoMessage added in v1.6.0

func (*DeploymentSpec) ProtoMessage()

func (*DeploymentSpec) Reset added in v1.6.0

func (m *DeploymentSpec) Reset()

func (*DeploymentSpec) Size added in v1.6.0

func (m *DeploymentSpec) Size() (n int)

func (*DeploymentSpec) String added in v1.6.0

func (this *DeploymentSpec) String() string

func (DeploymentSpec) SwaggerDoc added in v1.6.0

func (DeploymentSpec) SwaggerDoc() map[string]string

func (*DeploymentSpec) Unmarshal added in v1.6.0

func (m *DeploymentSpec) Unmarshal(data []byte) error

type DeploymentStatus added in v1.6.0

type DeploymentStatus struct {
	// The generation observed by the deployment controller.
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty" protobuf:"varint,1,opt,name=observedGeneration"`

	// Total number of non-terminated pods targeted by this deployment (their labels match the selector).
	// +optional
	Replicas int32 `json:"replicas,omitempty" protobuf:"varint,2,opt,name=replicas"`

	// Total number of non-terminated pods targeted by this deployment that have the desired template spec.
	// +optional
	UpdatedReplicas int32 `json:"updatedReplicas,omitempty" protobuf:"varint,3,opt,name=updatedReplicas"`

	// Total number of ready pods targeted by this deployment.
	// +optional
	ReadyReplicas int32 `json:"readyReplicas,omitempty" protobuf:"varint,7,opt,name=readyReplicas"`

	// Total number of available pods (ready for at least minReadySeconds) targeted by this deployment.
	// +optional
	AvailableReplicas int32 `json:"availableReplicas,omitempty" protobuf:"varint,4,opt,name=availableReplicas"`

	// Total number of unavailable pods targeted by this deployment.
	// +optional
	UnavailableReplicas int32 `json:"unavailableReplicas,omitempty" protobuf:"varint,5,opt,name=unavailableReplicas"`

	// Represents the latest available observations of a deployment's current state.
	Conditions []DeploymentCondition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,6,rep,name=conditions"`
}

DeploymentStatus is the most recently observed status of the Deployment.

func (*DeploymentStatus) CodecDecodeSelf added in v1.6.0

func (x *DeploymentStatus) CodecDecodeSelf(d *codec1978.Decoder)

func (*DeploymentStatus) CodecEncodeSelf added in v1.6.0

func (x *DeploymentStatus) CodecEncodeSelf(e *codec1978.Encoder)

func (*DeploymentStatus) Descriptor added in v1.6.0

func (*DeploymentStatus) Descriptor() ([]byte, []int)

func (*DeploymentStatus) Marshal added in v1.6.0

func (m *DeploymentStatus) Marshal() (data []byte, err error)

func (*DeploymentStatus) MarshalTo added in v1.6.0

func (m *DeploymentStatus) MarshalTo(data []byte) (int, error)

func (*DeploymentStatus) ProtoMessage added in v1.6.0

func (*DeploymentStatus) ProtoMessage()

func (*DeploymentStatus) Reset added in v1.6.0

func (m *DeploymentStatus) Reset()

func (*DeploymentStatus) Size added in v1.6.0

func (m *DeploymentStatus) Size() (n int)

func (*DeploymentStatus) String added in v1.6.0

func (this *DeploymentStatus) String() string

func (DeploymentStatus) SwaggerDoc added in v1.6.0

func (DeploymentStatus) SwaggerDoc() map[string]string

func (*DeploymentStatus) Unmarshal added in v1.6.0

func (m *DeploymentStatus) Unmarshal(data []byte) error

type DeploymentStrategy added in v1.6.0

type DeploymentStrategy struct {
	// Type of deployment. Can be "Recreate" or "RollingUpdate". Default is RollingUpdate.
	// +optional
	Type DeploymentStrategyType `json:"type,omitempty" protobuf:"bytes,1,opt,name=type,casttype=DeploymentStrategyType"`

	// Rolling update config params. Present only if DeploymentStrategyType =
	// RollingUpdate.
	//---
	// TODO: Update this to follow our convention for oneOf, whatever we decide it
	// to be.
	// +optional
	RollingUpdate *RollingUpdateDeployment `json:"rollingUpdate,omitempty" protobuf:"bytes,2,opt,name=rollingUpdate"`
}

DeploymentStrategy describes how to replace existing pods with new ones.

func (*DeploymentStrategy) CodecDecodeSelf added in v1.6.0

func (x *DeploymentStrategy) CodecDecodeSelf(d *codec1978.Decoder)

func (*DeploymentStrategy) CodecEncodeSelf added in v1.6.0

func (x *DeploymentStrategy) CodecEncodeSelf(e *codec1978.Encoder)

func (*DeploymentStrategy) Descriptor added in v1.6.0

func (*DeploymentStrategy) Descriptor() ([]byte, []int)

func (*DeploymentStrategy) Marshal added in v1.6.0

func (m *DeploymentStrategy) Marshal() (data []byte, err error)

func (*DeploymentStrategy) MarshalTo added in v1.6.0

func (m *DeploymentStrategy) MarshalTo(data []byte) (int, error)

func (*DeploymentStrategy) ProtoMessage added in v1.6.0

func (*DeploymentStrategy) ProtoMessage()

func (*DeploymentStrategy) Reset added in v1.6.0

func (m *DeploymentStrategy) Reset()

func (*DeploymentStrategy) Size added in v1.6.0

func (m *DeploymentStrategy) Size() (n int)

func (*DeploymentStrategy) String added in v1.6.0

func (this *DeploymentStrategy) String() string

func (DeploymentStrategy) SwaggerDoc added in v1.6.0

func (DeploymentStrategy) SwaggerDoc() map[string]string

func (*DeploymentStrategy) Unmarshal added in v1.6.0

func (m *DeploymentStrategy) Unmarshal(data []byte) error

type DeploymentStrategyType added in v1.6.0

type DeploymentStrategyType string
const (
	// Kill all existing pods before creating new ones.
	RecreateDeploymentStrategyType DeploymentStrategyType = "Recreate"

	// Replace the old RCs by new one using rolling update i.e gradually scale down the old RCs and scale up the new one.
	RollingUpdateDeploymentStrategyType DeploymentStrategyType = "RollingUpdate"
)

func (*DeploymentStrategyType) CodecDecodeSelf added in v1.6.0

func (x *DeploymentStrategyType) CodecDecodeSelf(d *codec1978.Decoder)

func (DeploymentStrategyType) CodecEncodeSelf added in v1.6.0

func (x DeploymentStrategyType) CodecEncodeSelf(e *codec1978.Encoder)

type RollbackConfig added in v1.6.0

type RollbackConfig struct {
	// The revision to rollback to. If set to 0, rollbck to the last revision.
	// +optional
	Revision int64 `json:"revision,omitempty" protobuf:"varint,1,opt,name=revision"`
}

func (*RollbackConfig) CodecDecodeSelf added in v1.6.0

func (x *RollbackConfig) CodecDecodeSelf(d *codec1978.Decoder)

func (*RollbackConfig) CodecEncodeSelf added in v1.6.0

func (x *RollbackConfig) CodecEncodeSelf(e *codec1978.Encoder)

func (*RollbackConfig) Descriptor added in v1.6.0

func (*RollbackConfig) Descriptor() ([]byte, []int)

func (*RollbackConfig) Marshal added in v1.6.0

func (m *RollbackConfig) Marshal() (data []byte, err error)

func (*RollbackConfig) MarshalTo added in v1.6.0

func (m *RollbackConfig) MarshalTo(data []byte) (int, error)

func (*RollbackConfig) ProtoMessage added in v1.6.0

func (*RollbackConfig) ProtoMessage()

func (*RollbackConfig) Reset added in v1.6.0

func (m *RollbackConfig) Reset()

func (*RollbackConfig) Size added in v1.6.0

func (m *RollbackConfig) Size() (n int)

func (*RollbackConfig) String added in v1.6.0

func (this *RollbackConfig) String() string

func (RollbackConfig) SwaggerDoc added in v1.6.0

func (RollbackConfig) SwaggerDoc() map[string]string

func (*RollbackConfig) Unmarshal added in v1.6.0

func (m *RollbackConfig) Unmarshal(data []byte) error

type RollingUpdateDeployment added in v1.6.0

type RollingUpdateDeployment struct {
	// The maximum number of pods that can be unavailable during the update.
	// Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%).
	// Absolute number is calculated from percentage by rounding down.
	// This can not be 0 if MaxSurge is 0.
	// Defaults to 25%.
	// Example: when this is set to 30%, the old RC can be scaled down to 70% of desired pods
	// immediately when the rolling update starts. Once new pods are ready, old RC
	// can be scaled down further, followed by scaling up the new RC, ensuring
	// that the total number of pods available at all times during the update is at
	// least 70% of desired pods.
	// +optional
	MaxUnavailable *intstr.IntOrString `json:"maxUnavailable,omitempty" protobuf:"bytes,1,opt,name=maxUnavailable"`

	// The maximum number of pods that can be scheduled above the desired number of
	// pods.
	// Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%).
	// This can not be 0 if MaxUnavailable is 0.
	// Absolute number is calculated from percentage by rounding up.
	// Defaults to 25%.
	// Example: when this is set to 30%, the new RC can be scaled up immediately when
	// the rolling update starts, such that the total number of old and new pods do not exceed
	// 130% of desired pods. Once old pods have been killed,
	// new RC can be scaled up further, ensuring that total number of pods running
	// at any time during the update is atmost 130% of desired pods.
	// +optional
	MaxSurge *intstr.IntOrString `json:"maxSurge,omitempty" protobuf:"bytes,2,opt,name=maxSurge"`
}

Spec to control the desired behavior of rolling update.

func (*RollingUpdateDeployment) CodecDecodeSelf added in v1.6.0

func (x *RollingUpdateDeployment) CodecDecodeSelf(d *codec1978.Decoder)

func (*RollingUpdateDeployment) CodecEncodeSelf added in v1.6.0

func (x *RollingUpdateDeployment) CodecEncodeSelf(e *codec1978.Encoder)

func (*RollingUpdateDeployment) Descriptor added in v1.6.0

func (*RollingUpdateDeployment) Descriptor() ([]byte, []int)

func (*RollingUpdateDeployment) Marshal added in v1.6.0

func (m *RollingUpdateDeployment) Marshal() (data []byte, err error)

func (*RollingUpdateDeployment) MarshalTo added in v1.6.0

func (m *RollingUpdateDeployment) MarshalTo(data []byte) (int, error)

func (*RollingUpdateDeployment) ProtoMessage added in v1.6.0

func (*RollingUpdateDeployment) ProtoMessage()

func (*RollingUpdateDeployment) Reset added in v1.6.0

func (m *RollingUpdateDeployment) Reset()

func (*RollingUpdateDeployment) Size added in v1.6.0

func (m *RollingUpdateDeployment) Size() (n int)

func (*RollingUpdateDeployment) String added in v1.6.0

func (this *RollingUpdateDeployment) String() string

func (RollingUpdateDeployment) SwaggerDoc added in v1.6.0

func (RollingUpdateDeployment) SwaggerDoc() map[string]string

func (*RollingUpdateDeployment) Unmarshal added in v1.6.0

func (m *RollingUpdateDeployment) Unmarshal(data []byte) error

type Scale added in v1.6.0

type Scale struct {
	metav1.TypeMeta `json:",inline"`
	// Standard object metadata; More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata.
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`

	// defines the behavior of the scale. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status.
	// +optional
	Spec ScaleSpec `json:"spec,omitempty" protobuf:"bytes,2,opt,name=spec"`

	// current status of the scale. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status. Read-only.
	// +optional
	Status ScaleStatus `json:"status,omitempty" protobuf:"bytes,3,opt,name=status"`
}

Scale represents a scaling request for a resource.

func (*Scale) CodecDecodeSelf added in v1.6.0

func (x *Scale) CodecDecodeSelf(d *codec1978.Decoder)

func (*Scale) CodecEncodeSelf added in v1.6.0

func (x *Scale) CodecEncodeSelf(e *codec1978.Encoder)

func (*Scale) Descriptor added in v1.6.0

func (*Scale) Descriptor() ([]byte, []int)

func (*Scale) Marshal added in v1.6.0

func (m *Scale) Marshal() (data []byte, err error)

func (*Scale) MarshalTo added in v1.6.0

func (m *Scale) MarshalTo(data []byte) (int, error)

func (*Scale) ProtoMessage added in v1.6.0

func (*Scale) ProtoMessage()

func (*Scale) Reset added in v1.6.0

func (m *Scale) Reset()

func (*Scale) Size added in v1.6.0

func (m *Scale) Size() (n int)

func (*Scale) String added in v1.6.0

func (this *Scale) String() string

func (Scale) SwaggerDoc added in v1.6.0

func (Scale) SwaggerDoc() map[string]string

func (*Scale) Unmarshal added in v1.6.0

func (m *Scale) Unmarshal(data []byte) error

type ScaleSpec added in v1.6.0

type ScaleSpec struct {
	// desired number of instances for the scaled object.
	// +optional
	Replicas int32 `json:"replicas,omitempty" protobuf:"varint,1,opt,name=replicas"`
}

ScaleSpec describes the attributes of a scale subresource

func (*ScaleSpec) CodecDecodeSelf added in v1.6.0

func (x *ScaleSpec) CodecDecodeSelf(d *codec1978.Decoder)

func (*ScaleSpec) CodecEncodeSelf added in v1.6.0

func (x *ScaleSpec) CodecEncodeSelf(e *codec1978.Encoder)

func (*ScaleSpec) Descriptor added in v1.6.0

func (*ScaleSpec) Descriptor() ([]byte, []int)

func (*ScaleSpec) Marshal added in v1.6.0

func (m *ScaleSpec) Marshal() (data []byte, err error)

func (*ScaleSpec) MarshalTo added in v1.6.0

func (m *ScaleSpec) MarshalTo(data []byte) (int, error)

func (*ScaleSpec) ProtoMessage added in v1.6.0

func (*ScaleSpec) ProtoMessage()

func (*ScaleSpec) Reset added in v1.6.0

func (m *ScaleSpec) Reset()

func (*ScaleSpec) Size added in v1.6.0

func (m *ScaleSpec) Size() (n int)

func (*ScaleSpec) String added in v1.6.0

func (this *ScaleSpec) String() string

func (ScaleSpec) SwaggerDoc added in v1.6.0

func (ScaleSpec) SwaggerDoc() map[string]string

func (*ScaleSpec) Unmarshal added in v1.6.0

func (m *ScaleSpec) Unmarshal(data []byte) error

type ScaleStatus added in v1.6.0

type ScaleStatus struct {
	// actual number of observed instances of the scaled object.
	Replicas int32 `json:"replicas" protobuf:"varint,1,opt,name=replicas"`

	// label query over pods that should match the replicas count. More info: http://kubernetes.io/docs/user-guide/labels#label-selectors
	// +optional
	Selector map[string]string `json:"selector,omitempty" protobuf:"bytes,2,rep,name=selector"`

	// label selector for pods that should match the replicas count. This is a serializated
	// version of both map-based and more expressive set-based selectors. This is done to
	// avoid introspection in the clients. The string will be in the same format as the
	// query-param syntax. If the target type only supports map-based selectors, both this
	// field and map-based selector field are populated.
	// More info: http://kubernetes.io/docs/user-guide/labels#label-selectors
	// +optional
	TargetSelector string `json:"targetSelector,omitempty" protobuf:"bytes,3,opt,name=targetSelector"`
}

ScaleStatus represents the current status of a scale subresource.

func (*ScaleStatus) CodecDecodeSelf added in v1.6.0

func (x *ScaleStatus) CodecDecodeSelf(d *codec1978.Decoder)

func (*ScaleStatus) CodecEncodeSelf added in v1.6.0

func (x *ScaleStatus) CodecEncodeSelf(e *codec1978.Encoder)

func (*ScaleStatus) Descriptor added in v1.6.0

func (*ScaleStatus) Descriptor() ([]byte, []int)

func (*ScaleStatus) Marshal added in v1.6.0

func (m *ScaleStatus) Marshal() (data []byte, err error)

func (*ScaleStatus) MarshalTo added in v1.6.0

func (m *ScaleStatus) MarshalTo(data []byte) (int, error)

func (*ScaleStatus) ProtoMessage added in v1.6.0

func (*ScaleStatus) ProtoMessage()

func (*ScaleStatus) Reset added in v1.6.0

func (m *ScaleStatus) Reset()

func (*ScaleStatus) Size added in v1.6.0

func (m *ScaleStatus) Size() (n int)

func (*ScaleStatus) String added in v1.6.0

func (this *ScaleStatus) String() string

func (ScaleStatus) SwaggerDoc added in v1.6.0

func (ScaleStatus) SwaggerDoc() map[string]string

func (*ScaleStatus) Unmarshal added in v1.6.0

func (m *ScaleStatus) Unmarshal(data []byte) error

type StatefulSet

type StatefulSet struct {
	metav1.TypeMeta `json:",inline"`
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`

	// Spec defines the desired identities of pods in this set.
	// +optional
	Spec StatefulSetSpec `json:"spec,omitempty" protobuf:"bytes,2,opt,name=spec"`

	// Status is the current status of Pods in this StatefulSet. This data
	// may be out of date by some window of time.
	// +optional
	Status StatefulSetStatus `json:"status,omitempty" protobuf:"bytes,3,opt,name=status"`
}

StatefulSet represents a set of pods with consistent identities. Identities are defined as:

  • Network: A single stable DNS and hostname.
  • Storage: As many VolumeClaims as requested.

The StatefulSet guarantees that a given network identity will always map to the same storage identity.

func (*StatefulSet) CodecDecodeSelf

func (x *StatefulSet) CodecDecodeSelf(d *codec1978.Decoder)

func (*StatefulSet) CodecEncodeSelf

func (x *StatefulSet) CodecEncodeSelf(e *codec1978.Encoder)

func (*StatefulSet) Descriptor

func (*StatefulSet) Descriptor() ([]byte, []int)

func (*StatefulSet) Marshal

func (m *StatefulSet) Marshal() (data []byte, err error)

func (*StatefulSet) MarshalTo

func (m *StatefulSet) MarshalTo(data []byte) (int, error)

func (*StatefulSet) ProtoMessage

func (*StatefulSet) ProtoMessage()

func (*StatefulSet) Reset

func (m *StatefulSet) Reset()

func (*StatefulSet) Size

func (m *StatefulSet) Size() (n int)

func (*StatefulSet) String

func (this *StatefulSet) String() string

func (StatefulSet) SwaggerDoc

func (StatefulSet) SwaggerDoc() map[string]string

func (*StatefulSet) Unmarshal

func (m *StatefulSet) Unmarshal(data []byte) error

type StatefulSetList

type StatefulSetList struct {
	metav1.TypeMeta `json:",inline"`
	// +optional
	metav1.ListMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`
	Items           []StatefulSet `json:"items" protobuf:"bytes,2,rep,name=items"`
}

StatefulSetList is a collection of StatefulSets.

func (*StatefulSetList) CodecDecodeSelf

func (x *StatefulSetList) CodecDecodeSelf(d *codec1978.Decoder)

func (*StatefulSetList) CodecEncodeSelf

func (x *StatefulSetList) CodecEncodeSelf(e *codec1978.Encoder)

func (*StatefulSetList) Descriptor

func (*StatefulSetList) Descriptor() ([]byte, []int)

func (*StatefulSetList) Marshal

func (m *StatefulSetList) Marshal() (data []byte, err error)

func (*StatefulSetList) MarshalTo

func (m *StatefulSetList) MarshalTo(data []byte) (int, error)

func (*StatefulSetList) ProtoMessage

func (*StatefulSetList) ProtoMessage()

func (*StatefulSetList) Reset

func (m *StatefulSetList) Reset()

func (*StatefulSetList) Size

func (m *StatefulSetList) Size() (n int)

func (*StatefulSetList) String

func (this *StatefulSetList) String() string

func (StatefulSetList) SwaggerDoc

func (StatefulSetList) SwaggerDoc() map[string]string

func (*StatefulSetList) Unmarshal

func (m *StatefulSetList) Unmarshal(data []byte) error

type StatefulSetSpec

type StatefulSetSpec struct {
	// Replicas is the desired number of replicas of the given Template.
	// These are replicas in the sense that they are instantiations of the
	// same Template, but individual replicas also have a consistent identity.
	// If unspecified, defaults to 1.
	// TODO: Consider a rename of this field.
	// +optional
	Replicas *int32 `json:"replicas,omitempty" protobuf:"varint,1,opt,name=replicas"`

	// Selector is a label query over pods that should match the replica count.
	// If empty, defaulted to labels on the pod template.
	// More info: http://kubernetes.io/docs/user-guide/labels#label-selectors
	// +optional
	Selector *metav1.LabelSelector `json:"selector,omitempty" protobuf:"bytes,2,opt,name=selector"`

	// Template is the object that describes the pod that will be created if
	// insufficient replicas are detected. Each pod stamped out by the StatefulSet
	// will fulfill this Template, but have a unique identity from the rest
	// of the StatefulSet.
	Template v1.PodTemplateSpec `json:"template" protobuf:"bytes,3,opt,name=template"`

	// VolumeClaimTemplates is a list of claims that pods are allowed to reference.
	// The StatefulSet controller is responsible for mapping network identities to
	// claims in a way that maintains the identity of a pod. Every claim in
	// this list must have at least one matching (by name) volumeMount in one
	// container in the template. A claim in this list takes precedence over
	// any volumes in the template, with the same name.
	// TODO: Define the behavior if a claim already exists with the same name.
	// +optional
	VolumeClaimTemplates []v1.PersistentVolumeClaim `json:"volumeClaimTemplates,omitempty" protobuf:"bytes,4,rep,name=volumeClaimTemplates"`

	// ServiceName is the name of the service that governs this StatefulSet.
	// This service must exist before the StatefulSet, and is responsible for
	// the network identity of the set. Pods get DNS/hostnames that follow the
	// pattern: pod-specific-string.serviceName.default.svc.cluster.local
	// where "pod-specific-string" is managed by the StatefulSet controller.
	ServiceName string `json:"serviceName" protobuf:"bytes,5,opt,name=serviceName"`
}

A StatefulSetSpec is the specification of a StatefulSet.

func (*StatefulSetSpec) CodecDecodeSelf

func (x *StatefulSetSpec) CodecDecodeSelf(d *codec1978.Decoder)

func (*StatefulSetSpec) CodecEncodeSelf

func (x *StatefulSetSpec) CodecEncodeSelf(e *codec1978.Encoder)

func (*StatefulSetSpec) Descriptor

func (*StatefulSetSpec) Descriptor() ([]byte, []int)

func (*StatefulSetSpec) Marshal

func (m *StatefulSetSpec) Marshal() (data []byte, err error)

func (*StatefulSetSpec) MarshalTo

func (m *StatefulSetSpec) MarshalTo(data []byte) (int, error)

func (*StatefulSetSpec) ProtoMessage

func (*StatefulSetSpec) ProtoMessage()

func (*StatefulSetSpec) Reset

func (m *StatefulSetSpec) Reset()

func (*StatefulSetSpec) Size

func (m *StatefulSetSpec) Size() (n int)

func (*StatefulSetSpec) String

func (this *StatefulSetSpec) String() string

func (StatefulSetSpec) SwaggerDoc

func (StatefulSetSpec) SwaggerDoc() map[string]string

func (*StatefulSetSpec) Unmarshal

func (m *StatefulSetSpec) Unmarshal(data []byte) error

type StatefulSetStatus

type StatefulSetStatus struct {
	// most recent generation observed by this StatefulSet.
	// +optional
	ObservedGeneration *int64 `json:"observedGeneration,omitempty" protobuf:"varint,1,opt,name=observedGeneration"`

	// Replicas is the number of actual replicas.
	Replicas int32 `json:"replicas" protobuf:"varint,2,opt,name=replicas"`
}

StatefulSetStatus represents the current state of a StatefulSet.

func (*StatefulSetStatus) CodecDecodeSelf

func (x *StatefulSetStatus) CodecDecodeSelf(d *codec1978.Decoder)

func (*StatefulSetStatus) CodecEncodeSelf

func (x *StatefulSetStatus) CodecEncodeSelf(e *codec1978.Encoder)

func (*StatefulSetStatus) Descriptor

func (*StatefulSetStatus) Descriptor() ([]byte, []int)

func (*StatefulSetStatus) Marshal

func (m *StatefulSetStatus) Marshal() (data []byte, err error)

func (*StatefulSetStatus) MarshalTo

func (m *StatefulSetStatus) MarshalTo(data []byte) (int, error)

func (*StatefulSetStatus) ProtoMessage

func (*StatefulSetStatus) ProtoMessage()

func (*StatefulSetStatus) Reset

func (m *StatefulSetStatus) Reset()

func (*StatefulSetStatus) Size

func (m *StatefulSetStatus) Size() (n int)

func (*StatefulSetStatus) String

func (this *StatefulSetStatus) String() string

func (StatefulSetStatus) SwaggerDoc

func (StatefulSetStatus) SwaggerDoc() map[string]string

func (*StatefulSetStatus) Unmarshal

func (m *StatefulSetStatus) Unmarshal(data []byte) error

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL