VNodectl コマンドラインツールをインストールして構成した後、VNodectl を使用して VNode とアドオンを管理できます。このトピックでは、VNodectl の一般的なコマンドについて説明します。
クライアント検証のために vnode コマンドに
--dryを追加できます。vnode コマンドの実行時に API バージョンの互換性エラーが発生した場合は、
--kubernetes-versionを追加して、クラスターの Kubernetes バージョンを指定します。
VNode の管理
以下のコマンドを使用して VNode を管理する前に、~/.vnode/config ファイルが存在し、ファイルの構成が正しいことを確認してください。
create
「create」コマンドは、VNode を作成するために使用されます。
構文
vnode create [--vswitch-id] [--security-group-id] [--custom-resources] [--cluster-dns] [--cluster-domain]パラメーターの説明
パラメーター
説明
例
--vswitch-id
VNode が接続されている vSwitch の ID。
--vswitch-id vsw-7xv2yk45qp5etidgf****
--security-group-id
VNode が属するセキュリティグループの ID。
--security-group-id sg-7xv5tcch4kjdr65t****
--custom-resources
VNode でサポートされているカスタムリソース。カスタムリソースが Elastic Container Instance ポッドの要求で指定されている場合、ポッドはカスタムリソースをサポートする VNode で実行するようにスケジュールされます。
カスタムリソースは、
リソース名=リソース数の形式で指定できます。複数のリソースはカンマ (,) で区切ります。--custom-resources example1.com=10000,example2.com=20000
--cluster-dns
Alibaba Cloud DNS (DNS) サーバーの IP アドレス。ポッドの dnsPolicy が
ClusterFirstに設定されている場合、Alibaba Cloud はこのパラメーターの値を使用してコンテナーに DNS サービスを提供します。複数の IP アドレスを指定できます。複数の IP アドレスはカンマ (,) で区切ります。
--cluster-dns 192.168.XX.XX
--cluster-domain
クラスターのドメイン名。このパラメーターをホストの検索ドメインと一緒に構成すると、Kubelet はすべてのコンテナーが指定されたドメイン名を検索するように構成します。
--cluster-domain example.com
例
例 1: パラメーターを使用せずに VNode を作成する
例 2: customResources を構成する
VNode が作成された後、
kubectl describe nodeコマンドを実行して VNode の詳細を表示できます。構成したカスタムリソースは、CapacityセクションとAllocatableセクションに表示されます。
例 3: clusterDNS と clusterDomain を構成する
VNode が作成された後、
kubectl describe podコマンドを実行して、VNode で実行するようにスケジュールされているポッドの詳細を表示できます。annotationsセクションに、clusterDNS と clusterDomain の値が表示されます。
list
「list」コマンドは、VNode のステータスをクエリするために使用されます。
構文
vnode list例
describe
「describe」コマンドは、VNode の詳細を表示するために使用されます。
構文
vnode describe <vnode id>例
update
「update」コマンドは、指定された VNode の構成を更新するために使用されます。VNode の vSwitch、セキュリティグループ、customResources、clusterDNS、および clusterDomain を更新できます。
構文
vnode update <vnode id> [--vswitch-id] [--security-group-id] [--custom-resources] [--cluster-dns] [--cluster-domain]パラメーターの説明
重要update コマンドを実行して VNode の構成を更新する場合、渡されたパラメーター値は元のパラメーター値を上書きします。たとえば、VNode に
--custom-resources example1.com=10000が指定されていて、元のカスタムリソースに 10000 example2.com を追加する場合、--custom-resources example1.com=10000,example2.com=10000を指定する必要があります。パラメーター
説明
例
--vswitch-id
VNode が接続されている vSwitch の ID。
--vswitch-id vsw-7xv2yk45qp5etidgf****
--security-group-id
VNode が属するセキュリティグループの ID。
--security-group-id sg-7xv5tcch4kjdr65t****
--custom-resources
VNode でサポートされているカスタムリソース。カスタムリソースが Elastic Container Instance ポッドの要求で指定されている場合、ポッドはカスタムリソースをサポートする VNode で実行するようにスケジュールされます。
カスタムリソースは、
リソース名=リソース数の形式で指定できます。複数のリソースはカンマ (,) で区切ります。--custom-resources example1.com=10000,example2.com=20000
--cluster-dns
Alibaba Cloud DNS (DNS) サーバーの IP アドレス。ポッドの dnsPolicy が
ClusterFirstに設定されている場合、Alibaba Cloud はこのパラメーターの値を使用してコンテナーに DNS サービスを提供します。複数の IP アドレスを指定できます。複数の IP アドレスはカンマ (,) で区切ります。
--cluster-dns 192.168.XX.XX
--cluster-domain
クラスターのドメイン名。このパラメーターをホストの検索ドメインと一緒に構成すると、Kubelet はすべてのコンテナーが指定されたドメイン名を検索するように構成します。
--cluster-domain example.com
例
delete
「delete」コマンドは、指定された VNode を削除するために使用されます。VNode を削除する前に、VNode に Elastic Container Instance が存在しないことを確認してください。
構文
vnode delete <vnode id>例
コンポーネントの管理
VNodectl は、eci-profile コンポーネントと vnode-approver コンポーネントも管理できます。
addon list
「addon list」コマンドは、使用可能なアドオンを一覧表示するために使用されます。
構文
vnode addon list --kubeconfig /path/to/kubeconfig例
addon enable
「addon enable」コマンドは、アドオンを読み込むために使用されます。
構文
vnode addon enable <プラグイン名> --kubeconfig /path/to/kubeconfig例
addon disable
「addon disable」コマンドは、アドオンをアンインストールするために使用されます。
構文
vnode addon disable <プラグイン名> --kubeconfig /path/to/kubeconfig例
クラスターの構成のクリア
cluster clean
「cluster clean」コマンドは、クラスターの構成をクリアするために使用されます。VNode を使用しなくなった場合は、cluster clean コマンドを実行してクラスターの VNode 構成をクリアできます。
構文
vnode cluster clean --kubeconfig <kubeconfig ファイルへのパス> [--bootstrap]例
以前に通常モードを使用してクラスターを構成した場合は、次のコマンドを使用してクラスターの VNode 構成をクリアできます。
vnode cluster clean --kubeconfig /path/to/kubeconfig以前に TLS ブートストラップモードを使用してクラスターを構成した場合は、次のコマンドを使用してクラスターの VNode 構成をクリアできます。
vnode cluster clean --kubeconfig /path/to/kubeconfig --bootstrap