Previous
Next
[Go 2주 완성 #07] Day 12~13: 의존성 관리와 테스팅 - CMake보다 쉬운 세상

[Go 2주 완성 #07] Day 12~13: 의존성 관리와 테스팅 - CMake보다 쉬운 세상

· 14분 읽기 · 수정 초급 가이드
[Go 2주 완성 #07] Day 12~13: 의존성 관리와 테스팅 - CMake보다 쉬운 세상

이 글의 핵심

[Go 2주 완성 #07] Day 12~13: 의존성 관리와 테스팅 - CMake보다 쉬운 세상. 시리즈 안내·빌드 시스템의 혁명.

시리즈 안내

📚 Go 2주 완성 시리즈 #07 | 전체 목차 보기

이 글은 C++ 개발자를 위한 2주 완성 Go 언어 커리큘럼의 Day 12~13 내용입니다.

이전: #06 고루틴·채널 ← | → 다음: #08 REST API 프로젝트 단위 테스트는 모든 언어에서 중요합니다. Python에서 pytest·CI, Node.js의 Jest, C++의 Google Test, Rust의 cargo test는 각각의 생태계에서 표준에 가깝습니다. 테스트를 파이프라인에 붙이려면 Node.js GitHub Actions CI/CD와 C++ GitHub Actions 멀티 OS 빌드를 함께 보세요. 의존성·빌드 도구 관점에서는 go mod가 언어에 내장된 반면, C++는 CMake와 Conan·vcpkg를 조합하는 경우가 많고, npm·node_modules·pip·uv·Poetry·Rust Cargo와 비교하면 “선언·락·재현 빌드” 패턴이 한눈에 정리됩니다. C++ 빌드 시스템 완전 비교도 함께 읽으면 좋습니다.

💡 초보자를 위한 한 줄: Go는 go mod init으로 프로젝트 시작, go get 패키지명으로 라이브러리 추가, go test로 테스트 실행. CMake·vcpkg 필요 없습니다. 테스트 파일은 _test.go 접미사로 만들고, 함수명은 TestXxx(t *testing.T)로 시작합니다. 벤치마크는 BenchmarkXxx(b *testing.B).

들어가며: “CMake 설정 파일은 어디 있죠?”

C++에서 외부 라이브러리를 추가하려면:

# CMakeLists.txt 수정
find_package(Boost REQUIRED)
find_package(OpenSSL REQUIRED)
target_link_libraries(myapp Boost::boost OpenSSL::SSL)

# vcpkg나 Conan으로 의존성 관리
vcpkg install boost openssl

Go는 한 줄입니다:

go get github.com/gin-gonic/gin

끝입니다. 테스트도 마찬가지입니다. Google Test를 설치하고 설정할 필요 없이, go test만 실행하면 됩니다. 이 글에서 배울 내용:

  • Go Modules로 의존성 관리
  • go get으로 라이브러리 추가
  • go test로 유닛 테스트 작성
  • 테이블 주도 테스트와 벤치마크

C++ 개발자 관점: C++ 백그라운드에서 Go로 전환하며 겪은 차이점과 함정을 중심으로 설명합니다. 포인터, 동시성, 메모리 관리 등 핵심 개념을 비교하며 정리했습니다.

1. Go Modules: 의존성 관리

C++ vs Go: 프로젝트 초기화

# C++: CMakeLists.txt
cmake_minimum_required(VERSION 3.15)
project(MyProject)
set(CMAKE_CXX_STANDARD 17)
# 외부 라이브러리 찾기
find_package(Boost REQUIRED)
find_package(OpenSSL REQUIRED)
# vcpkg 설정
# ...
add_executable(myapp main.cpp)
target_link_libraries(myapp Boost::boost OpenSSL::SSL)
# Go: 모듈 초기화 (한 줄)
go mod init myproject
# 생성된 go.mod
# module myproject
# 
# go 1.21

의존성 추가

# C++: vcpkg 또는 Conan
vcpkg install boost openssl
# 또는
conan install . --build=missing
# CMakeLists.txt 수정 필요
# Go: go get (한 줄)
go get github.com/gin-gonic/gin@latest
go get github.com/stretchr/[email protected]
# go.mod에 자동 추가됨

go.mod 파일 구조

// go.mod
module myproject
go 1.21
require (
    github.com/gin-gonic/gin v1.9.1
    github.com/stretchr/testify v1.8.4
)
// 간접 의존성 (자동 관리)
require (
    github.com/gin-contrib/sse v0.1.0 // indirect
    github.com/go-playground/validator/v10 v10.14.0 // indirect
    // ...
)

주요 go 명령어

# 모듈 관리
go mod init myproject      # 모듈 초기화
go mod tidy                # 불필요한 의존성 제거
go mod download            # 의존성 다운로드
go mod verify              # 의존성 무결성 검증
# 의존성 추가/업데이트
go get package@latest      # 최신 버전
go get [email protected]      # 특정 버전
go get -u                  # 모든 의존성 업데이트
# 빌드
go build                   # 현재 디렉토리
go build ./....            # 모든 하위 패키지
go build -o myapp          # 출력 파일명 지정
# 실행
go run main.go             # 컴파일 + 실행

2. 외부 라이브러리 사용

실전 예시: HTTP 서버 (Gin 프레임워크)

# 의존성 추가
go get github.com/gin-gonic/gin
// main.go
package main
import (
    "github.com/gin-gonic/gin"
    "net/http"
)
func main() {
    r := gin.Default()
    
    r.GET("/ping", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{
            "message": "pong",
        })
    })
    
    r.Run(":8080")
}
# 실행
go run main.go
# 빌드
go build -o server
./server

3. 유닛 테스트 작성

C++ vs Go: 테스트 프레임워크

// C++: Google Test 설치 및 설정 필요
#include <gtest/gtest.h>
int Add(int a, int b) {
    return a + b;
}
TEST(MathTest, AddPositive) {
    EXPECT_EQ(Add(2, 3), 5);
}
TEST(MathTest, AddNegative) {
    EXPECT_EQ(Add(-2, -3), -5);
}
int main(int argc, char **argv) {
    ::testing::InitGoogleTest(&argc, argv);
    return RUN_ALL_TESTS();
}
// CMakeLists.txt에 Google Test 설정 추가 필요
// Go: 내장 testing 패키지 (설치 불필요)
// math.go
package math
func Add(a, b int) int {
    return a + b
}
// math_test.go
package math
import "testing"
func TestAddPositive(t *testing.T) {
    result := Add(2, 3)
    if result != 5 {
        t.Errorf("Add(2, 3) = %d; want 5", result)
    }
}
func TestAddNegative(t *testing.T) {
    result := Add(-2, -3)
    if result != -5 {
        t.Errorf("Add(-2, -3) = %d; want -5", result)
    }
}
# 테스트 실행
go test                    # 현재 패키지
go test ./....             # 모든 하위 패키지
go test -v                 # 상세 출력
go test -run TestAddPositive  # 특정 테스트만

테스트 헬퍼 함수

// Go: 테스트 헬퍼
package math
import "testing"
func assertEqual(t *testing.T, got, want int) {
    t.Helper()  // 에러 발생 시 호출자 라인 표시
    if got != want {
        t.Errorf("got %d; want %d", got, want)
    }
}
func TestAdd(t *testing.T) {
    assertEqual(t, Add(2, 3), 5)
    assertEqual(t, Add(-2, -3), -5)
    assertEqual(t, Add(0, 0), 0)
}

4. 테이블 주도 테스트

테이블 주도 테스트 패턴

// Go: 테이블 주도 테스트 (권장 패턴)
package math
import "testing"
func TestAdd(t *testing.T) {
    tests := []struct {
        name     string
        a, b     int
        expected int
    }{
        {"positive numbers", 2, 3, 5},
        {"negative numbers", -2, -3, -5},
        {"zero", 0, 0, 0},
        {"mixed", -5, 10, 5},
        {"large numbers", 1000000, 2000000, 3000000},
    }
    
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            result := Add(tt.a, tt.b)
            if result != tt.expected {
                t.Errorf("Add(%d, %d) = %d; want %d", 
                    tt.a, tt.b, result, tt.expected)
            }
        })
    }
}

