Skip to content

Commit 0502391

Browse files
Update BenchPark documentation
[skip-ci] - Update benchpark-todo.md with latest progress - Update benchpark-results-format.md with new JSON format - Update benchpark-development.md with new file structure - Add benchpark-generator-plan.md for future reference
1 parent 19b0c16 commit 0502391

4 files changed

Lines changed: 273 additions & 173 deletions

File tree

‎.kiro/steering/benchpark-development.md‎

Lines changed: 22 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -90,24 +90,21 @@ git commit -m "Update documentation
9090
BenchPark関連の変更をコミットする前に確認してください:
9191

9292
- [ ] **BenchPark機能のフルテスト(結果送信あり)**: `[park-only]`を含める
93-
- `scripts/benchpark_*.sh`の修正
94-
- `scripts/benchpark_functions.sh`の修正
95-
- `scripts/convert_benchpark_results.py`の修正
96-
- setup, run, wait, 結果変換、結果送信まで実行される
93+
- `benchpark-bridge/scripts/`の修正
94+
- `benchpark-bridge/config/apps.csv`の修正
95+
- setup, run, 結果変換、結果送信まで実行される
9796

9897
- [ ] **BenchPark結果送信のみ**: `[park-send]`を含める
9998
- 結果変換ロジックの修正
10099
- 既存の結果を再送信したい場合
101-
- setup, run, waitはスキップされる
100+
- setup, runはスキップされる
102101

103102
- [ ] **ドキュメントのみ更新**: `[skip-ci]`を含める
104-
- `BENCHPARK_TODO.md`の更新
105-
- `BENCHPARK_MONITOR.md`の更新
106-
- `BENCHPARK_RESULTS_FORMAT.md`の更新
103+
- `.kiro/steering/benchpark-*.md`の更新
107104
- その他ドキュメントファイル
108105

109106
- [ ] **BenchPark設定変更**: `[benchpark]`を含める
110-
- `config/benchpark-monitor/list.csv`の変更
107+
- `benchpark-bridge/config/apps.csv`の変更
111108

112109
- [ ] **既存機能の修正**: タグなし
113110
- `programs/*/`の修正
@@ -174,10 +171,18 @@ BenchPark関連の変更をコミットする前に確認してください:
174171
175172
### ✅ 許可される配置
176173
```
177-
config/benchpark-monitor/ # BenchPark設定(新規ディレクトリ)
178-
scripts/benchpark_*.sh # BenchPark専用スクリプト
179-
scripts/convert_benchpark_*.py # BenchPark専用Python
180-
BENCHPARK_*.md # BenchPark専用ドキュメント
174+
benchpark-bridge/ # BenchPark統合ディレクトリ
175+
├── config/
176+
│ └── apps.csv # 監視対象定義
177+
└── scripts/
178+
├── common.sh # 共通関数
179+
├── ci_generator.sh # CI YAML生成
180+
├── runner.sh # BenchPark実行
181+
└── result_converter.py # 結果変換
182+
183+
.kiro/steering/
184+
└── benchpark-*.md # BenchPark関連ドキュメント
185+
181186
.gitlab-ci.benchpark.yml # 生成されるCI設定(gitignore済み)
182187
```
183188

@@ -205,10 +210,11 @@ BenchParkモニター機能は以下の場合**のみ**実行:
205210
rules:
206211
- if: '$benchpark == "true"' # API変数での明示指定
207212
- if: '$CI_COMMIT_MESSAGE =~ /\[benchpark\]/' # コミットメッセージ指定
213+
- if: '$CI_COMMIT_MESSAGE =~ /\[park-only\]/' # BenchPark専用実行
214+
- if: '$CI_COMMIT_MESSAGE =~ /\[park-send\]/' # 結果送信のみ
208215
- changes: # BenchPark関連ファイル変更
209-
- "config/benchpark-monitor/**/*"
210-
- "scripts/benchpark_*"
211-
- "BENCHPARK_*.md"
216+
- "benchpark-bridge/**/*"
217+
- ".kiro/steering/benchpark-*.md"
212218
- when: never # その他は実行しない
213219
```
214220
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# BenchPark Generator - 将来の実装計画
2+
3+
## 概要
4+
5+
BenchKitの登録アプリケーション設定から、BenchParkの定義ファイルを自動生成するツール(将来的な拡張)。
6+
7+
## 目的
8+
9+
- BenchKitアプリをBenchParkでも実行可能にする
10+
- 手動での定義ファイル作成を自動化
11+
- BenchKitとBenchParkの設定を同期
12+
13+
## 生成対象ファイル
14+
15+
1. **package.py** - Spackパッケージ定義
16+
2. **application.py** - Rambleアプリケーション定義
17+
3. **experiment.py** - Ramble実験定義
18+
19+
## 必要な情報
20+
21+
### BenchKit側(入力)
22+
- `programs/{app}/` - ビルド・実行スクリプト、メタデータ
23+
24+
### BenchPark側(出力)
25+
- アプリケーション名、バージョン
26+
- ビルド依存関係、コンパイラ要件
27+
- 実行コマンド、環境変数
28+
- ワークロード定義、パラメータ
29+
30+
## ファイル構成(将来)
31+
32+
```
33+
benchpark-bridge/
34+
└── generators/
35+
├── templates/ # Jinja2テンプレート
36+
├── *_generator.py # 各種ジェネレーター
37+
└── cli.py # 統合CLIツール
38+
```
39+
40+
## 優先度
41+
42+
**低優先度** - 結果変換機能の安定化とmainマージ後に着手
43+
44+
## 参考
45+
46+
- BenchPark: https://github.com/LLNL/benchpark
47+
- Ramble: https://github.com/GoogleCloudPlatform/ramble
48+
- Spack: https://spack.readthedocs.io/

0 commit comments

Comments
 (0)