Acerca de la configuración de un pipeline de integración y despliegue continuos

En primer lugar, obtenga la API lista. Debe definir al menos sus puntos finales y descargar la estructura que genera OMC. El escape representa una aplicación mínima que puede utilizar para asegurarse de que el proceso de integración y despliegue continuos funciona correctamente antes de continuar y escribir y probar el código de la API personalizada.

Cuando la API está lista y puede transferir correctamente los cambios al repositorio de Git en el proyecto de Developer Cloud Service, es hora de configurar la integración y el CD para el proyecto.

Configuración de la API en Oracle Mobile Hub

Cree una API scaffold definiendo los puntos finales REST a los que se conectan las aplicaciones. Una vez que haya terminado el análisis, puede descargar su definición para utilizarla como punto de partida para el código API.

Al definir los métodos HTTP para los puntos finales, tiene la opción de agregar respuestas de ejemplo. Es estrictamente hablante, las respuestas de muestra no son necesarias porque escribirá el código posteriormente que proporcione las respuestas reales. Sin embargo, puede que desee introducir algunas respuestas de ejemplo para probar la API antes de que el código personalizado esté listo.

1. Conéctese a Oracle Mobile Hub y abra el panel de navegación.
2. En la sección Aplicaciones del panel de navegación, haga clic en API .
3. Haga clic en Nueva API y, en el menú que se abre, haga clic en API.
   Se abrirá la ventana Nueva API .
4. En el campo Nombre mostrado de API y en el campo Nombre de API, introduzca un nombre adecuado para la API.
5. En el campo Descripción Breve , introduzca una descripción adecuada.
6. Si tiene un documento RAML para su API, cárguelo aquí.
7. Haga clic en Crear y se abrirá la página para la nueva API.
8. Agregue recursos HTTP. Si ha cargado un documento RAML, puede omitir este paso.
   1. Haga clic en Puntos Finales y, a continuación, en Nuevo Recurso para crear el primer punto final y definir sus métodos HTTP.
   2. Continúe definiendo los puntos finales y los métodos HTTP para la API hasta que todos los puntos finales estén definidos.
9. Haga clic en Guardar.

Configuración del Backend

Cree el backend que utilizará su API. El backend direcciona las solicitudes de su aplicación a la API y proporciona servicios de autenticación.

1. En el panel de navegación del hub de Oracle Mobile , haga clic en Backends , que abre la página Backends .
2. Haga clic en Nuevo Backend y en la ventana que abre, introduzca un nombre adecuado en el campo Nombre y, a continuación, haga clic en Crear .
   Se abre la página de configuración del backend. Tiene su propio panel de navegación, que se abre en la página Configuración .
3. En el panel de navegación de la página de configuración, haga clic en API y en la página que se abre, haga clic en Seleccionar API , que abre el catálogo de API.
4. En el catálogo, busque la tarjeta para la API que ha creado y haga clic en el botón + . Esto asocia esa API a este backend.

Registrar Información de Detalles de Instancia y Backend

Registre la información que necesitará al configurar las herramientas de desarrollo.

La información se utiliza en un archivo denominado toolsConfig.json y es necesaria para la autenticación. Permite a un script conectarse a Oracle Mobile Hub y entregarle artefactos de código.

1. En el panel de navegación del hub de Oracle Mobile , haga clic en Backends , que abre la página Backends .
2. Seleccione su backend y haga clic en Abrir .
3. En el panel de navegación, haga clic en Configuración .
4. Registre la siguiente información y cópiela en un archivo de texto u otro lugar donde pueda recuperarla con facilidad más adelante:
   • ID de cliente
   • Secreto de cliente
   • ID de Backend
   • Nombre de Backend
   • Versión de Backend
   • Clave Anónima
5. En el panel de navegación, haga clic en Desarrollo para abrir la página principal y, a continuación, haga clic en Detalles de Instancia para abrir el panel Detalles de Instancia .
6. Registre la siguiente información y guárdela con la información de backend que ha registrado en un paso anterior:
   • ID de cliente de aplicación de miembro de equipo
   • Secreto de cliente de aplicación de miembro de equipo

Configuración de un proyecto en Oracle Developer Cloud Service

Cree un proyecto que incluya un repositorio de Git. Posteriormente, configurará el proyecto para que ejecute una creación cada vez que envíe una confirmación al repositorio.

Crear Proyecto

Cree un proyecto que incluya un repositorio de Git.

1. Inicie sesión en la consola de Oracle Developer Cloud Service y haga clic en Nuevo proyecto .
2. En la página Detalles del Proyecto , introduzca un nombre para el proyecto y haga clic en Siguiente .
3. En la página Plantilla , seleccione Repositorio inicial y haga clic en Siguiente .
4. En la página Propiedades del Proyecto , acepte los valores por defecto y haga clic en Terminar para iniciar el proceso de provisionamiento.