실행 결과:

$ go test -v
=== RUN   TestAdd
=== RUN   TestAdd/positive_numbers
=== RUN   TestAdd/negative_numbers
=== RUN   TestAdd/zero
=== RUN   TestAdd/mixed
=== RUN   TestAdd/large_numbers
--- PASS: TestAdd (0.00s)
    --- PASS: TestAdd/positive_numbers (0.00s)
    --- PASS: TestAdd/negative_numbers (0.00s)
    --- PASS: TestAdd/zero (0.00s)
    --- PASS: TestAdd/mixed (0.00s)
    --- PASS: TestAdd/large_numbers (0.00s)
PASS

서브테스트 활용

// Go: 서브테스트로 구조화
func TestMath(t *testing.T) {
    t.Run("Add", func(t *testing.T) {
        if Add(2, 3) != 5 {
            t.Error("Add failed")
        }
    })
    
    t.Run("Subtract", func(t *testing.T) {
        if Subtract(5, 3) != 2 {
            t.Error("Subtract failed")
        }
    })
    
    t.Run("Multiply", func(t *testing.T) {
        if Multiply(2, 3) != 6 {
            t.Error("Multiply failed")
        }
    })
}

5. 벤치마크와 커버리지

벤치마크

// Go: 벤치마크 (함수명 BenchmarkXxx)
package math
import "testing"
func BenchmarkAdd(b *testing.B) {
    for i := 0; i < b.N; i++ {
        Add(2, 3)
    }
}
func BenchmarkAddLarge(b *testing.B) {
    for i := 0; i < b.N; i++ {
        Add(1000000, 2000000)
    }
}
# 벤치마크 실행
$ go test -bench=.
BenchmarkAdd-8          1000000000    0.25 ns/op
BenchmarkAddLarge-8     1000000000    0.26 ns/op
PASS
# 메모리 할당 측정
$ go test -bench=. -benchmem
BenchmarkAdd-8          1000000000    0.25 ns/op    0 B/op    0 allocs/op

