Руководство по установке TSeer

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

Требования к оборудованию: машина под управлением Linux.

1. Выбор метода установки

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

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

Установка из исходного кода

Пользователь должен предварительно установить Python, g++, cmake, wget, curl, flex, bison, убедиться, что сеть машины работает нормально, и клонировать репозиторий GitHub.

2. Tars

TSeer опирается на [Tars](https://github.com/Tencent/Tars). Однокликовый сценарий установки включает автоматическую загрузку и компиляцию Tars, поэтому пользователю не нужно беспокоиться о развёртывании Tars.

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

3. Установка из исходного кода

Примечание

• Перед выполнением сценария установки обязательно cd build/
• Не перекрывайте каталог установки и исходный каталог.

Загрузка исходного кода

Используйте git для загрузки исходного кода: 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 напрямую использует двоичный пакет, уже установленный на git.
• base_dir: служба будет установлена в каталоге tseer каталога base_dir.
• bind_ip: адрес прослушивания TseerServer/TseerAgent. По умолчанию используется IP этого компьютера.

4.2 Конфигурация TSeer

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

• regport: TSeerAgent регистрируется и сообщает об сердцебиении на этот порт TSeer Server и Web upload agent отправляет пакеты на этот номер порта.
• queryport: номер порта используется для запроса информации о маршрутизации службы.
• apiport: этот номер порта используется для WEB-операции для маршрутизации данных и управления TSeer Agent.

4.3 Конфигурация целевого хранилища

[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: порт кластера. В этом тексте рассказывается о развёртывании и настройке веб-платформы TSeer.

• number is used for internal communication in the etcd cluster.

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

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

Скрипт установки в один клик не включает развёртывание веб-платформы. Требуется ручная операция. Добавляется следующее:

1. Сначала скачайте установочный пакет Resin из здесь.

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

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

cd web
vi src/main/resources/seer.conf

Измените адрес локатора на IP-адрес прослушивания сервера Tseer плюс номер порта запроса, номер порта по умолчанию равен 9903.

3. Измените адрес службы TSeer в конфигурации. Изменение выглядит следующим образом:

cd web
vi src/main/resources/system.properties

Измените значения seer.api.url и seer.agent.onekey.install.url на IP-адрес прослушиваемого сервера Tseer и номер порта apiport, упомянутый в разделе 4.2.

Например, если bind_ip сервера Tseer — localhost, а порт — 9904, то измените это в файле конфигурации: seer.api.url=http://127.0.0.1:9904/v1/interface.

Теперь начните генерировать наш военный пакет, после выполнения следующей команды вы можете увидеть файл seer-1.0.0-SNAPSHOT.war в каталоге target.

cd web 
mvn clean
mvn install
cp target/seer-1.0.0-SNAPSHOT.war ../build/resin/webapps/

Скопируйте его в каталог webapps Resin.

4. Установите рабочий вход Resin:

vi conf/resin.xml

В этой заметке `веб-приложения могут быть переопределены/расширены в resin.xml`, добавив
<web-app id="/" root-directory="webapps/seer-1.0.0-SNAPSHOT"/>

Запустите 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 Использование TSeer API для получения данных маршрутизации

TSeer предоставляет API для C++ и Java, размещённые в каталоге API по пути установки по умолчанию.

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

c++ api

java api

7. Установка агента TSeer

В скрипте установки одним щелчком мыши процесс запуска агента TSer запускается автоматически. Если пользователь хочет развернуть агент TSer на других машинах, вам необходимо установить его самостоятельно.

Скрипт установки одним щелчком помогает пользователям упаковать пакеты агентов с суффиксом tgz в каталог сборки, и пользователи должны загрузить их.

7.1 Загрузите установочный пакет агента, загрузив веб-страницу

— На верхней правой стороне веб-страницы выберите опубликовать управление пакетами, затем выберите загрузку пакета выпуска TSeerAgent слева, как показано ниже.

7.2 Через операционную веб-страницу генерируется команда для загрузки агента.

— В верхнем правом углу веб-страницы пользователь выбирает Инструмент установки агента, заполняет целевой IP-адрес машины и веб-менеджер генерирует команду. Пользователь копирует её, вставляет на целевую машину и запускает команду.

Сгенерированная команда похожа на:

wget http://10.17.89.41:9904/installscript && python installscript --innerip=10.17.89.35
``` 10.17.89.41 — это машина, на которой вы запускаете скрипт установки в один клик. Innerip — целевая машина.

**Примечание.** Как правило, пользователю также необходимо указать версию ОС в формате CentOs-7.2-64, иначе пакет агента не может быть загружен. Таким образом, итоговая команда выглядит примерно так:

```wget http://10.17.89.41:9904/installscript && python installscript --innerip=10.17.89.35 --os=CentOs-7.2-64```

### 7.3 Войдите на целевую машину и выполните указанную команду

После выполнения команды пользователь использует `ps` или `netstat`, чтобы проверить, успешно ли запущен процесс агента.