프로젝트 목록 가이드
GIIP 플랫폼 내의 개별 프로젝트를 생성하고 관리하며, 각 프로젝트에 인프라 자산을 할당하는 방법을 안내합니다.
📋 개요
프로젝트는 GIIP의 가장 기본적인 관리 단위입니다. 서버, 데이터베이스, 네트워크 등 모든 인프라 자산은 특정 프로젝트에 소속되어야 하며, 이를 통해 명확한 권한 격리와 자원 추적이 가능합니다.
🔍 주요 기능
1. 프로젝트 생성 및 기본 설정
- 새 프로젝트 추가: 프로젝트명, 담당자, 설명 및 예상 예산 등을 입력하여 생성합니다.
- 상태 관리: 활성(Active), 일시중지(Suspended), 종료(Closed) 상태를 통해 프로젝트 생애주기를 관리합니다.
2. 자산(Assets) 바인딩
- 서버 연결: 미할당된 서버 목록에서 해당 프로젝트에서 사용할 서버를 선택하여 바인딩합니다.
- 데이터베이스 연결: 프로젝트에 필요한 DB 인스턴스를 할당합니다.
- 시각화: 프로젝트 상세 페이지에서 해당 프로젝트만의 3D 토폴로지를 즉시 확인할 수 있습니다.
3. 프로젝트별 대시보드
각 프로젝트는 고유의 대시보드를 가집니다. 프로젝트 내부의 서버 부하 상태, 이슈 발생 현황, 일일 비용 트렌드 등을 종합적으로 모니터링할 수 있습니다.
4. 선택된 프로젝트 빠른 액션 (상단 헤더)
페이지 상단 Selected Project: 의 프로젝트명 바로 옆에, 현재 선택된 프로젝트에 곧바로 적용되는 작은 아이콘 버튼 5종이 표시됩니다. 목록에서 해당 프로젝트 행을 찾지 않아도 바로 실행할 수 있습니다.
| 순서 | 색상 | 기능 | 동작 |
|---|---|---|---|
| 1 | 파랑 | 유저 관리 | 선택된 프로젝트의 사용자 목록(userlist) 화면으로 이동합니다. |
| 2 | 남색 | 프로젝트 그룹 | 선택된 프로젝트의 프로젝트 그룹 목록(prjgrouplist?csn=) 화면으로 이동합니다. 목록 행의 [Groups] 버튼과 같은 화면입니다. |
| 3 | 노랑 | 수정 | 프로젝트 코드와 이름을 고치는 [프로젝트 수정] 창을 엽니다. |
| 4 | 보라 | 언어 선택 | 프로젝트 기본 언어를 바꾸는 [프로젝트 언어 변경] 창을 엽니다. |
| 5 | 빨강 | 삭제 | 확인 창을 거친 뒤 프로젝트를 삭제합니다. |
- 프로젝트를 선택하지 않은 상태에서는 5개 버튼이 모두 비활성(회색)으로 표시됩니다.
- 선택한 프로젝트가 현재 목록에 없으면 [수정]과 [삭제]는 필요한 정보를 얻을 수 없어 비활성이 되고, [유저 관리]·[프로젝트 그룹]·[언어 선택]은 정상 동작합니다.
- [삭제]는 해당 프로젝트의 소유자(Owner) 또는 시스템 관리자에게만 보입니다. 목록 행의 [삭제] 버튼과 같은 조건입니다.
- 기존 목록의 행별 버튼(Enter / Users / Groups / Edit / Language / Delete)은 그대로 유지됩니다.
- 상단 아이콘 버튼은 목록 행 버튼과 같은 화면으로 이동합니다. 이동 대상·아이콘·색상 모두 행 버튼이 정본입니다.
🛠️ 관리 방법
- GIIP [인프라 관리] > [프로젝트 목록] 메뉴로 이동합니다.
- [생성] 버튼을 눌러 프로젝트 기본 정보를 입력합니다.
- 목록에서 프로젝트를 클릭하여 상세 페이지로 이동한 뒤, [Assets] 탭에서 서버 및 DB를 할당합니다.
💡 활용 팁
- 태그 활용: 프로젝트 생성 시 관련 태그(예: #Production, #Java, #AWS)를 입력하면 나중에 수많은 프로젝트 중 원하는 대상을 찾기 유용합니다.
- 권한 제어: 프로젝트 단위로 유저의 접근 권한이 제어되므로, 민감한 자산은 별도의 프로젝트로 분리하여 관리하세요.
API 참조
이 기능의 API 상세 사양은 별도 가이드를 참조하세요.
🔧 문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
| [Assets] 탭에서 바인딩할 서버가 목록에 보이지 않음 | 해당 서버가 이미 다른 프로젝트에 할당되어 있음 | 목록에는 미할당 서버만 표시되므로, 기존 프로젝트에서 서버를 해제한 뒤 다시 시도합니다. |
| 프로젝트 상세 페이지의 3D 토폴로지가 비어 있음 | 아직 서버·DB 자산이 바인딩되지 않음 | [Assets] 탭에서 서버 및 DB를 할당하면 토폴로지가 표시됩니다. |
| 목록에서 특정 프로젝트가 보이지 않거나 편집되지 않음 | 프로젝트 상태가 종료(Closed)로 전환됨 | 상태를 활성(Active)으로 변경한 뒤 다시 관리합니다. |
| 프로젝트가 많아 원하는 대상을 찾기 어려움 | 생성 시 태그를 입력하지 않음 | 태그(예: #Production, #Java)를 등록하여 검색·필터에 활용합니다. |
| 상단 헤더의 [수정]/[삭제] 아이콘이 회색이고 클릭되지 않음 | 프로젝트가 선택되지 않았거나, 선택한 프로젝트가 현재 목록에 없음 | [List]로 목록을 다시 불러오거나, 목록에서 프로젝트를 선택하세요. |
| 상단 헤더에 [삭제] 아이콘이 전혀 보이지 않음 | 프로젝트의 소유자도 시스템 관리자도 아닌 경우 | 프로젝트 소유자에게 삭제를 요청하세요. |
버전: 1.2
최종 업데이트: 2026-09-15
소스 파일: giipv3/public/help/projectlist.ko.md