すべてのプロダクト
Search

このプロダクト

    Container Service for Kubernetes:エッジノードの追加

    ドキュメントセンター

    Container Service for Kubernetes:エッジノードの追加

    最終更新日:Jun 23, 2026

    ACK Edge クラスターのエッジノードプールに、異なるリージョンのECS ノード、IDC ノード、他のクラウドプロバイダーのノード、または工場、店舗、車両、船舶にあるオンプレミスノードであるエッジノードを追加します。

    前提条件

    ACK Edge クラスターが作成されました。

    制限事項

    • お使いの クラスターに十分なノード クォータがあることを確認してください。ノードを追加するには、クォータセンターでクォータ引き上げリクエストを送信してください。ACK Edge クラスターの クォータ制限については、「クォータと制限」をご参照ください。

    • エッジノードを追加する際、必要なドメイン名へのアクセスを許可するようにセキュリティグループを設定してください。詳細については、「パブリックネットワークアクセスの設定」をご参照ください。

    • エッジノードには、サポートされているオペレーティングシステムを選択してください。

      システムアーキテクチャー

      システムバージョン

      カーネルバージョン

      クラスターバージョン

      AMD64/x86_64

      Anolis 7.9 および Anolis 8.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. ノードプール ページで、対象のノードプールの右側にある アクション 列から Icon > [既存ノードの追加] を選択します。

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

      説明

      コンソールのパラメーターが要件を満たさない場合は、生成されたスクリプトで edgeadm パラメーターを変更してください。詳細については、「パラメーターリスト」をご参照ください。

      カテゴリ

      パラメーター

      説明

      クラウドとエッジの通信

      トークンの有効期間

      スクリプトの有効期間。デフォルト： 1 時間。

      同じスクリプトを再利用してバッチでノードを追加する場合は、より長い有効期間を指定してください。

      サイレントモードの有効化

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

      エッジノードを追加する際、既存のランタイムを再インストールするかどうかなど、一部のステップでは確認が必要です。

      デフォルトでは、すべてのプロンプトに対して自動的に yes で応答します。

      詳細設定

      ノードラベル

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

      label がノードプールの label key と競合する場合、ノードプールの label が優先されます。

      Taint

      新しいノードに Taint を追加します。

      アノテーション

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

      annotations がノードプールの annotations と競合する場合、ノードプールの annotations が優先されます。

      自動時刻同期

      有効にすると、edgeadm は自動的に時刻同期を実行します。

      ノードネットワークインターフェイス

      ノード IP アドレスとコンテナネットワーク通信のためのホストネットワークインターフェイス。空の場合、デフォルトルートのネットワークインターフェイスが使用されます。

      アドオンのダウンロード元

      システムアドオンイメージをダウンロードするソース。デフォルト： パブリックネットワーク。

      内部ネットワーク経由でイメージをダウンロードするには、ノードを専用線ノードプールに追加する必要があります。

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

      ランタイムの作業ディレクトリであり、manageRuntime が true の場合にのみ有効になります。

      containerd のデフォルトパス： /var/lib/containerd。

    5. 設定後、OK をクリックします。結果ページで コピー をクリックし、スクリプトをエッジノードに貼り付けて実行します。

      エッジノードがクラスターに参加すると、ターミナルにログが表示されます。最後の出力行で、ノードが正常に追加されたことが確認できます。

      I0410 10:54:25.801554    19419 join-node.go:241] [join-node] Config the kubelet service configuration successfully.
