Skip to main content

Утиліти та скрипти Fledge

Платформа Fledge постачається з набором утиліт і скриптів, які допомагають користувачам, розробникам і адміністраторам виконувати повсякденні операції. Ці інструменти знаходяться в стадії інтенсивної розробки, і ви можете очікувати несумісності в майбутніх версіях, тому настійно рекомендуємо перевірити історію версій, щоб перевірити зміни в нових версіях.

fledge​

fledge це перша утиліта, доступна на платформі, це центр керування для всіх операцій адміністратора на Fledge.

У поточній реалізації fledge надає такі функції:

  • start Fledge
  • stop Fledge
  • kill процеси Fledge
  • Перевірте status Fledge, тобто чи працює він, запускається чи не працює
  • reset Fledge до заводських налаштувань

Запуск Fledge​

fledge start команда для запуску Fledge. Оскільки лише один основний мікросервіс Fledge може бути виконаний в тому самому середовищі, команда перевіряє, чи Fledge вже запущено, і якщо це так, вона завершується. Команда також перевіряє наявність змінних середовища FLEDGE_ROOT і FLEDGE_DATA. Якщо змінні не встановлено, він перевіряє, чи встановлено Fledge у стандартну позицію, яка є /usr/local/fledge, або в позицію, визначену встановленим пакетом, і відповідно встановлює відсутні змінні. Він також подбає про змінну PYTHONPATH.

Говорячи більш конкретно, команда виконує такі дії:

  • Перевіряє, чи Fledge вже працює
  • Перевіряє, чи є рівень зберігання керованим або некерованим. «керований» означає, що рівень зберігання покладається на систему зберігання (тобто базу даних, набір файлів або структур у пам’яті), які знаходяться під виключним контролем Fledge. «некерований» означає, що система зберігання є загальною та потенційно спільною з іншими програмами.
  • Перевіряє, чи доступний плагін зберігання та відповідна система зберігання (наприклад, база даних PostgreSQL).
  • Перевіряє, чи структура метаданих, необхідна для виконання Fledge, уже доступна на рівні зберігання. Якщо метадані недоступні, створюється модель даних і встановлюються заводські налаштування, необхідні для запуску та використання Fledge.
  • Запускає основний мікросервіс.
  • Чекає, доки основний мікросервіс запустить мікросервіс зберігання та початковий необхідний процес, необхідний для обробки інших завдань і мікросервісів.

Безпечний режим​

Можна запустити Fledge у безпечному режимі, передавши позначку --safe-mode команді запуску. У безпечному режимі Fledge не буде запускати жодну з південних сервісів або планувати будь-які завдання, такі як очищення чи завдання на північ. Безпечний режим дозволяє Fledge запускаєтися та налаштовуватися в тих ситуаціях, коли попередня неправильна конфігурація унеможливлює запуск і взаємодію з Fledge.

Після запуску в безпечному режимі слід внести будь-які зміни в конфігурацію, а потім перезапустити Fledge у звичайному режимі, щоб перевірити ці зміни конфігурації.

Зупинка Fledge​

fledge stop це команда, яка використовується для зупинки Fledge. Команда чекає, поки всі завдання та сервіси будуть завершені, а потім зупиняє основний сервіс.

Якщо Fledge не зупиняється​

Якщо Fledge не зупиняється, тобто якщо за допомогою команди стану процесу ps ви бачите, що процеси Fledge все ще працюють, ви можете використати fledge kill, щоб убити їх.

Примітка

Команда видає kill -9 для процесів, пов’язаних з Fledge. Це не рекомендується, якщо тільки Fledge неможливо зупинити. Команда стоп. Іншими словами, kill — це останній засіб перед перезавантаженням. Якщо вам потрібно використовувати команду kill, це означає, що виникла проблема: будь ласка, повідомте про це на слабкий канал проекту Fledge.

Перевірка статусу Fledge​

fledge status використовується для надання поточного статусу завдань і мікросервісів на машині. Вивід приблизно такий:

$ fledge status
Fledge running.
Fledge uptime:  2034 seconds.
=== Fledge services:
fledge.services.core
fledge.services.south --port=33074 --address=127.0.0.1 --name=HTTP_SOUTH
fledge.services.south --port=33074 --address=127.0.0.1 --name=COAP
=== Fledge tasks:
$ fledge_use_from_here stop
Fledge stopped.
$ fledge_use_from_here status
Fledge not running.
  • Перший рядок завжди вказує, працює Fledge чи ні
  • Другий рядок забезпечує час безвідмовної роботи в секундах
  • Наступний набір рядків містить інформацію про мікросервіси, запущені на машині
  • Останній набір рядків містить інформацію про завдання, які виконуються на машині

Скидання Fledge​

Може статися, що ви захочете відновити Fledge до заводських налаштувань, і саме це робить fledge reset. Ця команда також знищує всі дані та всю конфігурацію, яка наразі зберігається у Fledge, тому ви повинні використовувати її на свій страх і ризик!

Fledge можна відновити до заводських налаштувань, лише якщо він не запущений, тому вам слід спочатку зупинити його.

Команда змушує вас вставити слово YES, все у верхньому регістрі, щоб продовжити:

$ fledge reset
This script will remove all data stored in the server.
Enter YES if you want to continue: YES