Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions perf/ec2/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@

๋ฐฐํฌ ์„œ๋ฒ„๋ฅผ ํ…Œ์ŠคํŠธ ์‹œ๊ฐ„์—๋งŒ ๋นŒ๋ ค perf ํ”„๋กœํ•„๋กœ ๋„์šด๋‹ค. [perf-ec2.sh](perf-ec2.sh)๊ฐ€ EC2 ์ชฝ ๋‹จ๊ณ„๋ฅผ ๋ฌถ๋Š”๋‹ค.
EC2 Instance Connect ๋ธŒ๋ผ์šฐ์ € ํ„ฐ๋ฏธ๋„์—์„œ `~/restless` ์ €์žฅ์†Œ๋กœ ์‹คํ–‰ํ•œ๋‹ค. k6๋Š” ๋…ธํŠธ๋ถ์—์„œ ๋ˆ๋‹ค. ์„œ๋ฒ„ ์ž์›์€ CloudWatch๋กœ ๋ณธ๋‹ค.
๋ช…๋ น๋ณ„ ์„ค๋ช…๊ณผ ๋„๋ฉ”์ธ ์ˆœ์„œ, ํŒ€์› SSH ๊ณ„์ •์œผ๋กœ ์‹คํ–‰ํ•˜๋Š” ๋ฒ•์€ [RUNBOOK.md](RUNBOOK.md)์— ์žˆ๋‹ค.

- ๋น„๋ฐ€๊ฐ’์€ EC2์˜ `/opt/restless/perf.env`์—๋งŒ ์žˆ๋‹ค. ์Šคํฌ๋ฆฝํŠธ๋Š” ์ด ํŒŒ์ผ์„ ์„œ๋ฒ„ ์•ˆ์—์„œ๋งŒ ์ฝ๊ณ  ๊ฐ’์„ ์ถœ๋ ฅํ•˜์ง€ ์•Š๋Š”๋‹ค.
- ์‹œ๋“œ๋Š” EC2์—์„œ ๋Œ๋ฆฐ๋‹ค. perf `JWT_SECRET`์ด ์„œ๋ฒ„ ๋ฐ–์œผ๋กœ ๋‚˜๊ฐ€์ง€ ์•Š๋Š”๋‹ค. ๋…ธํŠธ๋ถ์—๋Š” ์„œ๋ช…๋œ ํ† ํฐ CSV๋งŒ ์˜ฎ๊ธด๋‹ค.
Expand Down
225 changes: 225 additions & 0 deletions perf/ec2/RUNBOOK.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,225 @@
# EC2 ๋ถ€ํ•˜ ํ…Œ์ŠคํŠธ ๋Ÿฐ๋ถ

