README.md を追加
This commit is contained in:
201
README.md
Normal file
201
README.md
Normal file
@@ -0,0 +1,201 @@
|
|||||||
|
# phpMyAdmin with nginx Helm Chart
|
||||||
|
|
||||||
|
このHelmチャートは、nginx をリバースプロキシとして使用する phpMyAdmin をKubernetes上にデプロイします。
|
||||||
|
|
||||||
|
## 機能
|
||||||
|
|
||||||
|
- ✅ nginx (1.29.3-alpine-perl) + phpMyAdmin (5.2.3-fpm-alpine) のマルチコンテナ構成
|
||||||
|
- ✅ 本番環境対応のセキュリティ設定
|
||||||
|
- ✅ 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
|
||||||
|
```
|
||||||
|
|
||||||
|
## パラメータ
|
||||||
|
|
||||||
|
### グローバル設定
|
||||||
|
|
||||||
|
| パラメータ | 説明 | デフォルト値 |
|
||||||
|
|----------|------|------------|
|
||||||
|
| `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` |
|
||||||
|
|
||||||
|
## アンインストール
|
||||||
|
|
||||||
|
```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
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user