Skip to content

Mettere online un server di annotazione

Come mettere online un server di annotazione Potato per uno studio reale: opzioni di autenticazione, HTTPS e configurazione di produzione con Docker o un reverse proxy.

Condurre uno studio di annotazione sul serio significa spostare Potato dal tuo portatile a un server raggiungibile dagli annotatori, con il metodo di accesso adatto e HTTPS a proteggere credenziali e dati. Questa guida riguarda le scelte di deployment; per la procedura passo passo vedi Sviluppo in locale e la sezione sul deployment.

Scegli un metodo di autenticazione

Adatta l'accesso alla popolazione dei tuoi annotatori:

  • Senza password: l'annotatore inserisce solo un nome utente. Va bene per team interni di cui ti fidi o per studi in crowdsourcing dove la piattaforma ha già identificato il worker. Vedi Accesso senza password.
  • Password: una lista di utenti gestita, per un insieme fisso di annotatori con nome e cognome.
  • OAuth / SSO: accesso con Google o GitHub, oppure con il single sign-on del tuo ateneo. È la scelta migliore per i deployment più grandi o istituzionali.

Mettilo dietro HTTPS

Qualsiasi deployment reale dovrebbe servire in HTTPS, così nomi utente, risposte ed eventuali dati personali viaggiano cifrati. Lo schema abituale è un reverse proxy come nginx che gestisce il TLS davanti a Potato, oppure una piattaforma di hosting che se ne occupa al posto tuo.

Uno stack di produzione tipico

  • Potato in esecuzione dentro un processo server di produzione.
  • nginx (o simili) come reverse proxy per il TLS e i file statici.
  • Docker per impacchettare tutto in modo riproducibile, se lavori con i container.
  • Un nome DNS pubblico con un certificato (Let's Encrypt è gratuito).

Prova prima in locale la configurazione esatta, poi metti online la stessa configurazione: le uniche cose che cambiano sono l'URL, l'autenticazione e il TLS.

Gestire lo studio

  • Segui avanzamento, ritmo di lavoro e accordo dalla dashboard di amministrazione.
  • Fai backup regolari della cartella di output; è lì che vengono scritte le annotazioni.
  • Per gli studi in crowdsourcing, vedi Condurre uno studio su Prolific e MTurk.

Approfondimenti