...

Source file src/github.com/openshift/api/apps/v1/zz_generated.swagger_doc_generated.go

Documentation: github.com/openshift/api/apps/v1

     1  package v1
     2  
     3  // This file contains a collection of methods that can be used from go-restful to
     4  // generate Swagger API documentation for its models. Please read this PR for more
     5  // information on the implementation: https://github.com/emicklei/go-restful/pull/215
     6  //
     7  // TODOs are ignored from the parser (e.g. TODO(andronat):... || TODO:...) if and only if
     8  // they are on one line! For multiple line or blocks that you want to ignore use ---.
     9  // Any context after a --- is ignored.
    10  //
    11  // Those methods can be generated by using hack/update-swagger-docs.sh
    12  
    13  // AUTO-GENERATED FUNCTIONS START HERE
    14  var map_CustomDeploymentStrategyParams = map[string]string{
    15  	"":            "CustomDeploymentStrategyParams are the input to the Custom deployment strategy.",
    16  	"image":       "Image specifies a container image which can carry out a deployment.",
    17  	"environment": "Environment holds the environment which will be given to the container for Image.",
    18  	"command":     "Command is optional and overrides CMD in the container Image.",
    19  }
    20  
    21  func (CustomDeploymentStrategyParams) SwaggerDoc() map[string]string {
    22  	return map_CustomDeploymentStrategyParams
    23  }
    24  
    25  var map_DeploymentCause = map[string]string{
    26  	"":             "DeploymentCause captures information about a particular cause of a deployment.",
    27  	"type":         "Type of the trigger that resulted in the creation of a new deployment",
    28  	"imageTrigger": "ImageTrigger contains the image trigger details, if this trigger was fired based on an image change",
    29  }
    30  
    31  func (DeploymentCause) SwaggerDoc() map[string]string {
    32  	return map_DeploymentCause
    33  }
    34  
    35  var map_DeploymentCauseImageTrigger = map[string]string{
    36  	"":     "DeploymentCauseImageTrigger represents details about the cause of a deployment originating from an image change trigger",
    37  	"from": "From is a reference to the changed object which triggered a deployment. The field may have the kinds DockerImage, ImageStreamTag, or ImageStreamImage.",
    38  }
    39  
    40  func (DeploymentCauseImageTrigger) SwaggerDoc() map[string]string {
    41  	return map_DeploymentCauseImageTrigger
    42  }
    43  
    44  var map_DeploymentCondition = map[string]string{
    45  	"":                   "DeploymentCondition describes the state of a deployment config at a certain point.",
    46  	"type":               "Type of deployment condition.",
    47  	"status":             "Status of the condition, one of True, False, Unknown.",
    48  	"lastUpdateTime":     "The last time this condition was updated.",
    49  	"lastTransitionTime": "The last time the condition transitioned from one status to another.",
    50  	"reason":             "The reason for the condition's last transition.",
    51  	"message":            "A human readable message indicating details about the transition.",
    52  }
    53  
    54  func (DeploymentCondition) SwaggerDoc() map[string]string {
    55  	return map_DeploymentCondition
    56  }
    57  
    58  var map_DeploymentConfig = map[string]string{
    59  	"":         "Deployment Configs define the template for a pod and manages deploying new images or configuration changes. A single deployment configuration is usually analogous to a single micro-service. Can support many different deployment patterns, including full restart, customizable rolling updates, and  fully custom behaviors, as well as pre- and post- deployment hooks. Each individual deployment is represented as a replication controller.\n\nA deployment is \"triggered\" when its configuration is changed or a tag in an Image Stream is changed. Triggers can be disabled to allow manual control over a deployment. The \"strategy\" determines how the deployment is carried out and may be changed at any time. The `latestVersion` field is updated when a new deployment is triggered by any means.\n\nCompatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).",
    60  	"metadata": "metadata is the standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata",
    61  	"spec":     "Spec represents a desired deployment state and how to deploy to it.",
    62  	"status":   "Status represents the current deployment state.",
    63  }
    64  
    65  func (DeploymentConfig) SwaggerDoc() map[string]string {
    66  	return map_DeploymentConfig
    67  }
    68  
    69  var map_DeploymentConfigList = map[string]string{
    70  	"":         "DeploymentConfigList is a collection of deployment configs.\n\nCompatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).",
    71  	"metadata": "metadata is the standard list's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata",
    72  	"items":    "Items is a list of deployment configs",
    73  }
    74  
    75  func (DeploymentConfigList) SwaggerDoc() map[string]string {
    76  	return map_DeploymentConfigList
    77  }
    78  
    79  var map_DeploymentConfigRollback = map[string]string{
    80  	"":                   "DeploymentConfigRollback provides the input to rollback generation.\n\nCompatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).",
    81  	"name":               "Name of the deployment config that will be rolled back.",
    82  	"updatedAnnotations": "UpdatedAnnotations is a set of new annotations that will be added in the deployment config.",
    83  	"spec":               "Spec defines the options to rollback generation.",
    84  }
    85  
    86  func (DeploymentConfigRollback) SwaggerDoc() map[string]string {
    87  	return map_DeploymentConfigRollback
    88  }
    89  
    90  var map_DeploymentConfigRollbackSpec = map[string]string{
    91  	"":                       "DeploymentConfigRollbackSpec represents the options for rollback generation.",
    92  	"from":                   "From points to a ReplicationController which is a deployment.",
    93  	"revision":               "Revision to rollback to. If set to 0, rollback to the last revision.",
    94  	"includeTriggers":        "IncludeTriggers specifies whether to include config Triggers.",
    95  	"includeTemplate":        "IncludeTemplate specifies whether to include the PodTemplateSpec.",
    96  	"includeReplicationMeta": "IncludeReplicationMeta specifies whether to include the replica count and selector.",
    97  	"includeStrategy":        "IncludeStrategy specifies whether to include the deployment Strategy.",
    98  }
    99  
   100  func (DeploymentConfigRollbackSpec) SwaggerDoc() map[string]string {
   101  	return map_DeploymentConfigRollbackSpec
   102  }
   103  
   104  var map_DeploymentConfigSpec = map[string]string{
   105  	"":                     "DeploymentConfigSpec represents the desired state of the deployment.",
   106  	"strategy":             "Strategy describes how a deployment is executed.",
   107  	"minReadySeconds":      "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)",
   108  	"triggers":             "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. If null, defaults to having a config change trigger.",
   109  	"replicas":             "Replicas is the number of desired replicas.",
   110  	"revisionHistoryLimit": "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. Defaults to 10. (This only applies to DeploymentConfigs created via the new group API resource, not the legacy resource.)",
   111  	"test":                 "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.",
   112  	"paused":               "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.",
   113  	"selector":             "Selector is a label query over pods that should match the Replicas count.",
   114  	"template":             "Template is the object that describes the pod that will be created if insufficient replicas are detected.",
   115  }
   116  
   117  func (DeploymentConfigSpec) SwaggerDoc() map[string]string {
   118  	return map_DeploymentConfigSpec
   119  }
   120  
   121  var map_DeploymentConfigStatus = map[string]string{
   122  	"":                    "DeploymentConfigStatus represents the current deployment state.",
   123  	"latestVersion":       "LatestVersion is used to determine whether the current deployment associated with a deployment config is out of sync.",
   124  	"observedGeneration":  "ObservedGeneration is the most recent generation observed by the deployment config controller.",
   125  	"replicas":            "Replicas is the total number of pods targeted by this deployment config.",
   126  	"updatedReplicas":     "UpdatedReplicas is the total number of non-terminated pods targeted by this deployment config that have the desired template spec.",
   127  	"availableReplicas":   "AvailableReplicas is the total number of available pods targeted by this deployment config.",
   128  	"unavailableReplicas": "UnavailableReplicas is the total number of unavailable pods targeted by this deployment config.",
   129  	"details":             "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",
   130  	"conditions":          "Conditions represents the latest available observations of a deployment config's current state.",
   131  	"readyReplicas":       "Total number of ready pods targeted by this deployment.",
   132  }
   133  
   134  func (DeploymentConfigStatus) SwaggerDoc() map[string]string {
   135  	return map_DeploymentConfigStatus
   136  }
   137  
   138  var map_DeploymentDetails = map[string]string{
   139  	"":        "DeploymentDetails captures information about the causes of a deployment.",
   140  	"message": "Message is the user specified change message, if this deployment was triggered manually by the user",
   141  	"causes":  "Causes are extended data associated with all the causes for creating a new deployment",
   142  }
   143  
   144  func (DeploymentDetails) SwaggerDoc() map[string]string {
   145  	return map_DeploymentDetails
   146  }
   147  
   148  var map_DeploymentLog = map[string]string{
   149  	"": "DeploymentLog represents the logs for a deployment\n\nCompatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).",
   150  }
   151  
   152  func (DeploymentLog) SwaggerDoc() map[string]string {
   153  	return map_DeploymentLog
   154  }
   155  
   156  var map_DeploymentLogOptions = map[string]string{
   157  	"":             "DeploymentLogOptions is the REST options for a deployment log\n\nCompatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).",
   158  	"container":    "The container for which to stream logs. Defaults to only container if there is one container in the pod.",
   159  	"follow":       "Follow if true indicates that the build log should be streamed until the build terminates.",
   160  	"previous":     "Return previous deployment logs. Defaults to false.",
   161  	"sinceSeconds": "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.",
   162  	"sinceTime":    "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.",
   163  	"timestamps":   "If true, add an RFC3339 or RFC3339Nano timestamp at the beginning of every line of log output. Defaults to false.",
   164  	"tailLines":    "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",
   165  	"limitBytes":   "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.",
   166  	"nowait":       "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.",
   167  	"version":      "Version of the deployment for which to view logs.",
   168  }
   169  
   170  func (DeploymentLogOptions) SwaggerDoc() map[string]string {
   171  	return map_DeploymentLogOptions
   172  }
   173  
   174  var map_DeploymentRequest = map[string]string{
   175  	"":                "DeploymentRequest is a request to a deployment config for a new deployment.\n\nCompatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).",
   176  	"name":            "Name of the deployment config for requesting a new deployment.",
   177  	"latest":          "Latest will update the deployment config with the latest state from all triggers.",
   178  	"force":           "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.",
   179  	"excludeTriggers": "ExcludeTriggers instructs the instantiator to avoid processing the specified triggers. This field overrides the triggers from latest and allows clients to control specific logic. This field is ignored if not specified.",
   180  }
   181  
   182  func (DeploymentRequest) SwaggerDoc() map[string]string {
   183  	return map_DeploymentRequest
   184  }
   185  
   186  var map_DeploymentStrategy = map[string]string{
   187  	"":                      "DeploymentStrategy describes how to perform a deployment.",
   188  	"type":                  "Type is the name of a deployment strategy.",
   189  	"customParams":          "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.",
   190  	"recreateParams":        "RecreateParams are the input to the Recreate deployment strategy.",
   191  	"rollingParams":         "RollingParams are the input to the Rolling deployment strategy.",
   192  	"resources":             "Resources contains resource requirements to execute the deployment and any hooks.",
   193  	"labels":                "Labels is a set of key, value pairs added to custom deployer and lifecycle pre/post hook pods.",
   194  	"annotations":           "Annotations is a set of key, value pairs added to custom deployer and lifecycle pre/post hook pods.",
   195  	"activeDeadlineSeconds": "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.",
   196  }
   197  
   198  func (DeploymentStrategy) SwaggerDoc() map[string]string {
   199  	return map_DeploymentStrategy
   200  }
   201  
   202  var map_DeploymentTriggerImageChangeParams = map[string]string{
   203  	"":                   "DeploymentTriggerImageChangeParams represents the parameters to the ImageChange trigger.",
   204  	"automatic":          "Automatic means that the detection of a new tag value should result in an image update inside the pod template.",
   205  	"containerNames":     "ContainerNames is used to restrict tag updates to the specified set of container names in a pod. If multiple triggers point to the same containers, the resulting behavior is undefined. Future API versions will make this a validation error. If ContainerNames does not point to a valid container, the trigger will be ignored. Future API versions will make this a validation error.",
   206  	"from":               "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.",
   207  	"lastTriggeredImage": "LastTriggeredImage is the last image to be triggered.",
   208  }
   209  
   210  func (DeploymentTriggerImageChangeParams) SwaggerDoc() map[string]string {
   211  	return map_DeploymentTriggerImageChangeParams
   212  }
   213  
   214  var map_DeploymentTriggerPolicy = map[string]string{
   215  	"":                  "DeploymentTriggerPolicy describes a policy for a single trigger that results in a new deployment.",
   216  	"type":              "Type of the trigger",
   217  	"imageChangeParams": "ImageChangeParams represents the parameters for the ImageChange trigger.",
   218  }
   219  
   220  func (DeploymentTriggerPolicy) SwaggerDoc() map[string]string {
   221  	return map_DeploymentTriggerPolicy
   222  }
   223  
   224  var map_ExecNewPodHook = map[string]string{
   225  	"":              "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.",
   226  	"command":       "Command is the action command and its arguments.",
   227  	"env":           "Env is a set of environment variables to supply to the hook pod's container.",
   228  	"containerName": "ContainerName is the name of a container in the deployment pod template whose container image will be used for the hook pod's container.",
   229  	"volumes":       "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.",
   230  }
   231  
   232  func (ExecNewPodHook) SwaggerDoc() map[string]string {
   233  	return map_ExecNewPodHook
   234  }
   235  
   236  var map_LifecycleHook = map[string]string{
   237  	"":              "LifecycleHook defines a specific deployment lifecycle action. Only one type of action may be specified at any time.",
   238  	"failurePolicy": "FailurePolicy specifies what action to take if the hook fails.",
   239  	"execNewPod":    "ExecNewPod specifies the options for a lifecycle hook backed by a pod.",
   240  	"tagImages":     "TagImages instructs the deployer to tag the current image referenced under a container onto an image stream tag.",
   241  }
   242  
   243  func (LifecycleHook) SwaggerDoc() map[string]string {
   244  	return map_LifecycleHook
   245  }
   246  
   247  var map_RecreateDeploymentStrategyParams = map[string]string{
   248  	"":               "RecreateDeploymentStrategyParams are the input to the Recreate deployment strategy.",
   249  	"timeoutSeconds": "TimeoutSeconds is the time to wait for updates before giving up. If the value is nil, a default will be used.",
   250  	"pre":            "Pre is a lifecycle hook which is executed before the strategy manipulates the deployment. All LifecycleHookFailurePolicy values are supported.",
   251  	"mid":            "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.",
   252  	"post":           "Post is a lifecycle hook which is executed after the strategy has finished all deployment logic. All LifecycleHookFailurePolicy values are supported.",
   253  }
   254  
   255  func (RecreateDeploymentStrategyParams) SwaggerDoc() map[string]string {
   256  	return map_RecreateDeploymentStrategyParams
   257  }
   258  
   259  var map_RollingDeploymentStrategyParams = map[string]string{
   260  	"":                    "RollingDeploymentStrategyParams are the input to the Rolling deployment strategy.",
   261  	"updatePeriodSeconds": "UpdatePeriodSeconds is the time to wait between individual pod updates. If the value is nil, a default will be used.",
   262  	"intervalSeconds":     "IntervalSeconds is the time to wait between polling deployment status after update. If the value is nil, a default will be used.",
   263  	"timeoutSeconds":      "TimeoutSeconds is the time to wait for updates before giving up. If the value is nil, a default will be used.",
   264  	"maxUnavailable":      "MaxUnavailable is the maximum number of pods that can be unavailable 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.\n\nThis cannot be 0 if MaxSurge is 0. By default, 25% is used.\n\nExample: 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.",
   265  	"maxSurge":            "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.\n\nThis cannot be 0 if MaxUnavailable is 0. By default, 25% is used.\n\nExample: 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.",
   266  	"pre":                 "Pre is a lifecycle hook which is executed before the deployment process begins. All LifecycleHookFailurePolicy values are supported.",
   267  	"post":                "Post is a lifecycle hook which is executed after the strategy has finished all deployment logic. All LifecycleHookFailurePolicy values are supported.",
   268  }
   269  
   270  func (RollingDeploymentStrategyParams) SwaggerDoc() map[string]string {
   271  	return map_RollingDeploymentStrategyParams
   272  }
   273  
   274  var map_TagImageHook = map[string]string{
   275  	"":              "TagImageHook is a request to tag the image in a particular container onto an ImageStreamTag.",
   276  	"containerName": "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.",
   277  	"to":            "To is the target ImageStreamTag to set the container's image onto.",
   278  }
   279  
   280  func (TagImageHook) SwaggerDoc() map[string]string {
   281  	return map_TagImageHook
   282  }
   283  
   284  // AUTO-GENERATED FUNCTIONS END HERE
   285  

View as plain text