# phpMyAdmin Helm Chart - CLAUDE.md

## リポジトリ概要

nginx をリバースプロキシとして使用する phpMyAdmin を Kubernetes 上にデプロイするHelmチャートです。
Raspberry Pi などのベアメタル上で動作する Kubernetes クラスタを想定した構成になっています。

## 実行環境について

**PHP実行環境はこのチャートには含まれません。**
phpMyAdmin は公式イメージ (`phpmyadmin/phpmyadmin`) の `-fpm-alpine` タグを使用しており、
PHP-FPM はその公式イメージ内に含まれています。別途 PHP 実行環境を用意する必要はありません。

## Git 情報

- **ユーザー名**: Claude
- **メールアドレス**: claude@cafepieters.com
- **リポジトリ**: ssh://git@192.168.9.65/helmchart/phpmyadmin.git

## リリースフローのルール

### バージョン番号の方針
- Helmチャートのバージョン番号（`Chart.yaml` の `version` / `appVersion`）は、**主アプリ（phpMyAdmin）のバージョン番号と同一**とする。

### 自動リリース条件
- **phpMyAdmin バージョン更新時**: `values.yaml` と `Chart.yaml` を更新し、Gitタグ・Giteaリリース・Gitea Package Registry への発行まで行う。
- **nginx のみの更新時**: `values.yaml` の該当タグのみ更新してコミットするが、**リリースは行わない**。

### 手動リリース（臨時）
- 改修作業などで手動リリースが必要な場合は、バージョン末尾にアルファベットを付与する。
  - 例: `5.2.3` → `5.2.3-a`, `5.2.3-b`

## ワークフロー構成

### `.gitea/workflows/image-update-and-release.yaml`
毎週月曜日 3:00 AM（JST 12:00 PM）に自動実行され、以下を行う:
1. Docker Hub から nginx・phpMyAdmin の最新バージョンを取得
2. 更新がある場合は `values.yaml` を更新
3. phpMyAdmin のバージョンが更新された場合のみ、Helm チャートのリリースを実施

### `.gitea/workflows/helm-release.yaml`
`main` ブランチへのプッシュ時に自動実行。Gitea Package Registry にチャートを発行する。

## 必要な Gitea Secrets

| シークレット名 | 用途 |
|---|---|
| `GITEA_TOKEN` | Gitea API（リリース作成・タグ操作） |
| `REGISTRY_USER` | Gitea Package Registry ユーザー名 |
| `REGISTRY_TOKEN` | Gitea Package Registry トークン |