Установка TSeer

Зависимости среды

Для запуска сервера достаточно одного компьютера с установленной Linux-системой.

1. Выбор способа установки

TSeer в настоящее время предлагает только установку из исходного кода, которая обеспечивает высокую настраиваемость. Установка не представляет сложности благодаря наличию скрипта для однократной установки.

Примечание: В процессе установки потребуются инструменты wget и curl.

Исходный код установки

Необходимо предварительно установить Python, GCC, CMake, Wget, Curl, Flex, Bison и убедиться, что сеть работает нормально и позволяет клонировать репозиторий GitHub.

2. Tars

TSeer зависит от Tars. В процессе однократной установки исходный код Tars автоматически загружается и устанавливается, поэтому нет необходимости беспокоиться о его развёртывании.

Примечание: Для компиляции исходного кода Tars необходимо заранее установить Flex и Bison.

3. Исходная установка

Внимание:

— Установка должна выполняться в каталоге build/ с помощью сценария установки; — Каталоги установки и исходные каталоги не должны пересекаться.

Скачивание исходного кода: git clone https://github.com/Tencent/TSeer.git

1. Отредактируйте файл конфигурации: vim build/tseer_deploy.ini, измените install_type=source, чтобы использовать метод установки из исходного кода (подробное использование см. в разделе 4, после редактирования выполните второй шаг).
2. Выполните установку: cd build; python tseer_deploy.py

4. Редактирование конфигурации установки

Расположение файла конфигурации установки: tseer/build/tseer_deploy.ini

4.1 Базовая конфигурация tseer:

[tseer]
; install_type: bin, source; default: bin.
; binary install: place binary executable to your set base path
; source install: depend tars
install_type=bin
; storage: etcd, data storage.
storage=etcd
base_dir=/usr/local/
bind_ip=localhost

• install_type — выбор метода установки: исходный код (source) приведёт к компиляции, двоичный пакет (bin) позволит использовать уже скомпилированный двоичный файл.
• base_dir — каталог установки, где будет установлен каталог tseer.
• bind_ip — адрес прослушивания TseerServer/TseerAgent, по умолчанию это IP-адрес локальной машины.

4.2 Конфигурация tseer server:

[tseer_server]
; agent registry and report heartbeat
regport=9902
; query service ip and port
queryport=9903
; admin port
apiport=9904

• regport — порт регистрации и отправки пульса агента на сервер tseer, а также порт загрузки пакета агента через веб.
• queryport — порт запроса информации о маршрутизации услуг.
• apiport — порт администрирования платформы управления, используемый для управления данными маршрутизации и администрирования tseeragent.

4.3 Конфигурация носителя данных

4.3.1 Конфигурация Etcd:

[etcd]
; host_list: localhost or like 10.0.0.1,192.168.0.10, 172.168.10.1
; localhost: start local 3 etcd instance
;host_list=localhost
client_port=2379
cluster_port=2380
base_dir=/data/test/etcd/

• host_list — список хостов для развёртывания etcd. По умолчанию запускается три экземпляра etcd. Для удалённой установки требуется библиотека paramiko, которую необходимо установить самостоятельно.
• client_port — интерфейс доступа.
• cluster_port — внутренний порт связи кластера etcd.

Имена членов etcd по умолчанию — tseer_etcd плюс порядковый номер, который нельзя настроить.

5. Развёртывание веб-платформы

Сценарий однократной установки не включает развёртывание веб-платформы, которое должно быть выполнено вручную. Здесь приводится дополнительная информация:

Сначала загрузите пакет resin с сайта http://caucho.com/download/resin-4.0.49.tar.gz. Распакуйте пакет resin в каталог build/.

cd build/
tar xvf resin-4.0.49.tar.gz
mv resin-4.0.49 resin

Измените адрес запроса маршрута:

cd web # Перейдите в каталог исходного кода web.
vi src/main/resources/seer.conf

Измените локатор на адрес конфигурации tseer и номер порта queryport, по умолчанию порт равен 9903.

Измените конфигурацию адреса службы TSeer, как показано ниже:

cd web # Войдите в каталог исходного кода веб.
vi src/main/resources/system.properties

Замените значения seer.api.url и seer.agent.onekey.install.url на IP-адрес вашего сервера TSeerServer и номер порта apiport, указанный в конфигурации 4.2. Например, если конфигурация bind_ip для tseer — localhost, порт — 9904, то можно изменить следующим образом: seer.api.url=http://127.0.0.1:9904/v1/interface

Теперь создайте файл war нашего пакета: после выполнения команды вы увидите файл seer-1.0.0-SNAPSHOT.war в каталоге target, скопируйте его в каталог webapps каталога resin/.

cd web  # Войдите в каталог исходного кода веб, есть файл pom.xml, подготовьтесь к выполнению команды mvn.
mvn clean
mvn install
cp target/seer-1.0.0-SNAPSHOT.war ../build/resin/webapps/ 

Установите точку входа resin: В conf/resin.xml под этой строкой комментариев webapps can be overridden/extended in the resin.xml добавьте:

Запустите resin: в каталоге resin/ выполните:

./bin/resin.sh start

6. Начало работы с Tseer

6.1 Доступ к платформе управления

По умолчанию порт resin — 8080, поэтому введите http://127.0.0.1:8080 в браузере (замените IP на реальный IP привязки).

6.2 Добавление данных маршрута

— В правом верхнем углу страницы нажмите «Список групп услуг».

— После перехода нажмите «Добавить группу услуг», введите название группы услуг.

— Добавьте модуль.

— Введите конкретные данные маршрута объекта.

Имя маршрута Tseer состоит из четырёх частей: группа услуг.имя услуги.имя сервиса.порт. На этапе добавления группы услуг имя услуги уже определено, а при добавлении модуля необходимо ввести оставшиеся три части имени. Как показано на рисунке, имя услуги — app, имя сервиса — server, порт — helloobj.

6.3 Использование API для получения данных маршрута

Tseer предоставляет C++ и Java API, которые находятся в каталоге api предустановленного пути установки.

Как использовать, см. соответствующие руководства и примеры использования API.

C++ API: docs/cplus-api-quickstart.md

Java API: docs/seer-api-java-quickstart.md