Remove usage of deprecated v1beta API endpoints (#6543)

influxdata · Oct 23, 2019 · 47a708e · 47a708e
1 parent 988e036
commit 47a708e
Show file tree

Hide file tree

Showing 11 changed files with 107 additions and 96 deletions.
diff --git a/Gopkg.lock b/Gopkg.lock
diff --git a/plugins/inputs/kube_inventory/README.md b/plugins/inputs/kube_inventory/README.md
@@ -1,17 +1,25 @@
 # Kube_Inventory Plugin
+
 This plugin generates metrics derived from the state of the following Kubernetes resources:
- - daemonsets
- - deployments
- - nodes
- - persistentvolumes
- - persistentvolumeclaims
- - pods (containers)
- - statefulsets
+
+- daemonsets
+- deployments
+- nodes
+- persistentvolumes
+- persistentvolumeclaims
+- pods (containers)
+- statefulsets
+
+Kubernetes is a fast moving project, with a new minor release every 3 months. As
+such, we will aim to maintain support only for versions that are supported by
+the major cloud providers; this is roughly 4 release / 2 years.
+
+**This plugin supports Kubernetes 1.11 and later.**
 
 #### Series Cardinality Warning
 
 This plugin may produce a high number of series which, when not controlled
-for, will cause high load on your database.  Use the following techniques to
+for, will cause high load on your database. Use the following techniques to
 avoid cardinality issues:
 
 - Use [metric filtering][] options to exclude unneeded measurements and tags.
@@ -61,6 +69,7 @@ avoid cardinality issues:
 #### Kubernetes Permissions
 
 If using [RBAC authorization](https://kubernetes.io/docs/reference/access-authn-authz/rbac/), you will need to create a cluster role to list "persistentvolumes" and "nodes". You will then need to make an [aggregated ClusterRole](https://kubernetes.io/docs/reference/access-authn-authz/rbac/#aggregated-clusterroles) that will eventually be bound to a user or group.
+
 ```yaml
 ---
 kind: ClusterRole
@@ -70,9 +79,9 @@ metadata:
   labels:
     rbac.authorization.k8s.io/aggregate-view-telegraf: "true"
 rules:
-- apiGroups: [""]
-  resources: ["persistentvolumes","nodes"]
-  verbs: ["get","list"]
+  - apiGroups: [""]
+    resources: ["persistentvolumes", "nodes"]
+    verbs: ["get", "list"]
 
 ---
 kind: ClusterRole
@@ -81,14 +90,15 @@ metadata:
   name: influx:telegraf
 aggregationRule:
   clusterRoleSelectors:
-  - matchLabels:
-      rbac.authorization.k8s.io/aggregate-view-telegraf: "true"
-  - matchLabels:
-      rbac.authorization.k8s.io/aggregate-to-view: "true"
+    - matchLabels:
+        rbac.authorization.k8s.io/aggregate-view-telegraf: "true"
+    - matchLabels:
+        rbac.authorization.k8s.io/aggregate-to-view: "true"
 rules: [] # Rules are automatically filled in by the controller manager.
 ```
 
 Bind the newly created aggregated ClusterRole with the following config file, updating the subjects as needed.
+
 ```yaml
 ---
 apiVersion: rbac.authorization.k8s.io/v1
@@ -100,15 +110,14 @@ roleRef:
   kind: ClusterRole
   name: influx:telegraf
 subjects:
-- kind: ServiceAccount
-  name: telegraf
-  namespace: default
+  - kind: ServiceAccount
+    name: telegraf
+    namespace: default
 ```
 
-
 ### Metrics:
 
-+ kubernetes_daemonset
+- kubernetes_daemonset
   - tags:
     - daemonset_name
     - namespace
@@ -122,7 +131,7 @@ subjects:
     - number_unavailable
     - updated_number_scheduled
 
-- kubernetes_deployment
+* kubernetes_deployment
   - tags:
     - deployment_name
     - namespace
@@ -131,22 +140,22 @@ subjects:
     - replicas_unavailable
     - created
 
-+ kubernetes_endpoints
+- kubernetes_endpoints
   - tags:
     - endpoint_name
     - namespace
     - hostname
     - node_name
     - port_name
     - port_protocol
-    - kind (*varies)
+    - kind (\*varies)
   - fields:
     - created
     - generation
     - ready
     - port
 
-- kubernetes_ingress
+* kubernetes_ingress
   - tags:
     - ingress_name
     - namespace
@@ -161,7 +170,7 @@ subjects:
     - backend_service_port
     - tls
 
-+ kubernetes_node
+- kubernetes_node
   - tags:
     - node_name
   - fields:
@@ -172,15 +181,15 @@ subjects:
     - allocatable_memory_bytes
     - allocatable_pods
 
-- kubernetes_persistentvolume
+* kubernetes_persistentvolume
   - tags:
     - pv_name
     - phase
     - storageclass
   - fields:
     - phase_type (int, [see below](#pv-phase_type))
 
-+ kubernetes_persistentvolumeclaim
+- kubernetes_persistentvolumeclaim
   - tags:
     - pvc_name
     - namespace
@@ -189,7 +198,7 @@ subjects:
   - fields:
     - phase_type (int, [see below](#pvc-phase_type))
 
-- kubernetes_pod_container
+* kubernetes_pod_container
   - tags:
     - container_name
     - namespace
@@ -204,7 +213,7 @@ subjects:
     - resource_limits_cpu_units
     - resource_limits_memory_bytes
 
-+ kubernetes_service
+- kubernetes_service
   - tags:
     - service_name
     - namespace
@@ -218,7 +227,7 @@ subjects:
     - port
     - target_port
 
-- kubernetes_statefulset
+* kubernetes_statefulset
   - tags:
     - statefulset_name
     - namespace
@@ -236,26 +245,25 @@ subjects:
 
 The persistentvolume "phase" is saved in the `phase` tag with a correlated numeric field called `phase_type` corresponding with that tag value.
 
-|Tag value |Corresponding field value|
------------|-------------------------|
-|bound     | 0                       |
-|failed    | 1                       |
-|pending   | 2                       |
-|released  | 3                       |
-|available | 4                       |
-|unknown   | 5                       |
+| Tag value | Corresponding field value |
+| --------- | ------------------------- |
+| bound     | 0                         |
+| failed    | 1                         |
+| pending   | 2                         |
+| released  | 3                         |
+| available | 4                         |
+| unknown   | 5                         |
 
 #### pvc `phase_type`
 
 The persistentvolumeclaim "phase" is saved in the `phase` tag with a correlated numeric field called `phase_type` corresponding with that tag value.
 
-|Tag value |Corresponding field value|
------------|-------------------------|
-|bound     | 0                       |
-|lost      | 1                       |
-|pending   | 2                       |
-|unknown   | 3                       |
-
+| Tag value | Corresponding field value |
+| --------- | ------------------------- |
+| bound     | 0                         |
+| lost      | 1                         |
+| pending   | 2                         |
+| unknown   | 3                         |
 
 ### Example Output:
 
@@ -271,7 +279,6 @@ kubernetes_pod_container,container_name=telegraf,namespace=default,node_name=ip-
 kubernetes_statefulset,namespace=default,statefulset_name=etcd replicas_updated=3i,spec_replicas=3i,observed_generation=1i,created=1544101669000000000i,generation=1i,replicas=3i,replicas_current=3i,replicas_ready=3i 1547597616000000000
 ```
 
-
 [metric filtering]: https://github.com/influxdata/telegraf/blob/master/docs/CONFIGURATION.md#metric-filtering
 [retention policy]: https://docs.influxdata.com/influxdb/latest/guides/downsampling_and_retention/
 [max-series-per-database]: https://docs.influxdata.com/influxdb/latest/administration/config/#max-series-per-database-1000000

diff --git a/plugins/inputs/kube_inventory/client.go b/plugins/inputs/kube_inventory/client.go
@@ -5,9 +5,8 @@ import (
 	"time"
 
 	"github.com/ericchiang/k8s"
-	"github.com/ericchiang/k8s/apis/apps/v1beta1"
-	"github.com/ericchiang/k8s/apis/apps/v1beta2"
-	"github.com/ericchiang/k8s/apis/core/v1"
+	v1APPS "github.com/ericchiang/k8s/apis/apps/v1"
+	v1 "github.com/ericchiang/k8s/apis/core/v1"
 	v1beta1EXT "github.com/ericchiang/k8s/apis/extensions/v1beta1"
 
 	"github.com/influxdata/telegraf/internal/tls"
@@ -48,15 +47,15 @@ func newClient(baseURL, namespace, bearerToken string, timeout time.Duration, tl
 	}, nil
 }
 
-func (c *client) getDaemonSets(ctx context.Context) (*v1beta2.DaemonSetList, error) {
-	list := new(v1beta2.DaemonSetList)
+func (c *client) getDaemonSets(ctx context.Context) (*v1APPS.DaemonSetList, error) {
+	list := new(v1APPS.DaemonSetList)
 	ctx, cancel := context.WithTimeout(ctx, c.timeout)
 	defer cancel()
 	return list, c.List(ctx, c.namespace, list)
 }
 
-func (c *client) getDeployments(ctx context.Context) (*v1beta1.DeploymentList, error) {
-	list := &v1beta1.DeploymentList{}
+func (c *client) getDeployments(ctx context.Context) (*v1APPS.DeploymentList, error) {
+	list := &v1APPS.DeploymentList{}
 	ctx, cancel := context.WithTimeout(ctx, c.timeout)
 	defer cancel()
 	return list, c.List(ctx, c.namespace, list)
@@ -111,8 +110,8 @@ func (c *client) getServices(ctx context.Context) (*v1.ServiceList, error) {
 	return list, c.List(ctx, c.namespace, list)
 }
 
-func (c *client) getStatefulSets(ctx context.Context) (*v1beta1.StatefulSetList, error) {
-	list := new(v1beta1.StatefulSetList)
+func (c *client) getStatefulSets(ctx context.Context) (*v1APPS.StatefulSetList, error) {
+	list := new(v1APPS.StatefulSetList)
 	ctx, cancel := context.WithTimeout(ctx, c.timeout)
 	defer cancel()
 	return list, c.List(ctx, c.namespace, list)

diff --git a/plugins/inputs/kube_inventory/daemonset.go b/plugins/inputs/kube_inventory/daemonset.go
@@ -4,7 +4,7 @@ import (
 	"context"
 	"time"
 
-	"github.com/ericchiang/k8s/apis/apps/v1beta2"
+	"github.com/ericchiang/k8s/apis/apps/v1"
 
 	"github.com/influxdata/telegraf"
 )
@@ -23,7 +23,7 @@ func collectDaemonSets(ctx context.Context, acc telegraf.Accumulator, ki *Kubern
 	}
 }
 
-func (ki *KubernetesInventory) gatherDaemonSet(d v1beta2.DaemonSet, acc telegraf.Accumulator) error {
+func (ki *KubernetesInventory) gatherDaemonSet(d v1.DaemonSet, acc telegraf.Accumulator) error {
 	fields := map[string]interface{}{
 		"generation":               d.Metadata.GetGeneration(),
 		"current_number_scheduled": d.Status.GetCurrentNumberScheduled(),

diff --git a/plugins/inputs/kube_inventory/daemonset_test.go b/plugins/inputs/kube_inventory/daemonset_test.go
@@ -4,7 +4,7 @@ import (
 	"testing"
 	"time"
 
-	"github.com/ericchiang/k8s/apis/apps/v1beta2"
+	"github.com/ericchiang/k8s/apis/apps/v1"
 	metav1 "github.com/ericchiang/k8s/apis/meta/v1"
 
 	"github.com/influxdata/telegraf/testutil"
@@ -24,7 +24,7 @@ func TestDaemonSet(t *testing.T) {
 			name: "no daemon set",
 			handler: &mockHandler{
 				responseMap: map[string]interface{}{
-					"/daemonsets/": &v1beta2.DaemonSetList{},
+					"/daemonsets/": &v1.DaemonSetList{},
 				},
 			},
 			hasError: false,
@@ -33,10 +33,10 @@ func TestDaemonSet(t *testing.T) {
 			name: "collect daemonsets",
 			handler: &mockHandler{
 				responseMap: map[string]interface{}{
-					"/daemonsets/": &v1beta2.DaemonSetList{
-						Items: []*v1beta2.DaemonSet{
+					"/daemonsets/": &v1.DaemonSetList{
+						Items: []*v1.DaemonSet{
 							{
-								Status: &v1beta2.DaemonSetStatus{
+								Status: &v1.DaemonSetStatus{
 									CurrentNumberScheduled: toInt32Ptr(3),
 									DesiredNumberScheduled: toInt32Ptr(5),
 									NumberAvailable:        toInt32Ptr(2),
@@ -90,7 +90,7 @@ func TestDaemonSet(t *testing.T) {
 			client: cli,
 		}
 		acc := new(testutil.Accumulator)
-		for _, dset := range ((v.handler.responseMap["/daemonsets/"]).(*v1beta2.DaemonSetList)).Items {
+		for _, dset := range ((v.handler.responseMap["/daemonsets/"]).(*v1.DaemonSetList)).Items {
 			err := ks.gatherDaemonSet(*dset, acc)
 			if err != nil {
 				t.Errorf("Failed to gather daemonset - %s", err.Error())

diff --git a/plugins/inputs/kube_inventory/deployment.go b/plugins/inputs/kube_inventory/deployment.go
@@ -4,8 +4,7 @@ import (
 	"context"
 	"time"
 
-	"github.com/ericchiang/k8s/apis/apps/v1beta1"
-
+	v1 "github.com/ericchiang/k8s/apis/apps/v1"
 	"github.com/influxdata/telegraf"
 )
 
@@ -23,7 +22,7 @@ func collectDeployments(ctx context.Context, acc telegraf.Accumulator, ki *Kuber
 	}
 }
 
-func (ki *KubernetesInventory) gatherDeployment(d v1beta1.Deployment, acc telegraf.Accumulator) error {
+func (ki *KubernetesInventory) gatherDeployment(d v1.Deployment, acc telegraf.Accumulator) error {
 	fields := map[string]interface{}{
 		"replicas_available":   d.Status.GetAvailableReplicas(),
 		"replicas_unavailable": d.Status.GetUnavailableReplicas(),