설정 관리와 핫리로드: config.ini/YAML 실전

-

🌐 English

돌아가는 봇의 파라미터를 바꾸려고 매번 재시작하면, 그 사이 시장은 기다려주지 않습니다. 재시작 없이 설정을 갈아끼우는 핫리로드 패턴을, 자동매매 봇을 운영하며 정리했습니다. 핵심은 세 가지 — 주기적 재로드, 동시성 안전, 그리고 검증입니다.

설정 파일에는 민감 정보(API 키 등)가 들어가기 쉽습니다. 절대 저장소에 커밋하지 말고, 예시 파일(config.example.ini)만 공유하세요.

왜 INI/YAML인가

봇 설정은 사람이 손으로 자주 고칩니다. 그래서 사람이 읽고 쓰기 쉬운 형식이 유리합니다. INI는 섹션 구조가 단순해 페어·종목별 설정을 나누기 좋고, YAML은 중첩 구조에 강합니다. 둘 다 주석을 달 수 있어 "이 값이 뭔지"를 파일 안에 남길 수 있습니다.

[COMMON]

GapEvalIntervalMs = 1000   ; 갭 평가 주기(ms)

EntryDebounceSec  = 30     ; 중복 진입 방지 시간(초)

[PAIR_01]

EntryGapPct = 0.50         ; 진입 임계치(%)

Enabled     = true

5분 자동 reload

가장 단순하면서 실전에서 잘 도는 패턴은 일정 주기로 파일을 다시 읽는 것입니다. 파일 변경 감시(inotify 등)보다 구현이 단순하고 예측 가능합니다.

func configReloader() {

    ticker := time.NewTicker(5 * time.Minute)

    for range ticker.C {

        if err := reloadConfig(); err != nil {

            logCh <- "[설정] 자동 reload 실패: " + err.Error()

            continue // 실패해도 기존 설정 유지

        }

        logCh <- "[설정] 자동 reload 완료"

    }

}

포인트는 continue입니다. reload에 실패해도 봇을 멈추지 않고 직전의 정상 설정으로 계속 돕니다. 오타 하나로 봇 전체가 죽으면 안 되니까요.

동시성 — 스냅샷으로 읽는다

여기서 초보가 놓치는 함정이 있습니다. reload는 설정을 쓰고(write), 봇의 여러 goroutine은 그 설정을 읽습니다(read). 아무 보호 없이 하면 읽는 도중 값이 바뀌는 경쟁 상태(race)가 납니다.

해법은 sync.RWMutex와 스냅샷 복사입니다. 읽는 쪽은 설정 전체를 오래 잡고 있지 말고, 독립된 복사본을 잠깐 떠서 그걸로 일합니다.

var cfgMu sync.RWMutex

// 활성 설정의 독립 복사본을 반환 — reload가 원본을 바꿔도 영향 없음

func snapshotPairs() []Pair3Config {

    cfgMu.RLock()

    defer cfgMu.RUnlock()

    out := make([]Pair3Config, len(cfg.Pairs))

    copy(out, cfg.Pairs)  // 값 복사

    return out

}

이러면 reader들은 락을 짧게만 잡고, 그 뒤로는 자기 사본으로 자유롭게 일합니다. reload가 원본을 통째로 갈아끼워도 진행 중이던 계산은 안전합니다. "락을 잡은 채로 오래 일하지 않는다"가 핵심 원칙입니다.

검증 — 나쁜 값은 걸러낸다

핫리로드의 가장 큰 위험은 잘못된 설정이 즉시 반영되는 것입니다. 그래서 reload 시 반드시 검증합니다.

  • 타입·범위 검사: 임계치가 음수거나 0이면 해당 항목 skip.
  • 필수 값 확인: 종목 코드가 비었으면 그 페어는 비활성 처리.
  • 핫리로드 대상 제한: 임계치·활성여부처럼 안전하게 바꿀 수 있는 것만 핫리로드하고, 종목 코드나 WebSocket 구독처럼 재구독이 필요한 항목은 재시작을 권고합니다.
if pair.EntryGapPct <= 0 || pair.MaxInvestPerLeg <= 0 {

    continue // 이상값 → 이 페어는 이번 reload에서 무시

}

검증을 통과하지 못한 항목은 조용히 무시하되 로그는 반드시 남깁니다. "왜 내 설정이 안 먹지?"를 나중에 추적할 수 있어야 하니까요.

정리

  • 설정은 사람이 읽기 쉬운 INI/YAML, 민감정보는 커밋 금지
  • 주기적 재로드(예: 5분)가 파일 감시보다 단순·예측 가능
  • reload는 write, 봇은 read → RWMutex + 스냅샷 복사로 race 차단
  • 검증을 통과한 안전한 항목만 핫리로드, 나머지는 재시작 권고
  • 실패·무시는 봇을 멈추지 말고 로그로 남긴다

핫리로드가 잘 되면 운영 감각이 완전히 달라집니다. 시장을 보며 파라미터를 실시간으로 조율하되, 그 편의가 안정성을 해치지 않도록 검증이라는 안전벨트를 꼭 채우세요.

댓글

댓글 쓰기

이 블로그의 인기 게시물

한국투자증권 KIS API로 실시간 시세 받기 (WebSocket 실전)

