5.2. Kubernetes API の非推奨化と削除

• APIRemovedInNextReleaseInUse: OpenShift Container Platform の次のリリースで削除される API の場合
• APIRemovedInNextEUSReleaseInUse: 次の OpenShift Container Platform Extended Update Support (EUS) リリースで削除される API の場合

前提条件

• cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。

手順

• 以下のコマンドを実行し、出力された REMOVEDINRELEASE 列を確認して、現在使用中の削除された API を特定します。

  $ oc get apirequestcounts

  出力例

  NAME                                                                      REMOVEDINRELEASE   REQUESTSINCURRENTHOUR   REQUESTSINLAST24H
  ...
  flowschemas.v1beta1.flowcontrol.apiserver.k8s.io                          1.26               0                       16
  flowschemas.v1beta2.flowcontrol.apiserver.k8s.io                                             101                     857
  groups.v1.user.openshift.io                                                                  22                      201
  hardwaredata.v1alpha1.metal3.io                                                              3                       33
  helmchartrepositories.v1beta1.helm.openshift.io                                              142                     628
  horizontalpodautoscalers.v2.autoscaling                                                      11                      103
  horizontalpodautoscalers.v2beta2.autoscaling                              1.26               0                       15
  ...

  重要

  結果に表示される以下のエントリーは無視しても問題はありません。

  • system:serviceaccount:kube-system:generic-garbage-collector および system:serviceaccount:kube-system:namespace-controller ユーザーは、削除するリソースの検索時に登録されたすべての API を呼び出すので、結果に表示される可能性があります。
  • system:kube-controller-manager および system:cluster-policy-controller ユーザーは、さまざまなポリシーを適用しながらすべてのリソースをウォークスルーするため、結果に表示される場合があります。

  -o jsonpath を使用して結果をフィルタリングすることもできます。

  $ oc get apirequestcounts -o jsonpath='{range .items[?(@.status.removedInRelease!="")]}{.status.removedInRelease}{"\t"}{.metadata.name}{"\n"}{end}'

  出力例

  1.26	flowschemas.v1beta1.flowcontrol.apiserver.k8s.io
  1.26	horizontalpodautoscalers.v2beta2.autoscaling

前提条件

• cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。

手順

• 以下のコマンドを実行して username および userAgent を確認すると、API を使用しているワークロードの特定に役立ちます。

  $ oc get apirequestcounts <resource>.<version>.<group> -o yaml

  以下に例を示します。

  $ oc get apirequestcounts flowschemas.v1beta1.flowcontrol.apiserver.k8s.io -o yaml

  -o jsonpath を使用して、APIRequestCount リソースから username および userAgent の値を抽出することもできます。

  $ oc get apirequestcounts flowschemas.v1beta1.flowcontrol.apiserver.k8s.io \
    -o jsonpath='{range .status.currentHour..byUser[*]}{..byVerb[*].verb}{","}{.username}{","}{.userAgent}{"\n"}{end}' \
    | sort -k 2 -t, -u | column -t -s, -NVERBS,USERNAME,USERAGENT

  出力例

  VERBS  USERNAME                                                            USERAGENT
  get    system:serviceaccount:openshift-cluster-version:default             cluster-version-operator/v0.0.0
  watch  system:serviceaccount:openshift-oauth-apiserver:oauth-apiserver-sa  oauth-apiserver/v0.0.0