スタンドアローン管理クラスタで使用する Tanzu CLI と Kubernetes CLI のインストール

このトピックでは、ブートストラップマシンに Tanzu コマンドラインインターフェイス (CLI) をインストールする方法について説明します。ブートストラップマシンは、管理クラスタとワークロードクラスタを展開するラップトップ、ホスト、またはサーバで、展開環境の Tanzu および Kubernetes 構成ファイルを保持します。ブートストラップマシンは通常ローカルですが、リモートからアクセスする物理マシンまたは仮想マシンの場合もあります。コマンドリファレンスを含む Tanzu CLI の詳細については、VMware Tanzu CLI v1.0.x のドキュメントを参照してください。

スーパーバイザーを使用しない vSphere、または AWS や Azure に Tanzu Kubernetes Grid を展開する場合は、Tanzu CLI を使用して、環境内の各クラウドプロバイダにスタンドアローン管理クラスタを作成します。Tanzu CLI は、この管理クラスタと通信して、ターゲットクラウドインフラストラクチャでワークロードクラスタを作成および管理します。

注
このトピックの手順は、スーパーバイザーを使用しない vSphere、または AWS や Azure にスタンドアローン管理クラスタを展開するために Tanzu CLI をインストールする場合に固有のものです。vSphere 8 の vSphere with Tanzu スーパーバイザーで使用する Tanzu CLI をインストールする場合は、『Tanzu CLI を使用した TKG 2.4 ワークロードクラスタの作成と管理』の対応するトピック「vSphere with Tanzu スーパーバイザーで使用する Tanzu CLI と Kubernetes CLI のインストール」を参照してください。

前提条件

Tanzu Kubernetes Grid で使用する Tanzu CLI をインストールして実行するブートストラップマシンは、特定の要件を満たしている必要があります。管理クラスタとしての vSphere with Tanzu スーパーバイザーで Tanzu CLI を使用するか、スタンドアローン管理クラスタを展開するか、またはその両方を実行するかに応じて、さらに要件があります。

Tanzu Kubernetes Grid v2.4 で Tanzu CLI を実行するには、次の機能を持つ Tanzu CLI をインストールして実行するブートストラップマシンが必要です。

次のハードウェアを備えた物理マシンまたは仮想マシンで実行されている Linux、Windows、または macOS オペレーティングシステム。
- 最小で 8 GB の RAM。VMware では少なくとも 16 GB の RAM を推奨しています。
- 使用可能なストレージが 50 GB のディスク。
- 2 個または 4 個の 2 コア CPU。
Tanzu Kubernetes Grid インストーラインターフェイスを使用してスタンドアローン管理クラスタを展開する場合は、ブラウザ、またはブラウザを使用するマシンからのリモートアクセス。Tanzu CLI はブラウザなしで使用できますが、最初の展開ではインストーラインターフェイスを使用することを強くお勧めします。
システム時刻は、Network Time Protocol (NTP) サーバと同期されます。
ブートストラップマシンが Windows で動作している場合、VMware では、Ubuntu 20.04.4 LTS で Windows Subsystem for Linux (WSL) をインストールすることを推奨しています。これにより、Windows で Linux コマンドを実行できます。WSL の詳細については、Microsoft のドキュメントの「WSL のインストール」を参照してください。
VMware Cloud on AWS および Azure VMware Solution では、ブートストラップマシンはローカル物理マシンではなく、クラウド仮想マシンである必要があります。セットアップ手順については、「VMware Cloud 環境への管理クラスタの展開の準備」を参照してください。
スタンドアローン管理クラスタを展開するには、ブートストラップマシンが実行されているオペレーティングシステムに応じて、追加の要件があります。
macOS
- ブートストラップマシンに Docker デスクトップがインストールされ、実行されている。
- kind コンテナに対応するために、Docker デスクトップに少なくとも 6 GB のメモリを割り当てる。kind ドキュメントの「Settings for Docker Desktop」を参照してください。
Linux
- ブートストラップマシンに Docker がインストールされ、実行されている。パッケージマネージャから Docker をインストールするには、snap の代わりに apt を使用します。インターネットが制限された環境に Docker クライアントアプリケーションをインストールする手順については、「インターネットが制限された環境の準備」を参照してください。
- root 以外のユーザーアカウントを docker ユーザーグループに追加します。グループがまだない場合は作成します。これにより、Tanzu CLI は、root ユーザーが所有する Docker ソケットにアクセスできます。詳細については、Docker ドキュメントの「Manage Docker as a non-root user」を参照してください。
- ブートストラップマシンで Ubuntu 22.04 が実行されている場合は、リバースパスフィルタリングが無効になっていることを確認します。リバースパスフィルタリングを無効にするには、次のオーバーライドを追加します。
  
  # New file /etc/sysctl.d/90-override.conf ipv4.conf.all.rp_filter = 0
