 Documentation
      ¶
      Documentation
      ¶
    
    
  
    
  
    Index ¶
- type APIVersion
- type Daemon
- type DaemonList
- type DaemonSpec
- type DaemonStatus
- type Deployment
- type DeploymentList
- type DeploymentSpec
- type DeploymentStatus
- type DeploymentStrategy
- type DeploymentType
- type HorizontalPodAutoscaler
- type HorizontalPodAutoscalerList
- type HorizontalPodAutoscalerSpec
- type HorizontalPodAutoscalerStatus
- type ReplicationControllerDummy
- type ResourceConsumption
- type RollingUpdateDeployment
- type Scale
- type ScaleSpec
- type ScaleStatus
- type SubresourceReference
- type ThirdPartyResource
- type ThirdPartyResourceData
- type ThirdPartyResourceList
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type APIVersion ¶
type APIVersion struct {
	Name     string `json:"name,omitempty" description:"name of this version (e.g. 'v1')"`
	APIGroup string `json:"apiGroup,omitempty" description:"The API group to add this object into, default 'experimental'"`
}
    An APIVersion represents a single concrete version of an object model.
type Daemon ¶
type Daemon struct {
	api.TypeMeta   `json:",inline"`
	api.ObjectMeta `json:"metadata,omitempty"`
	// Spec defines the desired behavior of this daemon.
	Spec DaemonSpec `json:"spec,omitempty"`
	// Status is the current status of this daemon. This data may be
	// out of date by some window of time.
	Status DaemonStatus `json:"status,omitempty"`
}
    Daemon represents the configuration of a daemon.
func (*Daemon) IsAnAPIObject ¶
func (*Daemon) IsAnAPIObject()
type DaemonList ¶
type DaemonList struct {
	api.TypeMeta `json:",inline"`
	api.ListMeta `json:"metadata,omitempty"`
	Items []Daemon `json:"items"`
}
    DaemonList is a collection of daemon.
func (*DaemonList) IsAnAPIObject ¶
func (*DaemonList) IsAnAPIObject()
type DaemonSpec ¶
type DaemonSpec struct {
	// Selector is a label query over pods that are managed by the daemon.
	Selector map[string]string `json:"selector"`
	// Template is the object that describes the pod that will be created.
	// The Daemon will create exactly one copy of this pod on every node
	// that matches the template's node selector (or on every node if no node
	// selector is specified).
	Template *api.PodTemplateSpec `json:"template,omitempty"`
}
    DaemonSpec is the specification of a daemon.
type DaemonStatus ¶
type DaemonStatus struct {
	// CurrentNumberScheduled is the number of nodes that are running exactly 1 copy of the
	// daemon and are supposed to run the daemon.
	CurrentNumberScheduled int `json:"currentNumberScheduled"`
	// NumberMisscheduled is the number of nodes that are running the daemon, but are
	// not supposed to run the daemon.
	NumberMisscheduled int `json:"numberMisscheduled"`
	// DesiredNumberScheduled is the total number of nodes that should be running the daemon
	// (including nodes correctly running the daemon).
	DesiredNumberScheduled int `json:"desiredNumberScheduled"`
}
    DaemonStatus represents the current status of a daemon.
type Deployment ¶
type Deployment struct {
	api.TypeMeta   `json:",inline"`
	api.ObjectMeta `json:"metadata,omitempty"`
	// Specification of the desired behavior of the Deployment.
	Spec DeploymentSpec `json:"spec,omitempty"`
	// Most recently observed status of the Deployment.
	Status DeploymentStatus `json:"status,omitempty"`
}
    func (*Deployment) IsAnAPIObject ¶
func (*Deployment) IsAnAPIObject()
type DeploymentList ¶
type DeploymentList struct {
	api.TypeMeta `json:",inline"`
	api.ListMeta `json:"metadata,omitempty"`
	Items []Deployment `json:"items"`
}
    func (*DeploymentList) IsAnAPIObject ¶
func (*DeploymentList) IsAnAPIObject()
type DeploymentSpec ¶
type DeploymentSpec struct {
	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	Replicas *int `json:"replicas,omitempty"`
	// Label selector for pods. Existing ReplicationControllers whose pods are
	// selected by this will be scaled down.
	Selector map[string]string `json:"selector,omitempty"`
	// Describes the pods that will be created.
	Template *api.PodTemplateSpec `json:"template,omitempty"`
	// The deployment strategy to use to replace existing pods with new ones.
	Strategy DeploymentStrategy `json:"strategy,omitempty"`
	// 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 selected by new RC).
	// Users can set this to an empty string to indicate that the system should
	// not add any selector and label. If unspecified, system uses
	// "deployment.kubernetes.io/podTemplateHash".
	// Value of this key is hash of DeploymentSpec.PodTemplateSpec.
	UniqueLabelKey *string `json:"uniqueLabel,omitempty"`
}
    type DeploymentStatus ¶
