DMI TCAT

Набор инструментов для сбора и анализа твитов Digital Methods Initiative (DMI-TCAT) позволяет получать и собирать твиты из Twitter, а также анализировать их различными способами.

Установка

Подробные инструкции по установке вы найдете в wiki.

Требования

• Учетные данные Twitter API (их можно получить на https://apps.twitter.com)
• Один из следующих дистрибутивов Linux:
  • Ubuntu 18.04
  • Debian 9.*
• ... или Docker (экспериментально)

Debian и Ubuntu

Выполните:

curl https://raw.githubusercontent.com/digitalmethodsinitiative/dmi-tcat/master/helpers/tcat-install-linux.sh | sudo bash

Docker

Последние образы Docker доступны на Docker Hub.

1. Установите Docker Desktop и запустите его. Обратите внимание: в Windows может потребоваться включить интеграцию WSL (Windows Subsystem for Linux) в Docker. Это можно сделать в настройках Docker: Settings -> Resources -> WSL Integration -> Enable integration with required distros.

Базовая установка

2. Выполните команду docker run --publish 80:80 --volume tcat_data:/var/lib/mysql/ --detach --name tcat digitalmethodsinitiative/tcat:1.0 — Docker загрузит версию 1.0 (или любой другой тег, которым вы замените «1.0»).

• --publish HOST_PORT:80 позволяет указать, какой порт на хост-сети используется. Если вы используете другой порт, возможно, потребуется добавить -e SERVERNAME=localhost:HOST_PORT, где HOST_PORT — желаемый порт, так как он используется для внутренних ссылок в интерфейсе TCAT.
• --volume volume_name:/var/lib/mysql/ гарантирует, что вы сможете легко повторно использовать базу данных TCAT mysql и восстановить данные после прекращения использования TCAT.

3. Откройте логи, чтобы получить информацию для входа: через интерфейс Docker или командную строку docker logs tcat (установка может занять некоторое время, так что можно подождать или выполнить docker logs -f tcat для наблюдения за процессом).
4. Откройте http://localhost:80 в браузере и завершите настройку, указав информацию о Twitter API и тип сбора твитов, который вы хотите выполнять.
5. Поздравляем! Вы можете использовать меню admin для создания первых корзин сбора твитов.
6. В будущем вы можете останавливать и запускать контейнер TCAT командами: docker stop tcat и docker start tcat

Настройка под собственный сервер

Установка Docker также позволяет легко разместить TCAT на сервере. Помимо переменной окружения SERVERNAME, вы также можете использовать Let’s Encrypt, добавив -e LETSENCRYPT=y и -e [email protected]. Также следует открыть порт 443 для работы Let’s Encrypt. Полная команда может выглядеть так: docker run --publish 80:80 --publish 443:443 --volume tcat_data:/var/lib/mysql/ --detach --name tcat -e SERVERNAME=my.website.com -e LETSENCRYPT=y -e [email protected] digitalmethodsinitiative/tcat:1.0

Дальнейшая настройка TCAT

Наконец, если вы хотите самостоятельно разрабатывать TCAT, вы можете клонировать этот репозиторий и создать собственный образ.

1. Клонируйте этот репозиторий: git clone https://github.com/digitalmethodsinitiative/dmi-tcat.git
2. Соберите образ (из каталога, куда вы клонировали TCAT): docker image build --progress=plain -t tcat:1.0 .
3. Замените digitalmethodsinitiative/tcat:1.0 на tcat:1.0 в команде docker run, описанной выше.

Проблемы

При сообщении о проблемах и ошибках используйте шаблоны для issues.

Статус

Хороший способ описать тот факт, что у нас не так много.

Содействие

Мы рады предложениям и улучшениям.

Лицензия

Apache License Version 2.0