- ブートストラップマシンに 2021 年 5 月の Linux セキュリティパッチの後にビルドされた Linux カーネルがある場合は、Tanzu CLI がローカルブートストラップクラスタの作成に使用する kind を有効にして、直近の Linux バージョンがデフォルトで読み取り専用にした制御ファイルに書き込む必要があります。
  
  このファイル権限を変更する方法は、Linux ディストリビューションによって異なります。たとえば、Linux 5.11 および 5.12 の Fedora ディストリビューションでは、次のコマンドを実行します。
  
  sudo sysctl net/netfilter/nf_conntrack_max=131072
  
  Debian ディストリビューションで、nf_conntrack_max=131072 を sysctl.conf ファイルに追加し、次のコマンドを実行します。
  
  sudo modprobe nf_conntrack
  
  「既存のブートストラップクラスタを使用した管理クラスタの展開と削除」の説明に従ってトラブルシューティングを行う場合は、kind v0.11 以降を使用して、事前に存在するパーシステントブートストラップクラスタを作成する必要があります。
Windows
- ブートストラップマシンに Docker デスクトップがインストールされ、実行されている。
- kind コンテナに対応するために、Docker デスクトップに少なくとも 6 GB のメモリを割り当てる。kind ドキュメントの「Settings for Docker Desktop」を参照してください。
- ブートストラップマシンが Windows Subsystem for Linux を実行しており、2021 年 5 月の Linux セキュリティパッチの後に作成された Linux カーネル（Fedora を使用する Linux 5.11 や 5.12 など）を持つ場合は、次のコマンドを実行します。
  
  sudo sysctl net/netfilter/nf_conntrack_max=131072
  
  これにより、tanzu CLI がローカルブートストラップクラスタの作成に使用する kind が、直近の Linux バージョンがデフォルトで読み取り専用にした制御ファイルに書き込みます。
  「既存のブートストラップクラスタを使用した管理クラスタの展開と削除」の説明に従ってトラブルシューティングを行う場合は、kind v0.11 以降を使用して、事前に存在するパーシステントブートストラップクラスタを作成する必要があります。

Tanzu CLI のインストール

Tanzu Kubernetes Grid v2.4 で使用する Tanzu CLI をインストールするには、Tanzu Core CLI と Tanzu Kubernetes Grid v2.4 用の Tanzu CLI プラグインの互換性のあるバージョンをインストールします。これらのプラグインによって提供されるコマンドにより、クラスタおよびパッケージの操作が可能になります。互換 CLI バージョンのリストについては、製品の相互運用性マトリックスを参照してください。

Tanzu Core CLI のインストール

Tanzu Core CLI をインストールするには、次の手順を実行します。手順を確認するには、[パッケージマネージャを使用したインストール (Install using a package manager)] または [バイナリリリースからのインストール (Install from a binary release)] タブをクリックします。

Tanzu Core CLI をインストールしたら、「TKG v2.4 用の Tanzu CLI プラグインのインストール」に進みます。