EC2 ๋‹ด๋‹น์ž๋Š” `~/restless`์—์„œ `perf/ec2/perf-ec2.sh <๋ช…๋ น>`์œผ๋กœ ์‹คํ–‰ํ•œ๋‹ค. ํŒ€์›์€ ๊ฐ์ž ๊ณ„์ •์œผ๋กœ SSH ์ ‘์†ํ•ด `$R <๋ช…๋ น>`์œผ๋กœ ์‹คํ–‰ํ•œ๋‹ค. ํŒ€์›์šฉ ์ ˆ์ฐจ๋Š” [ํŒ€์› ๊ณ„์ •์œผ๋กœ ์‹คํ–‰](#ํŒ€์›-๊ณ„์ •์œผ๋กœ-์‹คํ–‰)์— ์žˆ๋‹ค.
2026-11-18 ~ 2026-11-30์€ perf ์ „์šฉ ๊ธฐ๊ฐ„์ด๋‹ค. ํ…Œ์ŠคํŠธ๊ฐ€ ๋๋‚˜๋„ `finish`๋ฅผ ํ•˜์ง€ ์•Š๋Š”๋‹ค.

## ํŒ€์› ๊ณ„์ •์œผ๋กœ ์‹คํ–‰

ํŒ€์› ๊ณ„์ • ์ด๋ฆ„์€ `perf-<์„ฑ>`์ด๋‹ค. root ๊ถŒํ•œ์€ ์—†๊ณ  ์•„๋ž˜ ๋ช…๋ น๋งŒ ํ—ˆ์šฉ๋œ๋‹ค.

| ํ•˜๋Š” ์ผ | ๋ช…๋ น |
|---|---|
| ์Šคํฌ๋ฆฝํŠธ ์‹คํ–‰ | `$R <๋ช…๋ น>` |
| perf.env ์ˆ˜์ • | `sudoedit /opt/restless/perf.env` |
| ์„œ๋ฒ„ ์ €์žฅ์†Œ ๊ฐฑ์‹  | `sudo -u ubuntu git -C /home/ubuntu/restless pull --ff-only` |
| ํ† ํฐ ๋ฌถ์Œ ์ฝ๊ธฐ | `sudo -u ubuntu cat /home/ubuntu/restless/.ai-output/perf-tokens/seed-out.tar.gz` |
| ํ‹ฐ์ผ“ํŒ… ์‹œ๋“œ์™€ ๊ฒ€์ฆ | `$T seed`, `$T verify <๊ณต์—ฐID>` |

`$R`์€ `sudo -u ubuntu /home/ubuntu/restless/perf/ec2/perf-ec2.sh`, `$T`๋Š” `sudo -u ubuntu /home/ubuntu/restless/perf/seed/ticketing.sh`์ด๋‹ค. ์ ‘์†ํ•˜๋ฉด ์ž๋™์œผ๋กœ ์žกํžˆ๋ฏ€๋กœ ์ง์ ‘ ์ž…๋ ฅํ•˜์ง€ ์•Š๋Š”๋‹ค.
`perf/seed/ticketing.sh verify 1`์€ `$T verify 1`๋กœ ์“ด๋‹ค. `$R verify`๋Š” ์Šค์ผ€์ผ์„ ๋ฐ›๋Š” ๋‹ค๋ฅธ ๊ฒ€์ฆ์ด๋‹ค.
์ €์žฅ์†Œ๋Š” `/home/ubuntu/restless` ํ•˜๋‚˜๋ฟ์ด๊ณ  ํŒ€์›์€ `cd`๋กœ ๋“ค์–ด๊ฐˆ ์ˆ˜ ์—†๋‹ค. ๋“ค์–ด๊ฐˆ ํ•„์š”๋„ ์—†๋‹ค.

### ์ฒ˜์Œ ํ•œ ๋ฒˆ

๋…ธํŠธ๋ถ์—์„œ ํ‚ค๋ฅผ ๋งŒ๋“ค๊ณ  ๊ณต๊ฐœํ‚ค ํ•œ ์ค„์„ EC2 ๋‹ด๋‹น์ž์—๊ฒŒ ๋ณด๋‚ธ๋‹ค. ๊ฐœ์ธํ‚ค `~/.ssh/fanq-perf`๋Š” ๋ณด๋‚ด์ง€ ์•Š๋Š”๋‹ค.

```bash
ssh-keygen -t ed25519 -f ~/.ssh/fanq-perf -C "<์ด๋ฆ„>"
cat ~/.ssh/fanq-perf.pub
```

`~/.ssh/config` ํŒŒ์ผ ๋งจ ์•„๋ž˜์— ์ถ”๊ฐ€ํ•œ๋‹ค. ํด๋”๊ฐ€ ์•„๋‹ˆ๋ผ ํŒŒ์ผ์ด๋‹ค. Windows๋Š” `C:\Users\<์‚ฌ์šฉ์ž>\.ssh\config`์ด๊ณ  `.txt`๊ฐ€ ๋ถ™์œผ๋ฉด ์•ˆ ๋œ๋‹ค.

```
Host fanq-perf
HostName 3.35.88.242
User perf-<๋ณธ์ธ>
IdentityFile ~/.ssh/fanq-perf
```

`ssh fanq-perf`๋กœ ์ ‘์†ํ•ด `$R check`๋ฅผ ์‹คํ–‰ํ•œ๋‹ค. `profile=perf db=perf-restless`๊ฐ€ ๋‚˜์˜ค๋ฉด ์ค€๋น„๊ฐ€ ๋๋‚ฌ๋‹ค.

### ๋งค๋ฒˆ ํ…Œ์ŠคํŠธํ•  ๋•Œ

1. ์ฑ„๋„์— ์‹œ์ž‘์„ ์•Œ๋ฆฐ๋‹ค. ๋‹ค๋ฅธ ์‚ฌ๋žŒ์ด ์“ฐ๋Š” ์ค‘์ด๋ฉด ๊ธฐ๋‹ค๋ฆฐ๋‹ค. ์„œ๋ฒ„์™€ DB๊ฐ€ ํ•˜๋‚˜๋ผ ๋™์‹œ์— ํ•˜๋ฉด ๊ฒฐ๊ณผ๊ฐ€ ์„ž์ด๊ณ  ์„œ๋กœ์˜ ํ…Œ์ŠคํŠธ๊ฐ€ ๊นจ์ง„๋‹ค.
2. ์„œ๋ฒ„ ์ค€๋น„. `ssh fanq-perf`๋กœ ์ ‘์†ํ•œ ๋’ค ์‹คํ–‰ํ•œ๋‹ค.

```bash
sudo -u ubuntu git -C /home/ubuntu/restless pull --ff-only
sudoedit /opt/restless/perf.env # ํ•„์š”ํ•œ ๊ฐ’๋งŒ ์ˆ˜์ •
$R check
$R stop-app; $R reset-db # DB ์ด๋ฆ„ ์ž…๋ ฅ
$R start sha-<ํƒœ๊ทธ> && $R stop-app
$R seed <์Šค์ผ€์ผ>
```

3. ํ† ํฐ ๋ฐ›๊ธฐ. ๋…ธํŠธ๋ถ ์ €์žฅ์†Œ ํด๋”์—์„œ ์‹คํ–‰ํ•œ๋‹ค.

```bash
mkdir -p perf/seed/out
ssh fanq-perf 'sudo -u ubuntu cat /home/ubuntu/restless/.ai-output/perf-tokens/seed-out.tar.gz' > perf/seed/out/seed-out.tar.gz
tar -xzf perf/seed/out/seed-out.tar.gz -C perf/seed/out && rm perf/seed/out/seed-out.tar.gz
```

4. ์ธก์ •. ์‹œ์ž‘ ์‹œ๊ฐ๊ณผ ์ข…๋ฃŒ ์‹œ๊ฐ์„ ์ฑ„๋„์— ๋‚จ๊ธด๋‹ค. EC2 ๋‹ด๋‹น์ž๊ฐ€ ๊ทธ ๊ตฌ๊ฐ„์œผ๋กœ CloudWatch ๋ฆฌํฌํŠธ๋ฅผ ๋ฝ‘์•„ ์ค€๋‹ค.

```bash
$R start sha-<ํƒœ๊ทธ> && $R lockstats # ์„œ๋ฒ„, ์ธก์ • ์ „ ๊ฐ’
# ๋…ธํŠธ๋ถ์—์„œ k6 ์‹คํ–‰
$R lockstats # ์„œ๋ฒ„, ์ธก์ • ํ›„ ๊ฐ’
$R verify <์Šค์ผ€์ผ> # ์„œ๋ฒ„
```

5. ์ธ๊ณ„. `sudoedit /opt/restless/perf.env`๋กœ ๋ฐ”๊พผ ๊ฐ’์„ ๋˜๋Œ๋ฆฌ๊ณ  `$R check`๋ฅผ ์‹คํ–‰ํ•œ ๋’ค ์ฑ„๋„์— ๋์„ ์•Œ๋ฆฐ๋‹ค.

๊ฐ™์€ ์กฐ๊ฑด์œผ๋กœ ํ•œ ๋ฒˆ ๋” ์žฌ๋ ค๋ฉด 2๋ฒˆ์˜ `stop-app; reset-db`๋ถ€ํ„ฐ ๋‹ค์‹œ ํ•œ๋‹ค. `finish`๋Š” ์‹คํ–‰ํ•˜์ง€ ์•Š๋Š”๋‹ค.

### ์•„๋ž˜ ๋Ÿฐ๋ถ ๋ช…๋ น์„ ๋ฐ”๊ฟ” ์“ฐ๋Š” ๋ฒ•

| ๋Ÿฐ๋ถ | ํŒ€์› |
|---|---|
| `cd ~/restless` | ์“ฐ์ง€ ์•Š๋Š”๋‹ค |
| `perf/ec2/perf-ec2.sh <๋ช…๋ น>` | `$R <๋ช…๋ น>` |
| `perf/seed/ticketing.sh <๋ช…๋ น>` | `$T <๋ช…๋ น>` |
| `sudo vi /opt/restless/perf.env` | `sudoedit /opt/restless/perf.env` |
| `git pull -q` | `sudo -u ubuntu git -C /home/ubuntu/restless pull --ff-only` |
| `serve-tokens`์™€ curl | 3๋ฒˆ์˜ `ssh fanq-perf '...'` |

### ์ž์ฃผ ๋ง‰ํžˆ๋Š” ๊ณณ

- `-u: command not found`: ๋ฉ”์‹ ์ €์—์„œ ๋ณต์‚ฌํ•œ `R=...` ์ค„์˜ ๋”ฐ์˜ดํ‘œ๊ฐ€ ๋ฐ”๋€Œ์—ˆ๋‹ค. `R=...`๋Š” ์ž…๋ ฅํ•˜์ง€ ์•Š๋Š”๋‹ค. `exit` ํ›„ ๋‹ค์‹œ ์ ‘์†ํ•œ๋‹ค.
- `sudo su`๋‚˜ ๋‹ค๋ฅธ sudo ๋ช…๋ น์ด ๋น„๋ฐ€๋ฒˆํ˜ธ๋ฅผ ๋ฌป๋Š”๋‹ค: ํ—ˆ์šฉ๋˜์ง€ ์•Š์€ ๋ช…๋ น์ด๋‹ค. ๊ณ„์ •์— ๋น„๋ฐ€๋ฒˆํ˜ธ๊ฐ€ ์—†์–ด ํ†ต๊ณผํ•  ์ˆ˜ ์—†๋‹ค. ์œ„ ํ‘œ์˜ ๋ช…๋ น์œผ๋กœ ๋ฐ”๊พผ๋‹ค.
- `cd ~/restless`์—์„œ No such file: ํŒ€์› ํ™ˆ์—๋Š” ์ €์žฅ์†Œ๊ฐ€ ์—†๋‹ค. `cd` ์—†์ด `$R`์„ ์“ด๋‹ค.
- ์ ‘์†์ด ์•ˆ ๋œ๋‹ค: ๊ณต์ธ IP๊ฐ€ ๋ฐ”๋€Œ์—ˆ์„ ์ˆ˜ ์žˆ๋‹ค. `curl -s https://checkip.amazonaws.com` ๊ฒฐ๊ณผ๋ฅผ EC2 ๋‹ด๋‹น์ž์—๊ฒŒ ๋ณด๋‚ธ๋‹ค. ๋ณด์•ˆ ๊ทธ๋ฃน์˜ 22, 8080, 8081 ๊ทœ์น™์„ ๋ฐ”๊ฟ”์•ผ ํ•œ๋‹ค.
- ๋”ฐ์˜ดํ‘œ๊ฐ€ ๋“ค์–ด๊ฐ„ ๋ช…๋ น์€ ๋ฉ”์‹ ์ € ์ฝ”๋“œ ๋ธ”๋ก์œผ๋กœ ์ฃผ๊ณ ๋ฐ›๋Š”๋‹ค.

### ๊ณ„์ • ์ •๋ฆฌ (EC2 ๋‹ด๋‹น์ž, 2026-11-30)

```bash
for U in $(getent group perf-runners | cut -d: -f4 | tr , " "); do sudo userdel -r "$U"; done
sudo rm /etc/sudoers.d/perf-runners /etc/sudoers.d/perf-runners-ticketing
sudo groupdel perf-runners
```

๋ณด์•ˆ ๊ทธ๋ฃน์—์„œ ํŒ€์› IP์˜ 22, 8080, 8081 ๊ทœ์น™์„ ์ง€์šด๋‹ค. perf.env๋ฅผ ์—ด ์ˆ˜ ์žˆ์—ˆ์œผ๋ฏ€๋กœ DB ๋น„๋ฐ€๋ฒˆํ˜ธ๋ฅผ ๋ฐ”๊พผ๋‹ค.

## ๋ช…๋ น

### `check`: ์„ค์ • ํ™•์ธ
- `/opt/restless/perf.env`์˜ ์ด๋ฆ„๊ณผ ์ฃผ์š” ๊ฐ’์„ ๋ณด์—ฌ ์ค€๋‹ค. ๋น„๋ฐ€๊ฐ’์€ ์ถœ๋ ฅํ•˜์ง€ ์•Š๋Š”๋‹ค. ํ”„๋กœํ•„, DB ์ด๋ฆ„, ๋Œ€๊ธฐ์—ด, ๊ฐ€์งœ PG ๊ฐ’์„ ๋ณธ๋‹ค.
- ํ”„๋กœํ•„์ด perf๊ฐ€ ์•„๋‹ˆ๋ฉด ๋ฉˆ์ถ˜๋‹ค. DB ์ด๋ฆ„์ด `perf-`๋กœ ์‹œ์ž‘ํ•˜์ง€ ์•Š๊ฑฐ๋‚˜ prod๊ฐ€ ๋“ค์–ด ์žˆ์–ด๋„ ๋ฉˆ์ถ˜๋‹ค. JWT ๋น„๋ฐ€๊ฐ’์ด 32๋ฐ”์ดํŠธ๋ณด๋‹ค ์งง์•„๋„ ๋ฉˆ์ถ˜๋‹ค.
- ์•„๋ฌด๊ฒƒ๋„ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค.
- ์–ธ์ œ: perf.env๋ฅผ ๊ณ ์นœ ์งํ›„, ํ…Œ์ŠคํŠธ ์‹œ์ž‘ ์ „.

### `start <ํƒœ๊ทธ>`: perf ์•ฑ ๋„์šฐ๊ธฐ
1. `deploy.paused`๋ฅผ ๋งŒ๋“ค์–ด ์ž๋™ ๋ฐฐํฌ๋ฅผ ๋ฉˆ์ถ˜๋‹ค.
2. ๋ฐฐํฌ ์ปจํ…Œ์ด๋„ˆ `restless`์™€ ๊ธฐ์กด `restless-perf`๋ฅผ ์ง€์šด๋‹ค.
3. ํƒœ๊ทธ ์ด๋ฏธ์ง€๋ฅผ ๋ฐ›์•„ perf.env๋กœ `restless-perf`๋ฅผ ๋„์šด๋‹ค. ํฌํŠธ๋Š” 8080, 8081์ด๋‹ค.
4. health๊ฐ€ ์‘๋‹ตํ•  ๋•Œ๊นŒ์ง€ ์ตœ๋Œ€ 180์ดˆ ๊ธฐ๋‹ค๋ฆฐ๋‹ค.
5. Flyway ๊ฒฐ๊ณผ๋ฅผ ๋ณด์—ฌ ์ค€๋‹ค. ๋นˆ DB๋ฉด ์ด๋•Œ ์Šคํ‚ค๋งˆ๊ฐ€ ๋งŒ๋“ค์–ด์ง„๋‹ค.

- ์–ธ์ œ: ์‹œ๋“œ ์ „ ์Šคํ‚ค๋งˆ๋ฅผ ๋งŒ๋“ค ๋•Œ, ์ธก์ • ์ง์ „.
- perf.env๋Š” ์ปจํ…Œ์ด๋„ˆ๋ฅผ ๋งŒ๋“ค ๋•Œ๋งŒ ์ฝํžŒ๋‹ค. perf.env๋ฅผ ๋ฐ”๊ฟจ๊ฑฐ๋‚˜ ํ…Œ์ŠคํŠธํ•  ์ฝ”๋“œ๊ฐ€ ๋ฐ”๋€Œ์–ด ์ƒˆ ํƒœ๊ทธ๊ฐ€ ํ•„์š”ํ•˜๋ฉด `start`๋ฅผ ๋‹ค์‹œ ํ•œ๋‹ค. ๋‘˜ ๋‹ค ๊ทธ๋Œ€๋กœ๋ฉด ๋‹ค์‹œ ํ•  ํ•„์š”๊ฐ€ ์—†๋‹ค.

### `stop-app`: perf ์•ฑ๋งŒ ์ •์ง€
- `restless-perf`๋งŒ ๋ฉˆ์ถ˜๋‹ค. ์ž๋™ ๋ฐฐํฌ๋Š” ๋ฉˆ์ถ˜ ์ฑ„๋กœ ๋‘”๋‹ค.
- ์•ฑ์„ ๊บผ์•ผ ํ•˜๋Š” ์ด์œ ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™๋‹ค.
- `reset-db`: ์•ฑ์ด ์ปค๋„ฅ์…˜์„ ์žก๊ณ  ์žˆ์œผ๋ฉด DB๋ฅผ ์ง€์šธ ์ˆ˜ ์—†๋‹ค.
- `seed`: ์•ฑ ์Šค์ผ€์ค„๋Ÿฌ๊ฐ€ ์‹œ๋“œ ๋ฐ์ดํ„ฐ๋ฅผ ๊ฑด๋“œ๋ฆฌ๋ฉด ์•ˆ ๋œ๋‹ค.
- `serve-tokens`: 8080์„ ์•ฑ์ด ์“ฐ๊ณ  ์žˆ์œผ๋ฉด ํ† ํฐ์„ ๋‚ด๋ณด๋‚ผ ์ˆ˜ ์—†๋‹ค.

### `seed <scale>`: ์‹œ๋“œ์™€ ํ† ํฐ
1. `perf/seed/scale.yml`์˜ ์Šค์ผ€์ผ๋Œ€๋กœ ๋นˆ perf DB์— ๋ฐ์ดํ„ฐ๋ฅผ ๋„ฃ๋Š”๋‹ค. ์Šค์ผ€์ผ ์˜ˆ์‹œ๋Š” sale, capacity๋‹ค.
2. ํšŒ์›๋ณ„ ์„œ๋ช… ํ† ํฐ์„ ๋งŒ๋“ ๋‹ค. `users.csv`, `staff.csv`, `manifest.json`์ด๊ณ  3์ผ ๋’ค ๋งŒ๋ฃŒ๋œ๋‹ค.
3. ๋ฐ”๋กœ `verify`๋กœ ์‹œ๋“œ๋ฅผ ์ ๊ฒ€ํ•œ๋‹ค.
4. ํ† ํฐ ์„ธ ํŒŒ์ผ์„ ์••์ถ• ํ•˜๋‚˜๋กœ ๋ฌถ๋Š”๋‹ค.

- ์ „์ œ: DB๊ฐ€ ๋น„์–ด ์žˆ๊ณ  ์Šคํ‚ค๋งˆ๊ฐ€ ์žˆ์–ด์•ผ ํ•œ๋‹ค. ๊ทธ๋ž˜์„œ `reset-db` โ†’ `start` โ†’ `stop-app`์„ ๋จผ์ € ํ•œ๋‹ค.

### `lockstats`: DB ์ž ๊ธˆ ๋Œ€๊ธฐ ๋ˆ„์ ๊ฐ’
- MySQL ์ „์ฒด ํ–‰ ์ž ๊ธˆ ํ†ต๊ณ„๋ฅผ ๋ณด์—ฌ ์ค€๋‹ค. ๋Œ€๊ธฐ ํšŸ์ˆ˜, ๋Œ€๊ธฐ ์‹œ๊ฐ„ ํ•ฉ, ์ตœ๋Œ€ ๋Œ€๊ธฐ ์‹œ๊ฐ„, ํ˜„์žฌ ๋Œ€๊ธฐ ์ˆ˜๊ฐ€ ๋‚˜์˜จ๋‹ค.
- RDS๊ฐ€ ์ผœ์ง„ ๋’ค๋กœ ๊ณ„์† ์Œ“์ด๋Š” ๊ฐ’์ด๋‹ค. ์ธก์ • ์ „ํ›„ ์ฐจ์ด๋งŒ ์˜๋ฏธ๊ฐ€ ์žˆ๋‹ค.
- ์–ธ์ œ: k6 ์ง์ „๊ณผ ์งํ›„์— ํ•œ ๋ฒˆ์”ฉ.

### ํ•จ๊ป˜ ์“ฐ๋Š” ๋ช…๋ น

| ๋ช…๋ น | ํ•˜๋Š” ์ผ |
|---|---|
| `reset-db` | perf DB๋ฅผ ์ง€์šฐ๊ณ  ๋นˆ DB๋กœ ๋‹ค์‹œ ๋งŒ๋“ ๋‹ค. ์•ฑ์ด ๊บผ์ ธ ์žˆ์–ด์•ผ ํ•˜๊ณ  DB ์ด๋ฆ„์„ ์ž…๋ ฅํ•ด ํ™•์ธํ•œ๋‹ค |
| `serve-tokens` | ํ† ํฐ ์••์ถ• ํŒŒ์ผ์„ 8080์œผ๋กœ ํ•œ ๋ฒˆ๋งŒ ๋‚ด๋ณด๋‚ธ๋‹ค. ๋ฐ›์œผ๋ฉด ๋ฐ”๋กœ ๋๋‚˜๊ณ  5๋ถ„์ด ์ง€๋‚˜๋ฉด ๋‹ซํžŒ๋‹ค |
| `verify <scale>` | ๋ถˆ๋ณ€์‹, ๊ธˆ์•ก, FK๋ฅผ ๊ฒ€์‚ฌํ•œ๋‹ค. ๋ถ€ํ•˜ ๋’ค `seed baseline` ๊ฒ€์‚ฌ ์‹คํŒจ๋Š” ์ •์ƒ์ด๋‹ค |
| `finish` | perf ์•ฑ์„ ์ง€์šฐ๊ณ  ์ž๋™ ๋ฐฐํฌ๋ฅผ ๋‹ค์‹œ ์ผ ๋‹ค. ๊ธฐ๊ฐ„ ์ค‘์—๋Š” ํ•˜์ง€ ์•Š๋Š”๋‹ค |

## ๋„๋ฉ”์ธ A โ†’ B โ†’ C ์ˆœ์„œ

๊ณตํ†ต ์ „์ œ
- ๊ฐ™์€ `perf-restless` DB๋ฅผ ์“ฐ๋ฉด ๋„๋ฉ”์ธ๋งˆ๋‹ค `reset-db`๋ฅผ ํ•œ๋‹ค.
- ๋„๋ฉ”์ธ๋ผ๋ฆฌ ์‹œ๊ฐ„์ด ๊ฒน์น˜๋ฉด ์•ˆ ๋œ๋‹ค. ์•ฑ ์ปจํ…Œ์ด๋„ˆ์™€ RDS๊ฐ€ ํ•˜๋‚˜๋ผ ๊ฒฐ๊ณผ๊ฐ€ ์„ž์ธ๋‹ค.

### ๊ธฐ๊ฐ„ ์‹œ์ž‘์— ํ•œ ๋ฒˆ (์ฝ˜์†”)
- CPU ํฌ๋ ˆ๋”ง์„ ๋ฌด์ œํ•œ์œผ๋กœ ๋ฐ”๊พธ๊ณ  `CPUCreditBalance` ์‹œ์ž‘๊ฐ’์„ ์ ๋Š”๋‹ค.
- EC2 ์„ธ๋ถ€ ๋ชจ๋‹ˆํ„ฐ๋ง๊ณผ RDS ํ–ฅ์ƒ๋œ ๋ชจ๋‹ˆํ„ฐ๋ง์„ ์ผ ๋‹ค.

### ๊ฐ ๋„๋ฉ”์ธ ์ฐจ๋ก€

```bash
cd ~/restless && git pull -q

# 1. ๋‚ด ์‹คํ—˜ ์„ค์ •
sudo vi /opt/restless/perf.env # ํ•„์š”ํ•œ ๊ฐ’๋งŒ ๋ณ€๊ฒฝ
perf/ec2/perf-ec2.sh check

# 2. ๋นˆ DB์™€ ์Šคํ‚ค๋งˆ
perf/ec2/perf-ec2.sh stop-app # ์•ฑ์ด ์—†๋‹ค๋Š” ์—๋Ÿฌ๊ฐ€ ๋‚˜๋„ ๊ดœ์ฐฎ๋‹ค
perf/ec2/perf-ec2.sh reset-db # perf-restless ์ž…๋ ฅ
perf/ec2/perf-ec2.sh start sha-<ํƒœ๊ทธ> && perf/ec2/perf-ec2.sh stop-app

# 3. ์‹œ๋“œ์™€ ํ† ํฐ
perf/ec2/perf-ec2.sh seed <๋‚ด ๋„๋ฉ”์ธ ์Šค์ผ€์ผ>
perf/ec2/perf-ec2.sh serve-tokens # ๋‹ด๋‹น์ž ๋…ธํŠธ๋ถ์—์„œ curl๋กœ ๋ฐ›์•„ ํ•ด๋‹น ํŒ€์›์—๊ฒŒ ๊ฐœ์ธ ๋ฉ”์‹œ์ง€๋กœ ๋ณด๋‚ธ๋‹ค
# ํŒ€์›: tar -xzf <ํŒŒ์ผ> -C perf/seed/out

# 4. ์ธก์ •
perf/ec2/perf-ec2.sh start sha-<ํƒœ๊ทธ> && perf/ec2/perf-ec2.sh lockstats # ์ธก์ • ์ „ ๊ฐ’
# โ†’ ํŒ€์› ๋…ธํŠธ๋ถ์—์„œ k6 ์‹คํ–‰
perf/ec2/perf-ec2.sh lockstats # ์ธก์ • ํ›„ ๊ฐ’
perf/ec2/perf-ec2.sh verify <์Šค์ผ€์ผ> | awk '$1=="check" && $NF!=0'
# ๊ฒฐ์ œ๊ฐ€ ์žˆ๋Š” ์‹œ๋‚˜๋ฆฌ์˜ค๋ฉด reset ์ „์— ๊ฒฐ์ œ ํ™•์ธ ์ฟผ๋ฆฌ๋ฅผ ๋Œ๋ฆฐ๋‹ค

# 5. ๊ฐ™์€ ๋„๋ฉ”์ธ์„ ํ•œ ๋ฒˆ ๋” ์žฌ๋ ค๋ฉด 2๋ฒˆ๋ถ€ํ„ฐ ๋ฐ˜๋ณตํ•œ๋‹ค

# 6. ๋‹ค์Œ ๋„๋ฉ”์ธ์— ๋„˜๊ธฐ๊ธฐ
sudo vi /opt/restless/perf.env # ๋‚ด๊ฐ€ ๋ฐ”๊พผ ๊ฐ’ ๋˜๋Œ๋ฆฌ๊ธฐ. ๋Œ€๊ธฐ์—ด false, ์ถ”๊ฐ€ํ•œ ์ค„ ์‚ญ์ œ
perf/ec2/perf-ec2.sh check # ์•ฑ์€ ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค. finish ํ•˜์ง€ ์•Š๋Š”๋‹ค
```

๋…ธํŠธ๋ถ ์ชฝ ํ† ํฐ ๋ฐ›๊ธฐ

```bash
mkdir -p perf/seed/out && curl -fo perf/seed/out/seed-out.tar.gz http://perf-app:8080/seed-out.tar.gz
tar -xzf perf/seed/out/seed-out.tar.gz -C perf/seed/out && rm perf/seed/out/seed-out.tar.gz
```

### ๋„๋ฉ”์ธ๋ณ„๋กœ ๋‹ฌ๋ผ์ง€๋Š” ๊ฒƒ

| | A (์˜ˆ: ๋“œ๋กญ) | B (์˜ˆ: ๊ฒฝ๋งค) | C (์˜ˆ: ํ‹ฐ์ผ“ํŒ…) |
|---|---|---|---|
| perf.env | ๋Œ€๊ธฐ์—ด, TTL | ๊ฐ์ž ํ•„์š”ํ•œ ๊ฐ’ | ๊ฐ์ž ํ•„์š”ํ•œ ๊ฐ’ |
| ์Šค์ผ€์ผ | sale, capacity | base ๋“ฑ | base ๋“ฑ |
| ํƒœ๊ทธ | ๊ฐ์ž ๊ณ ์ • | ๊ฐ์ž ๊ณ ์ • | ๊ฐ์ž ๊ณ ์ • |

### ๊ธฐ๊ฐ„ ์ข…๋ฃŒ (2026-11-30)

```bash
perf/ec2/perf-ec2.sh finish # 3๋ถ„ ์•ˆ์— ๋ฐฐํฌ ์ปจํ…Œ์ด๋„ˆ๊ฐ€ ๋‹ค์‹œ ๋œฌ๋‹ค
```

์ฝ˜์†”์—์„œ CPU ํฌ๋ ˆ๋”ง์„ ํ‘œ์ค€์œผ๋กœ ๋˜๋Œ๋ฆฌ๊ณ  `CPUCreditBalance` ๋๊ฐ’์„ ์ ๋Š”๋‹ค. ๋ชจ๋‹ˆํ„ฐ๋ง์„ ๋ˆ๋‹ค.

## ์ž์ฃผ ํ•˜๋Š” ์‹ค์ˆ˜

- `perf-ec2.sh: command not found`: `~/restless`์—์„œ `perf/ec2/perf-ec2.sh`๋กœ ์‹คํ–‰ํ•œ๋‹ค. ํด๋” ์•ˆ์—์„œ๋Š” `./perf-ec2.sh`์ฒ˜๋Ÿผ `./`๋ฅผ ๋ถ™์ธ๋‹ค.
- ์žฌ์ ‘์†ํ•œ EC2 ํ„ฐ๋ฏธ๋„์€ `~`์—์„œ ์‹œ์ž‘ํ•œ๋‹ค. ๋จผ์ € `cd ~/restless`๋ฅผ ํ•œ๋‹ค.
- `serve-tokens` ๋’ค ์•ฑ์ด ๊บผ์ง„ ์ฑ„๋กœ k6๋ฅผ ๋Œ๋ฆฌ๋ฉด ์—ฐ๊ฒฐ์ด ๊ฑฐ๋ถ€๋œ๋‹ค. ์ธก์ • ์ „์— `start`๋ฅผ ํ•œ๋‹ค.
- ์ธก์ • ์ „ `lockstats`๋ฅผ ๋น ๋œจ๋ฆฌ๋ฉด ์ฐจ์ด๋ฅผ ๊ตฌํ•  ์ˆ˜ ์—†๋‹ค. `start && lockstats`๋ฅผ ํ•œ ์ค„๋กœ ์นœ๋‹ค.
- ๊ฒฐ์ œ ํ™•์ธ ์ฟผ๋ฆฌ๋Š” `reset-db` ์ „์— ๋Œ๋ฆฐ๋‹ค. ์ง€์šฐ๊ณ  ๋‚˜๋ฉด ํ™•์ธํ•  ์ˆ˜ ์—†๋‹ค.
Loading