커버리지

# 커버리지 측정
go test -cover
# PASS
# coverage: 85.7% of statements
# 상세 커버리지 리포트
go test -coverprofile=coverage.out
go tool cover -html=coverage.out  # HTML 리포트 생성

테스트 모킹

// Go: 인터페이스로 모킹
package user
import "testing"
// 인터페이스 정의
type UserStore interface {
    Get(id int) (*User, error)
    Save(u *User) error
}
// 프로덕션 구현
type DBUserStore struct {
    // DB 연결...
}
func (s *DBUserStore) Get(id int) (*User, error) {
    // 실제 DB 조회
    return nil, nil
}
// 테스트용 모의 구현
type MockUserStore struct {
    users map[int]*User
}
func NewMockUserStore() *MockUserStore {
    return &MockUserStore{
        users: make(map[int]*User),
    }
}
func (m *MockUserStore) Get(id int) (*User, error) {
    if user, ok := m.users[id]; ok {
        return user, nil
    }
    return nil, errors.New("not found")
}
func (m *MockUserStore) Save(u *User) error {
    m.users[u.ID] = u
    return nil
}
// 서비스 (인터페이스에 의존)
type UserService struct {
    store UserStore
}
func NewUserService(store UserStore) *UserService {
    return &UserService{store: store}
}
func (s *UserService) GetUser(id int) (*User, error) {
    return s.store.Get(id)
}
// 테스트
func TestUserService_GetUser(t *testing.T) {
    // 모의 스토어 사용
    mockStore := NewMockUserStore()
    mockStore.Save(&User{ID: 1, Name: "Alice"})
    
    service := NewUserService(mockStore)
    
    user, err := service.GetUser(1)
    if err != nil {
        t.Fatal(err)
    }
    
    if user.Name != "Alice" {
        t.Errorf("got %s; want Alice", user.Name)
    }
}

6. 실습 과제

과제 1: 문자열 유틸리티 테스트

