オンプレミス環境デプロイメントマニュアル¶
1 はじめに¶
1.1 本書について¶
本書は、オンプレミス環境(物理サーバー、IDC データセンターなどを含みますが、これらに限りません)へのデプロイを対象に、リソースの計画と設定から Guance のデプロイ、稼働までの一連の手順を説明します。
説明:
- 本書では dataflux.cn をメインドメインの例として使用しています。実際のデプロイ時は、該当するドメインに置き換えてください。
1.2 用語¶
| 用語 | 説明 |
|---|---|
| Launcher | Guance のデプロイとインストールに使用する WEB アプリケーションです。Launcher サービスの案内手順に従って、Guance のインストールとアップグレードを完了します |
| 運用操作マシン | kubectl がインストールされ、ターゲットの Kubernetes クラスタと同じネットワーク上にある運用マシンです |
| デプロイ操作マシン | ブラウザから launcher サービスにアクセスし、Guance のガイド、インストール、デバッグを行うマシンです |
| kubectl | Kubernetes のコマンドラインクライアントツールであり、運用操作マシンにインストールします |
1.3 デプロイ手順の構成¶
2 リソースの準備¶
3 インフラストラクチャのデプロイ¶
3.1 ステップ 1 Kubernetes クラスタの作成¶
3.2 ステップ 2 Kubernetes Ingress コンポーネント¶
Kubernetes Ingress コンポーネントのデプロイ
3.3 ステップ 3 プロキシのデプロイ¶
3.4 ステップ 4 NFS のデプロイ¶
3.5 ステップ 5 Kubernetes Storage コンポーネント¶
Kubernetes Storage コンポーネントのデプロイ
3.6 ステップ 6 Redis のデプロイ¶
3.7 ステップ 7 GuanceDB for Metrics のデプロイ¶
3.8 ステップ 8 ログエンジンのデプロイ¶
3.9 ステップ 9 MySQL のデプロイ¶
4 kubectl のインストールと設定¶
4.1 kubectl のインストール¶
kubectl は Kubernetes のコマンドラインクライアントツールであり、このコマンドラインツールを使用してアプリケーションのデプロイやクラスタリソースの確認・管理などを行うことができます。 弊社の Launcher はこのコマンドラインツールをベースにアプリケーションをデプロイしています。具体的なインストール方法は公式ドキュメントを参照してください:
https://kubernetes.io/docs/tasks/tools/install-kubectl/
4.2 kubeconfig の設定¶
kubectl を実行する運用操作マシン上で、ターゲットクラスタの kubeconfig を現在のユーザーの $HOME/.kube/config に保存します。
kubeadm でデプロイしたクラスタでは、管理者用 kubeconfig はデフォルトでコントロールプレーンノードの /etc/kubernetes/admin.conf にあります。このノード上で直接 kubectl を実行する場合は、次を実行します:
mkdir -p "$HOME/.kube"
sudo cp -i /etc/kubernetes/admin.conf "$HOME/.kube/config"
sudo chown "$(id -u):$(id -g)" "$HOME/.kube/config"
chmod 600 "$HOME/.kube/config"
運用操作マシンが別のホストである場合は、クラスタ管理者から適用可能な kubeconfig を入手し、その操作マシンの $HOME/.kube/config に保存してください。その際、API Server のアドレスが操作マシンからアクセス可能であることを確認してください。その他のデプロイ方法の場合は、それぞれのデプロイツールが生成した kubeconfig を使用してください。
設定後、kubectl get nodes を実行して、ターゲットクラスタにアクセスできることを確認します。詳細は kubeadm クラスタのアクセス設定 を参照してください。
5 Guance のインストールを開始する¶
操作が完了したら、マニュアル インストールの開始 を参照してください。
