CLIを使用したインストール

vz CLIを使用したVerrazzanoのインストール

次の手順では、CLIを使用して単一のKubernetesクラスタにVerrazzanoをインストールする方法を示します。

前提条件

  • Verrazzanoの前提条件の要件は、ここを参照してください。
  • Verrazzanoでサポートおよびインストールされるソフトウェア・バージョンのリストを確認します。

インストールの準備

Verrazzanoをインストールする前に、Kubernetesプラットフォームの準備とVerrazzano CLIのインストール(オプション)の手順を参照してください。Verrazzanoのインストールに使用するKubernetesクラスタを指す有効なkubeconfigファイルがあることを確認してください。

ノート: Verrazzanoは、ポッドがネットワーク通信に使用するポートおよびプロトコルを制限するために使用できるネットワーク・ポリシーを作成できます。ネットワーク・ポリシーによって追加のセキュリティが提供されますが、適用するKubernetes Container Network Interface (CNI)プラグイン(Calicoなど)をインストールした場合のみ適用されます。CNIプラグインのインストール手順については、Kubernetesクラスタのドキュメントを参照してください。

インストールの実行

Verrazzanoは、Verrazzanoインストールのライフサイクルを管理するためのプラットフォーム・オペレータを提供します。Verrazzanoカスタム・リソースを使用して、Verrazzanoインストールのインストール、アンインストールおよびアップグレードを行うことができます。Verrazzanoカスタム・リソースを適用すると、Verrazzano CLIはVerrazzanoプラットフォーム・オペレータをデプロイおよびインストールします。次のセクションで説明するように、必要なのはVerrazzanoをインストールすることだけです。

Verrazzanoでは、開発(dev)、本番(prod)および管理対象クラスタ(managed-cluster)といったインストール・プロファイルがサポートされています。詳細は、「インストール・プロファイル」を参照してください。

このドキュメントでは、次のものを使用した基本的なVerrazzanoインストールの作成方法を示します:

  • 開発(dev)インストール・プロファイル
  • ワイルドカードDNS。DNSはnip.io(デフォルト)によって提供されます

ノート: devプロファイルは自己署名証明書をインストールするため、VerrazzanoをmacOSにインストールすると、「接続はプライベートではありません」と表示されることがあります。回避策は、このFAQを参照してください。

Verrazzanoの構成方法の概要は、「Verrazzanoインストールの変更」を参照してください。Verrazzano構成オプションの詳細は、Verrazzanoカスタム・リソース定義を参照してください。

その他のDNSオプションを使用するには、「DNSのカスタマイズ」で詳細を参照してください。

Verrazzanoのインストール

前の項の説明に従ってVerrazzanoインストールを作成するには、次のコマンドを実行します

  1. devプロファイルを使用してVerrazzanoをインストールします。 
    $ vz install -f - <<EOF
apiVersion: install.verrazzano.io/v1beta1
kind: Verrazzano
metadata:
  name: example-verrazzano
spec:
  profile: dev
  defaultVolumeSource:
    persistentVolumeClaim:
      claimName: verrazzano-storage
  volumeClaimSpecTemplates:
    - metadata:
        name: verrazzano-storage
      spec:
        resources:
          requests:
            storage: 2Gi
EOF

このコマンドは、Verrazzanoプラットフォーム・オペレータをインストールし、Verrazzanoカスタム・リソースを適用します。

  1. インストールが完了するまで待ちます。インストールが完了するか、デフォルトのタイムアウト(30分)に達するまで、インストール・ログがコマンド・ウィンドウにストリーミングされます。

前述の例で別のプロファイルを使用するには、VZ_PROFILE環境変数をインストール対象のプロファイルの名前に設定します。

次のステップ

vz CLIを使用して、インストールされたVerrazzanoを検証します。「CLIを使用した検証」を参照してください。