Skip to content

Benvenuti in ISAA Wiki

Questa Wiki contiene i dettagli implementativi dell'infrastruttura della galassia di siti ISAA, e le istruzioni necessarie per il deployment dell'infrastruttura della galassia di siti ISAA su una macchina virtuale basata su Linux Ubuntu.

Introduzione

L'infrastruttura della galassia di siti ISAA è stata progettata per girare su una macchina virtuale linux basata su Ubuntu, preferibilmente aggiornata all'ultima LTS disponibile.

L'infrastruttura si basa su uno stack di tool che comprendono docker, docker compose, git, bash, s3cmd, mkdocs, più i vari yaml file per docker compose che definiscono i singoli servizi implementati.

Overview dell'infrastruttura

L'infrastruttura dei siti ISAA è basata su tre pilastri fondamentali:

  • il repository Infrastructure, che contiene la definizione dei container dei siti/servizi della galassia ISAA, insieme ai relativi script di servizio;

  • il repository wordpress_isaa, con la definizione dell'immagine Docker sulla quale si basano i siti Wordpress della galassia ISAA;

  • le directory con i file persistenti dei vari servizi, salvate nel sistema di storage Spaces di DigitalOcean.

Layout del progetto

infrastructure/     # File yml di configurazione dei servizi e scripts
    scripts/        # Script di vario utilizzo
        backup_persistent.bash
        do
        dumpdb.bash
        ...
    services/       # Servizi operativi, attivi di default
        astronauticast/
        astronautinews/
        traefik2/
        ...
    staging/        # Servizi operativi, momentaneamente "parcheggiati"
        streaming/
        ...
    templates/      # File di configurazione condivisi tra i diversi servizi
        static-web-server.yml
        wordpress-no-mariadb.yml
        wordpress-standard.yml
    testing/        # Servizi non funzionanti o in sviluppo
        ...
    starta_la_baracca.bash
    stoppa_la_baracca.bash
    sourceme.env
    websites.txt
persistent/         # File persistenti dei vari servizi
    astronauticast/
    astronauticon/
    astronautinews/
    ...

Commands

  • mkdocs new [dir-name] - Create a new project.
  • mkdocs serve - Start the live-reloading docs server.
  • mkdocs build - Build the documentation site.
  • mkdocs -h - Print help message and exit.

Beer! 🍺

Warning!

Do not drink too much!