注
Tanzu CLI の既存のインストールを保持する場合は、CLI バイナリを /usr/local/bin/tanzu から別の場所に移動し、次の手順を実行します。

パッケージマネージャを使用したインストール

パッケージマネージャを使用して Tanzu CLI をインストールするには、次の手順を実行します。

Tanzu CLI の互換性のあるバージョンを選択します。このリリースの Tanzu Kubernetes Grid と互換性のある CLI バージョンのリストについては、「製品の相互運用性マトリックス」を参照してください。

以下のパッケージマネージャの手順に従います。

APT（Debian または Ubuntu）：

インストールするバージョンが、Tanzu CLI の最新バージョン（たとえば、v1.0.0）である場合、次のコマンドを実行します。

sudo apt update
sudo apt install -y ca-certificates curl gpg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt update
sudo apt install -y tanzu-cli

Tanzu CLI の以前のバージョン（たとえば v0.90.1）をインストールする場合は、次のコマンドを実行します。

sudo apt update
sudo apt install -y ca-certificates curl gpg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt update
sudo apt install tanzu-cli=0.90.1

Chocolatey (Windows)：
- インストールするバージョンが、Tanzu CLI の最新バージョン（たとえば、v1.0.0）である場合、次のコマンドを実行します。
```
choco install tanzu-cli
```
- Tanzu CLI の以前のバージョン（たとえば v0.90.1）をインストールする場合は、次のコマンドを実行します。
```
choco install tanzu-cli --version 0.90.1
```
Homebrew (MacOS)：
- インストールするバージョンが、Tanzu CLI の最新バージョン（たとえば、v1.0.0）である場合、次のコマンドを実行します。
```
brew update
brew install vmware-tanzu/tanzu/tanzu-cli
```
- Tanzu CLI の以前のバージョン（たとえば v0.90.1）をインストールする場合は、次のコマンドを実行します。
```
brew update
brew tap-new local/tap
brew extract --version=0.90.1 vmware-tanzu/tanzu/tanzu-cli local/tap
brew install [email protected]
```

YUM または DNF (RHEL)：

インストールするバージョンが、Tanzu CLI の最新バージョン（たとえば、v1.0.0）である場合、次のコマンドを実行します。

cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
[tanzu-cli]
name=Tanzu CLI
baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
EOF

sudo yum install -y tanzu-cli # If you are using DNF, run sudo dnf install -y tanzu-cli.

Tanzu CLI の以前のバージョン（たとえば v0.90.1）をインストールする場合は、次のコマンドを実行します。

cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
[tanzu-cli]
name=Tanzu CLI
baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
EOF

sudo yum install tanzu-cli-0.90.1 # If you are using DNF, run sudo dnf install tanzu-cli-0.90.1.

CLI の正しいバージョンが正しくインストールされていることを確認します。例：
```
tanzu version
version: v1.0.0
...
```

バイナリリリースからのインストール

Tanzu CLI バイナリは、VMware Customer Connect または GitHub からダウンロードできます。すべての互換性のある CLI バージョンのリストについては、「製品の相互運用性マトリックス」を参照してください。

Tanzu CLI のバイナリリリースを Customer Connect からダウンロードしてインストールするには、次の手順を実行します。

Tanzu CLI バイナリをダウンロードして展開します。
1. VMware Customer Connect の VMware Tanzu CLI ページに移動し、Tanzu CLI v1.0.0 の [製品のダウンロード (Product Downloads)] でお使いのオペレーティングシステム (OS) に対応した Tanzu CLI バイナリを見つけてダウンロードします。
2. OS の Tanzu CLI ファイルを展開します。ファイルを展開するには、選択した抽出ツールを使用します。たとえば、Linux または macOS では、tar コマンドを使用できます。
  - macOS：
```
tar -xvf tanzu-cli-darwin-amd64.tar.gz
```
  - Linux：