// string_utils.go
package utils
import "strings"
func Reverse(s string) string {
    runes := []rune(s)
    for i, j := 0, len(runes)-1; i < j; i, j = i+1, j-1 {
        runes[i], runes[j] = runes[j], runes[i]
    }
    return string(runes)
}
func IsPalindrome(s string) bool {
    s = strings.ToLower(s)
    return s == Reverse(s)
}
func WordCount(s string) int {
    return len(strings.Fields(s))
}
// string_utils_test.go
package utils
import "testing"
func TestReverse(t *testing.T) {
    tests := []struct {
        input    string
        expected string
    }{
        {"hello", "olleh"},
        {"Go", "oG"},
        {"", ""},
        {"a", "a"},
        {"안녕하세요", "요세하녕안"},
    }
    
    for _, tt := range tests {
        t.Run(tt.input, func(t *testing.T) {
            result := Reverse(tt.input)
            if result != tt.expected {
                t.Errorf("Reverse(%q) = %q; want %q", 
                    tt.input, result, tt.expected)
            }
        })
    }
}
func TestIsPalindrome(t *testing.T) {
    tests := []struct {
        input    string
        expected bool
    }{
        {"racecar", true},
        {"hello", false},
        {"A man a plan a canal Panama", false},  // 공백 포함
        {"", true},
        {"a", true},
    }
    
    for _, tt := range tests {
        t.Run(tt.input, func(t *testing.T) {
            result := IsPalindrome(tt.input)
            if result != tt.expected {
                t.Errorf("IsPalindrome(%q) = %v; want %v", 
                    tt.input, result, tt.expected)
            }
        })
    }
}
func TestWordCount(t *testing.T) {
    tests := []struct {
        input    string
        expected int
    }{
        {"hello world", 2},
        {"Go is awesome", 3},
        {"", 0},
        {"   spaces   ", 1},
    }
    
    for _, tt := range tests {
        result := WordCount(tt.input)
        if result != tt.expected {
            t.Errorf("WordCount(%q) = %d; want %d", 
                tt.input, result, tt.expected)
        }
    }
}

과제 2: HTTP 핸들러 테스트

// handler.go
package main
import (
    "encoding/json"
    "net/http"
)
type Response struct {
    Message string `json:"message"`
    Status  string `json:"status"`
}
func PingHandler(w http.ResponseWriter, r *http.Request) {
    if r.Method != http.MethodGet {
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
        return
    }
    
    resp := Response{
        Message: "pong",
        Status:  "ok",
    }
    
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(resp)
}
// handler_test.go
package main
import (
    "encoding/json"
    "net/http"
    "net/http/httptest"
    "testing"
)
func TestPingHandler(t *testing.T) {
    // 요청 생성
    req := httptest.NewRequest(http.MethodGet, "/ping", nil)
    
    // 응답 기록기
    w := httptest.NewRecorder()
    
    // 핸들러 호출
    PingHandler(w, req)
    
    // 상태 코드 검증
    if w.Code != http.StatusOK {
        t.Errorf("got status %d; want %d", w.Code, http.StatusOK)
    }
    
    // 응답 본문 검증
    var resp Response
    if err := json.NewDecoder(w.Body).Decode(&resp); err != nil {
        t.Fatal(err)
    }
    
    if resp.Message != "pong" {
        t.Errorf("got message %s; want pong", resp.Message)
    }
    
    if resp.Status != "ok" {
        t.Errorf("got status %s; want ok", resp.Status)
    }
}
func TestPingHandler_InvalidMethod(t *testing.T) {
    req := httptest.NewRequest(http.MethodPost, "/ping", nil)
    w := httptest.NewRecorder()
    
    PingHandler(w, req)
    
    if w.Code != http.StatusMethodNotAllowed {
        t.Errorf("got status %d; want %d", 
            w.Code, http.StatusMethodNotAllowed)
    }
}

과제 3: 벤치마크 작성

