インストール・ガイド

Verrazzanoのインストール方法

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

前提条件

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

ノート

Verrazzanoシステム・コンポーネントとの競合を回避するために、Verrazzanoを空のクラスタにインストールすることをお薦めします。

インストールの準備

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

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

Verrazzanoは、Verrazzano CLIまたはkubectlを使用してインストールできます。次の各項を参照してください。

Verrazzanoは、Verrazzanoインストールのライフサイクルを管理するためのプラットフォーム・オペレータを提供します。Verrazzanoカスタム・リソースを使用して、Verrazzanoインストールのインストール、アンインストールおよびアップグレードを行うことができます。

インストールの実行

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

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

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

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

Verrazzano構成オプションの詳細は、Verrazzanoカスタム・リソース定義を参照してください。

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

Verrazzanoのインストール

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

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カスタム・リソースを適用します。

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

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

Verrazzanoプラットフォーム・オペレータのインストール

Verrazzanoプラットフォーム・オペレータをインストールするには:

Verrazzanoプラットフォーム・オペレータをデプロイします。

$ kubectl apply -f https://github.com/verrazzano/verrazzano/releases/download/v1.4.8/verrazzano-platform-operator.yaml

デプロイが完了するまで待ちます。

$ kubectl -n verrazzano-install rollout status deployment/verrazzano-platform-operator

# Expected response
deployment "verrazzano-platform-operator" successfully rolled out

オペレータ・ポッドが正しく定義され、実行中であることを確認します。

$ kubectl -n verrazzano-install get pods

# Sample output
NAME                                            READY   STATUS    RESTARTS   AGE
verrazzano-platform-operator-59d5c585fd-lwhsx   1/1     Running   0          114s

インストールの実行

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

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

Verrazzano構成オプションの詳細は、Verrazzanoカスタム・リソース定義を参照してください。

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

Verrazzanoのインストール

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

$ kubectl apply -f - <<EOF
apiVersion: install.verrazzano.io/v1beta1
kind: Verrazzano
metadata:
  name: example-verrazzano
spec:
  profile: ${VZ_PROFILE:-dev}
EOF
$ kubectl wait \
    --timeout=20m \
    --for=condition=InstallComplete verrazzano/example-verrazzano

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

エラーが発生した場合は、インストールのログ出力を確認します次のコマンドでログを表示できます

$ kubectl logs -n verrazzano-install \
    -f $(kubectl get pod \
    -n verrazzano-install \
    -l app=verrazzano-platform-operator \
    -o jsonpath="{.items[0].metadata.name}") | grep '^{.*}$' \
    | jq -r '."@timestamp" as $timestamp | "\($timestamp) \(.level) \(.message)"'

インストールの検証

Verrazzanoは複数のオブジェクトを複数のネームスペースにインストールします。verrazzano-systemネームスペースでは、Running状態のすべてのポッドでVerrazzanoが稼働中であることは必ずしも保証されませんが、そうであることを示している可能性は高いです。

$ kubectl get pods -n verrazzano-system

# Sample output
coherence-operator-dcfb446df-24djp                 1/1     Running   1          49m
fluentd-h65xf                                      2/2     Running   1          45m
oam-kubernetes-runtime-6645df49cd-6q96c            1/1     Running   0          49m
verrazzano-application-operator-85ffd7f77b-rhwk7   1/1     Running   0          48m
verrazzano-authproxy-58db5b9484-nhnql              2/2     Running   0          45m
verrazzano-console-5dbdc579bd-hm4rh                2/2     Running   0          45m
verrazzano-monitoring-operator-599654889d-lbb4z    1/1     Running   0          45m
verrazzano-operator-7b6fd64dd5-8j9h8               1/1     Running   0          45m
vmi-system-es-master-0                             2/2     Running   0          45m
vmi-system-grafana-5558d65b46-pxg78                2/2     Running   0          45m
vmi-system-kiali-5949966fb8-465s8                  2/2     Running   0          48m
vmi-system-kibana-86b894d8f6-q4vb5                 2/2     Running   0          45m
weblogic-operator-646756c75c-hgz6j                 2/2     Running   0          49m

インストールのトラブルシューティングのヘルプは、「分析アドバイス」を参照してください。

インストールの完了後、Verrazzanoコンソールを使用できます。コンソールのURLおよび資格証明の取得方法の詳細は、「Verrazzanoへのアクセス」を参照してください。

次のステップ

(オプション)ここにあるサンプル・アプリケーションを実行します。

フィードバック

このページは役に立ちましたか。

ありがとうございます。お気づきの点がございましたら、お聞かせください。

申し訳ございません。お気づきの点がございましたら、お聞かせください。