1. 개요

본 문서에서는 아이펀 디플로이와의 연동 작업에 필요한 기본 지식에 대해 설명합니다.

1.1. 연동 준비 작업

아이펀 디플로이와의 연동을 위해서는 다음 준비 작업들이 필요합니다.

  • API 서버 구축
  • 인터넷을 통해 rest API를 호출할 수 있는 서버 준비
  • 연동에 필요한 rest API 구현
  • 로그 디비 서버 구축
  • MongoDB 에 지정된 형식대로 게임 로그 기록
  • 게임 로그를 기록한 MongoDB 에 인터넷을 통해 접근 가능토록 설정

1.2. API server

게임 운영을 위해서는 사용자 추방 및 제재 등, 게임 자체에 대한 구현 외의 추가 기능들이 필요합니다. 또한 사용자의 자산 정보 등 게임 내 데이터에 대한 접근 및 수정 등도 필요합니다.

이러한 기능들을 구현하는 방법, 혹은 게임 내 데이터의 형태 등은 게임에 따라 매우 다릅니다. 또한 이러한 기능들이나 데이터를 직접 외부에 노출하는 것은 보안 등 다른 문제를 일으킬 수 있습니다. 따라서 아이펀 디플로이에서는 이러한 기능 수행, 혹은 데이터 접근이 필요할 때, 게임 서비스측에 해당 작업 수행을 `요청` 합니다.

아이펀 디플로이에서 게임 서비스측에 요청을 전달하기 위해 사용하는 방법은 rest API 호출입니다. 따라서 아이펀 디플로이와의 연동을 위해서는, 게임 서비스에서 저희가 지정하는 방식에 따라 rest API를 호출하고, 인터넷을 통해 아이펀 디플로이먼트가 필요한 API들을 호출할 수 있도록 환경 설정이 필요합니다. 이후 이러한 rest API를 열어 둔 서버를 API 서버라 칭하겠습니다.

즉 아이펀 디플로이와 게임 서비스를 연동 시 개략적인 절차는

  1. 운영자가 아이펀 디플로이에서 특정 기능 수행
  2. 아이펀 디플로이에서 기능 수행 중 필요에 따라 API 서버 상의 rest API 호출
  3. 아이펀 디플로이에서 내부 처리 및 API 서버의 응답 등을 조합하여 기능 수행 후 운영자에 결과 통보

예를 들어, 아이펀 디플로이상에서 특정 사용자의 정보를 조회할 때의 절차는 다음과 같습니다.

_images/outline_query_user_info.png

예를 하나 더 들어보겠습니다. 아이펀 디플로이상에서 캠페인을 등록하고, 해당 캠페인이 시작되기까지의 절차는 다음과 같습니다.

_images/outline_begin_capmaigin.png

아이펀 디플로이는 게임 서비스와는 별개로 서비스됩니다. 따라서 인터넷을 통해 API 서버에 구현된 rest API 에 접근할 수 있어야 합니다. 또한 rest API 의 url 이 변경되지 않도록 환경을 구성해 주셔야 합니다. 게임 서비스를 클라우드상에 구축하실 경우에는 보안 설정 수정등이 필요하며, 개발 환경과의 연동 등의 이유로 게임 서비스가 사무실 내에 구축되어 있다면 네트워크 설정 변경 및 DDNS 서비스 이용 등을 권장드립니다.

1.3. 게임 로그 연동

아이펀 디플로이에서는 통계 집계 및 기록 조회 등을 제공합니다. 이 기능들을 사용하기 위해서는 MongoDB에 지정된 형식으로 로그를 남겨 주셔야 하며, 아이펀 디플로이에서 `해당 MongoDB 인터넷을 통해 직접 접근할 있도록` 설정해 주셔야 합니다.

이후에는 게임 서버와 아이펀 디플로이를 실제로 연동해 보겠습니다.