Documentation ¶
Index ¶
- Constants
- func ActiveDeployment(input []*v1.ReplicationController) *v1.ReplicationController
- func AnnotationFor(obj runtime.Object, key string) string
- func CanTransitionPhase(current, next appsv1.DeploymentStatus) bool
- func ConfigSelector(name string) labels.Selector
- func DeleteStatusReasons(rc *v1.ReplicationController)
- func DeployerPodNameFor(obj runtime.Object) string
- func DeployerPodNameForDeployment(deployment string) string
- func DeployerPodSelector(name string) labels.Selector
- func DeploymentConfigNameFor(obj runtime.Object) string
- func DeploymentNameFor(obj runtime.Object) string
- func DeploymentNameForConfigVersion(name string, version int64) string
- func DeploymentStatusFor(deployment runtime.Object) appsv1.DeploymentStatus
- func DeploymentStatusReasonFor(obj runtime.Object) string
- func DeploymentVersionFor(obj runtime.Object) int64
- func DeploymentsForCleanup(configuration *appsv1.DeploymentConfig, ...) []v1.ReplicationController
- func GetAvailableReplicaCountForReplicationControllers(replicationControllers []*v1.ReplicationController) int32
- func GetDeploymentCondition(status appsv1.DeploymentConfigStatus, condType appsv1.DeploymentConditionType) *appsv1.DeploymentCondition
- func GetReadyReplicaCountForReplicationControllers(replicationControllers []*v1.ReplicationController) int32
- func GetReplicaCountForDeployments(deployments []*v1.ReplicationController) int32
- func GetStatusReplicaCountForDeployments(deployments []*v1.ReplicationController) int32
- func HasChangeTrigger(config *appsv1.DeploymentConfig) bool
- func HasImageChangeTrigger(config *appsv1.DeploymentConfig) bool
- func HasLastTriggeredImage(config *appsv1.DeploymentConfig) bool
- func HasSynced(dc *appsv1.DeploymentConfig, generation int64) bool
- func HasTrigger(config *appsv1.DeploymentConfig) bool
- func IsCompleteDeployment(deployment runtime.Object) bool
- func IsDeploymentCancelled(deployment runtime.Object) bool
- func IsFailedDeployment(deployment runtime.Object) bool
- func IsInitialDeployment(config *appsv1.DeploymentConfig) bool
- func IsOwnedByConfig(obj metav1.Object) bool
- func IsRollingConfig(config *appsv1.DeploymentConfig) bool
- func IsTerminatedDeployment(deployment runtime.Object) bool
- func LabelForDeployment(deployment *v1.ReplicationController) string
- func LabelForDeploymentConfig(config runtime.Object) string
- func LatestDeploymentInfo(config *appsv1.DeploymentConfig, deployments []*v1.ReplicationController) (bool, *v1.ReplicationController)
- func LatestDeploymentNameForConfig(config *appsv1.DeploymentConfig) string
- func LatestDeploymentNameForConfigAndVersion(name string, version int64) string
- func MakeDeployment(config *appsv1.DeploymentConfig) (*v1.ReplicationController, error)
- func MaxSurge(config appsv1.DeploymentConfig) int32
- func MaxUnavailable(config *appsv1.DeploymentConfig) int32
- func NewReplicationControllerScaleClient(client kubernetes.Interface) scaleclient.ScalesGetter
- func RemoveDeploymentCondition(status *appsv1.DeploymentConfigStatus, condType appsv1.DeploymentConditionType)
- func ResolveFenceposts(maxSurge, maxUnavailable *intstrutil.IntOrString, desired int32) (int32, int32, error)
- func SetCancelledByNewerDeployment(rc *v1.ReplicationController)
- func SetCancelledByUserReason(rc *v1.ReplicationController)
- func SetDeploymentCondition(status *appsv1.DeploymentConfigStatus, condition appsv1.DeploymentCondition)
- func SetDeploymentLatestVersionAnnotation(rc *v1.ReplicationController, version string)
- func WaitForRunningDeployerPod(podClient corev1client.PodsGetter, rc *corev1.ReplicationController, ...) error
- type ByLatestVersionAsc
- type ByLatestVersionDesc
Constants ¶
const ( // FailedRcCreateReason is added in a deployment config when it cannot create a new replication // controller. FailedRcCreateReason = "ReplicationControllerCreateError" // NewReplicationControllerReason is added in a deployment config when it creates a new replication // controller. NewReplicationControllerReason = "NewReplicationControllerCreated" // NewRcAvailableReason is added in a deployment config when its newest replication controller is made // available ie. the number of new pods that have passed readiness checks and run for at least // minReadySeconds is at least the minimum available pods that need to run for the deployment config. NewRcAvailableReason = "NewReplicationControllerAvailable" // TimedOutReason is added in a deployment config when its newest replication controller fails to show // any progress within the given deadline (progressDeadlineSeconds). TimedOutReason = "ProgressDeadlineExceeded" // PausedConfigReason is added in a deployment config when it is paused. Lack of progress shouldn't be // estimated once a deployment config is paused. PausedConfigReason = "DeploymentConfigPaused" // CancelledRolloutReason is added in a deployment config when its newest rollout was // interrupted by cancellation. CancelledRolloutReason = "RolloutCancelled" // DeploymentConfigLabel is the name of a label used to correlate a deployment with the DeploymentConfigLabel = "deploymentconfig" // DeploymentLabel is the name of a label used to correlate a deployment with the Pod created DeploymentLabel = "deployment" // MaxDeploymentDurationSeconds represents the maximum duration that a deployment is allowed to run. // This is set as the default value for ActiveDeadlineSeconds for the deployer pod. // Currently set to 6 hours. MaxDeploymentDurationSeconds int64 = 21600 // DefaultRecreateTimeoutSeconds is the default TimeoutSeconds for RecreateDeploymentStrategyParams. // Used by strategies: DefaultRecreateTimeoutSeconds int64 = 10 * 60 DefaultRollingTimeoutSeconds int64 = 10 * 60 // PreHookPodSuffix is the suffix added to all pre hook pods PreHookPodSuffix = "hook-pre" // MidHookPodSuffix is the suffix added to all mid hook pods MidHookPodSuffix = "hook-mid" // PostHookPodSuffix is the suffix added to all post hook pods PostHookPodSuffix = "hook-post" // DeploymentStatusReasonAnnotation represents the reason for deployment being in a given state // Used for specifying the reason for cancellation or failure of a deployment DeploymentIgnorePodAnnotation = "deploy.openshift.io/deployer-pod.ignore" DeploymentReplicasAnnotation = "openshift.io/deployment.replicas" DeploymentFailedUnableToCreateDeployerPod = "unable to create deployer pod" DeploymentFailedDeployerPodNoLongerExists = "deployer pod no longer exists" )
Variables ¶
This section is empty.
Functions ¶
func ActiveDeployment ¶
func ActiveDeployment(input []*v1.ReplicationController) *v1.ReplicationController
ActiveDeployment returns the latest complete deployment, or nil if there is no such deployment. The active deployment is not always the same as the latest deployment.
func AnnotationFor ¶
AnnotationFor returns the annotation with key for obj.
func CanTransitionPhase ¶
func CanTransitionPhase(current, next appsv1.DeploymentStatus) bool
CanTransitionPhase returns whether it is allowed to go from the current to the next phase.
func ConfigSelector ¶
ConfigSelector returns a label Selector which can be used to find all deployments for a DeploymentConfig.
TODO: Using the annotation constant for now since the value is correct but we could consider adding a new constant to the public types.
func DeleteStatusReasons ¶
func DeleteStatusReasons(rc *v1.ReplicationController)
func DeployerPodNameFor ¶
func DeployerPodNameForDeployment ¶
DeployerPodNameForDeployment returns the name of a pod for a given deployment
func DeployerPodSelector ¶
DeployerPodSelector returns a label Selector which can be used to find all deployer pods associated with a deployment with name.
func DeploymentConfigNameFor ¶
func DeploymentNameFor ¶
func DeploymentNameForConfigVersion ¶
DeploymentNameForConfigVersion returns the name of the version-th deployment for the config that has the provided name
func DeploymentStatusFor ¶
func DeploymentStatusFor(deployment runtime.Object) appsv1.DeploymentStatus
func DeploymentVersionFor ¶
func DeploymentsForCleanup ¶
func DeploymentsForCleanup(configuration *appsv1.DeploymentConfig, deployments []*v1.ReplicationController) []v1.ReplicationController
DeploymentsForCleanup determines which deployments for a configuration are relevant for the revision history limit quota
func GetAvailableReplicaCountForReplicationControllers ¶
func GetAvailableReplicaCountForReplicationControllers(replicationControllers []*v1.ReplicationController) int32
GetAvailableReplicaCountForReplicationControllers returns the number of available pods corresponding to the given replication controller.
func GetDeploymentCondition ¶
func GetDeploymentCondition(status appsv1.DeploymentConfigStatus, condType appsv1.DeploymentConditionType) *appsv1.DeploymentCondition
GetDeploymentCondition returns the condition with the provided type.
func GetReadyReplicaCountForReplicationControllers ¶
func GetReadyReplicaCountForReplicationControllers(replicationControllers []*v1.ReplicationController) int32
GetReadyReplicaCountForReplicationControllers returns the number of ready pods corresponding to the given replication controller.
func GetReplicaCountForDeployments ¶
func GetReplicaCountForDeployments(deployments []*v1.ReplicationController) int32
GetReplicaCountForDeployments returns the sum of all replicas for the given deployments.
func GetStatusReplicaCountForDeployments ¶
func GetStatusReplicaCountForDeployments(deployments []*v1.ReplicationController) int32
GetStatusReplicaCountForDeployments returns the sum of the replicas reported in the status of the given deployments.
func HasChangeTrigger ¶
func HasChangeTrigger(config *appsv1.DeploymentConfig) bool
HasChangeTrigger returns whether the provided deployment configuration has a config change trigger or not
func HasImageChangeTrigger ¶
func HasImageChangeTrigger(config *appsv1.DeploymentConfig) bool
HasImageChangeTrigger returns whether the provided deployment configuration has an image change trigger or not.
func HasLastTriggeredImage ¶
func HasLastTriggeredImage(config *appsv1.DeploymentConfig) bool
HasLastTriggeredImage returns whether all image change triggers in provided deployment configuration has the lastTriggerImage field set (iow. all images were updated for them). Returns false if deployment configuration has no image change trigger defined.
func HasSynced ¶
func HasSynced(dc *appsv1.DeploymentConfig, generation int64) bool
HasSynced checks if the provided deployment config has been noticed by the deployment config controller.
func HasTrigger ¶
func HasTrigger(config *appsv1.DeploymentConfig) bool
HasTrigger returns whether the provided deployment configuration has any trigger defined or not.
func IsCompleteDeployment ¶
IsCompleteDeployment returns true if the passed deployment is in state complete.
func IsDeploymentCancelled ¶
func IsFailedDeployment ¶
IsFailedDeployment returns true if the passed deployment failed.
func IsInitialDeployment ¶
func IsInitialDeployment(config *appsv1.DeploymentConfig) bool
IsInitialDeployment returns whether the deployment configuration is the first version of this configuration.
func IsOwnedByConfig ¶
IsOwnedByConfig checks whether the provided replication controller is part of a deployment configuration. TODO: Switch to use owner references once we got those working.
func IsRollingConfig ¶
func IsRollingConfig(config *appsv1.DeploymentConfig) bool
IsRollingConfig returns true if the strategy type is a rolling update.
func IsTerminatedDeployment ¶
IsTerminatedDeployment returns true if the passed deployment has terminated (either complete or failed).
func LabelForDeployment ¶
func LabelForDeployment(deployment *v1.ReplicationController) string
LabelForDeployment builds a string identifier for a Deployment.
func LabelForDeploymentConfig ¶
LabelForDeploymentConfig builds a string identifier for a DeploymentConfig.
func LatestDeploymentInfo ¶
func LatestDeploymentInfo(config *appsv1.DeploymentConfig, deployments []*v1.ReplicationController) (bool, *v1.ReplicationController)
LatestDeploymentInfo returns info about the latest deployment for a config, or nil if there is no latest deployment. The latest deployment is not always the same as the active deployment.
func LatestDeploymentNameForConfig ¶
func LatestDeploymentNameForConfig(config *appsv1.DeploymentConfig) string
LatestDeploymentNameForConfig returns a stable identifier for deployment config
func LatestDeploymentNameForConfigAndVersion ¶
LatestDeploymentNameForConfigAndVersion returns a stable identifier for config based on its version.
func MakeDeployment ¶
func MakeDeployment(config *appsv1.DeploymentConfig) (*v1.ReplicationController, error)
MakeDeployment creates a deployment represented as a ReplicationController and based on the given DeploymentConfig. The controller replica count will be zero.
func MaxSurge ¶
func MaxSurge(config appsv1.DeploymentConfig) int32
MaxSurge returns the maximum surge pods a rolling deployment config can take.
func MaxUnavailable ¶
func MaxUnavailable(config *appsv1.DeploymentConfig) int32
MaxUnavailable returns the maximum unavailable pods a rolling deployment config can take.
func NewReplicationControllerScaleClient ¶
func NewReplicationControllerScaleClient(client kubernetes.Interface) scaleclient.ScalesGetter
func RemoveDeploymentCondition ¶
func RemoveDeploymentCondition(status *appsv1.DeploymentConfigStatus, condType appsv1.DeploymentConditionType)
RemoveDeploymentCondition removes the deployment condition with the provided type.
func ResolveFenceposts ¶
func ResolveFenceposts(maxSurge, maxUnavailable *intstrutil.IntOrString, desired int32) (int32, int32, error)
ResolveFenceposts is copy from k8s deployment_utils to avoid unnecessary imports
func SetCancelledByNewerDeployment ¶
func SetCancelledByNewerDeployment(rc *v1.ReplicationController)
func SetCancelledByUserReason ¶
func SetCancelledByUserReason(rc *v1.ReplicationController)
func SetDeploymentCondition ¶
func SetDeploymentCondition(status *appsv1.DeploymentConfigStatus, condition appsv1.DeploymentCondition)
SetDeploymentCondition updates the deployment to include the provided condition. If the condition that we are about to add already exists and has the same status and reason then we are not going to update.
func SetDeploymentLatestVersionAnnotation ¶
func SetDeploymentLatestVersionAnnotation(rc *v1.ReplicationController, version string)
func WaitForRunningDeployerPod ¶
func WaitForRunningDeployerPod(podClient corev1client.PodsGetter, rc *corev1.ReplicationController, timeout time.Duration) error
WaitForRunningDeployerPod waits a given period of time until the deployer pod for given replication controller is not running.
Types ¶
type ByLatestVersionAsc ¶
type ByLatestVersionAsc []*v1.ReplicationController
func (ByLatestVersionAsc) Len ¶
func (d ByLatestVersionAsc) Len() int
func (ByLatestVersionAsc) Less ¶
func (d ByLatestVersionAsc) Less(i, j int) bool
func (ByLatestVersionAsc) Swap ¶
func (d ByLatestVersionAsc) Swap(i, j int)
type ByLatestVersionDesc ¶
type ByLatestVersionDesc []*v1.ReplicationController
ByLatestVersionDesc sorts deployments by LatestVersion descending.
func (ByLatestVersionDesc) Len ¶
func (d ByLatestVersionDesc) Len() int
func (ByLatestVersionDesc) Less ¶
func (d ByLatestVersionDesc) Less(i, j int) bool
func (ByLatestVersionDesc) Swap ¶
func (d ByLatestVersionDesc) Swap(i, j int)