// fibonacci.go
package math
func Fibonacci(n int) int {
    if n <= 1 {
        return n
    }
    return Fibonacci(n-1) + Fibonacci(n-2)
}
func FibonacciMemo(n int) int {
    memo := make(map[int]int)
    return fibMemo(n, memo)
}
func fibMemo(n int, memo map[int]int) int {
    if n <= 1 {
        return n
    }
    
    if v, ok := memo[n]; ok {
        return v
    }
    
    memo[n] = fibMemo(n-1, memo) + fibMemo(n-2, memo)
    return memo[n]
}
// fibonacci_test.go
package math
import "testing"
func BenchmarkFibonacci(b *testing.B) {
    for i := 0; i < b.N; i++ {
        Fibonacci(20)
    }
}
func BenchmarkFibonacciMemo(b *testing.B) {
    for i := 0; i < b.N; i++ {
        FibonacciMemo(20)
    }
}
# 벤치마크 실행
$ go test -bench=.
BenchmarkFibonacci-8            30000     50000 ns/op
BenchmarkFibonacciMemo-8      5000000       300 ns/op
PASS
# 메모이제이션이 약 166배 빠름!

과제 4: 테스트 커버리지 개선

// calculator.go
package calc
import "errors"
func Divide(a, b float64) (float64, error) {
    if b == 0 {
        return 0, errors.New("division by zero")
    }
    return a / b, nil
}
func SafeDivide(a, b float64) float64 {
    result, err := Divide(a, b)
    if err != nil {
        return 0
    }
    return result
}
// calculator_test.go
package calc
import "testing"
func TestDivide(t *testing.T) {
    tests := []struct {
        name      string
        a, b      float64
        expected  float64
        shouldErr bool
    }{
        {"normal", 10, 2, 5, false},
        {"zero dividend", 0, 5, 0, false},
        {"zero divisor", 10, 0, 0, true},
        {"negative", -10, 2, -5, false},
    }
    
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            result, err := Divide(tt.a, tt.b)
            
            if tt.shouldErr {
                if err == nil {
                    t.Error("expected error, got nil")
                }
            } else {
                if err != nil {
                    t.Errorf("unexpected error: %v", err)
                }
                if result != tt.expected {
                    t.Errorf("got %f; want %f", result, tt.expected)
                }
            }
        })
    }
}
func TestSafeDivide(t *testing.T) {
    tests := []struct {
        name     string
        a, b     float64
        expected float64
    }{
        {"normal", 10, 2, 5},
        {"zero divisor", 10, 0, 0},  // 에러 시 0 반환
    }
    
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            result := SafeDivide(tt.a, tt.b)
            if result != tt.expected {
                t.Errorf("got %f; want %f", result, tt.expected)
            }
        })
    }
}
# 커버리지 확인
$ go test -cover
PASS
coverage: 100.0% of statements

정리: Day 12~13 학습 체크리스트

완료해야 할 항목

  • go mod init으로 모듈 초기화
  • go get으로 의존성 추가
  • go.mod와 go.sum 파일 이해
  • _test.go 파일에 테스트 작성
  • testing.T로 유닛 테스트
  • 테이블 주도 테스트 패턴 활용
  • testing.B로 벤치마크 작성
  • 커버리지 측정 및 개선
  • 실습 과제 4개 완료

C++에서 Go로 전환 포인트

C++Go비고
CMakeLists.txtgo.mod훨씬 간단
vcpkg/Conango get한 줄로 끝
Google Testtesting 패키지내장
CTestgo test내장
gcov/lcovgo test -cover내장

Go 빌드 시스템의 장점

graph LR
    A[C++ 빌드] --> B[CMake 설정]
    B --> C[의존성 관리]
    C --> D[빌드 실행]
    D --> E[테스트 설정]
    E --> F[테스트 실행]
    
    G[Go 빌드] --> H[go build]
    G --> I[go test]
    
    style A fill:#ffcccc
    style G fill:#ccffcc

Go의 장점:

  • ✅ 빌드 시스템 내장
  • ✅ 의존성 관리 자동화
  • ✅ 테스트 프레임워크 내장
  • ✅ 크로스 컴파일 간단
# 크로스 컴파일 (C++에서는 복잡)
GOOS=linux GOARCH=amd64 go build    # Linux 64비트
GOOS=windows GOARCH=amd64 go build  # Windows 64비트
GOOS=darwin GOARCH=arm64 go build   # macOS ARM

다음 단계 예고

