Azure 리소스 그룹 관리 가이드
giip 프로젝트(CSN) 단위로 Azure 리소스 그룹(RG)을 등록·관리하는 방법을 안내합니다. 하나의 프로젝트에 여러 개의 RG를 매핑할 수 있으며(1 CSN : N RG), 이 매핑은 Azure 비용 페이지의 리소스 그룹 관점 필터로 활용됩니다.
📋 개요
Azure 리소스 그룹 관리는 현재 선택된 프로젝트(CSN)에 속하는 Azure 리소스 그룹을 목록으로 관리합니다. 등록한 매핑은 데이터베이스(tCsnAzureRg)에 저장되며, 권한은 서버에서 프로젝트 소속 여부로 검증됩니다.
🔍 구성 요소
등록/수정 폼
- 리소스 그룹(필수): Azure RG 이름 (예:
rg-example-prod). - 구독 ID / 구독 이름(선택): RG가 속한 Azure 구독 정보.
- 비용 소스 서버(LSSN)(선택): 이 RG의 비용이 담긴
azure_cost데이터를 수집하는 서버 번호. Azure 비용 연동 확장에 사용됩니다. - 메모(선택): 자유 메모.
[추가]로 새 매핑을 등록하고, 목록의 [수정]으로 값을 바꾼 뒤 [수정]/[취소]로 확정합니다.
목록
현재 프로젝트에 등록된 RG 매핑을 표로 보여줍니다. 각 행에서 [수정]·[삭제]가 가능합니다.
🔗 Azure 비용 연동
매핑을 1건 이상 등록하면, Azure 비용 페이지의 리소스 그룹 탭에 "CSN 매핑 RG만 보기" 토글이 나타납니다. 켜면 현재 조회 중인 서버의 리소스 그룹 목록을 매핑된 RG로만 필터링하고 매핑 소계를 함께 보여줍니다. 매핑이 없으면 기존처럼 전체 RG가 표시됩니다.
💡 유의 사항
- 같은 프로젝트 안에서 같은 RG 이름은 한 번만 등록할 수 있습니다(중복 시 기존 항목이 갱신됩니다).
- 프로젝트(CSN)가 선택되지 않으면 목록을 불러올 수 없습니다. 상단에서 프로젝트를 먼저 선택하세요.
문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
| "권한이 없습니다" 표시 | 현재 사용자가 해당 프로젝트 소속이 아님 | 소속 프로젝트를 선택하거나 관리자에게 권한을 요청합니다. |
| 목록이 비어 있음 | 아직 등록된 매핑이 없음 | 상단 폼에서 RG를 추가합니다. |
| Azure 비용에 필터 토글이 안 보임 | 해당 프로젝트에 매핑이 없음 | 이 페이지에서 RG를 먼저 등록합니다. |
관련 문서:
버전: 1.0
최종 업데이트: 2026-07-23
소스 파일: giipv3/public/help/azure-rg.ko.md