Progetto di Ingegneria del Software A.A. 2018 - 2019
Butterfly è un software che permette la configurazione dell’inoltro dei messaggi da parte di Redmine e Gitlab agli utenti tramite Telegram ed Email, passando per il Broker Apache Kafka che comunica con un Gestore Personale che contiene tutte le preferenze degli utenti e quindi la logica degli inoltri. Questo prodotto è stato sviluppato come progetto di gruppo per il progetto della materia Ingegneria del Software dell’Anno Accademico 2018/2019 dei professori Tullio Vardanega e Riccardo Cardin.
Il gruppo che lo ha sviluppato si chiama AlphaSix ed è composto da:
La figura proponente di questo progetto è Imola Informatica che ha fornito il seguente capitolato che descrive i requisiti richiesti per il Butterfly:
Butterfly utilizza l’architettura Publisher Subscriber ed è stato pensato in maniera da suddividerlo in più sottosistemi: quello dei Producer, dei Consumer, del Gestore Personale e del Broker.
Sotto richiesta dell’azienda proponente, Butterfly è stato sviluppato in maniera tale che funzioni su container Docker e la loro istanziazione venga fatta tramite un gestore di oggetti Kubernetes come Rancher. Il seguente README fa riferimento ad un sistema nel quale questi due sono correttamente installati e configurati.
Le immagini di Docker corrispondenti ai vari container sono presenti anche su DockerHub dove sono state configurate le Automated Builds sul branch master.
Producer GitLab : 
Producer Redmine : 
Consumer telegram : 
Consumer mail : 
Gestore Personale Client : 
Gestore Personale : 
Abbiamo sviluppato i Dockerfile in maniera tale da suddividere il progetto in 6 container:
Questi vengono descritti in particolare nelle rispettive cartelle in cui è anche contenuto il codice oltre che nei documenti prodotta insieme al software.
Su Rancher abbiamo pensato di suddividere un nodo che ci è stato fornito dall’azienda come ambiente di lavoro in maniera tale che ci fossero i seguenti namespace:
Nel container di Redmine è necessario installare correttamente il plugin relativo all’invio dei webhook.
È possibile configurare ciascun componente del prodotto tramite file di configurazione oppure variabili di ambiente (le seconde hanno la priorità) descritte per ciascuno dei servizi.
Per vedere l’installazione e la configurazione che è stata effettuata per la proponente vi rimandiamo ai documenti Manuale Utente e Manuale Sviluppatore rilasciati insieme al prodotto.