Una vez terminado el proyecto, la pantalla debe ser similar a la siguiente imagen:

Clonación y Configuración del Repositorio de Git

Clone el repositorio en su sistema de desarrollo local.

1. Conéctese a Oracle Developer Cloud Service y navegue a la página del proyecto.
2. Copie la dirección HTTP del campo para el repositorio para Git.
3. Abra una ventana de terminal (en Linux o Mac) o el terminal Bash de Git (en Windows) y cree un nuevo directorio en una ubicación adecuada en el disco duro. Utilice un nombre para el directorio adecuado para el proyecto.

    mkdir <your-directory-name>

4. Cambie al directorio y clone el repositorio, sustituyendo la dirección del repositorio en el ejemplo por la suya propia.

   cd <your-directory-name>
   git clone <your-repo-url>

   Cuando se le solicite una contraseña, utilice la contraseña que utiliza para conectarse a Oracle Developer Cloud Service .

5. Cambie al directorio creado por el proceso de clonación.

   cd <your-directory-name>

6. Defina su nombre y dirección de correo electrónico para este proyecto y configure Git para almacenar sus credenciales.

   git config user.name "<your-name>"
   git config user.email "<your-email-address>"
   git config credential.helper store

Crear Nuevo Trabajo de Creación

Cree un trabajo que se ejecutará siempre que envíe código al repositorio de Git del proyecto.

1. Conéctese a Oracle Developer Cloud Service y navegue a la página del proyecto.
2. En el panel de navegación, haga clic en Crear y, en la página que se abre, haga clic en Nuevo trabajo .
3. Introduzca un nombre y seleccione una plantilla de software y, a continuación, haga clic en Crear Trabajo .
4. Haga clic en Agregar Control de Origen y seleccione Git .
5. En la lista desplegable Repositorio , seleccione el repositorio de Git que desea utilizar.
6. Opcional: Si es el único desarrollador que envía código al repositorio, seleccione Realizar automáticamente la creación en la confirmación de SCM.

   Si varias personas están trabajando en el proyecto y envían código al repositorio, no seleccione esta opción. Puede configurar en su lugar un disparador de sondeo de SCM, que puede hacer después de terminar de crear el trabajo de creación.

7. Haga clic en Guardar.

Configurar el disparador de sondeo de SCM

Puede configurar un sondeo que compruebe los cambios en el repositorio de Git en una programación que defina. Si se detectan cambios, se inicia una creación.

Si es el único desarrollador que envía código al repositorio, es probable que sea apropiado una creación inmediata. Sin embargo, cuando varias personas enviarán código, puede configurar un disparador de sondeo que compruebe periódicamente los cambios en el repositorio antes de iniciar una creación.

Para configurar el disparador de sondeo de SCM, utilice el formato crontab para definir un programa de sondeo. Si no está familiarizado con el formato crontab, puede utilizar la interfaz gráfica para crear el programa.

El programa por defecto es cada 30 minutos, representado por 0/30 * * * *. Para definir que el programa se ejecute a los 30 minutos anteriores a la hora cada hora, utilice 30 * * * *.

1. Inicie sesión en la consola de Oracle Developer Cloud Service y abra el proyecto.
2. En el panel de navegación, haga clic en Crear y, a continuación, seleccione la versión para la que desea definir los parámetros.
   Se abre la página Configuración de Creación .
3. Haga clic en Configurar.
   Se abrirá la página Configuración del Trabajo .
4. Haga clic en el icono de engranaje y, a continuación, haga clic en Disparadores para abrir el panel Configurar Disparadores de Creación .
5. Haga clic en la lista desplegable Agregar disparador y seleccione Disparador de sondeo de SCM.
6. Configure el programa y haga clic en Guardar .

Configuración de los parámetros de creación

Configure un parámetro de cadena y un parámetro de contraseña para contener el nombre de usuario y la contraseña de la cuenta de Oracle Mobile Hub .

Realice un seguimiento de los nombres de estos parámetros porque los necesitará más adelante al configurar las herramientas del desarrollador.

1. Inicie sesión en la consola de Oracle Developer Cloud Service y abra el proyecto.
2. En el panel de navegación, haga clic en Crear y, a continuación, seleccione la versión para la que desea definir los parámetros.
   Se abre la página Configuración de Creación .
3. Haga clic en Configurar.
   Se abrirá la página Configuración del Trabajo .
