331 lines
9.0 KiB
Markdown
331 lines
9.0 KiB
Markdown
# phpMyAdmin with nginx Helm Chart
|
|
|
|
このHelmチャートは、nginx をリバースプロキシとして使用する phpMyAdmin をKubernetes上にデプロイします。
|
|
|
|
## 機能
|
|
|
|
- ✅ nginx (1.29.3-alpine-perl) + phpMyAdmin (5.2.3-fpm-alpine) のマルチコンテナ構成
|
|
- ✅ 本番環境対応のセキュリティ設定
|
|
- ✅ **自動バックアップ機能（CronJob）**
|
|
- 定期的なMySQLデータベースバックアップ
|
|
- PVCまたは外部NFSへの保存対応
|
|
- 圧縮・世代管理機能
|
|
- ✅ Horizontal Pod Autoscaler (HPA) サポート
|
|
- ✅ Pod Disruption Budget (PDB) による高可用性
|
|
- ✅ Network Policy によるネットワーク分離
|
|
- ✅ セッション永続化のための PersistentVolume サポート
|
|
- ✅ Ingress サポート (TLS対応)
|
|
- ✅ リソース制限の設定
|
|
- ✅ Liveness/Readiness プローブ
|
|
- ✅ Security Context による権限制御
|
|
|
|
## 前提条件
|
|
|
|
- Kubernetes 1.19+
|
|
- Helm 3.0+
|
|
- MySQL/MariaDB サーバー
|
|
|
|
## インストール
|
|
|
|
### 基本的なインストール
|
|
|
|
```bash
|
|
helm install phpmyadmin ./phpmyadmin-nginx
|
|
```
|
|
|
|
### カスタム設定でのインストール
|
|
|
|
```bash
|
|
helm install phpmyadmin ./phpmyadmin-nginx \
|
|
--set phpmyadmin.hosts[0].host=mysql.default.svc.cluster.local \
|
|
--set phpmyadmin.hosts[0].port=3306 \
|
|
--set ingress.enabled=true \
|
|
--set ingress.hosts[0].host=phpmyadmin.example.com
|
|
```
|
|
|
|
### values.yaml を使用したインストール
|
|
|
|
```bash
|
|
helm install phpmyadmin ./phpmyadmin-nginx -f custom-values.yaml
|
|
```
|
|
|
|
## 設定例
|
|
|
|
### 1. 複数のMySQLサーバーへの接続
|
|
|
|
```yaml
|
|
phpmyadmin:
|
|
hosts:
|
|
- host: mysql-primary.default.svc.cluster.local
|
|
port: 3306
|
|
- host: mysql-secondary.default.svc.cluster.local
|
|
port: 3306
|
|
```
|
|
|
|
### 2. Ingress の有効化 (TLS対応)
|
|
|
|
```yaml
|
|
ingress:
|
|
enabled: true
|
|
className: nginx
|
|
annotations:
|
|
cert-manager.io/cluster-issuer: "letsencrypt-prod"
|
|
nginx.ingress.kubernetes.io/rate-limit: "10"
|
|
hosts:
|
|
- host: phpmyadmin.example.com
|
|
paths:
|
|
- path: /
|
|
pathType: Prefix
|
|
tls:
|
|
- secretName: phpmyadmin-tls
|
|
hosts:
|
|
- phpmyadmin.example.com
|
|
```
|
|
|
|
### 3. オートスケーリングの有効化
|
|
|
|
```yaml
|
|
autoscaling:
|
|
enabled: true
|
|
minReplicas: 2
|
|
maxReplicas: 10
|
|
targetCPUUtilizationPercentage: 80
|
|
targetMemoryUtilizationPercentage: 80
|
|
```
|
|
|
|
### 4. Network Policy の有効化
|
|
|
|
```yaml
|
|
networkPolicy:
|
|
enabled: true
|
|
policyTypes:
|
|
- Ingress
|
|
- Egress
|
|
ingress:
|
|
- from:
|
|
- namespaceSelector:
|
|
matchLabels:
|
|
name: ingress-nginx
|
|
ports:
|
|
- protocol: TCP
|
|
port: 8080
|
|
egress:
|
|
- to:
|
|
- podSelector:
|
|
matchLabels:
|
|
app: mysql
|
|
ports:
|
|
- protocol: TCP
|
|
port: 3306
|
|
```
|
|
|
|
### 5. セッション永続化
|
|
|
|
```yaml
|
|
persistence:
|
|
enabled: true
|
|
storageClass: "standard"
|
|
accessMode: ReadWriteMany
|
|
size: 1Gi
|
|
```
|
|
|
|
### 6. 自動バックアップの有効化（PVC使用）
|
|
|
|
```yaml
|
|
backup:
|
|
enabled: true
|
|
# 毎日午前2時にバックアップ
|
|
schedule: "0 2 * * *"
|
|
|
|
# MySQL接続情報はphpmyadmin.hostsから自動取得
|
|
mysql:
|
|
user: "backup_user"
|
|
password: "your-backup-password"
|
|
|
|
# 特定のデータベースのみバックアップ
|
|
databases:
|
|
- myapp_db
|
|
- analytics_db
|
|
|
|
# バックアップの圧縮
|
|
compression:
|
|
enabled: true
|
|
level: 6
|
|
|
|
# 30日以上古いバックアップを自動削除
|
|
retention:
|
|
enabled: true
|
|
days: 30
|
|
|
|
# PVCストレージ設定
|
|
persistence:
|
|
storageClass: "standard"
|
|
accessMode: ReadWriteMany
|
|
size: 50Gi
|
|
```
|
|
|
|
### 7. 自動バックアップの有効化（NFS使用）
|
|
|
|
```yaml
|
|
backup:
|
|
enabled: true
|
|
schedule: "0 2 * * *"
|
|
|
|
# MySQL接続情報はphpmyadmin.hostsから自動取得
|
|
mysql:
|
|
existingSecret: "mysql-backup-credentials"
|
|
|
|
# NFSストレージ設定
|
|
nfs:
|
|
enabled: true
|
|
server: "nfs-server.example.com"
|
|
path: "/exports/mysql-backups"
|
|
```
|
|
|
|
### 8. 既存のSecretを使用したバックアップ
|
|
|
|
```yaml
|
|
backup:
|
|
enabled: true
|
|
mysql:
|
|
existingSecret: "mysql-backup-secret"
|
|
userKey: "username"
|
|
passwordKey: "password"
|
|
```
|
|
|
|
## パラメータ
|
|
|
|
### グローバル設定
|
|
|
|
| パラメータ | 説明 | デフォルト値 |
|
|
|----------|------|------------|
|
|
| `replicaCount` | レプリカ数 | `2` |
|
|
| `image.nginx.registry` | nginx イメージレジストリ | `docker.io` |
|
|
| `image.nginx.repository` | nginx リポジトリ | `nginx` |
|
|
| `image.nginx.tag` | nginx イメージタグ | `1.29.3-alpine-perl` |
|
|
| `image.phpmyadmin.registry` | phpMyAdmin イメージレジストリ | `docker.io` |
|
|
| `image.phpmyadmin.repository` | phpMyAdmin リポジトリ | `phpmyadmin` |
|
|
| `image.phpmyadmin.tag` | phpMyAdmin イメージタグ | `5.2.3-fpm-alpine` |
|
|
|
|
### サービス設定
|
|
|
|
| パラメータ | 説明 | デフォルト値 |
|
|
|----------|------|------------|
|
|
| `service.type` | Serviceタイプ | `ClusterIP` |
|
|
| `service.port` | Serviceポート | `80` |
|
|
| `service.targetPort` | ターゲットポート | `8080` |
|
|
|
|
### phpMyAdmin 設定
|
|
|
|
| パラメータ | 説明 | デフォルト値 |
|
|
|----------|------|------------|
|
|
| `phpmyadmin.hosts[0].host` | MySQLホスト | `mysql.default.svc.cluster.local` |
|
|
| `phpmyadmin.hosts[0].port` | MySQLポート | `3306` |
|
|
| `phpmyadmin.env.PMA_ARBITRARY` | 任意サーバー接続許可 | `"0"` |
|
|
| `phpmyadmin.env.UPLOAD_LIMIT` | アップロード制限 | `"128M"` |
|
|
| `phpmyadmin.env.MEMORY_LIMIT` | メモリ制限 | `"512M"` |
|
|
| `phpmyadmin.blowfishSecret` | Blowfish暗号化キー | `""` (自動生成) |
|
|
|
|
### リソース設定
|
|
|
|
| パラメータ | 説明 | デフォルト値 |
|
|
|----------|------|------------|
|
|
| `resources.nginx.requests.cpu` | nginx CPU要求 | `100m` |
|
|
| `resources.nginx.requests.memory` | nginx メモリ要求 | `64Mi` |
|
|
| `resources.phpmyadmin.requests.cpu` | phpMyAdmin CPU要求 | `250m` |
|
|
| `resources.phpmyadmin.requests.memory` | phpMyAdmin メモリ要求 | `256Mi` |
|
|
|
|
### バックアップ設定
|
|
|
|
| パラメータ | 説明 | デフォルト値 |
|
|
|----------|------|------------|
|
|
| `backup.enabled` | バックアップ機能の有効化 | `false` |
|
|
| `backup.schedule` | Cronスケジュール | `"0 2 * * *"` |
|
|
| `backup.mysql.user` | MySQLバックアップユーザー | `""` |
|
|
| `backup.mysql.password` | MySQLパスワード | `""` |
|
|
| `backup.mysql.existingSecret` | 既存Secret使用 | `""` |
|
|
| `backup.databases` | バックアップ対象DB（空=全DB） | `[]` |
|
|
| `backup.compression.enabled` | 圧縮有効化 | `true` |
|
|
| `backup.compression.level` | 圧縮レベル (1-9) | `6` |
|
|
| `backup.retention.enabled` | 世代管理有効化 | `true` |
|
|
| `backup.retention.days` | 保持日数 | `30` |
|
|
| `backup.persistence.size` | バックアップPVCサイズ | `50Gi` |
|
|
| `backup.nfs.enabled` | NFS使用 | `false` |
|
|
| `backup.nfs.server` | NFSサーバー | `""` |
|
|
| `backup.nfs.path` | NFSパス | `""` |
|
|
|
|
**注意**: MySQL接続情報（host、port）は `phpmyadmin.hosts[0]` から自動的に取得されます。
|
|
|
|
## アンインストール
|
|
|
|
```bash
|
|
helm uninstall phpmyadmin
|
|
```
|
|
|
|
## セキュリティに関する注意事項
|
|
|
|
1. **Blowfish Secret**: 本番環境では必ず独自の blowfish secret を設定してください
|
|
2. **Network Policy**: 本番環境では Network Policy を有効にしてアクセスを制限してください
|
|
3. **Ingress**: 外部公開する場合は必ず TLS を有効にしてください
|
|
4. **認証**: phpMyAdmin への直接アクセスを制限し、VPN経由でのアクセスを推奨します
|
|
|
|
## トラブルシューティング
|
|
|
|
### Podが起動しない場合
|
|
|
|
```bash
|
|
kubectl describe pod -l app.kubernetes.io/name=phpmyadmin-nginx
|
|
kubectl logs -l app.kubernetes.io/name=phpmyadmin-nginx -c nginx
|
|
kubectl logs -l app.kubernetes.io/name=phpmyadmin-nginx -c phpmyadmin
|
|
```
|
|
|
|
### MySQLに接続できない場合
|
|
|
|
1. MySQLサーバーのホスト名とポートを確認
|
|
2. Network Policyの設定を確認
|
|
3. MySQLサーバーがリッスンしているか確認
|
|
|
|
```bash
|
|
kubectl exec -it <pod-name> -c phpmyadmin -- nc -zv mysql.default.svc.cluster.local 3306
|
|
```
|
|
|
|
### バックアップジョブの確認
|
|
|
|
```bash
|
|
# CronJobの確認
|
|
kubectl get cronjob
|
|
|
|
# 実行されたJobの確認
|
|
kubectl get jobs -l app.kubernetes.io/component=backup
|
|
|
|
# バックアップジョブのログ確認
|
|
kubectl logs job/<job-name>
|
|
|
|
# バックアップファイルの確認（PVC使用時）
|
|
kubectl exec -it <backup-pod-name> -- ls -lh /backup/
|
|
|
|
# 手動でバックアップジョブを実行
|
|
kubectl create job --from=cronjob/<cronjob-name> manual-backup-$(date +%s)
|
|
```
|
|
|
|
### バックアップの復元方法
|
|
|
|
```bash
|
|
# バックアップPodに接続
|
|
kubectl exec -it <pod-name> -c phpmyadmin -- /bin/bash
|
|
|
|
# バックアップファイルの確認
|
|
ls -lh /backup/
|
|
|
|
# 復元実行（例）
|
|
gunzip -c /backup/20241120/mydb_20241120_020001.sql.gz | \
|
|
mysql -h mysql.default.svc.cluster.local -u root -p mydb
|
|
```
|
|
|
|
## ライセンス
|
|
|
|
このHelmチャートはMITライセンスの下で公開されています。
|
|
|
|
## サポート
|
|
|
|
問題が発生した場合は、GitHubのIssuesページで報告してください。 |