3.4. Provisioning

스마트시티 데이터허브 데이터 코어 모듈은 내부 어플리케이션 간 연계를 위해 설치 후 필수적으로 입력해야 하는 데이터가 있습니다. 본 장에서는 해당 내용을 설명 합니다. 만약 고가용성을 위해서 어플리케이션이 여러 개 기동되어 있다면 해당 어플리케이션 정보를 모두 등록해야 합니다.

3.4.1. Provisioning Server

데이터 코어의 data manager는 데이터 모델, 데이터 셋, 데이터 셋 플로우 정보를 생성/수정/삭제 하는 기능을 제공합니다. 해당 정보를 생성/수정/삭제 할 경우 data manager는 ingest interface 와 data service broker로 데이터 동기화를 위해 provisioning 요청을 하게 합니다. 이는 HTTP REST API를 통해 전송되며 data manager는 ingest interface와 data service broker의 HTTP API 호출 주소를 관리해야 합니다. 이는 최초 데이터 코어 설치 시 필수적으로 입력해야하는 정보입니다.

3.4.1.1. API를 통한 provisioning Server 정보 입력

• API 규격서의 POST /provision/servers API를 통해 provisioning server를 생성합니다.

  • 만약 서버가 이중화가 되어 있을 경우 해당되는 모든 서버 정보를 입력해야 합니다.

    필드명	필수여부	내용
    id	O	대상 서버 아이디 (사용자 정의 입력 값)
    provisionProtocol	O	http 입력
    type	O	dataServiceBroker 또는 ingestInterface 입력
    enabled	O	true/false
    provisionUri	O	대상 서버 호출 주소 입력 (Default port : ingestInterface=8081, dataServiceBroker=8082)

• 정상적으로 등록할 경우 하기와 같이 조회할 수 있습니다.

  [
    {
      "id": "ingestInterface01",
      "type": "ingestInterface",
      "description": "description1234",
      "provisionUri": "http://localhost:8081",
      "provisionProtocol": "http",
      "enabled": true,
      "createDatetime": "2021-06-26T07:51:17.366Z",
      "modifyDatetime": "2021-06-26T07:51:17.366Z"
    },
    {
      "id": "dataServiceBroker01",
      "type": "dataServiceBroker",
      "description": "description1234",
      "provisionUri": "http://localhost:8082",
      "provisionProtocol": "http",
      "enabled": true,
      "createDatetime": "2021-06-26T07:51:06.345Z",
      "modifyDatetime": "2021-12-17T18:05:04.596Z"
    }
  ]

3.4.1.2 관리자 UI를 통한 provisioning server 정보 입력

• 관리자 UI 로그인 및 Provision Server 등록 화면으로 이동합니다.

  

• provisioning server 정보 생성

  • 만약 서버가 이중화가 되어 있을 경우 해당되는 모든 서버 정보를 입력해야 합니다.

  

• 필수 값 입력 후 저장 버튼을 클릭합니다.

  필드명	필수여부	내용
  서버 아이디	O	대상 서버 아이디 (사용자 정의 입력 값)
  프로토콜 유형	O	HTTP 선택
  서버유형	O	dataServiceBroker 또는 ingestInterface 선택
  사용여부	O	enabled 선택
  Provision URI	O	대상 서버 호출 주소 입력 (Default port : ingestInterface=8081, dataServiceBroker=8082)