すべてのプロダクト
Search
ドキュメントセンター

Container Service for Kubernetes:エッジノードを追加する

最終更新日:Apr 24, 2025

ACK Edge クラスターは、異なるリージョンの Elastic Compute Service (ECS) ノード、IDC ノード、他のクラウドプロバイダーのノード、工場、アウトレット、車両、船舶に分散されたサーバーノードなど、さまざまな種類のリソースをエッジノードプールに追加することをサポートしています。このトピックでは、ACK Edge クラスターのエッジノードプールにエッジノードを追加する方法について説明します。

前提条件

ACK Edge クラスターが作成されていること

制限事項

  • クラスターに十分なノードクォータがあることを確認してください。さらにノードを追加するには、クォータの増加をリクエストしてください。ACK Edge クラスターのクォータ制限の詳細については、「クォータと制限」をご参照ください。

  • エッジノードを追加する場合、ノードはいくつかのドメイン名にアクセスする必要があります。これらのドメイン名へのアクセスを許可するように、ノードのセキュリティグループを構成する必要があります。詳細については、「エッジノード アクセスのドメイン名と IP ルーティング ネットワークセグメントの構成」をご参照ください。

  • エッジノードを追加する場合は、ノードのオペレーティングシステムを選択する必要があります。次のオペレーティングシステムがサポートされています。

    システムアーキテクチャ

    システムバージョン

    システムカーネルバージョン

    Edge Kubernetes クラスターバージョン

    AMD64/x86_64

    Anolis7.9、Anolis8.6

    4.19.X

    ≥ 1.16.9-aliyunedge.1

    AMD64/x86_64

    Alibaba Cloud Linux 2.1903

    4.19.X

    ≥ 1.20.11-aliyunedge.1

    AMD64/x86_64

    Alibaba Cloud Linux 3

    5.10.X

    ≥ 1.20.11-aliyunedge.1

    AMD64/x86_64

    CentOS 7.4、CentOS 7.5、CentOS 7.6、CentOS 7.7、CentOS 7.8、および CentOS 7.9

    3.10.X

    1.12.6-aliyunedge.1 ≤ クラスターバージョン ≤ 1.30.7-aliyun.1

    AMD64/x86_64

    CentOS 8.0、CentOS 8.2

    4.18.X

    1.18.8-aliyunedge.1 ≤ クラスターバージョン ≤ 1.30.7-aliyun.1

    AMD64/x86_64

    Ubuntu 16.04

    4.4.X

    1.18.8-aliyunedge.1 ≤ クラスターバージョン ≤ 1.30.7-aliyun.1

    AMD64/x86_64

    Ubuntu 18.04

    4.15.X

    1.12.6-aliyunedge.1 ≤ クラスターバージョン ≤ 1.30.7-aliyun.1

    AMD64/x86_64

    Ubuntu 18.04

    5.4.X

    ≥ 1.16.9-aliyunedge.1

    AMD64/x86_64

    Ubuntu 18.04

    5.11.X

    ≥ 1.18.8-aliyunedge.1

    AMD64/x86_64

    Ubuntu 20.04

    5.4.X

    ≥ 1.18.8-aliyunedge.1

    AMD64/x86_64

    Ubuntu 20.04 および Ubuntu 22.04

    5.15.X

    ≥ 1.26.3-aliyun.1

    AMD64/x86_64

    Ubuntu 24.04

    6.8.X

    ≥ 1.30.7-aliyun.1

    AMD64/x86_64

    Red Hat Enterprise Linux 8.8、Red Hat Enterprise Linux 8.10

    4.18.X

    1.26.3-aliyun.1 ≤ クラスターバージョン ≤ 1.30.7-aliyun.1

    AMD64/x86_64

    Kylin V10

    4.19.X

    ≥ 1.26.3-aliyun.1

    AMD64/x86_64

    UnionTech OS Server 20

    4.19.X

    ≥ 1.26.3-aliyun.1

    AMD64/x86_64

    Red Hat Enterprise Linux 9.3

    5.14.X

    ≥ 1.30.7-aliyun.1

    Arm64

    CentOS 8.0

    4.19.X

    ≥ 1.14.8-aliyunedge.1

    Arm64

    Ubuntu 18.04

    4.9.X

    1.14.8-aliyunedge.1 ≤ クラスターバージョン ≤ 1.30.7-aliyun.1

    Arm64

    Ubuntu 18.04

    4.19.X

    ≥ 1.14.8-aliyunedge.1

    Arm64

    Ubuntu 20.04

    5.10.X

    ≥ 1.22.15-aliyunedge.1

  • GPU ノードをクラスターに追加する場合は、「GPU ノードを追加する」をご参照ください。

ノードを追加する

