GitFlic Runner Silent Registration

Скрипты для безопасной регистрации GitFlic Runner без вывода токенов и URL в терминал. Поддерживаются Windows (PowerShell) и Linux/macOS (Bash).

---

Описание

При стандартной регистрации GitFlic Runner:

java -jar runner.jar register --url <REG_URL> --registration-token <REG_TOKEN>

токен и адрес видны в списке процессов и истории оболочки. Данные скрипты решают эту проблему:

• берут параметры из файла .env;
• записывают весь вывод в файл register.log;
• не показывают токен в терминале;
• выводят в консоль только итоговое сообщение.

---

Требования

Среда	Необходимо
Windows	PowerShell 5.1 или PowerShell 7+, установленная Java (JRE/JDK)
Linux/macOS	Bash 4+, установленная Java (JRE/JDK)

Проверьте наличие Java:

java -version

---

1. Подготовка

1. Скопируйте в директорию с агентом нужную версию скрипта:

   • Register-Runner.ps1 (Windows)
   • register-runner.sh (Linux)

Опционально: для удобного запуска в Windows скопируйте файл Register-Runner.cmd в директорию с агентом

2. Создание файла .env

В той же директории создайте файл .env следующего содержания:

REG_URL=<reg_url>
REG_TOKEN=<token>

# опционально
# NAME=<name>
# TAGS=<tags>

Разрешены кавычки, строки с # считаются комментариями.

3. Запуск регистрации

Linux / macOS

1. Перейдите в директорию с агентом и скриптом:

   cd /opt/gitflic-runner

2. Сделайте скрипт исполняемым:

   chmod +x register-runner.sh

3. Запустите его:

   ./register-runner.sh

4. После выполнения:

   • В консоли появится:

     Registration completed successfully, log saved to register.log
     

   • Подробный вывод будет сохранён в файл register.log.

   • Конфигурация агента появится в файле config/application.properties (при отсутствии).

Windows (PowerShell)

1. Разрешите выполнение скриптов в текущем сеансе:

   Set-ExecutionPolicy Bypass -Scope Process -Force

2. Перейдите в директорию с агентом и скриптом:

   cd $env:USERPROFILE\gitflic-runner

3. Запустите скрипт для регистрации агента:

   .\Register-Runner.ps1

   Или дважды кликните по файлу Register-Runner.cmd

4. При успешной регистрации появится сообщение:

   Registration completed successfully, log saved to register.log
   

5. В папке появится:

   • файл register.log — журнал выполнения;
   • файл config/application.properties — конфигурация агента (при отсутствии).

---

4. Рекомендации по безопасности

• Закройте доступ к файлу .env:

  chmod 600 .env

• После успешной регистрации удалите или очистите токен:

  REG_TOKEN=

---