Container Service for Kubernetes:Usage notes and risky operations

項目

参照

使用上の注意

• データプレーンコンポーネント

• クラスターのアップグレード

• ネイティブ Kubernetes の設定

• Serverless Kubernetes クラスター

• 登録済みクラスター

• アプリカタログ

リスクの高い操作

• クラスターに関連するリスクの高い操作

• ノードプールに関連するリスクの高い操作

• ネットワーキングとロードバランシングに関連するリスクの高い操作

• ストレージに関連するリスクの高い操作

• ログに関連するリスクの高い操作

分類

リスクの高い操作

影響

回復計画

API サーバー

API サーバーが使用する SLB インスタンスを他のシナリオで再利用する (例：LoadBalancer サービスで SLB インスタンスを再利用する)。

クラスターが利用不可になり、サービスのトラフィックに影響します。

元の構成に戻すか、アフターサービスサポートに依頼してください。

API サーバーが使用する SLB インスタンスのリスナー、vServer グループ、アクセス制御リスト (ACL)、またはタグ構成を変更する。これらの構成は SLB の転送を制御します。

クラスターが異常になります。

元の構成に戻してください。

API サーバーが使用する SLB インスタンスを削除する。

クラスターが操作不能になります。

復旧不可。クラスターを再作成してください。詳細については、「ACK マネージドクラスターの作成」をご参照ください。

ワーカーノード

クラスター内のノードのセキュリティグループを変更する。

ノードが利用できなくなる可能性があります。

クラスター用に自動作成されたセキュリティグループにノードを再度追加してください。詳細については、「インスタンス (プライマリ ENI) とセキュリティグループの関連付け」をご参照ください。

ノードが有効期限切れになるか、破棄される。

ノードが利用できなくなります。

回復不能。

オペレーティングシステムを再インストールする。

ノード上のコンポーネントが削除されます。

クラスターからノードを削除し、再度追加してください。詳細については、「ノードの削除」および「既存ノードのクラスターへの追加」をご参照ください。

ノードコンポーネントのバージョンを独自にアップグレードする。

ノードが使用不能になる可能性があります。

元のバージョンにロールバックしてください。

ノードの IP アドレスを変更する。

ノードが利用できなくなります。

IP アドレスを元のものに戻してください。

kubelet、docker、containerd などのコアコンポーネントのパラメーターを独自に変更する。

ノードが利用できなくなる可能性があります。

公式サイトで推奨されているパラメーターを設定してください。

オペレーティングシステムの設定を変更する。

ノードが利用できなくなる可能性があります。

設定項目を元に戻すか、ノードを削除して新しいものを購入してください。

ノードの時刻を変更する。

ノード上のコンポーネントが異常に動作する可能性があります。

ノードの時刻を元に戻してください。

ACK がサポートしていない方法でクラスターに計算能力リソースを追加する。

ACK は、コンソール、OpenAPI、コマンドラインインターフェイス (CLI) など、クラスターに計算能力リソースを追加するための複数の方法を提供しています。詳細については、「既存ノードのクラスターへの追加」をご参照ください。他の手段でクラスターにノードを追加した場合、ACK はノードのソースを識別できません。その結果、ACK はノードのライフサイクル管理、自動 O&M、技術サポートなどの製品機能を提供できません。リスクの詳細については、「コンソールにノードが属するノードプールのソースが「その他のノード」と表示されるのはなぜですか？」をご参照ください。

計算能力リソースはノードプールを使用して管理することを推奨します。ノードを引き続き使用する場合は、Kubernetes コンポーネント、ネットワーク、ストレージ、セキュリティコンポーネントなど、すべてのクラスターコンポーネントとの互換性を確保してください。

マスターノード (ACK 専用クラスター)

クラスター内のノードのセキュリティグループを変更する。

Master ノードが利用できなくなる可能性があります。

クラスター用に自動作成されたセキュリティグループにノードを再度追加してください。詳細については、「インスタンス (プライマリ ENI) とセキュリティグループの関連付け」をご参照ください。

ノードが有効期限切れになるか、破棄される。

