このトピックでは、ブートストラップ マシンに Tanzu コマンド ライン インターフェイス (CLI) をインストールして初期化する方法について説明します。ブートストラップ マシンは、管理クラスタとワークロード クラスタを展開するラップトップ、ホスト、またはサーバで、展開環境の Tanzu および Kubernetes 構成ファイルを保持します。ブートストラップ マシンは通常ローカルですが、リモートからアクセスする物理マシンまたは仮想マシンの場合もあります。
スーパーバイザーを使用しない 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.2 ワークロード クラスタの作成と管理」の対応するトピック「vSphere with Tanzu スーパーバイザーで使用する Tanzu CLI およびその他のツールのインストール」を参照してください。
コマンド リファレンスを含む Tanzu CLI の詳細については、VMware Tanzu CLI のドキュメントを参照してください。
Tanzu CLI をインストールして実行するブートストラップ マシンは、特定の要件を満たしている必要があります。管理クラスタとしての vSphere with Tanzu スーパーバイザーで Tanzu CLI を使用するか、スタンドアローン管理クラスタを展開するか、またはその両方を実行するかに応じて、さらに要件があります。
Tanzu Kubernetes Grid v2.2 で Tanzu CLI を実行するには、Tanzu CLI をインストールして実行するブートストラップ マシンに以下が必要です。
ブートストラップ マシンが 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 環境への管理クラスタの展開の準備」を参照してください。
スタンドアローン管理クラスタを展開するには、ブートストラップ マシンが実行されているオペレーティング システムに応じて、追加の要件があります。
kind
コンテナに対応するために、Docker デスクトップに少なくとも 6 GB のメモリを割り当てる。kind
ドキュメントの「Settings for Docker Desktop」を参照してください。snap
の代わりに apt
を使用します。インターネットが制限された環境に Docker クライアント アプリケーションをインストールする手順については、「インターネットが制限された環境の準備」を参照してください。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 modprob nf_conntrack
「既存のブートストラップ クラスタを使用した管理クラスタの展開と削除」の説明に従ってトラブルシューティングを行う場合は、kind
v0.11 以降を使用して、事前に存在するパーシステント ブートストラップ クラスタを作成する必要があります。
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 Kubernetes Grid のダウンロード ページから、互換性のあるバージョンの Tanzu CLI のファイルをダウンロードします。
VMware Customer Connect にアクセスし、VMware Customer Connect の認証情報を使用してログインします。
Tanzu Kubernetes Grid のダウンロード ページにアクセスします。
VMware Tanzu Kubernetes Grid の行で、[ダウンロードに移動 (Go to Downloads)] をクリックします。
[バージョンの選択 (Select Version)] ドロップダウンで、[2.2.0] を選択します。
[製品のダウンロード (Product Downloads)] で、「VMware Tanzu CLI 2.2.0」というラベルの付いたセクションまでスクロールします。
(オプション)ダウンロードしたファイルが元のファイルから変更されていないことを確認します。VMware は、ダウンロードごとに SHA-1、SHA-256、および MD5 チェックサムを提供します。これらのチェックサムを取得するには、ダウンロードするエントリの下にある [詳細を表示] をクリックします。詳細については、「暗号化ハッシュの使用」を参照してください。
システムで、tanzu
という名前の新しいディレクトリを作成します。以前のリリースのアーティファクトをこのフォルダに展開した場合は、フォルダの既存の内容を削除します。
tanzu
フォルダで、オペレーティング システムに対応した Tanzu CLI バンドル ファイルを展開します。バンドル ファイルを展開するには、選択した抽出ツールを使用します。たとえば、Linux または macOS では、tar
コマンドを使用できます。
tar -xvf tanzu-cli-bundle-darwin-amd64.tar.gz
tar -xvf tanzu-cli-bundle-linux-amd64.tar.gz
tanzu-cli-bundle-windows-amd64.zip
を解凍します。
バンドル ファイルを展開すると、tanzu
フォルダに、複数のサブフォルダとファイルを含む cli
フォルダが表示されます。
ブートストラップ マシンで Tanzu CLI をダウンロードして展開したら、システムで使用できるようにする必要があります。
前のセクションで展開した tanzu
フォルダの下にある cli
サブフォルダに移動します。
cd cli
CLI をシステムで使用できるようにします。
/usr/local/bin
にインストールします。
sudo install core/v0.29.0/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
/usr/local/bin
にインストールします。
sudo install core/v0.29.0/tanzu-core-linux_amd64 /usr/local/bin/tanzu
Program Files\tanzu
フォルダを作成します。cli
フォルダで、core\v0.29.0\tanzu-core-windows_amd64.exe
ファイルを見つけて新しい Program Files\tanzu
フォルダにコピーします。tanzu-core-windows_amd64.exe
の名前を tanzu.exe
に変更します。tanzu
フォルダを右クリックして [プロパティ] > [セキュリティ] を選択し、ユーザー アカウントに [フル コントロール] 権限があることを確認します。env
を検索します。Path
行を選択し、[編集] をクリックします。tanzu
CLI へのパスを入力します。新しいターミナルのコマンド ラインで、Tanzu CLI を初期化します。
tanzu init
CLI の正しいバージョンが正しくインストールされていることを確認します。CLI バージョンは、Tanzu CLI に含まれる現在のバージョンの Tanzu フレームワークと同じです。Tanzu Kubernetes Grid 2.2 は、Tanzu Framework v0.29.0 にある Tanzu CLI v0.29.0 を使用します。
tanzu version
macOS で実行している場合は、次のエラーが発生する可能性があります。
"tanzu" cannot be opened because the developer cannot be verified.
この場合は、tanzu
実行ファイルのセキュリティ例外を作成する必要があります。Finder で tanzu
アプリケーションを見つけ、Control キーを押しながらアプリケーションをクリックし、[開く] を選択します。
以前の CLI インストールからマシンに既存の Tanzu CLI プラグインがインストールされている場合は、プラグインを現在の CLI バージョンに更新します。
既存のプラグインをアンインストールします。
tanzu plugin clean
このリリースのすべてのプラグインをインストールします。
tanzu plugin sync
プラグインのインストール ステータスとバージョンを確認します。
tanzu plugin list
注Tanzu CLI をインストールした後でも、これを使用して管理クラスタにログインするまでは、コンテキスト固有のすべての CLI コマンド グループ(
tanzu cluster
、tanzu kubernetes-release
など)は使用できず、Tanzu CLI の--help
の出力にも含まれません。
ブートストラップ マシンで Kubernetes CLI kubectl
をダウンロードして展開し、システムで使用できるようにします。
VMware Customer Connect にアクセスし、VMware Customer Connect の認証情報を使用してログインします。
Tanzu Kubernetes Grid のダウンロード ページにアクセスします。
VMware Tanzu Kubernetes Grid の行で、[ダウンロードに移動 (Go to Downloads)] をクリックします。
[バージョンの選択 (Select Version)] ドロップダウンで、[2.2.0] を選択します。
[製品のダウンロード (Product Downloads)] で、VMware Tanzu Kubernetes Grid 2.2.0 の Kubectl 1.25.7 というラベルのセクションまでスクロールします。
(オプション)ダウンロードしたファイルが元のファイルから変更されていないことを確認します。VMware は、ダウンロードごとに SHA-1、SHA-256、および MD5 チェックサムを提供します。これらのチェックサムを取得するには、ダウンロードするエントリの下にある [詳細を表示] をクリックします。詳細については、「暗号化ハッシュの使用」を参照してください。
上記の「Tanzu CLI のダウンロードと展開」で作成した tanzu
ディレクトリに移動し、オペレーティング システムに対応した kubectl
バイナリを展開します。バンドル ファイルを展開するには、選択した抽出ツールを使用します。たとえば、gunzip
コマンドなどです。
gunzip kubectl-mac-v1.25.7+vmware.2.gz
gunzip kubectl-linux-v1.25.7+vmware.2.gz
kubectl-windows-v1.25.7+vmware.2.exe.gz
を解凍します。
CLI をシステムで使用できるようにします。
ダウンロードしたファイルを実行可能にします。
chmod ugo+x kubectl-mac-v1.25.7+vmware.2
バイナリを /usr/local/bin
にインストールします。
sudo install kubectl-mac-v1.25.7+vmware.2 /usr/local/bin/kubectl
kubectl version
を実行して、kubectl
の正しいバージョンがインストールされ、実行可能であることを確認します。
kubectl version
ダウンロードしたファイルを実行可能にします。
chmod ugo+x kubectl-linux-v1.25.7+vmware.2
バイナリを /usr/local/bin
にインストールします。
sudo install kubectl-linux-v1.25.7+vmware.2 /usr/local/bin/kubectl
kubectl version
を実行して、kubectl
の正しいバージョンがインストールされ、実行可能であることを確認します。
kubectl version
Program Files\kubectl
フォルダを作成します。kubectl-windows-v1.25.7+vmware.2.exe
ファイルを見つけて、新しい Program Files\kubectl
フォルダにコピーします。kubectl-windows-v1.25.7+vmware.1.exe
の名前を kubectl.exe
に変更します。kubectl
フォルダを右クリックして [プロパティ] > [セキュリティ] を選択し、ユーザー アカウントに [フル コントロール] 権限があることを確認します。env
を検索します。Path
行を選択し、[編集] をクリックします。kubectl
CLI へのパスを入力します。kubectl version
を実行して、CLI の正しいバージョンが適切にインストールされていることを確認します。
tanzu --help
を実行して、Tanzu CLI が提供するコマンドのリストを表示します。
特定のコマンドまたはコマンド グループに関する情報を表示するには、--help
オプションを使用して任意のコマンド グループのヘルプ テキストを表示します。たとえば、tanzu login --help
、tanzu management-cluster --help
、tanzu management-cluster create --help
などです。
Tanzu CLI の詳細については、「Tanzu CLI コマンド リファレンス」を参照してください。
Carvel オープンソース プロジェクト では、アプリケーションの構築、構成、Kubernetes への展開を支援する、信頼性の高い、単一用途の構成可能なツール セットが提供されます。
Tanzu Kubernetes Grid は、Tanzu CLI にバンドルされている ytt
、kapp
、kbld
、および imgpkg
の署名付きバイナリを提供します。バンドルには、kubernetes ディレクトリ構造ツール vendir
も含まれています。これは、現在エンド ユーザーに必要ではありませんが、便宜上提供されています。
ブートストラップ環境マシン上の、OS に対応した Tanzu CLI バンドル tar ファイルを展開した場所に移動します。
たとえば、前の手順で作成した tanzu
フォルダなどです。
cli
フォルダを開きます。
cd cli
ytt
のインストールytt
は YAML ファイルのテンプレート化とパッチ適用のためのコマンドライン ツールです。また、ytt
を使用して、YAML のフラグメントとパイルをモジュールのチャンクに収集し、簡単に再利用することもできます。Tanzu Kubernetes Grid は、ytt
を使用してクラスタおよびクラスタ プランのオーバーレイベースのカスタマイズをサポートします。カスタマイズ オーバーレイを使用するには、ytt
が必要になる場合があります。
ytt
バイナリを展開し、実行可能にします。
gunzip ytt-darwin-amd64-v0.43.1+vmware.1.gz
chmod ugo+x ytt-darwin-amd64-v0.43.1+vmware.1
バイナリを /usr/local/bin
に移動し、名前を ytt
に変更します。
sudo mv ./ytt-darwin-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt
ytt --version
を実行して、ytt
の正しいバージョンがインストールされ、実行可能であることを確認します。
ytt --version
ytt
バイナリを展開し、実行可能にします。
gunzip ytt-linux-amd64-v0.43.1+vmware.1.gz
chmod ugo+x ytt-linux-amd64-v0.43.1+vmware.1
バイナリを /usr/local/bin
に移動し、名前を ytt
に変更します。
sudo mv ./ytt-linux-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt
ytt --version
を実行して、ytt
の正しいバージョンがインストールされ、実行可能であることを確認します。
ytt --version
ytt
バイナリを展開します。
gunzip ytt-windows-amd64-v0.43.1+vmware.1.gz
ytt-windows-amd64-v0.43.1+vmware.1
の名前を ytt.exe
に変更します。
Program Files\ytt
フォルダを作成し、そこに ytt.exe
ファイルをコピーします。ytt
フォルダを右クリックして [プロパティ] > [セキュリティ] を選択し、ユーザー アカウントに [フル コントロール] 権限があることを確認します。env
を検索します。Path
行を選択し、[編集] をクリックします。ytt
ツールへのパスを入力します。ytt version
を実行し、ytt
の正しいバージョンが適切にインストールされていることを確認します。kapp
のインストールkapp
は Kubernetes のアプリケーション展開 CLI です。これにより、複数の Kubernetes リソースを 1 つのアプリケーションとしてインストール、アップグレード、および削除することができます。
kapp
バイナリを展開し、実行可能にします。
gunzip kapp-darwin-amd64-v0.53.2+vmware.1.gz
chmod ugo+x kapp-darwin-amd64-v0.53.2+vmware.1
バイナリを /usr/local/bin
に移動し、名前を kapp
に変更します。
sudo mv ./kapp-darwin-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp
kapp --version
を実行して、kapp
の正しいバージョンがインストールされ、実行可能であることを確認します。
kapp --version
kapp
バイナリを展開し、実行可能にします。
gunzip kapp-linux-amd64-v0.53.2+vmware.1.gz
chmod ugo+x kapp-linux-amd64-v0.53.2+vmware.1
バイナリを /usr/local/bin
に移動し、名前を kapp
に変更します。
sudo mv ./kapp-linux-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp
kapp --version
を実行して、kapp
の正しいバージョンがインストールされ、実行可能であることを確認します。
kapp --version
kapp
バイナリを展開します。
gunzip kapp-windows-amd64-v0.53.2+vmware.1.gz
kapp-windows-amd64-v0.53.2+vmware.1
の名前を kapp.exe
に変更します。
Program Files\kapp
フォルダを作成し、そこに kapp.exe
ファイルをコピーします。kapp
フォルダを右クリックして [プロパティ] > [セキュリティ] を選択し、ユーザー アカウントに [フル コントロール] 権限があることを確認します。env
を検索します。Path
行を選択し、[編集] をクリックします。kapp
ツールへのパスを入力します。kapp version
を実行し、kapp
の正しいバージョンが適切にインストールされていることを確認します。kbld
のインストールkbld
はイメージのビルドおよび解像度ツールです。
kbld
バイナリを展開し、実行可能にします。
gunzip kbld-darwin-amd64-v0.35.1+vmware.1.gz
chmod ugo+x kbld-darwin-amd64-v0.35.1+vmware.1
バイナリを /usr/local/bin
に移動し、名前を kbld
に変更します。
sudo mv ./kbld-darwin-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld
kbld --version
を実行して、kbld
の正しいバージョンがインストールされ、実行可能であることを確認します。
kbld
バイナリを展開し、実行可能にします。
gunzip kbld-linux-amd64-v0.35.1+vmware.1.gz
chmod ugo+x kbld-linux-amd64-v0.35.1+vmware.1
バイナリを /usr/local/bin
に移動し、名前を kbld
に変更します。
sudo mv ./kbld-linux-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld
kbld --version
を実行して、kbld
の正しいバージョンがインストールされ、実行可能であることを確認します。
kbld --version
kbld
バイナリを展開します。
gunzip kbld-windows-amd64-v0.35.1+vmware.1.gz
kbld-windows-amd64-v0.35.1+vmware.1
の名前を kbld.exe
に変更します。
Program Files\kbld
フォルダを作成し、そこに kbld.exe
ファイルをコピーします。kbld
フォルダを右クリックして [プロパティ] > [セキュリティ] を選択し、ユーザー アカウントに [フル コントロール] 権限があることを確認します。env
を検索します。Path
行を選択し、[編集] をクリックします。kbld
ツールへのパスを入力します。kbld version
を実行し、kbld
の正しいバージョンが適切にインストールされていることを確認します。imgpkg
のインストールimgpkg
は Kubernetes が構成および関連するコンテナ イメージを OCI イメージとして保存し、転送できるようにするツールです。imgpkg
は、インターネット アクセスが制限された環境に Tanzu Kubernetes Grid を展開する場合や、独自のマシン イメージをビルドする場合に必要です。Harbor パッケージを構成する場合にも必要となります。
imgpkg
バイナリを展開し、実行可能にします。
gunzip imgpkg-darwin-amd64-v0.31.1+vmware.1.gz
chmod ugo+x imgpkg-darwin-amd64-v0.31.1+vmware.1
バイナリを /usr/local/bin
に移動し、名前を imgpkg
に変更します。
sudo mv ./imgpkg-darwin-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg
imgpkg --version
を実行して、imgpkg
の正しいバージョンがインストールされ、実行可能であることを確認します。
imgpkg --version
imgpkg
バイナリを展開し、実行可能にします。
gunzip imgpkg-linux-amd64-v0.31.1+vmware.1.gz
chmod ugo+x imgpkg-linux-amd64-v0.31.1+vmware.1
バイナリを /usr/local/bin
に移動し、名前を imgpkg
に変更します。
sudo mv ./imgpkg-linux-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg
imgpkg --version
を実行して、imgpkg
の正しいバージョンがインストールされ、実行可能であることを確認します。
imgpkg --version
imgpkg
バイナリを展開します。
gunzip imgpkg-windows-amd64-v0.31.1+vmware.1.gz
imgpkg-windows-amd64-v0.31.1+vmware.1
の名前を imgpkg.exe
に変更します。
Program Files\imgpkg
フォルダを作成し、そこに imgpkg.exe
ファイルをコピーします。imgpkg
フォルダを右クリックして [プロパティ] > [セキュリティ] を選択し、ユーザー アカウントに [フル コントロール] 権限があることを確認します。env
を検索します。Path
行を選択し、[編集] をクリックします。imgpkg
ツールへのパスを入力します。imgpkg version
を実行し、imgpkg
の正しいバージョンが適切にインストールされていることを確認します。スタンドアローン管理クラスタをクラウド プロバイダに展開するには、「スタンドアローン管理クラスタの展開」の手順に従います。