3. 디플로이먼트 관리

3.1. 디플로이먼트란?

아이펀 디플로이에서 사용하는 서비스의 배포 단위 입니다.

Note

이는 추후에 추가될 인프라 기능을 고려한 이름으로, IaaS 클라우드에서 일반적으로 사용하는 인프라 관리 기본 단위와 비슷한 의미가 있습니다.

3.2. 디플로이먼트 생성

  1. 메인 페이지 내 디플로이먼트 리스트 왼쪽 위의 + 디플로이먼트 버튼 클릭
_images/deployment-list.png
  1. 디플로이먼트 타입 선택
_images/deployment-choose.png

Note

현재 인프라 기능이 추가되지 않은 관계로 운영 툴 만 선택 가능합니다.

  1. 디플로이먼트 생성 창의 각 내용을 입력하고 생성 버튼 클릭

3.2.1. 운영 툴 디플로이먼트 타입

_images/deployment-create.png
디플로이먼트 명칭

이름을 입력하세요.

Caution

한 번 지정한 디플로이먼트 이름은 변경 불가능 합니다. 신중하게 결정해 주세요.

API 엔드포인트 URL

디플로이먼트와 연결될 게임 API 서버의 주소를 입력하세요.

Note

API 엔드 포인트 유저 ID/비밀번호 항목은 API 서버 보안 접속 을 위한 것입니다. API 서버 보안 접속이 필요 없는 경우 API 엔드포인트 URL 항목의 URL 프로토콜을 http 로 지정하시면 해당 항목이 숨김 처리되지만 권장하지 않습니다. http 프로토콜은 개발이나 테스트 단계에서만 사용해주세요.

게임 로그 DB 사용 여부

해제하면, 게임 로그 MongoDB 항목 들이 모두 숨김 처리 됩니다.

그 후 비활성화되는 기능 목록을 확인하실 수 있습니다.

_images/is-log-db-used.png

Note

언제든 해당 항목을 체크하고, 게임 로그 MongoDB 항목 들을 입력하면 기능들을 활성화할 수 있습니다.

MongoDB TLS 연결 사용 여부

게임 로그 DB 연결 시 보안 접속 여부를 선택할 수 있습니다.

Important

게임 로그 DB 사용 여부 를 체크 해야만 활성화됩니다.

Note

게임 로그 MongoDB 유저 ID/비밀번호 항목은 로그 DB 보안 접속 을 위한 것입니다. 로그 DB 보안 접속이 필요 없는 경우 MongoDB TLS 연결 사용 여부 항목을 해제하시면 해당 항목이 숨김 처리되지만 권장하지 않습니다 . 체크 해제는 개발이나 테스트 단계에서만 해주세요.

생성이 완료되면 디플로이먼트 리스트에서 새로 생성된 디플로이먼트를 확인하실 수 있습니다.

Note

URL이나 계정, 데이터베이스명 등이 잘못 입력되어도 디플로이먼트 생성은 가능합니다. 대신 관련 기능을 실행할 때 잘못된 정보로 접속을 시도하면서 에러가 발생하므로 접속 전 올바른 정보를 입력하여 주세요.

3.2.2. 인프라 & 운영 툴 디플로이먼트 타입

Attention

현재 인프라 기능은 지원하지 않습니다.

3.3. 디플로이먼트 삭제

디플로이먼트를 영구적으로 제거 합니다. 삭제 시 모든 설정과 로그, 멤버 목록 등의 해당 디플로이먼트 관련 데이터가 완전히 삭제됩니다.

Warning

디플로이먼트 삭제는 되돌릴 수 없습니다. 신중하게 결정해주세요.

디플로이먼트는 아래의 두 가지 경로를 통해 삭제할 수 있습니다.

  1. 메인 페이지 에서 삭제
  1. 디플로이먼트 리스트 각 항목의 오른쪽 아래에 있는 휴지통 아이콘 클릭
_images/deployment-list-item-del.png
  1. 삭제 여부를 재확인하는 팝업창에서 삭제 버튼 클릭
_images/deployment-delete.png
  1. 디플로이먼트 설정 페이지 에서 삭제
  1. 디플로이먼트 설정 페이지 열기
  2. 오른쪽 아래의 디플로이먼트 삭제 버튼 클릭
_images/deployment-setting.png
  1. 삭제 여부를 재확인하는 팝업창에서 삭제 버튼 클릭
_images/deployment-delete.png

3.4. 디플로이먼트 설정

디플로이먼트 설정 페이지는 아래의 두 가지 방법으로 접근할 수 있습니다.

  1. 메인 페이지에서 접근
_images/deployment-list-item-edit.png
  1. 상단 메뉴바에서 접근