Day 12~13에서는 의존성 관리와 테스팅을 배웠습니다. 마지막 Day 14에서는 지금까지 배운 모든 것을 통합하여 실전 REST API 서버를 구축합니다!

📚 시리즈 네비게이션

이전 글목차다음 글
← #06 고루틴·채널📑 전체 목차#08 REST API →
Go 2주 완성 시리즈:
커리큘럼 • #01 기본 문법 • #02 자료구조 • #03 객체지향 • #04 인터페이스 • #05 에러 처리 • #06 고루틴·채널 • #07 테스팅 • #08 REST API • #09 context·우아한 종료

한 줄 요약: Go Modules는 CMake보다 수백 배 쉽고, go test는 외부 프레임워크 없이 모든 것을 제공합니다.

같이 보면 좋은 글 (내부 링크)

이 주제와 연결되는 다른 글입니다.

이 글에서 다루는 키워드 (관련 검색어)

Go modules, go mod tidy, go test, 벤치마크 Go, 테스트 커버리지, CMake 대체, Golang 의존성, Go 2주 완성 등으로 검색하시면 이 글이 도움이 됩니다.

실전 팁 (Go)

  • go fmt, go vet, 필요 시 golangci-lint로 기본 품질을 맞춥니다.
  • if err != nil을 습관화합니다. 에러를 삼키면 운영에서 원인 추적이 어렵습니다.
  • go test ./...로 패키지 단위 회귀를 확인합니다. 성능은 go test -bench로 측정할 수 있을 때만 다룹니다.

실전 체크리스트 (Go)

코드

  • 외부 호출·I/O 실패 시 에러가 처리되거나 로깅되는가?
  • 고루틴·채널 사용 시 블로킹·누수 가능성을 검토했는가?

모듈

  • go.mod / go.sum이 팀과 합의된 범위인가?

자주 묻는 질문 (FAQ)

Q. 이 내용을 실무에서 언제 쓰나요?

A. C++의 복잡한 CMake, vcpkg 설정에서 벗어나 Go Modules로 간단하게 의존성을 관리하세요. 외부 프레임워크 없이 go test만으로 유닛 테스트, 벤치마크, 커버리지까지 모두 처리합니다. 실무에서는 위 본문의 예제와 선택 가이드를 참고해 적용하면 됩니다.

Q. 선행으로 읽으면 좋은 글은?

A. 각 글 하단의 이전 글 또는 관련 글 링크를 따라가면 순서대로 배울 수 있습니다. C++ 시리즈 목차에서 전체 흐름을 확인할 수 있습니다.

Q. 더 깊이 공부하려면?

A. cppreference와 해당 라이브러리 공식 문서를 참고하세요. 글 말미의 참고 자료 링크도 활용하면 좋습니다.

관련 글

심화 부록: 구현·운영 관점

