Plugin Perfecto Jenkins

El Plugin Perfecto Jenkins proporciona la capacidad de crear automáticamente/reutilizar un tunnel-id existente de Perfecto Connect en el entorno de compilación.

Tabla de contenidos

• Plugin Perfecto Jenkins
• Tabla de contenidos
  • Requisitos previos
  • 1. Pasos para habilitar el plugin
    • Capturas de pantalla
      • Mac
      • Windows
    • Opciones avanzadas
  • 2. Uso
    • Ejemplo con Maven
    • Ejemplo con Gradle
  • 3. Pasos para detener Perfecto Connect
  • Uso avanzado
    • Ejemplo de pipeline de Perfecto Connect
    • Subir app a Perfecto

Requisitos previos

• Descargue el cliente Perfecto Connect, extráigalo en cualquier carpeta.
• Genere el token de seguridad de Perfecto (si no se ha generado ya)
• Los usuarios de Mac deben instalar Jenkins mediante brew.

1. Pasos para habilitar el plugin

1. Haga clic en New Item en la página de inicio de Jenkins.
   
2. Ingrese el nombre de Item que prefiera.
   
3. Seleccione cualquier tipo de proyecto excepto pipeline.
   
4. Haga clic en OK.
   
5. Seleccione la casilla Perfecto Connect en Build Environment (consulte la sección de capturas de pantalla)
   
6. Nota: Solicite ayuda a su administrador de Jenkins para crear las siguientes credenciales de Perfecto:
   a. Seleccione la opción Add junto al menú desplegable Credentials y seleccione Jenkins.
   b. Seleccione la opción “Perfecto” en el menú desplegable Kind de la ventana Add Credentials.
   c. Proporcione su Cloud Name, Username y Security Token y haga clic en Add.
   

7. Proporcione la ruta de Perfecto Connect en el campo de texto Perfecto Connect Path.
   a. E.g.: - /Users/Mymac/Downloads
   
8. Proporcione el nombre del archivo de Perfecto Connect en el campo de texto Perfecto Connect File Name.
   a. E.g.: - Mac – perfectoconnect
   b. E.g.: - Windows – perfectoconnect64.exe o perfectoconnect32.exe
   

Capturas de pantalla

Mac

Windows

Opciones avanzadas

Puede proporcionar opciones avanzadas como parámetros adicionales de Perfecto Connect, sobrescribir el nombre del Tunnel ID y un Tunnel ID existente.

1. Parámetros adicionales
   a. Proporcione parámetros de Perfecto Connect como bridgeproxyip, bridgeproxyport
   b. E.g.: - --bridgeproxyip=127.0.0.1 --bridgeproxyport=8888
   
2. Puede sobrescribir el nombre de la variable de entorno del Tunnel ID en el campo de texto Override Tunnel ID Name. (El nombre de variable predeterminado del entorno de compilación de Jenkins es tunnelId)
   
3. Puede reutilizar un Tunnel ID ya creado en el campo de texto Existing Tunnel ID.
   

2. Uso

Ejemplo con Maven

Ejemplo con Gradle

3. Pasos para detener Perfecto Connect

1. Agregue una tarea Post Build en Post Build Action.
   
2. Ingrese el siguiente script en el campo de texto Script.
   

Uso avanzado

Ejemplo de pipeline de Perfecto Connect

1. Cree un nuevo Pipeline y agregue el siguiente código al campo de texto del script del pipeline.
   
2. Actualice cloudName, securityToken y perfectoConnectPath según corresponda.
   

import groovy.json.JsonSlurperClassic
import groovy.json.JsonSlurper
 
node {
String cloudName = "<<CLOUD NAME e.g. demo>>";
String securityToken = "<<SECURITY TOKEN>>";
String perfectoConnectPath = "/Users/myMac/Downloads/perfectoconnect";
    environment {
        tunnelId = ""
    }
    stage('perfectoconnect start'){
        if(cloudName.contains("<<")){
             error "Kindly update cloudName, securityToken and perfectoConnectPath"
        }
        String script = perfectoConnectPath + " start  -c " + cloudName + ".perfectomobile.com  -s " + securityToken;
        echo script;
        tunnelId = sh (script: script , returnStdout: true).trim()
        env.tunnelId = "${tunnelId}"
    }
    stage('script'){
        echo "Tunnel id: ${tunnelId}"
    }
    stage('perfectoconnect stop'){
        sh label: '', returnStdout: true, script: perfectoConnectPath + " stop"
    }
}

Subir app a Perfecto

Siga esta documentación para usar curl y subir la app al repositorio multimedia de Perfecto.