NFT 백엔드 API GitOps 배포 노트: ArgoCD + Kustomize
NFT 프로젝트 백엔드 API를 ArgoCD와 Kustomize로 dev/qa/prod 배포하는 패턴을 정리한 관찰 문서
개요
NFT 컬렉션 프로젝트의 백엔드 REST API 서버를 Kubernetes 위에서 ArgoCD + Kustomize overlay 구조로 운영하기 위한 배포 노트입니다. 하나의 ingress overlay에 strategic merge patch와 JSON 6902 patch가 공존하는 사례를 통해 두 패치 방식의 적용 순서와 함정을 분석합니다. RPC 호출 rate limit, IPFS gateway latency, 컨트랙트 주소의 환경별 분리 등 NFT 도메인 특화 운영 이슈도 함께 다룹니다. stateless API 서버 특성상 RollingUpdate 기반 무중단 배포가 자연스럽게 적용되는 구조를 관찰자 시점에서 정리했습니다.
담당 역할
레포 자체가 관찰/정리 문서로, 실제 운영 사례를 바탕으로 GitOps 배포 패턴과 함정을 분석·문서화함
아키텍처 다이어그램
레포지토리 분석 결과를 바탕으로 자동 생성된 구조도입니다.
NFT 백엔드 배포 아키텍처
사용자 요청이 ingress를 거쳐 백엔드 Pod에 도달하고 외부 블록체인/IPFS 의존성과 연결되는 구조를 보여줍니다.
두 종류 ingress patch 적용 흐름
Kustomize가 strategic merge patch와 JSON 6902 patch를 순서대로 적용하는 흐름과 주의점을 보여줍니다.
기술스택
각 기술을 이 프로젝트에서 어떤 용도로 썼는지 정리했습니다.
인프라
- KubernetesNFT 백엔드 API 서버를 dev/qa/prod 환경으로 오케스트레이션
- AWS ALBingress controller로 외부 트래픽 노출
- nginx ingress대안 ingress controller
DevOps
데이터베이스
- PostgreSQL분석 데이터 및 holder 정보 캐시
- Redis메타데이터 캐시 및 rate limit 처리
블록체인
- IPFSNFT 메타데이터 저장/조회 gateway
핵심 포인트
- strategic merge patch와 JSON 6902 patch가 한 ingress overlay에 공존하는 드문 구조를 분석
- 6902 patch의 array index 의존성으로 인한 silent fail 위험을 문서화
- listener와 달리 multi-replica + RollingUpdate로 무중단 배포되는 stateless API 특성 정리
- RPC rate limit, IPFS latency 등 NFT 도메인 특화 백엔드 운영 함정을 정리
문제와 해결
문제strategic merge patch와 JSON 6902 patch를 같은 필드에 동시 적용하면 6902가 우선 적용되어 의도치 않은 결과 발생
해결필드별로 패치 방식을 하나로 고정하고 주석으로 담당 방식을 명시
문제JSON 6902 patch가 array index에 의존해 base의 rules 순서가 바뀌면 다른 host를 잘못 패치
해결6902 사용 시 base를 동결하거나 host별로 별도 ingress로 분리
문제무료 RPC 노드 호출이 사용자 요청마다 발생하면 rate limit(429)으로 timeout 폭주
해결메타데이터/holder 정보를 캐시하고 배치 동기화로 직접 RPC 호출 최소화
레포지토리 정보
- 생성
- 2026년 5월 14일
- 최근 커밋
- 2026년 5월 14일
- 크기
- 5 KB
- 라이선스
- 없음
이 문서는 2026년 7월 26일 에 자동 분석으로 생성되었습니다.