type DeploymentStrategy ¶
type DeploymentStrategy struct {
	// Type of deployment. Can be "Recreate" or "RollingUpdate". Defaults to RollingUpdate.
	Type DeploymentType `json:"type,omitempty"`
	// TODO: Update this to follow our convention for oneOf, whatever we decide it
	// to be.
	// Rolling update config params. Present only if DeploymentType =
	// RollingUpdate.
	RollingUpdate *RollingUpdateDeployment `json:"rollingUpdate,omitempty"`
}
    type DeploymentType ¶
type DeploymentType string
const ( // Kill all existing pods before creating new ones. DeploymentRecreate DeploymentType = "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. DeploymentRollingUpdate DeploymentType = "RollingUpdate" )
type HorizontalPodAutoscaler ¶
type HorizontalPodAutoscaler struct {
	api.TypeMeta   `json:",inline"`
	api.ObjectMeta `json:"metadata,omitempty"`
	// Spec defines the behaviour of autoscaler.
	Spec HorizontalPodAutoscalerSpec `json:"spec,omitempty"`
	// Status represents the current information about the autoscaler.
	Status *HorizontalPodAutoscalerStatus `json:"status,omitempty"`
}
    HorizontalPodAutoscaler represents the configuration of a horizontal pod autoscaler.
func (*HorizontalPodAutoscaler) IsAnAPIObject ¶
func (*HorizontalPodAutoscaler) IsAnAPIObject()
type HorizontalPodAutoscalerList ¶
type HorizontalPodAutoscalerList struct {
	api.TypeMeta `json:",inline"`
	api.ListMeta `json:"metadata,omitempty"`
	Items []HorizontalPodAutoscaler `json:"items"`
}
    HorizontalPodAutoscaler is a collection of pod autoscalers.
func (*HorizontalPodAutoscalerList) IsAnAPIObject ¶
func (*HorizontalPodAutoscalerList) IsAnAPIObject()
type HorizontalPodAutoscalerSpec ¶
type HorizontalPodAutoscalerSpec struct {
	// ScaleRef is a reference to Scale subresource. HorizontalPodAutoscaler will learn the current resource consumption from its status,
	// and will set the desired number of pods by modyfying its spec.
	ScaleRef *SubresourceReference `json:"scaleRef"`
	// MinCount is the lower limit for the number of pods that can be set by the autoscaler.
	MinCount int `json:"minCount"`
	// MaxCount is the upper limit for the number of pods that can be set by the autoscaler. It cannot be smaller than MinCount.
	MaxCount int `json:"maxCount"`
	// Target is the target average consumption of the given resource that the autoscaler will try to maintain by adjusting the desired number of pods.
	// Currently two types of resources are supported: "cpu" and "memory".
	Target ResourceConsumption `json:"target"`
}
    HorizontalPodAutoscalerSpec is the specification of a horizontal pod autoscaler.
type HorizontalPodAutoscalerStatus ¶
type HorizontalPodAutoscalerStatus struct {
	// CurrentReplicas is the number of replicas of pods managed by this autoscaler.
	CurrentReplicas int `json:"currentReplicas"`
	// DesiredReplicas is the desired number of replicas of pods managed by this autoscaler.
	// The number may be different because pod downscaling is someteimes delayed to keep the number
	// of pods stable.
	DesiredReplicas int `json:"desiredReplicas"`
	// CurrentConsumption is the current average consumption of the given resource that the autoscaler will
	// try to maintain by adjusting the desired number of pods.
	// Two types of resources are supported: "cpu" and "memory".
	CurrentConsumption *ResourceConsumption `json:"currentConsumption"`
	// LastScaleTimestamp is the last time the HorizontalPodAutoscaler scaled the number of pods.
	// This is used by the autoscaler to controll how often the number of pods is changed.
	LastScaleTimestamp *util.Time `json:"lastScaleTimestamp,omitempty"`
}
    HorizontalPodAutoscalerStatus contains the current status of a horizontal pod autoscaler
type ReplicationControllerDummy ¶
Dummy definition
func (*ReplicationControllerDummy) IsAnAPIObject ¶
func (*ReplicationControllerDummy) IsAnAPIObject()
type ResourceConsumption ¶
type ResourceConsumption struct {
	Resource api.ResourceName  `json:"resource,omitempty"`
	Quantity resource.Quantity `json:"quantity,omitempty"`
}
    ResourceConsumption is an object for specifying average resource consumption of a particular resource.
type RollingUpdateDeployment ¶
type RollingUpdateDeployment struct {
	// Value can be an absolute number (ex: 5) or a percentage of total pods at the start of update (ex: 10%).
	// Absolute number is calculated from percentage by rounding up.
	// This can not be 0 if MaxSurge is 0.
	// By default, a fixed value of 1 is used.
	// Example: when this is set to 30%, the old RC can be scaled down by 30%
	// 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 at least 70% of original number of pods are available at all times
	// during the update.
	MaxUnavailable util.IntOrString `json:"maxUnavailable,omitempty"`
	// The maximum number of pods that can be scheduled above the original number of
	// pods.
	// Value can be an absolute number (ex: 5) or a percentage of total pods at
	// the start of the update (ex: 10%). This can not be 0 if MaxUnavailable is 0.
	// Absolute number is calculated from percentage by rounding up.
	// By default, a value of 1 is used.
	// Example: when this is set to 30%, the new RC can be scaled up by 30%
	// immediately when the rolling update starts. 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 original pods.
	MaxSurge util.IntOrString `json:"maxSurge,omitempty"`
	// 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)
	MinReadySeconds int `json:"minReadySeconds,omitempty"`
}
    Spec to control the desired behavior of rolling update.
type Scale ¶
type Scale struct {
	api.TypeMeta   `json:",inline"`
	api.ObjectMeta `` /* 136-byte string literal not displayed */
	// Spec defines the behavior of the scale.
	Spec ScaleSpec `` /* 161-byte string literal not displayed */
	// Status represents the current status of the scale.
	Status ScaleStatus `` /* 193-byte string literal not displayed */
}
    Scale subresource, applicable to ReplicationControllers and (in future) Deployment.
func (*Scale) IsAnAPIObject ¶
func (*Scale) IsAnAPIObject()
type ScaleSpec ¶
type ScaleSpec struct {
	// Replicas is the number of desired replicas.
	Replicas int `` /* 171-byte string literal not displayed */
}
    ScaleSpec describes the attributes a Scale subresource
type ScaleStatus ¶
type ScaleStatus struct {
	// Replicas is the number of actual replicas.
	Replicas int `` /* 178-byte string literal not displayed */
	// Selector is a label query over pods that should match the replicas count.
	Selector map[string]string `` /* 255-byte string literal not displayed */
}
    ScaleStatus represents the current status of a Scale subresource.
type SubresourceReference ¶
type SubresourceReference struct {
	Kind        string `json:"kind,omitempty"`
	Namespace   string `json:"namespace,omitempty"`
	Name        string `json:"name,omitempty"`
	APIVersion  string `json:"apiVersion,omitempty"`
	Subresource string `json:"subresource,omitempty"`
}
    SubresourceReference contains enough information to let you inspect or modify the referred subresource.
type ThirdPartyResource ¶
type ThirdPartyResource struct {
	api.TypeMeta   `json:",inline"`
	api.ObjectMeta `json:"metadata,omitempty" description:"standard object metadata"`
	Description string `json:"description,omitempty" description:"The description of this object"`
	Versions []APIVersion `json:"versions,omitempty" description:"The versions for this third party object"`
}
    A ThirdPartyResource is a generic representation of a resource, it is used by add-ons and plugins to add new resource types to the API. It consists of one or more Versions of the api.
func (*ThirdPartyResource) IsAnAPIObject ¶
func (*ThirdPartyResource) IsAnAPIObject()
type ThirdPartyResourceData ¶
type ThirdPartyResourceData struct {
	api.TypeMeta   `json:",inline"`
	api.ObjectMeta `json:"metadata,omitempty" description:"standard object metadata"`
	Data []byte `json:"name,omitempty" description:"the raw JSON data for this data"`
}
    An internal object, used for versioned storage in etcd. Not exposed to the end user.
type ThirdPartyResourceList ¶
type ThirdPartyResourceList struct {
	api.TypeMeta `json:",inline"`
	api.ListMeta `json:"metadata,omitempty" description:"standard list metadata; see http://docs.k8s.io/api-conventions.md#metadata"`
	Items []ThirdPartyResource `json:"items" description:"items is a list of schema objects"`
}
    func (*ThirdPartyResourceList) IsAnAPIObject ¶
func (*ThirdPartyResourceList) IsAnAPIObject()