Documentation ¶
Overview ¶
+groupName=apps.openshift.io Package api is the internal version of the API.
Index ¶
- Constants
- Variables
- func DeepCopy_apps_CustomDeploymentStrategyParams(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentCause(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentCauseImageTrigger(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentCondition(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentConfig(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentConfigList(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentConfigRollback(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentConfigRollbackSpec(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentConfigSpec(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentConfigStatus(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentDetails(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentLog(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentLogOptions(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentRequest(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentStrategy(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentTriggerImageChangeParams(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_DeploymentTriggerPolicy(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_ExecNewPodHook(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_LifecycleHook(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_RecreateDeploymentStrategyParams(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_RollingDeploymentStrategyParams(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_TagImageHook(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_apps_TemplateImage(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeploymentConfigToSelectableFields(deploymentConfig *DeploymentConfig) fields.Set
- func DeploymentToPodLogOptions(opts *DeploymentLogOptions) *kapi.PodLogOptions
- func EachContainer(pod *kapi.PodSpec, fn func(*kapi.Container) error) error
- func EachTemplateImage(pod *kapi.PodSpec, triggerFn TriggeredByFunc, fn func(TemplateImage, error))
- func IsKindOrLegacy(kind string, gk schema.GroupKind) bool
- func IsResourceOrLegacy(resource string, gr schema.GroupResource) bool
- func Kind(kind string) schema.GroupKind
- func LegacyKind(kind string) schema.GroupKind
- func LegacyResource(resource string) schema.GroupResource
- func RegisterDeepCopies(scheme *runtime.Scheme) error
- func Resource(resource string) schema.GroupResource
- func ScaleFromConfig(dc *DeploymentConfig) *extensions.Scale
- type CustomDeploymentStrategyParams
- type DeploymentCause
- type DeploymentCauseImageTrigger
- type DeploymentCondition
- type DeploymentConditionReason
- type DeploymentConditionType
- type DeploymentConfig
- type DeploymentConfigList
- type DeploymentConfigRollback
- type DeploymentConfigRollbackSpec
- type DeploymentConfigSpec
- type DeploymentConfigStatus
- type DeploymentDetails
- type DeploymentLog
- type DeploymentLogOptions
- type DeploymentRequest
- type DeploymentStatus
- type DeploymentStrategy
- type DeploymentStrategyType
- type DeploymentTriggerImageChangeParams
- type DeploymentTriggerPolicy
- type DeploymentTriggerType
- type ExecNewPodHook
- type LifecycleHook
- type LifecycleHookFailurePolicy
- type RecreateDeploymentStrategyParams
- type RollingDeploymentStrategyParams
- type TagImageHook
- type TemplateImage
- type TriggeredByFunc
Constants ¶
const ( LegacyGroupName = "" GroupName = "apps.openshift.io" )
const ( // DefaultRollingTimeoutSeconds is the default TimeoutSeconds for RollingDeploymentStrategyParams. DefaultRollingTimeoutSeconds int64 = 10 * 60 // DefaultRecreateTimeoutSeconds is the default TimeoutSeconds for RecreateDeploymentStrategyParams. DefaultRecreateTimeoutSeconds int64 = 10 * 60 // DefaultRollingIntervalSeconds is the default IntervalSeconds for RollingDeploymentStrategyParams. DefaultRollingIntervalSeconds int64 = 1 // DefaultRollingUpdatePeriodSeconds is the default PeriodSeconds for RollingDeploymentStrategyParams. DefaultRollingUpdatePeriodSeconds int64 = 1 // 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 )
These constants represent defaults used in the deployment process.
const ( // DeploymentConfigAnnotation is an annotation name used to correlate a deployment with the // DeploymentConfig on which the deployment is based. DeploymentConfigAnnotation = "openshift.io/deployment-config.name" // DeploymentAnnotation is an annotation on a deployer Pod. The annotation value is the name // of the deployment (a ReplicationController) on which the deployer Pod acts. DeploymentAnnotation = "openshift.io/deployment.name" // DeploymentPodAnnotation is an annotation on a deployment (a ReplicationController). The // annotation value is the name of the deployer Pod which will act upon the ReplicationController // to implement the deployment behavior. DeploymentPodAnnotation = "openshift.io/deployer-pod.name" // DeploymentIgnorePodAnnotation is an annotation on a deployment config that will bypass creating // a deployment pod with the deployment. The caller is responsible for setting the deployment // status and running the deployment process. DeploymentIgnorePodAnnotation = "deploy.openshift.io/deployer-pod.ignore" // DeploymentPodTypeLabel is a label with which contains a type of deployment pod. DeploymentPodTypeLabel = "openshift.io/deployer-pod.type" // DeployerPodForDeploymentLabel is a label which groups pods related to a // deployment. The value is a deployment name. The deployer pod and hook pods // created by the internal strategies will have this label. Custom // strategies can apply this label to any pods they create, enabling // platform-provided cancellation and garbage collection support. DeployerPodForDeploymentLabel = "openshift.io/deployer-pod-for.name" // DeploymentStatusAnnotation is an annotation name used to retrieve the DeploymentPhase of // a deployment. DeploymentStatusAnnotation = "openshift.io/deployment.phase" // DeploymentEncodedConfigAnnotation is an annotation name used to retrieve specific encoded // DeploymentConfig on which a given deployment is based. DeploymentEncodedConfigAnnotation = "openshift.io/encoded-deployment-config" // DeploymentVersionAnnotation is an annotation on a deployment (a ReplicationController). The // annotation value is the LatestVersion value of the DeploymentConfig which was the basis for // the deployment. DeploymentVersionAnnotation = "openshift.io/deployment-config.latest-version" // DeploymentLabel is the name of a label used to correlate a deployment with the Pod created // to execute the deployment logic. // TODO: This is a workaround for upstream's lack of annotation support on PodTemplate. Once // annotations are available on PodTemplate, audit this constant with the goal of removing it. DeploymentLabel = "deployment" // DeploymentConfigLabel is the name of a label used to correlate a deployment with the // DeploymentConfigs on which the deployment is based. DeploymentConfigLabel = "deploymentconfig" // DesiredReplicasAnnotation represents the desired number of replicas for a // new deployment. // TODO: This should be made public upstream. DesiredReplicasAnnotation = "kubectl.kubernetes.io/desired-replicas" // DeploymentStatusReasonAnnotation represents the reason for deployment being in a given state // Used for specifying the reason for cancellation or failure of a deployment DeploymentStatusReasonAnnotation = "openshift.io/deployment.status-reason" // DeploymentCancelledAnnotation indicates that the deployment has been cancelled // The annotation value does not matter and its mere presence indicates cancellation DeploymentCancelledAnnotation = "openshift.io/deployment.cancelled" // DeploymentReplicasAnnotation is for internal use only and is for // detecting external modifications to deployment replica counts. DeploymentReplicasAnnotation = "openshift.io/deployment.replicas" // PostHookPodSuffix is the suffix added to all pre hook pods PreHookPodSuffix = "hook-pre" // PostHookPodSuffix 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" )
These constants represent keys used for correlating objects related to deployments.
const ( DeploymentCancelledByUser = "cancelled by the user" DeploymentCancelledNewerDeploymentExists = "newer deployment was found running" DeploymentFailedDeployerPodNoLongerExists = "deployer pod no longer exists" )
These constants represent the various reasons for cancelling a deployment or for a deployment being placed in a failed state
const ( // DeploymentCancelledAnnotationValue represents the value for the DeploymentCancelledAnnotation // annotation that signifies that the deployment should be cancelled DeploymentCancelledAnnotationValue = "true" )
These constants represent values used in deployment annotations.
Variables ¶
var ( SchemeGroupVersion = schema.GroupVersion{Group: GroupName, Version: runtime.APIVersionInternal} LegacySchemeGroupVersion = schema.GroupVersion{Group: LegacyGroupName, Version: runtime.APIVersionInternal} LegacySchemeBuilder = runtime.NewSchemeBuilder(addLegacyKnownTypes) AddToSchemeInCoreGroup = LegacySchemeBuilder.AddToScheme SchemeBuilder = runtime.NewSchemeBuilder(addKnownTypes) AddToScheme = SchemeBuilder.AddToScheme )
Functions ¶
func DeepCopy_apps_CustomDeploymentStrategyParams ¶
func DeepCopy_apps_CustomDeploymentStrategyParams(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentCause ¶
func DeepCopy_apps_DeploymentCause(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentCauseImageTrigger ¶
func DeepCopy_apps_DeploymentCauseImageTrigger(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentCondition ¶
func DeepCopy_apps_DeploymentCondition(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentConfig ¶
func DeepCopy_apps_DeploymentConfig(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentConfigList ¶
func DeepCopy_apps_DeploymentConfigList(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentConfigRollback ¶
func DeepCopy_apps_DeploymentConfigRollback(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentConfigRollbackSpec ¶
func DeepCopy_apps_DeploymentConfigRollbackSpec(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentConfigSpec ¶
func DeepCopy_apps_DeploymentConfigSpec(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentConfigStatus ¶
func DeepCopy_apps_DeploymentConfigStatus(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentDetails ¶
func DeepCopy_apps_DeploymentDetails(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentLog ¶
func DeepCopy_apps_DeploymentLog(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentLogOptions ¶
func DeepCopy_apps_DeploymentLogOptions(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentRequest ¶
func DeepCopy_apps_DeploymentRequest(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentStrategy ¶
func DeepCopy_apps_DeploymentStrategy(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentTriggerImageChangeParams ¶
func DeepCopy_apps_DeploymentTriggerImageChangeParams(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_DeploymentTriggerPolicy ¶
func DeepCopy_apps_DeploymentTriggerPolicy(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_ExecNewPodHook ¶
func DeepCopy_apps_ExecNewPodHook(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_LifecycleHook ¶
func DeepCopy_apps_LifecycleHook(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_RecreateDeploymentStrategyParams ¶
func DeepCopy_apps_RecreateDeploymentStrategyParams(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_RollingDeploymentStrategyParams ¶
func DeepCopy_apps_RollingDeploymentStrategyParams(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_TagImageHook ¶
func DeepCopy_apps_TagImageHook(in interface{}, out interface{}, c *conversion.Cloner) error
func DeepCopy_apps_TemplateImage ¶
func DeepCopy_apps_TemplateImage(in interface{}, out interface{}, c *conversion.Cloner) error
func DeploymentConfigToSelectableFields ¶
func DeploymentConfigToSelectableFields(deploymentConfig *DeploymentConfig) fields.Set
DeploymentConfigToSelectableFields returns a label set that represents the object
func DeploymentToPodLogOptions ¶
func DeploymentToPodLogOptions(opts *DeploymentLogOptions) *kapi.PodLogOptions
DeploymentToPodLogOptions builds a PodLogOptions object out of a DeploymentLogOptions. Currently DeploymentLogOptions.Container and DeploymentLogOptions.Previous aren't used so they won't be copied to PodLogOptions.
Note that Previous for PodLogOptions is different from Previous for DeploymentLogOptions so it shouldn't be included here.
func EachContainer ¶
EachContainer iterates a pod spec with each container.
func EachTemplateImage ¶
func EachTemplateImage(pod *kapi.PodSpec, triggerFn TriggeredByFunc, fn func(TemplateImage, error))
EachTemplateImage iterates a pod spec, looking for triggers that match each container and invoking fn with each located image.
func IsKindOrLegacy ¶
IsKindOrLegacy checks if the provided GroupKind matches with the given kind by looking up the API group and also the legacy API.
func IsResourceOrLegacy ¶
func IsResourceOrLegacy(resource string, gr schema.GroupResource) bool
IsResourceOrLegacy checks if the provided GroupResources matches with the given resource by looking up the API group and also the legacy API.
func LegacyKind ¶
LegacyKind takes an unqualified kind and returns back a Group qualified GroupKind
func LegacyResource ¶
func LegacyResource(resource string) schema.GroupResource
LegacyResource takes an unqualified resource and returns back a Group qualified GroupResource
func RegisterDeepCopies ¶
RegisterDeepCopies adds deep-copy functions to the given scheme. Public to allow building arbitrary schemes.
func Resource ¶
func Resource(resource string) schema.GroupResource
Resource takes an unqualified resource and returns back a Group qualified GroupResource
func ScaleFromConfig ¶
func ScaleFromConfig(dc *DeploymentConfig) *extensions.Scale
ScaleFromConfig builds a scale resource out of a deployment config.
Types ¶
type CustomDeploymentStrategyParams ¶
type CustomDeploymentStrategyParams struct { // Image specifies a Docker image which can carry out a deployment. Image string // Environment holds the environment which will be given to the container for Image. Environment []kapi.EnvVar // Command is optional and overrides CMD in the container Image. Command []string }
CustomDeploymentStrategyParams are the input to the Custom deployment strategy.
type DeploymentCause ¶
type DeploymentCause struct { // Type is the type of the trigger that resulted in the creation of a new deployment Type DeploymentTriggerType // ImageTrigger contains the image trigger details, if this trigger was fired based on an image change ImageTrigger *DeploymentCauseImageTrigger }
DeploymentCause captures information about a particular cause of a deployment.
type DeploymentCauseImageTrigger ¶
type DeploymentCauseImageTrigger struct { // From is a reference to the changed object which triggered a deployment. The field may have // the kinds DockerImage, ImageStreamTag, or ImageStreamImage. From kapi.ObjectReference }
DeploymentCauseImageTrigger contains information about a deployment caused by an image trigger
type DeploymentCondition ¶
type DeploymentCondition struct { // Type of deployment condition. Type DeploymentConditionType // Status of the condition, one of True, False, Unknown. Status kapi.ConditionStatus // The last time this condition was updated. LastUpdateTime metav1.Time // The last time the condition transitioned from one status to another. LastTransitionTime metav1.Time // The reason for the condition's last transition. Reason DeploymentConditionReason // A human readable message indicating details about the transition. Message string }
DeploymentCondition describes the state of a deployment config at a certain point.
type DeploymentConditionReason ¶
type DeploymentConditionReason string
const ( // ReplicationControllerUpdatedReason is added in a deployment config when one of its replication // controllers is updated as part of the rollout process. ReplicationControllerUpdatedReason DeploymentConditionReason = "ReplicationControllerUpdated" // FailedRcCreateReason is added in a deployment config when it cannot create a new replication // controller. FailedRcCreateReason DeploymentConditionReason = "ReplicationControllerCreateError" // NewReplicationControllerReason is added in a deployment config when it creates a new replication // controller. NewReplicationControllerReason DeploymentConditionReason = "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 DeploymentConditionReason = "NewReplicationControllerAvailable" // TimedOutReason is added in a deployment config when its newest replication controller fails to show // any progress within the given deadline (progressDeadlineSeconds). TimedOutReason DeploymentConditionReason = "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 DeploymentConditionReason = "DeploymentConfigPaused" // ResumedConfigReason is added in a deployment config when it is resumed. Useful for not failing accidentally // deployment configs that paused amidst a rollout. ResumedConfigReason DeploymentConditionReason = "DeploymentConfigResumed" // CancelledRolloutReason is added in a deployment config when its newest rollout was // interrupted by cancellation. CancelledRolloutReason DeploymentConditionReason = "RolloutCancelled" )
type DeploymentConditionType ¶
type DeploymentConditionType string
const ( // DeploymentAvailable means the DeploymentConfig is available, ie. at least the minimum available // replicas required (dc.spec.replicas in case the DeploymentConfig is of Recreate type, // dc.spec.replicas - dc.spec.strategy.rollingParams.maxUnavailable in case it's Rolling) are up and // running for at least dc.spec.minReadySeconds. DeploymentAvailable DeploymentConditionType = "Available" // DeploymentProgressing is: // * True: the DeploymentConfig has been successfully deployed or is amidst getting deployed. // The two different states can be determined by looking at the Reason of the Condition. // For example, a complete DC will have {Status: True, Reason: NewReplicationControllerAvailable} // and a DC in the middle of a rollout {Status: True, Reason: ReplicationControllerUpdated}. // TODO: Represent a successfully deployed DC by using something else for Status like Unknown? // * False: the DeploymentConfig has failed to deploy its latest version. // // This condition is purely informational and depends on the dc.spec.strategy.*params.timeoutSeconds // field, which is responsible for the time in seconds to wait for a rollout before deciding that // no progress can be made, thus the rollout is aborted. // // Progress for a DeploymentConfig is considered when new pods scale up or old pods scale down. DeploymentProgressing DeploymentConditionType = "Progressing" // DeploymentReplicaFailure is added in a deployment config when one of its pods // fails to be created or deleted. DeploymentReplicaFailure DeploymentConditionType = "ReplicaFailure" )
These are valid conditions of a DeploymentConfig.
type DeploymentConfig ¶
type DeploymentConfig struct { metav1.TypeMeta metav1.ObjectMeta // Spec represents a desired deployment state and how to deploy to it. Spec DeploymentConfigSpec // Status represents the current deployment state. Status DeploymentConfigStatus }
DeploymentConfig represents a configuration for a single deployment (represented as a ReplicationController). It also contains details about changes which resulted in the current state of the DeploymentConfig. Each change to the DeploymentConfig which should result in a new deployment results in an increment of LatestVersion.
type DeploymentConfigList ¶
type DeploymentConfigList struct { metav1.TypeMeta metav1.ListMeta // Items is a list of deployment configs Items []DeploymentConfig }
DeploymentConfigList is a collection of deployment configs.
type DeploymentConfigRollback ¶
type DeploymentConfigRollback struct { metav1.TypeMeta // Name of the deployment config that will be rolled back. Name string // UpdatedAnnotations is a set of new annotations that will be added in the deployment config. UpdatedAnnotations map[string]string // Spec defines the options to rollback generation. Spec DeploymentConfigRollbackSpec }
DeploymentConfigRollback provides the input to rollback generation.
type DeploymentConfigRollbackSpec ¶
type DeploymentConfigRollbackSpec struct { // From points to a ReplicationController which is a deployment. From kapi.ObjectReference // Revision to rollback to. If set to 0, rollback to the last revision. Revision int64 // IncludeTriggers specifies whether to include config Triggers. IncludeTriggers bool // IncludeTemplate specifies whether to include the PodTemplateSpec. IncludeTemplate bool // IncludeReplicationMeta specifies whether to include the replica count and selector. IncludeReplicationMeta bool // IncludeStrategy specifies whether to include the deployment Strategy. IncludeStrategy bool }
DeploymentConfigRollbackSpec represents the options for rollback generation.
type DeploymentConfigSpec ¶
type DeploymentConfigSpec struct { // Strategy describes how a deployment is executed. Strategy DeploymentStrategy // MinReadySeconds is the 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 int32 // Triggers determine how updates to a DeploymentConfig result in new deployments. If no triggers // are defined, a new deployment can only occur as a result of an explicit client update to the // DeploymentConfig with a new LatestVersion. Triggers []DeploymentTriggerPolicy // Replicas is the number of desired replicas. Replicas int32 // RevisionHistoryLimit is the number of old ReplicationControllers to retain to allow for rollbacks. // This field is a pointer to allow for differentiation between an explicit zero and not specified. RevisionHistoryLimit *int32 // Test ensures that this deployment config will have zero replicas except while a deployment is running. This allows the // deployment config to be used as a continuous deployment test - triggering on images, running the deployment, and then succeeding // or failing. Post strategy hooks and After actions can be used to integrate successful deployment with an action. Test bool // Paused indicates that the deployment config is paused resulting in no new deployments on template // changes or changes in the template caused by other triggers. Paused bool // Selector is a label query over pods that should match the Replicas count. Selector map[string]string // Template is the object that describes the pod that will be created if // insufficient replicas are detected. Template *kapi.PodTemplateSpec }
DeploymentConfigSpec represents the desired state of the deployment.
type DeploymentConfigStatus ¶
type DeploymentConfigStatus struct { // LatestVersion is used to determine whether the current deployment associated with a deployment // config is out of sync. LatestVersion int64 // ObservedGeneration is the most recent generation observed by the deployment config controller. ObservedGeneration int64 // Replicas is the total number of pods targeted by this deployment config. Replicas int32 // UpdatedReplicas is the total number of non-terminated pods targeted by this deployment config // that have the desired template spec. UpdatedReplicas int32 // AvailableReplicas is the total number of available pods targeted by this deployment config. AvailableReplicas int32 UnavailableReplicas int32 // Details are the reasons for the update to this deployment config. // This could be based on a change made by the user or caused by an automatic trigger Details *DeploymentDetails // Conditions represents the latest available observations of a deployment config's current state. Conditions []DeploymentCondition // Total number of ready pods targeted by this deployment. ReadyReplicas int32 }
DeploymentConfigStatus represents the current deployment state.
type DeploymentDetails ¶
type DeploymentDetails struct { // Message is the user specified change message, if this deployment was triggered manually by the user Message string // Causes are extended data associated with all the causes for creating a new deployment Causes []DeploymentCause }
DeploymentDetails captures information about the causes of a deployment.
type DeploymentLog ¶
DeploymentLog represents the logs for a deployment
type DeploymentLogOptions ¶
type DeploymentLogOptions struct { metav1.TypeMeta // Container for which to return logs Container string // Follow if true indicates that the deployment log should be streamed until // the deployment terminates. Follow bool // If true, return previous deployment logs Previous bool // A relative time in seconds before the current time from which to show logs. If this value // precedes the time a pod was started, only logs since the pod start will be returned. // If this value is in the future, no logs will be returned. // Only one of sinceSeconds or sinceTime may be specified. SinceSeconds *int64 // An RFC3339 timestamp from which to show logs. If this value // precedes the time a pod was started, only logs since the pod start will be returned. // If this value is in the future, no logs will be returned. // Only one of sinceSeconds or sinceTime may be specified. SinceTime *metav1.Time // If true, add an RFC3339 or RFC3339Nano timestamp at the beginning of every line // of log output. Timestamps bool // If set, the number of lines from the end of the logs to show. If not specified, // logs are shown from the creation of the container or sinceSeconds or sinceTime TailLines *int64 // If set, the number of bytes to read from the server before terminating the // log output. This may not display a complete final line of logging, and may return // slightly more or slightly less than the specified limit. LimitBytes *int64 // NoWait if true causes the call to return immediately even if the deployment // is not available yet. Otherwise the server will wait until the deployment has started. NoWait bool // Version of the deployment for which to view logs. Version *int64 }
DeploymentLogOptions is the REST options for a deployment log
type DeploymentRequest ¶
type DeploymentRequest struct { metav1.TypeMeta // Name of the deployment config for requesting a new deployment. Name string // Latest will update the deployment config with the latest state from all triggers. Latest bool // Force will try to force a new deployment to run. If the deployment config is paused, // then setting this to true will return an Invalid error. Force bool // ExcludeTriggers instructs the instantiator to avoid processing the specified triggers. // This field overrides the triggers from latest and allows clients to control specific // logic. ExcludeTriggers []DeploymentTriggerType }
DeploymentRequest is a request to a deployment config for a new deployment.
type DeploymentStatus ¶
type DeploymentStatus string
DeploymentStatus describes the possible states a deployment can be in.
const ( // DeploymentStatusNew means the deployment has been accepted but not yet acted upon. DeploymentStatusNew DeploymentStatus = "New" // DeploymentStatusPending means the deployment been handed over to a deployment strategy, // but the strategy has not yet declared the deployment to be running. DeploymentStatusPending DeploymentStatus = "Pending" // DeploymentStatusRunning means the deployment strategy has reported the deployment as // being in-progress. DeploymentStatusRunning DeploymentStatus = "Running" // DeploymentStatusComplete means the deployment finished without an error. DeploymentStatusComplete DeploymentStatus = "Complete" // DeploymentStatusFailed means the deployment finished with an error. DeploymentStatusFailed DeploymentStatus = "Failed" )
type DeploymentStrategy ¶
type DeploymentStrategy struct { // Type is the name of a deployment strategy. Type DeploymentStrategyType // CustomParams are the input to the Custom deployment strategy, and may also // be specified for the Recreate and Rolling strategies to customize the execution // process that runs the deployment. CustomParams *CustomDeploymentStrategyParams // RecreateParams are the input to the Recreate deployment strategy. RecreateParams *RecreateDeploymentStrategyParams // RollingParams are the input to the Rolling deployment strategy. RollingParams *RollingDeploymentStrategyParams // Resources contains resource requirements to execute the deployment and any hooks. Resources kapi.ResourceRequirements // Labels is a set of key, value pairs added to custom deployer and lifecycle pre/post hook pods. Labels map[string]string // Annotations is a set of key, value pairs added to custom deployer and lifecycle pre/post hook pods. Annotations map[string]string // ActiveDeadlineSeconds is the duration in seconds that the deployer pods for this deployment // config may be active on a node before the system actively tries to terminate them. ActiveDeadlineSeconds *int64 }
DeploymentStrategy describes how to perform a deployment.
type DeploymentStrategyType ¶
type DeploymentStrategyType string
DeploymentStrategyType refers to a specific DeploymentStrategy implementation.
const ( // DeploymentStrategyTypeRecreate is a simple strategy suitable as a default. DeploymentStrategyTypeRecreate DeploymentStrategyType = "Recreate" // DeploymentStrategyTypeCustom is a user defined strategy. DeploymentStrategyTypeCustom DeploymentStrategyType = "Custom" // DeploymentStrategyTypeRolling uses the Kubernetes RollingUpdater. DeploymentStrategyTypeRolling DeploymentStrategyType = "Rolling" )
type DeploymentTriggerImageChangeParams ¶
type DeploymentTriggerImageChangeParams struct { // Automatic means that the detection of a new tag value should result in an image update // inside the pod template. Automatic bool // ContainerNames is used to restrict tag updates to the specified set of container names in a pod. ContainerNames []string // From is a reference to an image stream tag to watch for changes. From.Name is the only // required subfield - if From.Namespace is blank, the namespace of the current deployment // trigger will be used. From kapi.ObjectReference // LastTriggeredImage is the last image to be triggered. LastTriggeredImage string }
DeploymentTriggerImageChangeParams represents the parameters to the ImageChange trigger.
type DeploymentTriggerPolicy ¶
type DeploymentTriggerPolicy struct { // Type of the trigger Type DeploymentTriggerType // ImageChangeParams represents the parameters for the ImageChange trigger. ImageChangeParams *DeploymentTriggerImageChangeParams }
DeploymentTriggerPolicy describes a policy for a single trigger that results in a new deployment.
type DeploymentTriggerType ¶
type DeploymentTriggerType string
DeploymentTriggerType refers to a specific DeploymentTriggerPolicy implementation.
const ( // DeploymentTriggerManual is a placeholder implementation which does nothing. DeploymentTriggerManual DeploymentTriggerType = "Manual" // DeploymentTriggerOnImageChange will create new deployments in response to updated tags from // a Docker image repository. DeploymentTriggerOnImageChange DeploymentTriggerType = "ImageChange" // DeploymentTriggerOnConfigChange will create new deployments in response to changes to // the ControllerTemplate of a DeploymentConfig. DeploymentTriggerOnConfigChange DeploymentTriggerType = "ConfigChange" )
type ExecNewPodHook ¶
type ExecNewPodHook struct { // Command is the action command and its arguments. Command []string // Env is a set of environment variables to supply to the hook pod's container. Env []kapi.EnvVar // ContainerName is the name of a container in the deployment pod template // whose Docker image will be used for the hook pod's container. ContainerName string // Volumes is a list of named volumes from the pod template which should be // copied to the hook pod. Volumes names not found in pod spec are ignored. // An empty list means no volumes will be copied. Volumes []string }
ExecNewPodHook is a hook implementation which runs a command in a new pod based on the specified container which is assumed to be part of the deployment template.
type LifecycleHook ¶
type LifecycleHook struct { // FailurePolicy specifies what action to take if the hook fails. FailurePolicy LifecycleHookFailurePolicy // ExecNewPod specifies the options for a lifecycle hook backed by a pod. ExecNewPod *ExecNewPodHook // TagImages instructs the deployer to tag the current image referenced under a container onto an image stream tag. TagImages []TagImageHook }
LifecycleHook defines a specific deployment lifecycle action. Only one type of action may be specified at any time.
type LifecycleHookFailurePolicy ¶
type LifecycleHookFailurePolicy string
LifecycleHookFailurePolicy describes possibles actions to take if a hook fails.
const ( // LifecycleHookFailurePolicyRetry means retry the hook until it succeeds. LifecycleHookFailurePolicyRetry LifecycleHookFailurePolicy = "Retry" // LifecycleHookFailurePolicyAbort means abort the deployment. LifecycleHookFailurePolicyAbort LifecycleHookFailurePolicy = "Abort" // LifecycleHookFailurePolicyIgnore means ignore failure and continue the deployment. LifecycleHookFailurePolicyIgnore LifecycleHookFailurePolicy = "Ignore" )
type RecreateDeploymentStrategyParams ¶
type RecreateDeploymentStrategyParams struct { // TimeoutSeconds is the time to wait for updates before giving up. If the // value is nil, a default will be used. TimeoutSeconds *int64 // Pre is a lifecycle hook which is executed before the strategy manipulates // the deployment. All LifecycleHookFailurePolicy values are supported. Pre *LifecycleHook // Mid is a lifecycle hook which is executed while the deployment is scaled down to zero before the first new // pod is created. All LifecycleHookFailurePolicy values are supported. Mid *LifecycleHook // Post is a lifecycle hook which is executed after the strategy has // finished all deployment logic. All LifecycleHookFailurePolicy values are supported. Post *LifecycleHook }
RecreateDeploymentStrategyParams are the input to the Recreate deployment strategy.
type RollingDeploymentStrategyParams ¶
type RollingDeploymentStrategyParams struct { // UpdatePeriodSeconds is the time to wait between individual pod updates. // If the value is nil, a default will be used. UpdatePeriodSeconds *int64 // IntervalSeconds is the time to wait between polling deployment status // after update. If the value is nil, a default will be used. IntervalSeconds *int64 // TimeoutSeconds is the time to wait for updates before giving up. If the // value is nil, a default will be used. TimeoutSeconds *int64 // during the update. 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 down. // // This cannot be 0 if MaxSurge is 0. By default, 25% 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 intstr.IntOrString // MaxSurge is 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%). Absolute // number is calculated from percentage by rounding up. // // This cannot be 0 if MaxUnavailable is 0. By default, 25% 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 intstr.IntOrString // Pre is a lifecycle hook which is executed before the deployment process // begins. All LifecycleHookFailurePolicy values are supported. Pre *LifecycleHook // Post is a lifecycle hook which is executed after the strategy has // finished all deployment logic. All LifecycleHookFailurePolicy values // are supported. Post *LifecycleHook }
RollingDeploymentStrategyParams are the input to the Rolling deployment strategy.
type TagImageHook ¶
type TagImageHook struct { // ContainerName is the name of a container in the deployment config whose image value will be used as the source of the tag. If there is only a single // container this value will be defaulted to the name of that container. ContainerName string // To is the target ImageStreamTag to set the container's image onto. To kapi.ObjectReference }
TagImageHook is a request to tag the image in a particular container onto an ImageStreamTag.
type TemplateImage ¶
type TemplateImage struct { Image string Ref *imageapi.DockerImageReference From *kapi.ObjectReference Container *kapi.Container }
TemplateImage is a structure for helping a caller iterate over a PodSpec
func IgnoreTriggers ¶
func IgnoreTriggers(container *kapi.Container) (TemplateImage, bool)
IgnoreTriggers ignores the triggers
func TemplateImageForContainer ¶
func TemplateImageForContainer(pod *kapi.PodSpec, triggerFn TriggeredByFunc, containerName string) (TemplateImage, error)
TemplateImageForContainer locates the requested container in a pod spec, returning information about the trigger (if it exists), or an error.
type TriggeredByFunc ¶
type TriggeredByFunc func(container *kapi.Container) (TemplateImage, bool)
TriggeredByFunc returns a TemplateImage or error from the provided container
func DeploymentConfigHasTrigger ¶
func DeploymentConfigHasTrigger(config *DeploymentConfig) TriggeredByFunc
DeploymentConfigHasTrigger returns a function that can identify the image for each container.
Source Files ¶
Directories ¶
Path | Synopsis |
---|---|
+groupName=apps.openshift.io Package v1 is the v1 version of the API.
|
+groupName=apps.openshift.io Package v1 is the v1 version of the API. |