-
🌐 English 주식 자동매매 봇의 심장은 실시간 시세 입니다. REST 폴링만으로는 초 단위 시그널을 만들 수 없습니다. 한국투자증권(KIS) 오픈API는 WebSocket으로 호가와 체결을 밀어주는데, 실전에서 부딪히는 지점들을 자동매매 봇을 만들며 정리한 노트입니다. ⚠️ 이 글은 교육·정보 제공 목적입니다. 투자 권유가 아니며, 투자 손실 책임은 본인에게 있습니다. 두 개의 TR을 구독한다 KIS 실시간에서 자주 쓰는 TR은 두 가지입니다. H0STASP0 — 실시간 호가 (매수·매도 1~10호가) H0STCNT0 — 실시간 체결가 (현재가, 시가, 전일종가, 누적거래량) 시가 기준 전략을 쓴다면 H0STCNT0 이 필수입니다. 체결 메시지 안에 시가(stck_oprc) 가 들어 있어서, 장 시작 첫 체결로 그날의 기준선을 잡을 수 있기 때문입니다. 종목당 두 TR을 구독하므로, 종목이 늘어나면 구독 건수가 빠르게 증가합니다. KIS는 한 연결에 동시 구독 한도(수십 건)가 있으니, 중복 종목은 seen 맵으로 걸러 한 번만 구독합니다. seen := make(map[string]bool) addSym := func(code string) { if code == "" || seen[code] { return // 빈 코드·중복은 skip } seen[code] = true subscribeKIS(conn, approvalKey, "H0STASP0", code) // 호가 time.Sleep(50 * time.Millisecond) subscribeKIS(conn, approvalKey, "H0STCNT0", code) // 체결 time.Sleep(50 * time.Millisecond) } 구독 사이에 짧은 sleep 을 두는 이유는, 여러 구독 프레임을 한...
자세한 내용 보기

파이썬으로 업비트 API 연동하기 — 시세 조회부터 주문까지 기초

-
🌐 English 코인 자동매매를 만들어 보려고 검색하면 대부분 "전략"부터 이야기합니다. 그런데 막상 코드를 짜려고 하면 거래소에 요청을 어떻게 보내는지 에서 먼저 막힙니다. 이 글은 그 첫 관문만 다룹니다. 파이썬으로 업비트 API에 붙어서 시세를 읽고, 잔고를 확인하고, 주문을 넣는 데까지입니다. 0. 준비물 필요한 건 두 가지뿐입니다. 파이썬 패키지 : pip install requests pyjwt — requests는 HTTP 요청 라이브러리, PyJWT는 인증 토큰을 만드는 라이브러리입니다. 업비트 API 키 : 업비트 웹사이트 → 마이페이지 → Open API 관리에서 발급합니다. 발급할 때 허용 IP를 반드시 등록 하고, 처음에는 자산조회·주문조회 권한만 켜세요. 주문 권한은 코드가 검증된 뒤에 켜도 늦지 않습니다. 발급받은 secret key는 발급 화면을 벗어나면 다시 볼 수 없습니다. 그리고 절대 소스코드에 직접 적지 마세요. 환경변수나 설정 파일로 분리합니다. import os ACCESS_KEY = os.environ["UPBIT_ACCESS_KEY"] # 실제 키는 환경변수로 SECRET_KEY = os.environ["UPBIT_SECRET_KEY"] SERVER_URL = "https://api.upbit.com" 1. 시세 조회 — 인증이 필요 없는 요청 가장 쉬운 것부터 합니다. 현재가 조회는 인증 없이 됩니다. 그냥 GET 요청 하나면 끝입니다. import requests def get_price(market="KRW-BTC"): url = f"{SERVER_URL}/v1/ticker" res = requests.get(url, params={"markets": market}, timeout=5) res.rais...
자세한 내용 보기

Go로 자동매매 신호봇 프레임워크 설계하기

-
🌐 English 자동매매 봇을 만들다 보면 전략 코드보다 주변 골격 에 시간을 더 쓰게 됩니다. 설정을 어떻게 읽지? 상태는 어디서 보지? 알림은? 이 글은 실제로 돌아가는 Go 선물 신호봇을 만들며 정리한, 재사용 가능한 프레임워크 뼈대입니다. 핵심 원칙은 하나입니다. 최소 의존성. 설정은 ini 하나, 웹은 표준 net/http , 알림은 텔레그램 REST 호출. 무거운 프레임워크 없이 단일 실행 파일로 끝냅니다. 1. 설정 로더 — config.ini 봇 파라미터는 코드가 아니라 파일에 둡니다. 재빌드 없이 값을 바꾸기 위해서죠. INI는 사람이 편집하기 쉽고 섹션으로 묶기 좋습니다. type AppConfig struct { APIKey, APISecret string Testnet bool LoopIntervalSec int NotionalPerEntry float64 Leverage int DashboardPort int DashboardKey string } func loadConfig(path string) (*AppConfig, error) { f, err := ini.Load(path) if err != nil { return nil, err } c := &AppConfig{} bi := f.Section("binance") c.APIKey = bi.Key("api_key").String() c.Testnet = bi.Key("testnet").MustBool(true) // 기본값을 안전한 쪽으로 tr := f.Section("trading") c.LoopIntervalSec = tr.Key("loop_interval_sec").MustInt(10) c.Leverage = tr.Key("l...
자세한 내용 보기