Kubernetes 1.26 以降を実行するクラスター

  1. ACK コンソール にログインします。左側のナビゲーションウィンドウで、[クラスター] をクリックします。

  2. [クラスター] ページで、管理するクラスターを見つけ、その名前をクリックします。左側のナビゲーションウィンドウで、[ノード] > [ノードプール] を選択します。

  3. [ノードプール] ページで、管理するノードプールを見つけ、アクション图标列で アクション を選択します。

  4. [既存のノードを追加] ページで、クラウドエッジ通信パラメーターと詳細オプションを構成します。

    説明

    以下のパラメーターが要件を満たせない場合は、以下のパラメーターに基づいて、生成されたスクリプトの edgeadm パラメーターを変更できます。

    image

    カテゴリ

    パラメーター

    説明

    クラウドエッジ通信構成

    トークンの有効期間

    スクリプトの有効期間。デフォルト値は 1 時間です。このパラメーターが 0 時間に設定されている場合、スクリプトは有効です。

    同じスクリプトを長時間バッチ追加に使用する必要がある場合は、スクリプトの有効期間を延長できます。

    サイレントモードを有効にする

    サイレントモードを有効にするかどうかを指定します。

    エッジノードのアクセスプロセス中に、ノードに既に存在するランタイムを再インストールするかどうかなど、判断するために介入が必要な手順があります。

    デフォルト値は Yes です。これは、すべての質問に yes で自動的に回答して、プロセスを自動的に進めることを意味します。

    詳細

    ノードラベル

    追加するノードにラベルを追加します。

    ノードプールは、ノードプール内のすべてのノードにラベルを追加することをサポートしています。label がノードプール上の label key と競合する場合、ノードプールで定義された label の方が優先されます。

    テイント

    追加するノードにテイントを追加します。

    アノテーション

    追加するノードにアノテーションを追加します。

    annotations がノードプール上の annotations と競合する場合、ノードプールで定義された annotations の方が優先されます。

    時刻の自動同期

    この機能が有効になっている場合、edgeadm は時刻同期を自動的に完了します。

    ノードネットワークポート

    ノード IP アドレスの取得とコンテナーネットワーク通信に使用されるホストネットワークインターフェースカード名。このパラメーターを空のままにすると、デフォルトルートに対応するネットワークカードが自動的に選択されます。

    コンポーネントのダウンロード元

    ノード上のシステムコンポーネントイメージのソース。デフォルトはパブリックネットワークです。

    ダウンロードにプライベートネットワークを使用する場合は、ノードを専用回線ノードプールに接続する必要があります。

    ランタイム作業ディレクトリ

    ランタイムの作業ディレクトリ。この構成は、manageRuntimetrue に設定されている場合にのみ有効になります。

    containerd ランタイムのデフォルトパスは /var/lib/containerd です。

  5. 構成が完了したら、[OK] をクリックします。送信結果ページで、[コピー] をクリックし、スクリプトをエッジノードに貼り付けて実行します。

    次の結果が返された場合、エッジノードはクラスターに追加されます。

    接入成功

Kubernetes 1.26 より前を実行するクラスター

  1. ACK コンソール にログインします。左側のナビゲーションウィンドウで、[クラスター] をクリックします。

  2. [クラスター] ページで、管理するクラスターを見つけ、その名前をクリックします。左側のナビゲーションウィンドウで、[ノード] > [ノードプール] を選択します。

  3. [ノードプール] ページで、対象のノードプールを見つけ、[アクション] 列の [詳細] 图标 > [既存ノードの追加] を選択します。

  4. [ノードを追加] ページでは、デフォルトで [手動] モードが選択されており、既存のインスタンスが追加されます。

    説明

    手動モードでは、ECS インスタンス、ENS インスタンス、およびエッジノードを追加できます。

    1. [次のステップ] をクリックして、[インスタンス情報] ページに移動します。ここで、ノードアクセス構成を入力できます。具体的な構成パラメーターについては、「パラメーター」をご参照ください。

      image

      説明

      [スクリプトの有効期間] のデフォルト値は 1 時間です。同じスクリプトを長時間バッチ追加に使用する必要がある場合は、スクリプトの有効期間を延長できます。[スクリプトの有効期間] が 0 時間に設定されている場合、スクリプトは常に有効です。

    2. 構成が完了したら、[次のステップ] をクリックします。[完了] ページで、[コピー] をクリックし、スクリプトをエッジノードに貼り付けて実行します。

    次の結果が返された場合、エッジノードはクラスターに追加されます。

    接入成功

パラメーター

コンソールのパラメーターが要件を満たせない場合は、次の表に基づいて、生成されたスクリプトの edgeadm パラメーターを変更できます。

パラメーター

コンソールと同等のパラメーター

説明

有効な値

quiet

サイレントモードを有効にする

サイレントモードを有効にするかどうかを指定します。ノードアクセスプロセス中に、ノードに既に存在するランタイムを再インストールするかどうかなど、判断するために介入が必要な手順があります。

  • true: デフォルト値。すべての質問に yes で自動的に回答して、プロセスを自動的に進めます。

  • false: ノードアクセスプロセス中に、確認を得るためにプロセスが一時停止し、ノードアクセスプロセスが中断される場合があります。

