Instalar y configurar la herramienta de herramientas de Oracle Mobile Hub para desplegar API personalizadas

Puede descargar y configurar herramientas adicionales para desplegar API personalizadas en Oracle Mobile Hub.

Instale la herramienta Node.js

Al descargar el SDK de Oracle Technology Network (OTN), puede descargar el archivo omce-tools-vXX.X.X, que incluye un script Node.js que puede utilizar para desplegar aplicaciones en Oracle Mobile Hub.

Para instalar la herramienta Node.js en el proyecto:

Descargue el archivo zip omce-tools-vXX.X.X y descomprima el archivo zip en un directorio
En su equipo, abra una ventana de terminal (es posible que sea necesario ejecutar este comando como usuario administrador) y, a continuación, cambie al directorio omce-tools/node-configurations.
Determine la configuración de nodo que necesita utilizar para la API personalizada que está probando. Utilice 6.10 para la versión de nodo 6.10.0 o compatible y 8.9 para la versión de nodo 8.9.4 o compatible. La configuración de nodo por defecto para Oracle Mobile Hub es 8.9.
Cambie al directorio para la configuración de nodo que desea utilizar: '6.10` o `8.9`
Ejecute el siguiente comando:
```
npm install
```
Cambie al directorio omce-tools.
Ejecute el comando:
```
npm install -g
```
Este comando pone las herramientas a disposición global en su entorno local. Debe tener instalado Node.js y el gestor de paquetes npm antes de ejecutar este comando
Defina la variable de entorno NODE_PATH en el directorio node_modules para la configuración de nodo que desea utilizar o en path/omce-tools/node-configurations/8.9/node_modules.
Para probar si la instalación se ha realizado correctamente, ejecute el comando:
```
omce-test --version
```

Descarga de JavaScript Scaffold para una API personalizada

Después de crear su API personalizada, puede descargar una estructura basada en el documento RAML de la API y, a continuación, utilizar scaffold como un inicio rápido para implantar la API personalizada.

Scaffold viene con el formato de un módulo Node, que son los componentes clave del archivo JavaScript principal que contiene métodos stub para cada punto final (recurso más método HTTP) y un archivo package.json que sirve como manifiesto para el módulo.

Para descargar scaffold:

Haga clic en para abrir el menú lateral, haga clic en Desarrollo y, a continuación, en API.
Abra la API que desea descargar.
En el área de navegación izquierda del diseñador de API, haga clic en Implantaciones .
Haga clic en JavaScript Scaffold para descargar el archivo zip.
En el sistema, descomprima el archivo descargado.

Si más adelante cambia la API, puede descargar una nueva estructura basada en los puntos finales actualizados. Sin embargo, cualquier codificación que pueda haber realizado y cargado previamente no se reflejará en el nuevo análisis.

Configure toolsConfig.jsen File

Después de descargar un archivo scaffold que se basa en el documento RAML de la API, puede configurar manualmente un archivo Notation (JSON) de JavaScript denominado toolsConfig.json.

Oracle Mobile Hub utiliza un archivo toolsConfig.json que contiene la información de despliegue para una API personalizada. Se genera un valor por defecto de toolsConfig.json al crear una API personalizada y se descarga el scaffold. Para configurar el archivo toolsConfig.json:

Abrir la página de configuración de backend móvil en Oracle Mobile Hub
Anote la información de la página Configuración .
La página Configuración contiene información como los tipos de autenticación (HTTP básico, consumidor de OAuth) y las URL de entorno.

Con un editor de texto, actualice el archivo toolsConfig.json con los valores de la página Configuración de Oracle Mobile Hub.

    "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>"
        }
    },

Abra la página Desarrollo .
Haga clic en Detalles de instancia.
Tenga en cuenta los valores de Id de cliente de aplicación de miembro de equipo y Secreto de cliente de aplicación de miembro de equipo.

Actualice el archivo toolsConfig.json con estos valores.

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

(Opcional) Para probar que toolsConfig.json es correcto puede realizar una prueba de despliegue. Abra una ventana de terminal, navegue hasta el directorio omce-tools y despliegue la API personalizada mediante el comando:
```
node omce-deploy toolsConfig.json
```
Después de ejecutar este comando, se le pedirán sus credenciales de Oracle Mobile Hub. Si su archivo toolsConfig.json es correcto, se muestra un mensaje que indica Deployment completed successfully. Puede utilizar este comando para desplegar su API personalizada en el futuro.