diff --git a/pkg/apis/operations/v1alpha2/register.go b/pkg/apis/operations/v1alpha2/register.go index 5b7611e05f160dd3d355c67ec49b3e66f218df4c..4f54a332f66707778c76e46f395587768a0db54e 100644 --- a/pkg/apis/operations/v1alpha2/register.go +++ b/pkg/apis/operations/v1alpha2/register.go @@ -43,7 +43,7 @@ func addWebService(c *restful.Container) error { webservice.Route(webservice.POST("/nodes/{node}/drainage"). To(operations.DrainNode). Deprecate(). - Doc("Drain node"). + Doc("remove a node from service, safely evict all of your pods from a node and you can power down the node. More info: https://kubernetes.io/docs/tasks/administer-cluster/safely-drain-node/"). Param(webservice.PathParameter("node", "node name")). Returns(http.StatusOK, ok, errors.Error{})) diff --git a/pkg/apis/resources/v1alpha2/register.go b/pkg/apis/resources/v1alpha2/register.go index 5556001b94a7bd5110267c7af00991e965747afa..83e863aa4a4fac51b8489fc16318be81d29262f6 100644 --- a/pkg/apis/resources/v1alpha2/register.go +++ b/pkg/apis/resources/v1alpha2/register.go @@ -106,7 +106,7 @@ func addWebService(c *restful.Container) error { webservice.Route(webservice.POST("/nodes/{node}/drainage"). To(operations.DrainNode). Metadata(restfulspec.KeyOpenAPITags, []string{constants.ClusterResourcesTag}). - Doc("Drain node"). + Doc("remove a node from service, safely evict all of your pods from a node and you can power down the node. More info: https://kubernetes.io/docs/tasks/administer-cluster/safely-drain-node/"). Param(webservice.PathParameter("node", "node name")). Returns(http.StatusOK, ok, errors.Error{})) diff --git a/pkg/models/status/status.go b/pkg/models/status/status.go index 040f09499d176e3adcfda436f30eb23205336354..269726827efbf41f117b5afeca0f78357cce46ef 100644 --- a/pkg/models/status/status.go +++ b/pkg/models/status/status.go @@ -27,8 +27,8 @@ import ( ) type WorkLoadStatus struct { - Namespace string `json:"namespace" description:"namespace"` - Count map[string]int `json:"data" description:"unhealthy workload count"` + Namespace string `json:"namespace" description:"the name of the namespace"` + Count map[string]int `json:"data" description:"the number of unhealthy workloads"` Items map[string]interface{} `json:"items,omitempty" description:"unhealthy workloads"` } diff --git a/pkg/models/types.go b/pkg/models/types.go index b4c0e95fa02ad0aa48d5e3747281287a48c08ac7..3916d6cb79b9d022a2dc7eaaeea7246feadd4a11 100644 --- a/pkg/models/types.go +++ b/pkg/models/types.go @@ -83,16 +83,16 @@ type Group struct { type ComponentStatus struct { Name string `json:"name" description:"component name"` - Namespace string `json:"namespace" description:"namespace"` + Namespace string `json:"namespace" description:"the name of the namespace"` SelfLink string `json:"selfLink" description:"self link"` Label interface{} `json:"label" description:"labels"` StartedAt time.Time `json:"startedAt" description:"started time"` - TotalBackends int `json:"totalBackends" description:"total backends"` - HealthyBackends int `json:"healthyBackends" description:"healthy backends"` + TotalBackends int `json:"totalBackends" description:"the total replicas of each backend system component"` + HealthyBackends int `json:"healthyBackends" description:"the number of healthy backend components"` } type NodeStatus struct { TotalNodes int `json:"totalNodes" description:"total number of nodes"` - HealthyNodes int `json:"healthyNodes" description:"number of healthy nodes"` + HealthyNodes int `json:"healthyNodes" description:"the number of healthy nodes"` } type HealthStatus struct {