msa-django-nhn/README.md

msa-django-nhn

NHN Cloud 리소스 관리를 위한 통합 API 서비스입니다.

기술 스택

분류	기술
Framework	Django 4.2.14
API	Django REST Framework 3.16.0
Auth	SimpleJWT 5.5.0 (RS256)
Database	MySQL (mysqlclient 2.2.7)
Docs	drf-yasg 1.21.10
Server	Gunicorn 20.1.0

지원 서비스

• Compute: 인스턴스, Flavor, Keypair, 이미지
• VPC: VPC, 서브넷, Floating IP, 보안 그룹
• NKS: Kubernetes 클러스터, 노드 그룹
• Storage: Object Storage 컨테이너
• DNS Plus: Zone, 레코드셋, GSLB, Pool, 헬스체크
• Load Balancer: LB, 리스너, 풀, 멤버, L7 정책

API 엔드포인트

Token

Method	Endpoint	설명
POST	/api/nhn/token/	토큰 생성

Compute

Method	Endpoint	설명
GET	/api/nhn/compute/instances/	인스턴스 목록
POST	/api/nhn/compute/instances/create/	인스턴스 생성
GET	/api/nhn/compute/instances/<id>/	인스턴스 상세
POST	/api/nhn/compute/instances/<id>/action/	인스턴스 액션
GET	/api/nhn/compute/flavors/	Flavor 목록
GET	/api/nhn/compute/keypairs/	Keypair 목록
GET	/api/nhn/compute/images/	이미지 목록

VPC/Network

Method	Endpoint	설명
GET/POST	/api/nhn/vpc/	VPC 목록/생성
GET	/api/nhn/vpc/<id>/	VPC 상세
GET/POST	/api/nhn/subnet/	서브넷 목록/생성
GET	/api/nhn/floatingip/	Floating IP 목록
GET	/api/nhn/securitygroup/	보안 그룹 목록

NKS (Kubernetes)

Method	Endpoint	설명
GET	/api/nhn/nks/clusters/	클러스터 목록
POST	/api/nhn/nks/clusters/create/	클러스터 생성
GET	/api/nhn/nks/clusters/<name>/	클러스터 상세
GET	/api/nhn/nks/clusters/<name>/config/	kubeconfig
GET	/api/nhn/nks/clusters/<name>/nodegroups/	노드 그룹 목록
POST	/api/nhn/nks/clusters/<name>/nodegroups/create/	노드 그룹 생성

DNS Plus

Method	Endpoint	설명
GET/POST	/api/nhn/dns/zones/	Zone 목록/생성
GET/POST	/api/nhn/dns/zones/<id>/recordsets/	레코드셋
GET/POST	/api/nhn/dns/gslbs/	GSLB 목록/생성
GET/POST	/api/nhn/dns/pools/	Pool 목록/생성
GET/POST	/api/nhn/dns/health-checks/	헬스체크

Load Balancer

Method	Endpoint	설명
GET/POST	/api/nhn/lb/loadbalancers/	LB 목록/생성
GET/POST	/api/nhn/lb/listeners/	리스너
GET/POST	/api/nhn/lb/pools/	풀
GET/POST	/api/nhn/lb/pools/<id>/members/	멤버
GET/POST	/api/nhn/lb/healthmonitors/	헬스 모니터
GET/POST	/api/nhn/lb/l7policies/	L7 정책

Async Task

Method	Endpoint	설명
GET	/api/nhn/tasks/	비동기 작업 목록
GET	/api/nhn/tasks/<id>/	작업 상세

API 문서

• Swagger UI: /swagger/

프로젝트 구조

nhn/
├── views.py           # API 뷰 (40개 이상)
├── models.py          # AsyncTask 모델
├── urls.py            # URL 라우팅
├── serializers.py     # DRF 직렬화
├── authentication.py  # JWT 인증
└── packages/          # NHN Cloud API 클라이언트
    ├── base.py        # 기본 클래스, 엔드포인트
    ├── token.py       # Token API
    ├── compute.py     # Compute API
    ├── vpc.py         # VPC API
    ├── nks.py         # NKS API
    ├── storage.py     # Storage API
    ├── dnsplus.py     # DNS Plus API
    └── loadbalancer.py # LB API

환경 변수

# Django
DEBUG=1
SECRET_KEY=your-secret-key
ISTIO_JWT=1

# Database
SQL_ENGINE=django.db.backends.mysql
SQL_HOST=localhost
SQL_USER=user
SQL_PASSWORD=password
SQL_DATABASE=msa-nhn
SQL_PORT=3306

요청 헤더

NHN Cloud API 호출 시 다음 헤더가 필요합니다:

헤더	설명
X-NHN-Token	NHN Cloud API 토큰
X-NHN-Region	리전 (kr1, kr2, jp1)
X-NHN-Tenant-ID	테넌트 ID
X-NHN-Appkey	DNS Plus Appkey (DNS API용)

실행 방법

개발 서버

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python3 manage.py migrate
python3 manage.py runserver 0.0.0.0:8900

Docker

docker build -t msa-django-nhn .
docker run -p 8000:8000 --env-file .env.dev msa-django-nhn