DMI TCAT

O Digital Methods Initiative Twitter Capture and Analysis Toolset (DMI-TCAT) permite recuperar e coletar tweets do Twitter e analisá-los de diversas formas.

Instalação

Você pode encontrar instruções detalhadas de instalação na wiki

Requisitos

• Credenciais da API do Twitter (podem ser obtidas em https://apps.twitter.com)
• Uma das seguintes distribuições Linux:
  • Ubuntu 18.04
  • Debian 9.*
• ... ou Docker (experimental)

Debian e Ubuntu

Execute:

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

Docker

As nossas imagens Docker mais recentes estão disponíveis no Docker Hub.

1. Instale o Docker Desktop e inicie-o. Note que no Windows, pode ser necessário garantir que a integração WSL (Subsistema Windows para Linux) esteja ativada no Docker. Isto pode ser encontrado nas configurações do Docker em Configurações -> Recursos -> Integração WSL -> Ativar integração com as distros necessárias.

Instalação básica

2. Execute o comando docker run --publish 80:80 --volume tcat_data:/var/lib/mysql/ --detach --name tcat digitalmethodsinitiative/tcat:1.0 e o Docker irá baixar a versão 1.0 (ou qualquer tag pela qual substituir o "1.0")

• --publish PORTA_HOST:80 permite definir qual porta na rede do host será usada. Se estiver usando uma porta diferente, pode ser necessário adicionar -e SERVERNAME=localhost:PORTA_HOST onde PORTA_HOST é a porta desejada, pois isso é usado para links internos na interface TCAT.
• --volume nome_do_volume:/var/lib/mysql/ garante que você possa reutilizar facilmente o banco de dados MySQL do TCAT e recuperar dados depois de parar de usar o TCAT

3. Abra os logs para obter as informações de login através da interface do Docker ou da linha de comando docker logs tcat (a instalação pode demorar algum tempo, então pode aguardar ou executar docker logs -f tcat para acompanhar)
4. Abra http://localhost:80 no seu navegador e conclua a configuração fornecendo as suas informações da API do Twitter e o tipo de captura de tweets que deseja realizar.
5. Parabéns! Pode usar o menu admin para criar os seus primeiros bins de captura de tweets
6. No futuro, pode parar e iniciar o seu contentor TCAT com: docker stop tcat e docker start tcat

Personalização para o seu próprio servidor

A instalação Docker também permite alojar facilmente o TCAT num servidor. Além da variável de ambiente SERVERNAME, também pode usar o Let's Encrypt adicionando -e LETSENCRYPT=y e -e [email protected]. Deve também abrir a porta 443 para o Let's Encrypt funcionar. O comando completo pode ser algo como: docker run --publish 80:80 --publish 443:443 --volume tcat_data:/var/lib/mysql/ --detach --name tcat -e SERVERNAME=meu.site.pt -e LETSENCRYPT=y -e [email protected] digitalmethodsinitiative/tcat:1.0

Personalização adicional do TCAT

Finalmente, se desejar desenvolver o TCAT por si mesmo, pode clonar este repositório e criar a sua própria imagem.

1. Clone este repositório git clone https://github.com/digitalmethodsinitiative/dmi-tcat.git
2. Construa a imagem (a partir do diretório onde clonou o TCAT): docker image build --progress=plain -t tcat:1.0 .
3. Substitua digitalmethodsinitiative/tcat:1.0 por tcat:1.0 no seu comando docker run

Problemas

Por favor, use os modelos de issue ao relatar problemas e bugs.

Estado

Uma forma simpática de descrever que não temos muito

Contribuições

Estamos felizes em receber sugestões e melhorias.

Licença

Licença Apache Versão 2.0