```
tar -xvf tanzu-cli-linux-amd64.tar.gz
```
  - Windows：
    
    Windows の解凍ツールを使用して、tanzu-cli-windows-amd64.zip を解凍します。
CLI をシステムで使用できるようにします。
- macOS：
  
  バイナリを /usr/local/bin にインストールします。
```
install tanzu-cli-darwin_amd64 /usr/local/bin/tanzu
```
- Linux：
  
  バイナリを /usr/local/bin にインストールします。
```
sudo install tanzu-cli-linux_amd64 /usr/local/bin/tanzu
```
- Windows：
  1. 新しい Program Files\tanzu フォルダを作成します。
  2. tanzu-cli-windows_amd64.exe ファイルを新しい Program Files\tanzu フォルダにコピーします。
  3. tanzu-cli-windows_amd64.exe の名前を tanzu.exe に変更します。
  4. tanzu フォルダを右クリックして [プロパティ] > [セキュリティ] を選択し、ユーザーアカウントに [フルコントロール] 権限があることを確認します。
  5. Windows 検索を使用して、env を検索します。
  6. [システム環境変数の編集] を選択し、[環境変数] ボタンをクリックします。
  7. [システム環境変数] の下にある Path 行を選択し、[編集] をクリックします。
  8. [新規] をクリックして新しい行を追加し、tanzu CLI へのパスを入力します。パスの値に .exe 拡張子を含めないようにしてください。たとえば、C:\Program Files\tanzuです。
CLI の正しいバージョンが正しくインストールされていることを確認します。例：
```
tanzu version
version: v1.0.0
...
```

GitHub のバイナリリリースから Tanzu CLI をダウンロードしてインストールするには、『Tanzu CLI のインストール』の「GitHub プロジェクトのバイナリリリースから」セクションの手順に従います。

TKG v2.4 用の Tanzu CLI プラグインのインストール

Tanzu Kubernetes Grid v2.4 用のスタンドアローン Tanzu CLI プラグインをインストールするには、次の手順を実行します。

Tanzu Kubernetes Grid v2.4 用のスタンドアローン Tanzu CLI プラグインを一覧表示します。

tanzu plugin group get vmware-tkg/default:v2.4.0

出力は次のようになります。

Plugins in Group:  vmware-tkg/default:v2.4.0
  NAME                TARGET      VERSION
  isolated-cluster    global      v0.31.0
  management-cluster  kubernetes  v0.31.0
  package             kubernetes  v0.31.0
  pinniped-auth       global      v0.31.0
  secret              kubernetes  v0.31.0
  telemetry           kubernetes  v0.31.0

vmware-tkg/default プラグイングループで使用可能なすべてのバージョンを一覧表示するには、次のコマンドを実行します。

tanzu plugin group search -n vmware-tkg/default --show-details

Tanzu Kubernetes Grid v2.4 用のスタンドアローンプラグインをインストールします。
```
tanzu plugin install --group vmware-tkg/default:v2.4.0
```
プラグインが正常にインストールされたことを確認します。
```
tanzu plugin list
```
tanzu plugin group get vmware-tkg/default:v2.4.0 によって返される各プラグイン名とプラグインのバージョンが tanzu plugin list の出力に含まれている必要があります。

注
Tanzu CLI および Tanzu Kubernetes Grid のスタンドアローンプラグインをインストールした後でも、それらを使用して管理クラスタに接続するまでは、tanzu cluster や tanzu kubernetes-release など、コンテキスト固有のすべての CLI コマンドグループは使用できず、Tanzu CLI --help の出力にも含まれません。管理クラスタに接続すると、Tanzu CLI はコンテキストスコープのプラグインを自動的にインストールします。Tanzu CLI プラグインとそのインストール方法の詳細については、「Tanzu CLI プラグインのインストール」を参照してください。

Kubernetes CLI のインストール