_images/common-menu-bar.png

디플로이먼트 설정 페이지는 아래의 메뉴들로 구성되어 있습니다.

_images/deployment-setting.png
  1. 디플로이먼트 상세사항
  • 디플로이먼트 설정 변경
  1. 멤버
  • 신규 멤버 초대
  • 기존 멤버 권한 변경
  • 기존 멤버 비밀번호 변경
  • 기존 멤버 삭제
  1. 운영 로그
  • 운영툴 로그 조회
  • 푸쉬 알림 로그 조회
  1. API 연동 상태
  • 디플로이 연동 API 상태 조회
  1. 통계 연동 상태
  • 통계 연동 상태 조회

3.4.1. 디플로이먼트 상세사항

디플로이먼트 생성 시 지정했던 설정들을 변경할 수 있습니다.

운영 툴 디플로이먼트 상세사항

_images/deployment-menu-config.png

API 엔드포인트 URL 항목의 프로토콜을 https 로 바꾸면 API 엔드포인트 ID/비밀번호 항목이 나타납니다. 로그 DB도 마찬가지로 MongoDB TLS 연결 사용 여부 항목을 체크하면 게임 로그 MongoDB 유저 ID/비밀번호 항목이 나타납니다.

_images/deployment-menu-config-long.png
디플로이먼트 삭제
디플로이먼트 삭제 버튼을 누르면 해당 디플로이먼트가 완전히 삭제됩니다. 자세한 사항은 디플로이먼트 삭제 항목을 참고해주세요.

인프라 & 운영 툴 디플로이먼트 상세사항

Attention

현재 인프라 기능은 지원하지 않습니다.

3.4.2. 멤버

멤버 관리 항목을 참고해주세요.

3.4.3. 운영 로그

게임 운영 중에 문제가 발생하는 경우, 어떤 사용자가 무슨 작업을 했는지 조회 및 확인이 필요합니다. 아이펀 디플로이는 이를 위해 디플로이먼트에 적용한 작업에 대한 운영 로그를 제공합니다. 운영 로그는 인프라 작업 및 유저 데이터 작업에 대하여 작업자와 작업 시간, 작업 내용을 기록하며 푸쉬 알림에 대한 로그도 이곳에서 확인하실 수 있습니다. 그리고 로그는 기간과 멤버 ID(이메일)로 검색 가능합니다.

_images/deployment-menu-log.png

3.4.4. API 연동 상태

API 구현 가이드 (개발자용) 에서는 아이펀 디플로이와의 연동을 위해 게임 서버가 구현해야 하는 API에 관해서 설명합니다. 이 페이지에서는 API 들이 잘 연동되었는지 확인하실 수 있습니다. API 상세 목록은 디플로이 연동 API 를, 그리고 연동 확인에 대한 보다 자세한 설명은 API 연동 상황 확인하기 를 참고해주세요.

_images/deployment-menu-api.png

3.4.5. 통계 연동 상태

API 연동과 마찬가지로, 통계 연동도 확인하실 수 있습니다. 연동해야 하는 로그 목록은 통계 분석 기능을 위한 필수 로그 를 참고해주시고, 연동 확인에 대한 자세한 설명은 로그 연동 상태 확인 을 참고해주세요.

Important

게임 로그 DB 사용 여부 를 체크하고 게임 로그 DB 정보가 있어야 활성화됩니다.

_images/deployment-menu-statistics.png

3.5. 멤버 관리

게임 운영은 필연적으로 서로 다른 권한의 여러 사용자가 하나의 게임 서비스에서 공동 작업을 하게 됩니다. 아이펀 디플로이는 이를 위해 디플로이먼트에서 새 멤버를 추가하거나 삭제하고, 권한을 부여할 수 있는 기능을 제공합니다.

_images/deployment-menu-member.png

3.5.1. 멤버의 권한

모든 멤버는 디플로이먼트에 하나 이상의 권한을 가지고 있으며, 가진 권한에 따라 사용 가능한 기능이 달라집니다. 멤버가 가질 수 있는 권한은 아래의 5가지입니다.

사용 가능한 기능 수퍼유저 게임 서버 개발자 고객 지원 담당자 게임 운영 담당자 마케팅 담당자
디플로이먼트 관리 O O      
게임 유저 관리 기능 O O O O  
사용자 정의 기능 O O O O  
캠페인 관리 기능 O O   O  
푸시 메시지 보내기 O O   O  
게임 로그 O O      
구매 내역 및 환불 O O      
게임 통계 기능 O O     O

Important

해당 기능에 대한 권한이 없으면, 버튼이나 메뉴 등이 숨김 처리되어 보이지 않을 수 있습니다.

Note

권한이나 사용 가능한 기능은 차후에 변경될 수 있습니다.

