本記事はPostgreSQL on Kubernetes Advent Calendar 2018の5日目です。
昨日は「PostgreSQL on Kubernetesのインストール」ということで、Rook上にPostgreSQLを構築し、KubernetesレベルやCephレベルで構築状況を確認しました。
本日は以下のツールを同じKubernetesクラスタ内に構築し、実際にデータベースとしての操作を試していきます。
- pgadmin （PostgreSQLの定番GUIツール）
- pgbench （PostgreSQLのベンチマークツール）
TL;DR
- PostgreSQLの定番管理ツールpgadminをKubernetes内で使ってみよう。
- クラスタ内のPostgreSQLにはサービス名で接続できるよ。
- ユーザとデータベースもGUIで楽々作成。
必要な構成
これまで述べた構成と同様ですが、pgadminとpgbenchを同梱したポッドを以下のツール用サーバに導入します。
- 1台のツール用サーバ。Kubernetes上でラベルとして、type=node.mon.bench が付いていること
pgtoolsの導入
#3でクローンしたものと同じリポジトリを使い、pgtoolsのディレクトリに移動します。
$ cd ./postgres-on-k8s/postgres-install/bench-tools
pgtoolsをデプロイして確認します。
$ kubectl apply -f pgtools.yaml
deployment.apps/pgtools created
service/pgadmin4-nodeport created
$ kubectl get deployment -o wide
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE CONTAINERS IMAGES SELECTOR
pgtools 1 1 1 1 2m pgbench,pgadmin4 tzkoba/pgbench:0.1,dpage/pgadmin4:3.3 app=pgtools
pgtoolsの1ポッドにpgbenchとpgadmin4の2つのコンテナが入っていることが分かりますね。
pgadmin4はこちらのDockerイメージを使っています。
pgbenchは今回のためにCentOSのイメージにPostgreSQL 10のクライアントをインストールしたものを利用しています。
pgadminを使ってみる
今回はpgadmin用にNodePortのサービスを構築していますので、まずはそのポートを確認しましょう。
$ kubectl get svc
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
pgadmin4-nodeport NodePort 10.43.207.114 <none> 80:32273/TCP 8m
ここでは32273となっているので、http://サーバのグローバルIP:32273 で接続するとログイン画面が表示されます。
ログイン時の「Email Address」と「Passwordはpgtools.yaml内に環境変数として設定されているので、お好みに応じて修正をして下さい（初期値はいずれもpgadmin）。
では、第4回に構築したPostgreSQLのデータベースに接続しましょう。
pgadminログイン後の画面で左上の「Servers」を右クリックし、「Create」-「Server」をクリックします。
DB接続用のプロパティを以下のように入力し、「Save」で設定します。
以下の3つは第4回の構築時に使用したpg-rook-configmap.yamlの値と同じにする必要があります。
- Maintenance daatabase
- Username
- Password
そして、ここではホスト名に pg-rook-sf.default.svc を指定していることにも注目です。
Kubernetes内ではサービス名により名前解決ができるようになっており、[サービス名].[名前空間].[svc]で今回構築したデータベースにアクセスできます。
（今回はStatefulSetを使っており、Headless Serviceによるポッド名での名前解決も出来ますが、その説明は別の機会に。）
ユーザとデータベースを作ってみる
次回以降ではpgbenchを使いますので、その準備として以下を構築しておきます。
- benchユーザ
- benchデータベース
まずはユーザを作ります。
先ほどのpg-rook-sfへの接続をSaveしていれば、そのままデータベースに接続されているはずです。
その状態で「pg-rook-sf」-「Login/Group Roles」-「Create」-「Login/GroupRole...」と辿ってクリックして下さい。
ユーザ作成画面が開きますので、「Name」をbenchとして下さい。「Definition」にパスワード設定欄がありますので、こちらはご自由に。
もう一つ、「Privileges」タブの「Can login?」をONにしておかないとログインできないのでここも設定しておきます。「Save」を忘れずに。
ユーザが出来たら、次はデータベースの作成です。
「pg-rook-sf」-「Databases」-「Create」-「Database...」と辿ってクリックして下さい。
以下の入力画面で「Database」をbench、「Owner」もbenchとしたら「Save」で完了です。
まとめ
今回はpgtoolsを導入し、GUI管理ツールであるpgadmin4をコンテナとしてKubernetesクラスタ内に構築してみました。
このあたりが公開されているDockerイメージから簡単にできるのも、PostgreSQL on Kubernetes構成のメリットといえますね。
次回は本日までの準備を踏まえて、pgbenchの使い方を紹介しようと思います。
よろしくお願いします。