Master ノードが利用できなくなります。

回復不能。

オペレーティングシステムを再インストールする。

Master ノード上のコンポーネントが削除されます。

回復不能。

Master または etcd コンポーネントのバージョンを独自にアップグレードする。

クラスターが使用できなくなる可能性があります。

元のバージョンにロールバックしてください。

ノード上の /etc/kubernetes などのコアディレクトリ内のデータを削除またはフォーマットする。

Master ノードが利用できなくなります。

回復不能。

ノードの IP アドレスを変更する。

Master ノードが利用できなくなります。

IP アドレスを元のものに戻してください。

etcd、kube-apiserver、docker などのコアコンポーネントのパラメーターを独自に変更する。

Master ノードが利用できなくなる可能性があります。

公式サイトで推奨されているパラメーターを設定してください。

Master または etcd の証明書を独自に置き換える。

クラスターが使用できなくなる可能性があります。

回復不能。

マスターノードを独自に追加または削除する。

クラスターが使用できなくなる可能性があります。

回復不能。

ノードの時刻を変更する。

ノード上のコンポーネントが異常に動作する可能性があります。

ノードの時刻を元に戻してください。

その他

RAM を使用して権限を変更または修正する。

Server Load Balancer などの一部のクラスターリソースの作成に失敗する可能性があります。

元の権限に戻してください。

クラスター内のプリセットされた PodSecurityPolicy 関連のリソースを変更または削除する。これには、ack.privileged という名前の PodSecurityPolicy リソース、および名前が ack:podsecuritypolicy: で始まる ClusterRole、ClusterRoleBinding、Role、RoleBinding リソースが含まれます。

コアクラスターコンポーネントが異常になる可能性があります。クラスター内で Pod リソースを作成または更新できなくなる場合があります。

関連リソースを回復してください。詳細については、「ACK のデフォルト Pod セキュリティポリシーの設定または回復」をご参照ください。

リスクの高い操作

影響

回復計画

スケーリンググループを削除する。

ノードプールが異常になります。

復旧不可。ノードプールを再作成するしかありません。詳細については、「ノードプールの作成」をご参照ください。

kubectl を使用してノードを削除する。

ノードプールに表示されるノード数が実際の数と一致しなくなります。

管理コンソールまたはノードプール関連の API を使用して指定されたノードを削除する (「ノードの削除」をご参照ください)、または期待されるノード数を変更してノードプールをスケールインする (「ノードプールの作成と管理」をご参照ください)。

ECS インスタンスを直接リリースする。

ノードプールの製品ページで例外が表示される場合があります。期待されるノード数を持つノードプールの場合、その数を維持するために構成に基づいて自動的に期待される数までスケールアウトします。

復旧不可。正しい方法は、管理コンソールまたはノードプール関連の API を使用して、期待されるノード数を変更してノードプールをスケールインする (「ノードプールの作成と管理」をご参照ください) か、指定されたノードを削除する (「ノードの削除」をご参照ください) ことです。

自動スケーリングが有効になっているノードプールを手動でスケールアウトまたはスケールインする。

自動スケーリングコンポーネントがポリシーに基づいてノード数を自動的に調整するため、予期しない結果につながります。

回復不能。自動スケーリングノードプールに手動で介入しないでください。

ESS スケーリンググループのインスタンスの最大数または最小数を変更する。

スケーリングが異常になる可能性があります。

• 自動スケーリングが有効になっていないノードプールの場合、ESS スケーリンググループのインスタンスの最大数と最小数をデフォルト値の 2000 と 0 に変更してください。

• 自動スケーリングが有効になっているノードプールの場合、ESS スケーリンググループのインスタンスの最大数と最小数を、ノードプールのノードの最大数と最小数と一致するように変更してください。

既存のノードを追加する前にデータをバックアップしない。

インスタンス上のデータは追加される前に失われます。

回復不能。

• 既存のノードを手動で追加する前に、保持したいすべてのデータをバックアップする必要があります。

• ノードが自動的に追加されると、そのシステムディスクは置き換えられます。システムディスクに保存されている有用なデータは事前にバックアップする必要があります。

