インストール・ガイド
次の手順では、単一のKubernetesクラスタにVerrazzanoをインストールする方法を示します。
前提条件
インストールの準備
Verrazzanoをインストールする前に、Kubernetesプラットフォームの準備に関する手順を参照してください。
ノート: Verrazzanoは、ポッドがネットワーク通信に使用するポートおよびプロトコルを制限するために使用できるネットワーク・ポリシーを作成できます。ネットワーク・ポリシーによって追加のセキュリティが提供されますが、適用するKubernetes Container Network Interface (CNI)プラグイン(Calicoなど)をインストールした場合のみ適用されます。CNIプラグインのインストール手順については、Kubernetesクラスタのドキュメントを参照してください。
Verrazzanoプラットフォーム・オペレータのインストール
Verrazzanoは、Verrazzanoインストールのライフサイクルを管理するためのプラットフォーム・オペレータを提供します。Verrazzanoカスタム・リソースを使用して、Verrazzanoインストールのインストール、アンインストールおよびアップグレードを行うことができます。
Verrazzanoプラットフォーム・オペレータをインストールするには:
-
Verrazzanoプラットフォーム・オペレータをデプロイします。
$ kubectl apply -f https://github.com/verrazzano/verrazzano/releases/download/v1.2.2/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)、本番(prod)および管理対象クラスタ(managed-cluster)といったインストール・プロファイルがサポートされています。プロファイルの詳細は、インストール・プロファイルを参照してください。
このページでは、次のものを使用した基本的なVerrazzanoインストールの作成方法を示します:
- 開発(
dev)インストール・プロファイル - ワイルドカードDNS。DNSはnip.io(デフォルト)によって提供されます
ノート
devプロファイルは自己署名証明書をインストールするため、VerrazzanoをmacOSにインストールすると、「接続はプライベートではありません」と表示されます。回避策は、このFAQを参照してください。
Verrazzano構成オプションの詳細は、Verrazzanoカスタム・リソース定義を参照してください。
その他のDNSオプションを使用するには、DNSのカスタマイズのページで詳細を参照してください。
Verrazzanoのインストール
前の項の説明に従ってVerrazzanoインストールを作成するには、次のコマンドを実行します:
$ kubectl apply -f - <<EOF
apiVersion: install.verrazzano.io/v1alpha1
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)"'
インストールのトラブルシューティングの詳細は、分析アドバイスを参照してください。
インストールの完了後、コンソールURLを使用できます。Verrazzanoコンソールへのアクセス方法の詳細は、Verrazzanoへのアクセスを参照してください。
インストールの検証
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
vmi-system-prometheus-0-859fcd87dc-m5ws9 3/3 Running 0 44m
weblogic-operator-646756c75c-hgz6j 2/2 Running 0 49m
(オプション)サンプル・アプリケーションの実行
サンプル・アプリケーションについては、こちらを参照してください。