DMI TCAT

Il Twitter Capture and Analysis Toolset (DMI-TCAT) della Digital Methods Initiative consente di recuperare e raccogliere tweet da Twitter e analizzarli in vari modi.

Installazione

Puoi trovare istruzioni dettagliate per l'installazione nel wiki

Requisiti

• Credenziali API di Twitter (possono essere ottenute da https://apps.twitter.com)
• Una delle seguenti distribuzioni Linux:
  • Ubuntu 18.04
  • Debian 9.*
• ... oppure Docker (sperimentale)

Debian e Ubuntu

Esegui:

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

Docker

Le nostre immagini Docker più recenti sono disponibili su Docker Hub.

1. Installa Docker Desktop e avvialo. Nota che su Windows potrebbe essere necessario assicurarsi che l'integrazione WSL (Windows Subsystem for Linux) sia abilitata in Docker. Puoi trovare questa opzione nelle impostazioni di Docker in Impostazioni -> Risorse -> Integrazione WSL -> Abilita integrazione con le distribuzioni richieste.

Installazione di base

2. Esegui il comando docker run --publish 80:80 --volume tcat_data:/var/lib/mysql/ --detach --name tcat digitalmethodsinitiative/tcat:1.0 e Docker scaricherà la versione 1.0 (o qualsiasi tag con cui sostituisci il "1.0")

• --publish HOST_PORT:80 permette di definire quale porta sulla rete host viene utilizzata. Se stai usando una porta diversa, potresti dover aggiungere -e SERVERNAME=localhost:HOST_PORT dove HOST_PORT è la porta desiderata in quanto viene utilizzata per i collegamenti interni nell'interfaccia TCAT.
• --volume volume_name:/var/lib/mysql/ assicura di poter riutilizzare facilmente il database MySQL di TCAT e recuperare i dati dopo aver smesso di usare TCAT

3. Apri i log per recuperare le informazioni di accesso tramite l'interfaccia di Docker o la riga di comando docker logs tcat (l'installazione potrebbe richiedere del tempo, quindi puoi attendere o eseguire docker logs -f tcat per seguire l'andamento)
4. Apri http://localhost:80 nel tuo browser e completa la configurazione fornendo le tue informazioni API di Twitter e il tipo di cattura dei tweet che desideri eseguire.
5. Congratulazioni! Puoi usare il menu admin per creare i tuoi primi contenitori di cattura tweet
6. In futuro, puoi fermare e avviare il tuo contenitore TCAT con: docker stop tcat e docker start tcat

Personalizzazione per il tuo server

L'installazione Docker ti permette anche di ospitare facilmente TCAT su un server. Oltre alla variabile d'ambiente SERVERNAME, puoi anche usare Let's Encrypt aggiungendo -e LETSENCRYPT=y e -e [email protected]. Dovresti anche aprire la porta 443 affinché Let's Encrypt funzioni. Il tuo comando completo potrebbe assomigliare a questo: 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

Ulteriore personalizzazione di TCAT

Infine, se desideri sviluppare TCAT autonomamente, puoi clonare questo repository e creare la tua immagine.

1. Clona questo repository git clone https://github.com/digitalmethodsinitiative/dmi-tcat.git
2. Costruisci l'immagine (dalla directory in cui hai clonato TCAT): docker image build --progress=plain -t tcat:1.0 .
3. Sostituisci digitalmethodsinitiative/tcat:1.0 con tcat:1.0 sopra nel tuo comando docker run

Problemi

Si prega di utilizzare i modelli di issue quando si segnalano problemi e bug.

Stato

Bel modo per descrivere il fatto che non abbiamo molto

Contribuire

Siamo felici di ricevere suggerimenti e miglioramenti.

Licenza

Apache License Version 2.0