ブートストラップマシンで Kubernetes CLI kubectl をダウンロードして展開し、システムで使用できるようにします。

VMware Customer Connect にアクセスし、VMware Customer Connect の認証情報を使用してログインします。
Tanzu Kubernetes Grid のダウンロードページにアクセスします。
VMware Tanzu Kubernetes Grid の行で、[ダウンロードに移動 (Go to Downloads)] をクリックします。
[バージョンの選択 (Select Version)] ドロップダウンで、[2.4.0] を選択します。
[製品のダウンロード (Product Downloads)] で、Kubectl 1.27.5 for VMware Tanzu Kubernetes Grid 2.4.0 というラベルのセクションまでスクロールします。

macOS

kubectl cli v1.27.5 for Mac を見つけて、 [今すぐダウンロード (Download Now)] をクリックします。

Linux

kubectl cli v1.27.5 for Linux を見つけて、 [今すぐダウンロード (Download Now)] をクリックします。

Windows

kubectl cli v1.27.5 for Windows を見つけて、 [今すぐダウンロード (Download Now)] をクリックします。
（オプション）ダウンロードしたファイルが元のファイルから変更されていないことを確認します。VMware は、ダウンロードごとに SHA-1、SHA-256、および MD5 チェックサムを提供します。これらのチェックサムを取得するには、ダウンロードするエントリの下にある [詳細を表示] をクリックします。詳細については、「暗号化ハッシュの使用」を参照してください。
オペレーティングシステムの kubectl バイナリを展開するには、選択した抽出ツールを使用します。たとえば、gunzip コマンドなどです。
macOS
```
gunzip kubectl-mac-v1.27.5+vmware.1.gz
```
Linux
```
gunzip kubectl-linux-v1.27.5+vmware.1.gz
```
Windows

Windows の解凍ツールを使用して、 kubectl-windows-v1.27.5+vmware.2.exe.gz を解凍します。
CLI をシステムで使用できるようにします。
macOS
1. ダウンロードしたファイルを実行可能にします。
  
  chmod ugo+x kubectl-mac-v1.27.5+vmware.1
2. バイナリを /usr/local/bin にインストールします。
  
  sudo install kubectl-mac-v1.27.5+vmware.1 /usr/local/bin/kubectl
3. kubectl version を実行して、kubectl の正しいバージョンがインストールされ、実行可能であることを確認します。
  
  kubectl version
Linux
1. ダウンロードしたファイルを実行可能にします。
  
  chmod ugo+x kubectl-linux-v1.27.5+vmware.1
2. バイナリを /usr/local/bin にインストールします。
  
  sudo install kubectl-linux-v1.27.5+vmware.1 /usr/local/bin/kubectl
3. kubectl version を実行して、kubectl の正しいバージョンがインストールされ、実行可能であることを確認します。
  
  kubectl version
Windows
1. 新しい Program Files\kubectl フォルダを作成します。
2. kubectl-windows-v1.27.5+vmware.1.exe ファイルを見つけて、新しい Program Files\kubectl フォルダにコピーします。
3. kubectl-windows-v1.27.5+vmware.1.exe の名前を kubectl.exe に変更します。
4. kubectl フォルダを右クリックして [プロパティ] > [セキュリティ] を選択し、ユーザーアカウントに [フルコントロール] 権限があることを確認します。
5. Windows 検索を使用して、env を検索します。
6. [システム環境変数の編集] を選択し、[環境変数] ボタンをクリックします。
7. [システム環境変数] の下にある Path 行を選択し、[編集] をクリックします。
8. [新規] をクリックして新しい行を追加し、kubectl CLI へのパスを入力します。
9. kubectl version を実行して、CLI の正しいバージョンが適切にインストールされていることを確認します。
  
  kubectl version

次の手順

スタンドアローン管理クラスタをクラウドプロバイダに展開するには、「スタンドアローン管理クラスタの展開」の手順に従います。