3.5.2. 멤버 초대

디플로이먼트 멤버로 추가하고자 하는 사람에게 초대 메일을 발송할 수 있습니다.

  1. 유저 추가 버튼 클릭
  2. 팝업창의 각 내용 입력 후 확인 버튼 클릭
_images/deployment-member-invite.png

Important

같은 이메일이어도 로그인 방식이 다르면 서로 다른 계정으로 인식됩니다.

  • 인증 방법 : 현재 ID/비밀번호 인증과 Google OAuth 인증을 제공합니다. 자세한 것은 로그인 항목을 참고해주세요.
  • 이메일 : 해당 메일주소로 초대 메일이 발송되며, 해당 멤버가 로그인 시 ID로 사용하게 됩니다.
  • 권한 : 신규 멤버의 권한을 설정합니다. 권한은 멤버 추가 후에도 언제든지 수정할 수 있습니다. 자세한 것은 멤버의 권한 항목을 참고해주세요.

초대한 멤버가 초대 메일을 받고 아이펀 디플로이에 접속하면, 해당 디플로이먼트에 대하여 초대 시 지정된 권한을 가지게 됩니다. 해당 멤버가 로그인한 시점부터 디플로이먼트 관리 페이지 멤버 메뉴의 멤버 목록에서 확인 및 관리할 수 있게 됩니다. 만일 초대한 멤버의 계정이 존재하지 않을 경우 초대 메일을 발송한 시점에 신규 계정을 생성시킵니다. 반대로 초대한 멤버의 계정이 이미 존재할 경우 기존 계정에 디플로이먼트에 대한 권한만 추가시킵니다.

Caution

아이펀 디플로이는 현재 초대 메일 재발송 기능을 지원하지 않습니다. 만약 신규 사용자가 초대 메일을 분실해 로그인에 문제가 생겼을 경우 Deploy Support 로 연락주세요.

3.5.3. 멤버 권한 변경 및 삭제

멤버 권한 변경

_images/deployment-member-action.png

테이블 우측의 권한 관리 버튼을 누르면 해당 유저의 권한을 변경할 수 있습니다. 설정할 수 있는 권한에 대해서는 멤버의 권한 항목을 참고해주세요.

멤버 비밀번호 변경

_images/deployment-member-action.png

해당 멤버가 비밀번호를 분실해 로그인하지 못하는 경우, 이 메뉴에서 강제로 비밀번호를 변경할 수 있습니다. 비밀번호 변경 시 해당 멤버의 이메일로 변경된 비밀번호가 발송됩니다.

Note

멤버의 계정 인증방식이 ID/패스워드 인 경우에만 드롭다운 메뉴가 표시됩니다.

멤버 삭제

_images/deployment-member-action.png

현재 디플로이먼트에서 특정 멤버를 제외할 수 있습니다. 이는 디플로이먼트에 대한 권한만을 삭제 하는 것으로, 해당 멤버의 계정이 삭제되는 것은 아닙니다.

Note

해당 디플로이먼트를 생성한 계정은 삭제할 수 없습니다. 해당 디플로이먼트를 생성한 계정이 아닌 경우에만 드롭다운 메뉴가 표시됩니다.

사용자 정의 기능 권한 설정

Important

이 기능은 슈퍼유저 권한을 가진 멤버만 사용할 수 있습니다.

해당 사용자에게 특정 사용자 정의 기능 을 실행하거나 설정을 변경할 수 있는 권한을 부여하거나 회수할 수 있습니다.

_images/deployment-member-cs-priv-drop.png

사용자 정의 기능 권한 설정을 선택하시면 다음과 같은 화면을 보실 수 있습니다.

_images/deployment-member-cs-priv-setting.png

상단의 검색창을 이용해 권한을 수정할 사용자 정의 기능을 검색하실 수 있습니다.

사용자 정의 기능 ID 및 이름은 사용자 정의 기능 내의 ID 및 이름과 동일합니다.

사용자에게 특정 사용자 정의 기능 실행 권한을 부여하시려면 해당 사용자 정의 기능이 포함된 행의 ‘실행’ 열 내의 체크박스를, 설정 변경 권한을 부여하시려면 ‘설정’ 열 내의 체크박스를 체크해 주시면 됩니다.

설정을 변경하신 후 설정 버튼을 클릭하시면 변경 내용이 반영됩니다.

Important

디플로이먼트에 새로운 멤버를 추가하셨을 경우, 해당 멤버는 사용자 정의 기능을 실행하거나 변경할 수 없습니다. 사용자 정의 기능을 실행하거나 설정을 변경할 필요가 있다면 해당 멤버에게 권한을 부여해 주셔야 합니다.