사용자정의 Api 배치를 위한 Oracle Mobile Hub 툴 설치 및 구성

Oracle Mobile Hub 에서 사용자정의 api를 배치하는 추가 툴을 다운로드 및 구성할 수 있습니다.

Node.js 툴링 설치

OTN(Oracle Technology Network) 에서 SDK를 다운로드할 때, Oracle Mobile Hub 에 애플리케이션을 배치하는 데 사용할 수 있는 Node.js 스크립트가 포함된 omce-tools-vXX.X.X 파일을 다운로드할 수 있는 옵션이 제공됩니다.

프로젝트에 Node.js 툴을 설치하려면 다음과 같이 하십시오.

omce-tools-vXX.X.X zip 파일을 다운로드하고 Zip 파일을 디렉토리로 압축 해제합니다.
시스템에서 터미널 창을 열고 (관리 사용자로 이 명령을 실행해야 할 수 있음) omce-tools/node-configurations 디렉토리로 변경하십시오.
테스트하려는 사용자정의 API에 사용해야 하는 노드 구성을 결정합니다. 노드 버전 6.10.0 또는 호환 버전에 6.10을 사용하고 노드 버전 8.9.4 또는 호환 버전에 8.9를 사용합니다. Oracle Mobile Hub 에 대한 기본 노드 구성은 8.9. 입니다.
사용할 노드 구성에 대한 디렉토리로 변경: `6.10` 또는 `8.9`
다음 명령을 실행합니다.
```
npm install
```
omce-tools 디렉토리로 변경합니다.
명령을 실행합니다.
```
npm install -g
```
이 명령은 로컬 환경에서 툴을 전역적으로 사용할 수 있도록 합니다. 이 명령을 실행하기 전에 Node.js 및 npm 패키지 관리자가 설치되어 있어야 합니다.
NODE_PATH 환경 변수를 사용할 노드 구성의 node_modules 디렉토리 또는 path/omce-tools/node-configurations/8.9/node_modules 로 설정합니다.
설치 성공 여부를 테스트하려면 다음 명령을 실행합니다.
```
omce-test --version
```

사용자정의 API에 대한 JavaScript 스캐폴드 다운로드

사용자정의 API를 생성한 후 API의 RAML 문서를 기반으로 하는 스캐폴드를 다운로드한 다음 스캐폴드를 사용자정의 API 구현을 위한 빠른 시작으로 사용할 수 있습니다.

스캐폴은 노드 모듈, 각 끝점에 대한 스텁 메소드를 포함하는 기본 JavaScript 파일인 주요 구성 요소 (리소스 및 HTTP 메소드) 및 모듈에 대한 Manifest로 사용되는 package.json 파일로 구성됩니다.

스캐폴드를 다운로드하려면 다음과 같이 하십시오.

을 눌러 측면 메뉴를 열고 개발 을 누른 다음 api 를 누릅니다.
다운로드할 API를 엽니다.
API Designer의 왼쪽 탐색 영역에서 구현 을 누릅니다.
Zip 파일을 다운로드하려면 JavaScript Scaffold 를 누릅니다.
시스템에서 다운로드한 파일의 압축을 해제합니다.

나중에 API를 변경할 경우 업데이트된 끝점을 기반으로 새 스캐폴드를 다운로드할 수 있습니다. 하지만 이전에 완료 및 업로드한 코딩은 새 스캐폴드에 반영되지 않습니다.

파일에서 toolsConfig.js 구성

API의 RAML 문서를 기반으로 하는 스캐폴드 파일을 다운로드한 후 toolsConfig.json 라는 JSON (JavaScript Notation) 파일을 수동으로 구성할 수 있습니다.

Oracle Mobile Hub 는 사용자정의 API에 대한 배치 정보가 포함된 toolsConfig.json 파일을 사용합니다. 사용자정의 API를 생성할 때 기본 toolsConfig.json가 생성되어 scaffold를 다운로드합니다. toolsConfig.json 파일을 구성하려면 다음을 수행합니다.

Oracle Mobile Hub 에서 모바일 백엔드 설정 페이지 열기
[설정 ] 페이지의 정보에 유의하십시오.
[설정 ] 페이지에는 인증 유형 (HTTP 기본, OAuth 소비자), 환경 url 등의 정보가 포함됩니다.

텍스트 편집기를 사용하여 Oracle Mobile Hub 의 설정 페이지에서 toolsConfig.json 파일을 값으로 업데이트합니다.

    "backend":{
        "backendId":"<YOUR_BACKEND_ID>",
        "backendName":"<YOUR_BACKEND_NAME>",
        "backendVersion":"<YOUR_BACKEND_VERSION>",
        "authorization":{
            "anonymousKey":"<BACKEND_ANONYMOUS_KEY>",
            "clientId":"<BACKEND_CLIENT_ID>",
            "clientSecret":"<BACKEND_CLIENT_SECRET>"
        }
    },

개발 페이지를 엽니다.
인스턴스 세부정보 를 누릅니다.
팀 구성원 앱 클라이언트 Id 및 팀 구성원 앱 클라이언트 암호 값에 유의하십시오.

다음 값으로 toolsConfig.json 파일을 업데이트합니다.

    "tools":{
        ...,
        "authorization":{
            "clientId":"<TEAM_MEMBER_APP_CLIENT_ID>",
            "clientSecret":"<TEAM_MEMBER_APP_CLIENT_SECRET>"
        }
    },

(선택 사항) toolsConfig.json 가 정확한지 테스트하려면 배치 테스트를 수행할 수 있습니다. 터미널 창을 열고 omce-tools 디렉토리로 이동한 다음 명령을 사용하여 사용자정의 API를 배치합니다.
```
node omce-deploy toolsConfig.json
```
이 명령을 실행하면 Oracle Mobile Hub 자격 증명을 묻는 메시지가 표시됩니다. toolsConfig.json 파일이 올바르면 Deployment completed successfully 라는 메시지가 표시됩니다. 이 명령을 사용하여 이후에 사용자정의 API를 배치할 수 있습니다.