이 부록은 앞선 본문에서 다룬 주제(「[Go 2주 완성 #07] Day 12~13: 의존성 관리와 테스팅 - CMake보다 쉬운 세상」)를 구현·런타임·운영 관점에서 다시 압축합니다. 도메인별 세부 구현은 글마다 다르지만, 입력 검증 → 핵심 연산 → 부작용(I/O·네트워크·동시성) → 관측의 흐름으로 장애를 나누면 원인 추적이 빨라집니다.

내부 동작과 핵심 메커니즘

flowchart TD
  A[입력·요청·이벤트] --> B[파싱·검증·디코딩]
  B --> C[핵심 연산·상태 전이]
  C --> D[부작용: I/O·네트워크·동시성]
  D --> E[결과·관측·저장]
sequenceDiagram
  participant C as 클라이언트/호출자
  participant B as 경계(런타임·게이트웨이·프로세스)
  participant D as 의존성(API·DB·큐·파일)
  C->>B: 요청/이벤트
  B->>D: 조회·쓰기·RPC
  D-->>B: 지연·부분 실패·재시도 가능
  B-->>C: 응답 또는 오류(코드·상관 ID)
  • 불변 조건(Invariant): 버퍼 경계, 프로토콜 상태, 트랜잭션 격리, FD 상한 등 단계별로 문장으로 적어 두면 디버깅 비용이 줄어듭니다.
  • 결정성: 순수 층과 시간·네트워크·스케줄에 의존하는 층을 분리해야 테스트와 장애 분석이 쉬워집니다.
  • 경계 비용: 직렬화, 인코딩, syscall 횟수, 락 경합, 할당·GC, 캐시 미스를 의심 목록에 둡니다.
  • 백프레셔: 생산자가 소비자보다 빠를 때 버퍼·큐·스트림에서 속도를 줄이는 신호를 어디에 둘지 정의합니다.

프로덕션 운영 패턴

영역운영 관점 질문
관측성요청 단위 상관 ID, 에러율·지연 p95/p99, 의존성 타임아웃·재시도가 대시보드에 보이는가
안전성입력 검증·권한·비밀·감사 로그가 코드 경로마다 일관적인가
신뢰성재시도는 멱등 연산에만 적용되는가, 서킷 브레이커·백오프·DLQ가 있는가
성능캐시·배치 크기·커넥션 풀·인덱스·백프레셔가 데이터 규모에 맞는가
배포롤백 룬북, 카나리/블루그린, 마이그레이션·피처 플래그가 문서화되어 있는가
용량피크 트래픽·디스크·FD·스레드 풀 상한을 주기적으로 검증하는가

스테이징은 데이터 양·네트워크 RTT·동시성을 프로덕션에 가깝게 맞출수록 재현율이 올라갑니다.

확장 예시: 엔드투엔드 미니 시나리오

앞선 본문 주제(「[Go 2주 완성 #07] Day 12~13: 의존성 관리와 테스팅 - CMake보다 쉬운 세상」)를 배포·운영 흐름에 맞춰 옮긴 체크리스트입니다. 도메인에 맞게 단계 이름만 바꿔 적용할 수 있습니다.

  1. 입력 계약 고정: 스키마·버전·최대 페이로드·타임아웃·에러 코드를 경계에 둔다.
  2. 핵심 경로 계측: 요청 ID, 단계별 지연, 외부 호출 결과 코드를 로그·메트릭·트레이스에서 한 흐름으로 본다.
  3. 실패 주입: 의존성 타임아웃·5xx·부분 데이터·락 대기를 스테이징에서 재현한다.
  4. 호환·롤백: 설정/마이그레이션/클라이언트 버전을 되돌릴 수 있는지 확인한다.
  5. 부하 후 검증: 피크 대비 p95/p99, 에러율, 리소스 상한, 알림 임계값을 점검한다.
handle(request):
  ctx = newCorrelationId()
  validated = validateSchema(request)
  authorize(validated, ctx)
  result = domainCore(validated)
  persistOrEmit(result, idempotentKey)
  recordMetrics(ctx, latency, outcome)
  return result

문제 해결(Troubleshooting)

증상가능 원인조치
간헐적 실패레이스, 타임아웃, 외부 의존성, DNS최소 재현 스크립트, 분산 트레이스·로그 상관관계, 재시도·서킷 설정 점검
성능 저하N+1, 동기 I/O, 락 경합, 과도한 직렬화, 캐시 미스프로파일러·APM으로 핫스팟 확인 후 한 가지씩 제거
메모리 증가캐시 무제한, 구독/리스너 누수, 대용량 버퍼, 커넥션 미반납상한·TTL·힙/FD 스냅샷 비교
빌드·배포만 실패환경 변수, 권한, 플랫폼 차이, lockfileCI 로그와 로컬 diff, 런타임·이미지 버전 핀
설정 불일치프로필·시크릿·기본값, 리전스키마 검증된 설정 단일 소스와 배포 매트릭스 표준화
데이터 불일치비멱등 재시도, 부분 쓰기, 캐시 무효화 누락멱등 키·아웃박스·트랜잭션 경계 재검토

권장 순서: (1) 최소 재현 (2) 최근 변경 범위 축소 (3) 환경·의존성 차이 (4) 관측으로 가설 검증 (5) 수정 후 회귀·부하 테스트.

배포 전에는 git add → git commit → git push 후 npm run deploy 순서를 권장합니다.