Files
caliverse_doc/05. Tool/ControlCenterTool 메뉴얼.md
2025-05-01 07:27:54 +09:00

5.3 KiB

실행 방법

커맨드라인에서 실행

.\ServerControlTool.exe [env]
env : stage / live / 생략시 local

DevTray

사전작업
server-all.sln 빌드

실행 위치
Server/Tools/ControlCenter/ServerControlTool/bin/Debug/net8.0-windows7.0/ServerControlTool.exe [env]

메뉴
서버 관제 시스템 > Control Tool 실행 - {env} 

Tool 정보

메뉴 구성

메인 메뉴

  • File > Exit : Tool 종료
  • View
    • AgentList : Control Center Server에 연결된 Agent List 목록
    • ServerList : Agent 들이 관리하고 있는 Server List 목록
  • Command
    • Process
      • Add : Server 추가 생성 ( 사용할 Agent 가 없으면, 신규 AWS Instance 생성 )
      • Del : 미사용
    • AWS
      • AllLB > AllowUser : Login 및 UgqApiServer 의 외부 접속 허용 처리 ( LoadBalancer 수정 )
      • AllLB > BlockUser : Login 및 UgqApiServer 의 외부 접속 불가 및 사내 접속 허용 처리 ( LoadBalancer 수정 )
      • 기타 : 각 역할에 맞는 LoadBalancer 수정
  • Logs
    • Start : Control Center Tool 에서 생성하는 Log 기록 표시
    • Stop : Control Center Tool 에서 생성하는 Log 기록 멈춤
  • Configure
    • ScaleSetting : 서버 기본 Scale In/Out 설정
    • PatchSetting : 신규 Instance 생성에 필요한 AMI 이미지 설정

팝업 메뉴

  • Process
    • Start : 선택된 서버 시작 명령
    • Stop : 선택된 서버 종료 명령 ( 단, 접속된 모든 유저들이 Disconnect 될때까지 대기 )
    • Restart : 선택된 서버 재시작 명령 ( 단, 접속된 모든 유저들이 Disconnect 될때까지 대기 )
    • ForceStop : 선택된 서버 강제 종료 명령 ( 접속된 모든 유저 Kick 처리 후 종료 )
    • ForceRestart : 선택된 서버 강제 재시작 명령 ( 접속된 모든 유저 Kick 처리 후 재시작 )
  • Patch : 선택된 서버를 해당 버전으로 Patch ( SFTP 데이터 활용 )
  • Setting
    • AutoReStart : Agent 가 관할하는 서버 상태를 체크하여, 재시작 처리하는 옵션 수정
  • Config
    • Open : Agent 가 관할하는 서버의 Config 파일 오픈
    • Save : 화면에 수정된 Config 내용 저장
  • Contents
    • Block Server : 서버에 더이상 유저 유입이 없도록 Block 처리
    • Kick Server : 서버에 접속한 모든 유저들을 Kick 처리
  • Log : 미사용

화면 구성

  • 상단 : 기본 정보
    • Login / Ugq LoadBalancer 적용 정보 : Port - 적용 Port / Source - 적용 IP / desc - 설명
    • Server Info
      • All Agent Count : Control Center 에 연결된 Agent 수
      • All Server Count : Agent 들이 관리하는 Server 수
      • All Connection User Count : 현재 접속된 모든 유저 수
  • 좌측
    • Server Type 별 서버 간략 정보
  • 우측 ( Main )
    • Server Type 별 서버 상세 정보 ( ServerList )
    • Agent 상세 정보 ( AgentList )
    • Configure 정보 등 상세 정보 표시

배포&패치 방법

빌드 및 AMI 이미지 생성 (배포)

Stable Branch

Product Branch

패치 하기 (환경 공통)

Server

  1. Server 빌드 및 AMI 이미지 생성

  2. Control Center Tool 활용

    1. 패치 대상에 대한 Server 상태 변경 ( Running -> Stop )
    2. 패치 대상 선택 후 팝업 메뉴(Patch) 선택 (우클릭 메뉴)
    1. 24-09-12
      1. 패치 대상이 전체일 경우 - 기준 죄측 상단에 0으로 표시된 내용 우클릭해서 패치
    1. 버전 리스트에서 패치할 버전 선택

    2. Version 변경 확인 ( 패치할 버전으로 버전명이 변경되었는지 체크 )

    3. 상단 메뉴에서 Configure -> PatchSetting 선택

    4. 신규 인스턴스를 위한 패치버전 선택 후 저장(리비전)

Control Center Agent

  1. Server 빌드 및 AMI 이미지 생성 ( Binary )
  2. Control Center Tool 활용
    1. AgentList 화면 전환
    2. 패치 대상 Agent 선택 후 팝업 메뉴(Patch) 선택 (우클릭 메뉴)
    3. 버전 리스트에서 패치할 버전 선택
    4. Id 가 변경되었는지 확인 ( 패치 버전 명 추후 업데이트 예정 )
    5. 상단 메뉴에서 PatchSetting 선택
    6. 신규 인스턴스를 위한 패치버전 선택 후 저장