manageRuntime

該当なし

edgeadm がランタイムを検出してインストールするかどうかを指定します。

  • true: デフォルト値。ランタイムを検出してインストールします。

  • false: ランタイムをインストールしません。ノードに事前にランタイムをインストールする必要があります。

nodeNameOverride

該当なし

ノードの名前。

  • "": デフォルト値。ホスト名を使用します。

  • "XXX": ノード名を XXX として指定します。

  • "*": 6 文字の文字列をランダムに生成します。

  • "*.XXX": XXX サフィックスが付いた 6 文字の文字列をランダムに生成します。

allowedClusterAddons

該当なし

インストールするコンポーネント。通常のノードの場合は、このパラメーターを ["kube-proxy","flannel","coredns"] に設定します。

デフォルト値: ["kube-proxy","flannel","coredns"]

gpuVersion

該当なし

追加するノードが GPU アクセラレーションノードかどうかを指定します。デフォルトでは、このパラメーターは空です。

サポートされている GPU バージョンについては、「GPU モデル」をご参照ください。

"": デフォルト値。ノードは GPU ノードとして追加されません。

ACK Edge クラスター 1.26 以降では、NVIDIA GPU を追加する場合、gpuVersion パラメーターを構成する必要はありません。アクセツールは GPU モデルを自動的にチェックし、関連コンポーネントをインストールします。

labels

ノードラベル

ノードに追加するラベルを指定します。ノードプールは、ノードプール内のすべてのノードにラベルを追加することをサポートしています。label がノードプール上の label key と競合する場合、ノードプールで定義された label の方が優先されます。

{}: ラベルを追加しません。

annotations

アノテーション

ノード構成に追加するアノテーションを指定します。annotations がノードプール上の annotations と競合する場合、ノードプールで定義された annotations の方が優先されます。

{}: アノテーションを追加しません。

taints

テイント

ノードに追加するテイントを指定します。

[]

nodeIface

該当なし

ホストネットワークインターフェースカードを指定します。このパラメーターには 2 つの機能があります。

  • kubelet は、指定されたネットワークインターフェースカードからノードの IP 情報を取得します。

  • コンテナーネットワークプラグイン flannel が使用するネットワークインターフェースカードを設定します。

"": このパラメーターを空のままにすると、kubelet は次の順序でノード IP を取得します。

  • /etc/hosts 内でホスト名と同じ名前のレコードを探します。

  • ノードのデフォルトルートエントリで指定されているネットワークインターフェースの IP アドレスを取得します。

Flannel は、ノードのデフォルトルートにあるネットワークインターフェースカードを使用します。

runtimeRootDir

ランタイム作業ディレクトリ

ランタイムの作業ディレクトリを指定します。この構成は、manageRuntimetrue に設定されている場合にのみ有効になります。

"": デフォルト値。

  • ランタイムが Docker の場合、デフォルトパスは /var/lib/docker です。

  • ランタイムが containerd の場合、デフォルトパスは /var/lib/containerd です。

imageRepoType

コンポーネントのダウンロード元

ノード上のシステムコンポーネントイメージのソースを指定します。

  • "": デフォルト値。専用回線ノードプール内のノードは内部ネットワークからイメージをダウンロードし、通常のノードプール内のノードはパブリックネットワークからイメージをダウンロードします。

  • public: パブリックネットワークからイメージをダウンロードします。

  • private: 内部ネットワークからイメージをダウンロードします。ノードは専用回線ノードプールに接続されています。

selfHostNtpServer

時刻の自動同期

時刻を手動で同期するかどうかを指定します。

  • false: デフォルト値。edgeadm は時刻を自動的に同期します。

  • true: 時刻同期は手動で完了しているため、自動時刻同期は不要です。

flannelIface

ノードネットワークポート

flannel が使用するネットワークインターフェースカード名(非推奨、代わりに nodeIface パラメーターを使用できます)。

"": デフォルト値。Flannel は、ノードのデフォルトルートで使用されるネットワークインターフェースカードを使用します。

enableIptables

該当なし

edgehub が iptables の最適化を有効にするかどうかを指定します(非推奨、バージョン 1.22 以降は廃止)。

false: iptables を有効にしません。

関連情報

  • エッジノードを追加する際の問題への対処方法の詳細については、「エッジノードの問題を診断する」をご参照ください。

  • 未使用のエッジノードを削除する方法の詳細については、「エッジノードを削除する」をご参照ください。

  • エッジノードの自己管理を実装する方法の詳細については、「エッジノードの自律性を構成する」をご参照ください。構成後、クラウドエッジネットワークが切断された場合でも、エッジノード上のワークロードは引き続き安定して実行できます。