4. Haga clic en el separador Parámetros de Creación .
5. Haga clic en la lista desplegable Agregar parámetro de creación y seleccione Parámetro de cadena.
6. Introduzca un nombre para el parámetro de nombre de usuario. Por ejemplo, devUser.
7. En el campo Valor por Defecto, introduzca el nombre de usuario del hub de Oracle Mobile . Por ejemplo [e-mail].
8. Haga clic en la lista desplegable Agregar Parámetro de Creación y seleccione Parámetro de Contraseña.
9. Introduzca un nombre para el parámetro de contraseña como devPassword .
10. En el campo Valor por Defecto , introduzca la contraseña del nombre de usuario del hub de Oracle Mobile .
11. Haga clic en Guardar.

Configurar Creador de Shell de Unix

El creador de shell es un script Bash que se ejecuta en el sistema de creación cuando se dispara una creación. Instala dependencias y entrega su código a Oracle Mobile Hub .

El script se ejecuta en el origen a partir del repositorio de Git que ha configurado al crear el proyecto en Oracle Developer Cloud Service . Tenga en cuenta que si el archivo de comandos falla en cualquier momento, se cierra con un error y no se despliega ningún código.

1. Inicie sesión en la consola de Oracle Developer Cloud Service y abra el proyecto.
2. En el panel de navegación, haga clic en Crear y, a continuación, seleccione la versión para la que desea definir los parámetros.
   Se abre la página Configuración de Creación .
3. Haga clic en Configurar.
   Se abrirá la página Configuración del Trabajo .
4. Haga clic en el separador Creadores .
5. Haga clic en la lista desplegable Agregar Creador y seleccione Creador de Shell de Unix.
6. En el campo Script , introduzca el siguiente script:

   export NODE_PATH=node-configurations/8.9/node_modules
   npm install
   cd omce-tools
   npm install
   cd node-configurations/8.9
   npm install
   cd ../..
   node omce-deploy ../toolsConfig.json -u $devUser -p $devPassword

7. Haga clic en Guardar.

Descarga de JavaScript Scaffold

Después de haber creado el esqueleto de la API, el sistema crea una estructura para el código de la API que puede descargar en un archivo zip.

El campo scaffold contiene la estructura inicial y los archivos para la implementación de la API, que utilizará como punto de partida para las personalizaciones. Debe extraer los archivos y colocarlos en el directorio de trabajo.

1. En Oracle Mobile Hub , abra la API para la que desea tener el formato scaffold.
2. En el panel de navegación de API, haga clic en Implantación .
3. Haga clic en JavaScript Scaffold , que descarga el archivo scaffold en su computadora.
4. Extraiga el archivo package.json, toolsConfig.json y .js de la API en el directorio de trabajo. Es el mismo directorio que se creó cuando clonó el repositorio de Git y contiene el directorio .git.

Instalar y Configurar Herramientas de Desarrollo

Oracle proporciona herramientas para cargar implantaciones de API personalizadas en Oracle Mobile Hub desde la línea de comandos. Agregue las herramientas al repositorio de Git para que estén disponibles para su script de creación en Oracle Developer Cloud Service .

Las herramientas forman parte de una descarga que también contiene una API de hub de Oracle Mobile que puede utilizar para probar y depurar las implantaciones de API personalizadas en el sistema de desarrollo. La API no es necesaria para el uso del pipeline de integración y despliegue continuos. Consulte el archivo Léame del directorio omce-tools para obtener instrucciones sobre el uso de la API, que se denomina OracleMobileAPI.

Las herramientas admiten dos versiones de Node.js: 6.10.0 y 8.9.x. En este procedimiento se asume que está utilizando la versión 8.9.4 o superior.

Para instalar y configurar las herramientas:

1. Vaya a https://www.oracle.com/technetwork/topics/cloud/downloads/amce-downloads-4478270.html y descargue las herramientas de prueba de código personalizado versión 18.3.1 o posterior. Tenga en cuenta que los nombres de archivo de esta página siguen teniendo en cuenta los nombres de producto heredados, pero el código que contienen está actualizado con la última versión. Igualmente, para los nombres de las herramientas que se encuentran en la descarga.
2. Abra el archivo que ha descargado y extraiga el contenido del directorio omce-tools/omce-tools en el directorio de trabajo, el que tiene su directorio .git. Por ejemplo, si el directorio de trabajo es test-project, extraiga el contenido de omce-tools/omce-tools a test-project/omce-tools.
3. Instale la configuración del nodo: cambie al directorio omce-tools/node-configurations/8.9 y ejecute npm install.
4. Instale omce-tools en el sistema: cambie al directorio omce-tools y ejecute npm install -g.
5. Cree una variable de entorno denominada NODE_PATH y establézcala en node-configurations/8.9/node_modules.
6. Asegúrese de que las herramientas se han instalado correctamente. En el directorio omce-tools, ejecute node omce-test --version. El resultado debe ser 18.3.1.
7. Actualice toolsConfig.json. Al descargar scaffold, se incluye el archivo de configuración toolsConfig.json. Utilice la información que ha registrado desde el backend para sustituir el texto de marcador de posición en toolsConfig.json.