I0410 10:54:25.801590    19419 join-node.go:246] [join-node] Adding edge hub static yaml
I0410 10:54:25.801662    19419 join-node.go:279] [join-node] Add edge hub static yaml is ok
I0410 10:54:25.801666    19419 join-node.go:384] [join-node] Start to joining node to cluster.
I0410 10:54:27.338166    19419 join-node.go:393] [join-node] Join node to cluster successfully.
I0410 10:54:27.338214    19419 install.go:151] [install-edgehub] Checking edgehub status
I0410 10:54:37.357405    19419 install.go:156] [install-edgehub] Edgehub is ok
I0410 10:54:37.357421    19419 install.go:86] [install-edgehub] Reconfiguring the kubelet configuration files.
I0410 10:54:37.364387    19419 install.go:103] [install-edgehub] Reconfigure the kubelet configuration files successfully.
I0410 10:54:37.364400    19419 install.go:104] [install-edgehub] Restarting the kubelet.
I0410 10:54:52.626540    19419 install.go:127] [install-edgehub] Restart the kubelet successfully.
I0410 10:54:52.626613    19419 postcheck.go:77] [post-check] Checking docker status
I0410 10:54:52.629194    19419 postcheck.go:86] [post-check] docker is ok
I0410 10:54:52.629208    19419 postcheck.go:92] [post-check] Checking kubelet status
I0410 10:54:52.631661    19419 postcheck.go:100] [post-check] Kubelet is ok
I0410 10:54:52.631671    19419 postcheck.go:106] [post-check] Checking edgehub status
I0410 10:54:52.642345    19419 postcheck.go:113] [post-check] Edgehub is ok
I0410 10:54:52.642356    19419 postcheck.go:129] [post-check] Checking addon kube-proxy status.
I0410 10:54:52.683227    19419 postcheck.go:133] [post-check] kube-proxy is OK.
I0410 10:54:52.683243    19419 postcheck.go:129] [post-check] Checking addon flannel status.
I0410 10:54:52.724501    19419 postcheck.go:133] [post-check] flannel is OK.
I0410 10:54:52.724518    19419 postcheck.go:129] [post-check] Checking addon coredns status.
I0410 10:54:52.764745    19419 postcheck.go:133] [post-check] coredns is OK.
I0410 10:54:52.764763    19419 postcheck.go:165] [post-check] Callback to the OpenAPI.
I0410 10:54:53.014706    19419 postcheck.go:178] [post-check] Callback to the OpenAPI successfully.
I0410 10:54:53.014760    19419 postcheck.go:66] This node joined into the cluster successfully.

    Kubernetes 1.26 未満

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

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

    3. ノードプール ページの対象ノードプールの アクション 列で、Icon > 既存のインスタンスの追加 を選択します。

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

      説明

      手動モードでは、クラウド上の ECS ノード、Edge Node Service (ENS) ノード、およびオンプレミスノードを追加できます。

      1. 次 をクリックして、次のページでノードアクセスパラメーターを設定します。詳細については、「パラメーターリスト」をご参照ください。

        [アーキテクチャ] を [AMD64/X86_64] または [ARM64] に設定し、[軽量アクセスモードの使用] を選択してから、JSON エディターでアクセスパラメーターを設定します。たとえば、enableIptables、quiet、manageRuntime を true に設定し、allowedClusterAddons に kube-proxy、flannel、coredns を指定します。

        説明

        デフォルトの [スクリプトの有効期間] は 1 時間です。ノードの一括追加でスクリプトを再利用するには、より長い期間を指定します。スクリプトを無期限にするには、[スクリプトの有効期間] を 0 時間に設定します。

      2. 設定後、次 をクリックします。追加成功 ページで コピー をクリックし、スクリプトをエッジノードに貼り付けて実行します。

    パラメーターリスト

    コンソールのパラメーターが要件を満たさない場合は、以下に説明するように、生成されたスクリプトで edgeadm パラメーターを変更してください。

    パラメーター

    対応するコンソールパラメーター

    説明

    値

    quiet

    サイレントモードの有効化

    サイレントモードを有効にするかどうか。ノード登録中に、既存のランタイムを再インストールするかどうかなど、一部のステップで確認が必要です。

    • true (デフォルト)：すべてのプロンプトに自動的に yes で応答します。

    • false：登録は確認のために一時停止し、中断できます。

    manageRuntime

    N/A

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

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

    • false：ランタイムをインストールしません。事前にノードにランタイムをインストールしてください。

    nodeNameOverride

    N/A

    ノード名。

    • ""：デフォルト。ホスト名が使用されます。

    • "XXX"：ノード名は XXX になります。

    • "*"：ランダムな 6 文字の文字列が生成されます。

    • "*.XXX"：XXX サフィックス付きのランダムな 6 文字の文字列が生成されます。

    allowedClusterAddons

    N/A

    インストールするアドオン。標準ノードのデフォルト：["kube-proxy","flannel","coredns"]。

    デフォルト： ["kube-proxy","flannel","coredns"]。

    gpuVersion

    N/A

    ノードが GPU ノードかどうか。デフォルト：空。

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

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

    Kubernetes 1.26 以降を実行するACK Edge クラスターでは、gpuVersion を設定せずに NVIDIA GPU ノードを追加できます。このツールは GPU モデルを自動的に検出し、必要なアドオンをインストールします。

    labels

    ノードラベル

    ノードの登録時に追加するラベル。この label キーがノードプールの label key と競合する場合、ノードプールの label が優先されます。

    {}：ラベルは追加されません。

    annotations

    アノテーション

    ノードが登録される際に追加されるアノテーションです。これらの annotations がノードプールの annotations と競合する場合、ノードプールの annotations が優先されます。

    {}：アノテーションは追加されません。

    taints

    Taint

    ノードに追加する Taint。

    []

    nodeIface

    N/A

    ホストネットワークインターフェイスは、以下に使用されます：

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

    • Flannel コンテナネットワークプラグインによって使用されるネットワークインターフェイス。

    ""：空の場合、kubelet は次の順序でノード IP アドレスを取得します：

    • /etc/hosts でホスト名に一致するレコードを検索します。

    • デフォルトルートのネットワークインターフェイスの IP アドレス。

    Flannel はデフォルトルートのネットワークインターフェイスを使用します。

    runtimeRootDir

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

    ランタイムの作業ディレクトリ。 manageRuntime が true の場合にのみ有効になります。

    ""：デフォルト。

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

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

    imageRepoType

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

    ノードがシステムアドオンイメージをダウンロードするソース。

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

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

    • private：内部ネットワークからイメージをダウンロードします。ノードは専用線ノードプール内にある必要があります。

    selfHostNtpServer

    自動時刻同期

    時刻同期が手動で実行されたかどうか。

    • false (デフォルト)：edgeadm は自動的に時刻同期を実行します。

    • true：手動で実行されたため、自動時刻同期をスキップします。

    flannelIface

    ノードネットワークインターフェイス

    Flannel が使用するネットワークインターフェイス。代わりに nodeIface パラメーターを使用してください。

    "" (デフォルト)：Flannel はデフォルトルートのネットワークインターフェイスを使用します。

    enableIptables

    N/A

    edgehub が iptables の最適化を有効にするかどうか。v1.22 以降では非推奨です。推奨されません。

    false：iptables の最適化は無効です。

    関連ドキュメント