Плагин Perfecto для Jenkins

Плагин Perfecto для Jenkins предоставляет возможность автоматически создавать или повторно использовать существующий tunnel-id Perfecto Connect в среде сборки.

Оглавление

• Плагин Perfecto для Jenkins
• Оглавление
  • Предварительные требования
  • 1. Шаги по включению плагина
    • Скриншоты
      • Mac
      • Windows
    • Дополнительные параметры
  • 2. Использование
    • Пример для Maven
    • Пример для Gradle
  • 3. Шаги по остановке Perfecto Connect
  • Расширенное использование
    • Пример Pipeline для Perfecto Connect
    • Загрузка приложения в Perfecto

Предварительные требования

• Загрузите клиент Perfecto Connect и распакуйте его в любую папку.
• Сгенерируйте токен безопасности Perfecto (если ещё не сгенерирован)
• Пользователям Mac следует установить Jenkins через brew.

1. Шаги по включению плагина

1. Нажмите New Item на главной странице Jenkins.
   
2. Введите предпочитаемое имя элемента.
   
3. Выберите любой тип проекта, кроме pipeline.
   
4. Нажмите OK.
   
5. Установите флажок Perfecto Connect в разделе Build Environment (см. раздел «Скриншоты»)
   
6. Примечание. Обратитесь за помощью к администратору Jenkins, чтобы создать указанные ниже учётные данные Perfecto:
   a. Выберите опцию Add рядом с раскрывающимся списком Credentials и выберите Jenkins.
   b. Выберите опцию «Perfecto» в раскрывающемся списке Kind в окне Add Credentials.
   c. Укажите Cloud Name, Username и Security Token и нажмите Add.
   

7. Укажите путь к Perfecto Connect в текстовом поле Perfecto Connect Path.
   a. Например: /Users/Mymac/Downloads
   
8. Укажите имя файла Perfecto Connect в текстовом поле Perfecto Connect File Name.
   a. Например: Mac – perfectoconnect
   b. Например: Windows – perfectoconnect64.exe или perfectoconnect32.exe
   

Скриншоты

Mac

Windows

Дополнительные параметры

Вы можете указать дополнительные параметры, такие как Perfecto Connect Additional Parameters, Override Tunnel ID Name и Existing Tunnel ID.

1. Additional Parameters
   a. Укажите параметры Perfecto Connect, например bridgeproxyip, bridgeproxyport
   b. Например: --bridgeproxyip=127.0.0.1 --bridgeproxyport=8888
   
2. Вы можете переопределить имя переменной окружения Tunnel ID в текстовом поле Override Tunnel ID Name. (Имя переменной окружения сборки Jenkins по умолчанию — tunnelId)
   
3. Вы можете повторно использовать уже созданный Tunnel ID в текстовом поле Existing Tunnel ID.
   

2. Использование

Пример для Maven

Пример для Gradle

3. Шаги по остановке Perfecto Connect

1. Добавьте задачу Post Build в разделе Post Build Action.
   
2. Введите приведённый ниже скрипт в текстовом поле Script.
   

Расширенное использование

Пример Pipeline для Perfecto Connect

1. Создайте новый Pipeline и добавьте приведённый ниже код в текстовое поле pipeline script.
   
2. Обновите cloudName, securityToken и perfectoConnectPath в соответствии с вашими данными.
   

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

Загрузка приложения в Perfecto

Следуйте этой документации, чтобы использовать curl и загрузить приложение в медиарепозиторий Perfecto.