ノードのシステムディスクに重要なデータを保存する。

ノードプールの自己修復操作により、ノードの構成をリセットして修復することがあり、これによりシステムディスク上のデータが失われる可能性があります。

復旧不可。正しい方法は、重要なデータを追加のデータディスク、またはクラウドディスク、NAS、OSS に保存することです。

リスクの高い操作

影響

回復計画

カーネルパラメーター net.ipv4.ip_forward=0 を変更する。

ネットワーク接続が失敗する。

カーネルパラメーターを net.ipv4.ip_forward=1 に変更してください。

カーネルパラメーターを変更する：

• net.ipv4.conf.all.rp_filter = 1|2

• net.ipv4.conf.[ethX].rp_filter = 1|2

  説明

  ethX は、名前が eth で始まるすべてのネットワークインターフェースカードを表します。

ネットワーク接続が失敗する。

カーネルパラメーターを次のように変更してください：

• net.ipv4.conf.all.rp_filter = 0

• net.ipv4.conf.[ethX].rp_filter = 0

カーネルパラメーター net.ipv4.tcp_tw_reuse = 1 を変更する。

Pod のヘルスチェックが異常になります。

カーネルパラメーターを net.ipv4.tcp_tw_reuse = 0 に変更してください。

カーネルパラメーター net.ipv4.tcp_tw_recycle = 1 を変更する。

NAT が異常になります。

カーネルパラメーターを net.ipv4.tcp_tw_recycle = 0 に変更してください。

カーネルパラメーター net.ipv4.ip_local_port_range を変更する。

ネットワーク接続が断続的に失敗する。

カーネルパラメーターをデフォルト値 net.ipv4.ip_local_port_range="32768 60999" に変更してください。

Firewalld や ufw などのファイアウォールソフトウェアをインストールする。

コンテナネットワーク接続が失敗する。

ファイアウォールソフトウェアをアンインストールし、ノードを再起動してください。

ノードのセキュリティグループ構成が、コンテナー CIDR ブロックのポート 53 での UDP トラフィックを許可していない。

クラスター内の DNS が正しく機能しません。

公式サイトで推奨されているように、セキュリティグループを構成してトラフィックを許可してください。

ACK によって追加された SLB インスタンスのタグを変更または削除する。

SLB インスタンスが異常になります。

SLB インスタンスのタグを元に戻してください。

Server Load Balancer コンソールで、ACK が管理する SLB インスタンスの構成 (SLB インスタンス、リスナー、vServer グループを含む) を変更する。

SLB インスタンスが異常になります。

SLB インスタンスの構成を元に戻してください。

サービスから既存の SLB インスタンスを再利用するためのアノテーションを削除する：service.beta.kubernetes.io/alibaba-cloud-loadbalancer-id: ${YOUR_LB_ID}。

SLB インスタンスが異常になります。

サービスに既存の SLB インスタンスを再利用するためのアノテーションを追加してください。

Server Load Balancer コンソールで ACK によって作成された SLB インスタンスを削除する。

クラスターネットワークが異常になる可能性があります。

サービスを削除することで SLB インスタンスを削除してください。詳細については、「サービスの削除」をご参照ください。

Nginx Ingress Controller コンポーネントがインストールされている場合、kube-system 名前空間の nginx-ingress-lb サービスを手動で削除する。

Ingress コントローラーが正しく機能せず、クラッシュすることさえあります。

以下の YAML テンプレートを使用して、同じ名前の新しいサービスを作成してください。

apiVersion: v1
kind: Service
metadata:
  annotations:
  labels:
    app: nginx-ingress-lb
  name: nginx-ingress-lb
  namespace: kube-system
spec:
  externalTrafficPolicy: Local
  ports:
  - name: http
    port: 80
    protocol: TCP
    targetPort: 80
  - name: https
    port: 443
    protocol: TCP
    targetPort: 443
  selector:
    app: ingress-nginx
  type: LoadBalancer

ECS ノード上の DNS 設定ファイル /etc/resolv.conf の nameserver オプションを追加または変更する。

