NSQ 메시지 큐의 디스크 저장소: DiskQueue 설계 상세
개요 및 역할
NSQ 아키텍처에서 DiskQueue는 비휘발성 스토리지 역할을 수행하는 핵심 컴포넌트입니다. 메모리 기반 처리의 속도와 디스크 기반 영구성의 안정성을 결합하여, 시스템 재부팅 후에도 손실되지 않도록 메시지를 파일로 관리합니다. 이 구성 요소는 메모리와 디스크 사이의 효율적인 데이터를 이동시키는 메커니즘을 제공하며, 특히 고可用 환경에서 데이터 ...
8월 1일 19:28에 게시됨
Machinery Task Signatures: 분산 환경에서의 비동기 작업 설계 및 구현 가이드
Machinery는 Go 언어로 작성된 분산 메시지 패싱 기반의 비동기 작업 큐 시스템입니다. 이 시스템의 핵심 개념인 작업 시그니처(Task Signature)는 분산된 워커들 사이에서 실행될 작업의 명세서 역할을 합니다. 효율적이고 확장 가능한 시스템 구축을 위해 작업 시그니처를 설계하고 활용하는 방법을 상세히 살펴봅니다.
1. 작업 시그니처의 기본 구조
작업 시그니처는 ...
8월 1일 10:51에 게시됨
Gin 프레임워크에서 Zap 로깅 시스템 통합 및 로그 로테이션 설정하기
Gin 프레임워크를 사용하여 웹 서비스를 개발할 때, 기본적으로 제공되는 로거 대신 Uber의 고성능 로깅 라이브러리인 zap을 사용하면 더 빠르고 구조화된 로그를 남길 수 있습니다. 이 글에서는 Gin의 기본 로그를 Zap으로 대체하고, 대용량 로그 관리를 위한 로그 로테이션(Lumberjack) 설정 방법을 설명합니다.
Gin의 기본 로거 이해
Gin 애플리케이션을 시작할 때 흔 ...
7월 31일 15:02에 게시됨
Watermill 라이브러리로 구현하는 Golang CQRS
CQRS 개요
CQRS는 명령-질의 책임 분리(Command-Query Responsibility Segregation)의 약자입니다. 이 패턴의 핵심은 명령(쓰기 요청)과 질의(읽기 요청)를 서로 다른 객체가 처리하도록 분리하는 데 있습니다. 이것이 기본 개념입니다.
이를 더 확장하여 데이터 저장소를 분리하고, 읽기 전용 저장소와 쓰기 전용 저장소를 별도로 사용할 수 있습니다. 이렇게 하면 다양한 ...
7월 30일 02:18에 게시됨
LogKit 설치 및 사용 방법 안내
LogKit 소개
LogKit은 로그와 메트릭을 수집하고 전송하는 강력한 서버 에이전트로, 직관적인 웹 콘솔을 통해 쉽게 관리할 수 있습니다. 이 도구는 다양한 환경에서 로그 데이터를 중앙 집중식으로 처리할 수 있도록 설계되어 있으며, 대규모 분산 시스템부터 소규모 서버까지 유연하게 적용 가능합니다.
저장소 디렉터리 구조
LogKit 저장소를 클론한 후 확인할 수 있는 ...
7월 24일 02:03에 게시됨
Go + gRPC-Gateway(V2) 마이크로서비스实战,小程序 로그인 인증 서비스(5): 인증 gRPC-Interceptor 구현
인터셉터(gRPC-Interceptor) 소개
gRPC-Interceptor는 Gin 미들웨어(Middleware)와 유사한 개념입니다. 이를 통해 실제 RPC 서비스 호출 전에 인증, 파라미터 검증, Rate Limiting 등의 공통 작업을 수행할 수 있습니다.
UnaryInterceptor 이해하기
gRPC 소스 코드를 분석해보면 다음과 같은 정의를 확인할 수 있습니다:
// UnaryInterceptor는 gRPC 서버에 UnaryServe ...
7월 22일 06:57에 게시됨
Go 언어 Circuit Breaker 구현 가이드
서론
Circuit Breaker는 일종의 안전장치로 작동합니다. 의존하는 외부 서비스에서 문제가 발생했을 때 적시에 오류를 처리할 수 있습니다. 이를 통해 두 가지 주요 효과를 얻을 수 있습니다:
상위 서비스가 자사 서비스에 대한 접근 의존도를 줄여 캐스케이드 실패 방지
요청 빈도를 낮춰 상위 서비스의 복구 시간 단축
이 패턴은 매우 광범위하게 활용됩니다. 일반 ...
7월 21일 06:20에 게시됨
클라우드 네이티브 게임 서버 개발: Golang을 활용한 마작 게임 서버 구축
로그 분석 및 패킷 캡처를 통한 비회원 로그인 프로세스 이해
소개
이 문서는 클라우드 네이티브 환경에서 DevOps(GitOps), Kubernetes, BPF, SRE 등을 적용하여 Golang으로 생산급 마작 게임 서버를 만드는 과정을 다룹니다. 특히, 비회원(Guest) 로그인 프로세스를 통해 서버와 클라이언트 간의 상호 작용을 분석합니다.
Nano Game Server 개요
Nano Game Server는 ...
7월 20일 00:49에 게시됨
Go 언어 기반 REST API 유닛 테스트 및 Gorilla Mux 연동 가이드
애플리케이션 구조 설계
Go 언어로 견고한 REST API를 구축하기 위해서는 데이터베이스 연결과 라우팅 로직을 추상화하는 구조가 필요합니다. 아래는 Gorilla Mux와 MySQL을 활용한 애플리케이션의 핵심 구조체인 RestServer 예제입니다.
package main
import (
"database/sql"
"encoding/json"
"fmt"
"log"
"net/http"
"strconv"
_ "g ...
7월 16일 17:45에 게시됨
Go 언어로 구현하는 데코레이터 패턴: 유연한 기능 확장을 위한 설계
데코레이터 패턴이란?
데코레이터 패턴(Decorator Pattern)은 객체의 기능을 동적으로 확장할 수 있도록 해주는 구조적 디자인 패턴입니다. 상속을 사용하지 않고도, 기존 코드를 수정하지 않으면서 새로운 행동을 추가할 수 있습니다. 이는 "상속보다 조합(composition)을 우선하라"는 객체 지향 원칙과 일치합니다.
특히 다음 상황에서 유용하게 사용됩니다:
클래스 ...
7월 14일 21:54에 게시됨