設定された DNS サーバーが適切に構成されていない場合、DNS 解決に失敗し、クラスターの正常な動作に影響を与える可能性があります。

自己管理の DNS サーバーをアップストリームサーバーとして使用する場合は、CoreDNS 側で設定することを推奨します。詳細については、「アンマネージド CoreDNS の設定手順」をご参照ください。

ACK によって作成された ENI または Lingjun ENI を変更または削除する。

Pod ネットワークが中断される。

回復不能。

ネットワーク関連の CRD を変更または削除する。

podnetworkings.network.alibabacloud.com
podenis.network.alibabacloud.com
networkinterfaces.network.alibabacloud.com
nodes.network.alibabacloud.com
noderuntimes.network.alibabacloud.com
*.cilium.io
*.crd.projectcalico.org

Terway コンポーネントが機能しなくなります。深刻な場合、ネットワークの中断や Pod の例外を引き起こす可能性があります。

回復不能。

ネットワーク関連のシステム CR を作成、変更、または削除する。

podenis.network.alibabacloud.com
networkinterfaces.network.alibabacloud.com
nodes.network.alibabacloud.com
noderuntimes.network.alibabacloud.com
*.cilium.io
*.crd.projectcalico.org

Terway コンポーネントが機能しなくなります。深刻な場合、ネットワークの中断や Pod の例外を引き起こす可能性があります。

カスタム CR 定義を削除し、関連する Pod を再作成してください。

Terway ネットワーク構成で変更が許可されていないフィールドを変更または削除する。構成パラメーターの詳細については、「Terway 構成パラメーターのカスタマイズ」をご参照ください。

Terway コンポーネントが機能しなくなります。深刻な場合、ネットワークの中断や Pod の例外を引き起こす可能性があります。

元の構成に戻し、ノードを再起動してください。

リスクの高い操作

影響

回復計画

コンソールでディスクを手動でデタッチする。

Pod が書き込み操作中に I/O エラーを報告します。

Pod を再起動し、ノード上の残存マウント情報を手動でクリアしてください。

ノード上のディスクマウントパスに対して umount コマンドを実行する。

Pod がローカルディスクにデータを書き込む。

Pod を再起動してください。

ノード上のディスクを直接操作する。

Pod がローカルディスクにデータを書き込む。

回復不能。

同じディスクを複数の Pod にマウントする。

Pod がローカルディスクにデータを書き込むか、I/O エラーを報告します。

1 つのディスクが 1 つの Pod のみで使用されるようにしてください。

NAS のマウントディレクトリを手動で削除する。

Pod が書き込み操作中に I/O エラーを報告します。

Pod を再起動してください。

使用中の NAS ディスクまたはマウントポイントを削除する。

Pod で I/O ハングが発生します。

ECS ノードを再起動してください。詳細については、「ECS インスタンスの再起動」をご参照ください。

リスクの高い操作

影響

回復計画

ホスト上の /tmp/ccs-log-collector/pos ディレクトリを削除する。

ログが繰り返し収集されます。

回復不能。このディレクトリのファイルはログ収集位置を記録しています。

ホスト上の /tmp/ccs-log-collector/buffer ディレクトリを削除する。

ログが失われます。

復旧不可。このディレクトリには、消費を待つログのキャッシュファイルが含まれています。

aliyunlogconfig CRD リソースを削除する。

ログ収集が失敗します。

削除された CRD とそれに対応するリソースを再作成してください。ただし、障害期間中のログは回復できません。

CRD を削除すると、関連するすべてのインスタンスも削除されます。CRD を回復した後でも、削除されたインスタンスを手動で作成する必要があります。

ログコンポーネントをアンインストールする。

ログ収集が失敗します。

ログコンポーネントを再インストールし、aliyunlogconfig CRD インスタンスを手動で回復してください。アンインストール期間中のログは回復できません。

ログコンポーネントをアンインストールすることは、aliyunlogconfig CRD と Logtail ログコレクターを削除することに相当します。この期間中、すべてのログ収集機能が失われます。