Quick Start

Come iniziare con la nostra piattaforma in ML/AI Kaspian.



Questo documento descrive la installazione completa (lunga) di Kaspian sul tuo server personale: se vuoi partire con la versione cloud (rapida) vai invece a questa pagina.

Cosa serve prima di iniziare

  • Server Linux ospitato su Linode, Digital Ocean, Amazon AWS o simili
  • Coppia di chiavi SSH per accedere a Github dal terminale di Linux
  • Git installato sul server Linux
  • Account attivo su Github
Perchè usare GIT? Git è il software più usato per il controllo e il download dei programmi in versione sorgente. Github e Gitlab prendono il nome da questo tool, in alternativa poreste usare il comando wget per scaricare i file zippati da Terminale.

Come installare la nostra piattaforma sul vostro server Linux

Kaspian funziona con la tecnologia a microkernel e si appoggia a docker e docker-compose: è necessario installare entrambi i tools per poi lanciare le routine di build

Come installare Docker e docker-compose 

sudo apt update
sudo apt install apt-transport-https ca-certificates curl software-properties-common`
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
apt-cache policy docker-ce
mkdir -p ~/.docker/cli-plugins/
curl -SL https://github.com/docker/compose/releases/download/v2.3.3/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-composee

$ chmod +x ~/.docker/cli-plugins/docker-compose
$ curl -SL https://github.com/docker/compose/releases/download/v2.3.3/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-composee

Infine si deve installare il pacchetto di Docker

$ sudo apt install docker-ce

Docker adesso dovrebbe essere installato con il daemon attivo e settato per ripartire in automatico dopo ogni reboot. Per controllare basta eseguire:

$ sudo systemctl status docker

e dovrebbe apparire un output del tipo 👉


docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Tue 2023-07-04 09:51:25 UTC; 1 weeks 0 days ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 747 (dockerd)
      Tasks: 92
     Memory: 84.9M
     CGroup: /system.slice/docker.service
             ├─   747 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock
             ├─  1018 /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 9000 -container-ip 172.19.0.2 -container-port 9000
             ├─  1022 /usr/bin/docker-proxy -proto tcp -host-ip :: -host-port 9000 -container-ip 172.19.0.2 -container-port 9000
             ├─  1079 /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 8004 -container-ip 172.19.0.2 -container-port 8004
             ├─  1091 /usr/bin/docker-proxy -proto tcp -host-ip :: -host-port 8004 -container-ip 172.19.0.2 -container-port 8004
             ├─  8370 /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 443 -container-ip 172.18.0.8 -container-port 443
             ├─  8375 /usr/bin/docker-proxy -proto tcp -host-ip :: -host-port 443 -container-ip 172.18.0.8 -container-port 443
             ├─  8390 /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 80 -container-ip 172.18.0.8 -container-port 80
             ├─  8395 /usr/bin/docker-proxy -proto tcp -host-ip :: -host-port 80 -container-ip 172.18.0.8 -container-port 80
             ├─921235 /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 8005 -container-ip 172.18.0.11 -container-port 8005
             └─921240 /usr/bin/docker-proxy -proto tcp -host-ip :: -host-port 8005 -container-ip 172.18.0.11 -container-port 8005" />}}

Per le vedere le opzioni dispinbili basta scrivere:

$ docker docker-subcommand --help

e per le impostazione di sistema:

$ docker info

Docker è disponibile in varie versioni e potete selezionare la più aggiornata in questa pagina del sito.

Installare docker-compose

Per installare docker-compose oltre a Docker funzionante serve:

git clone https://github.com/h-enk/doks-child-theme.git my-doks-site

Starter theme

  • Intended for intermediate to advanced users
  • Intended for major customizations
git clone https://github.com/h-enk/doks.git my-doks-site
Help me choose Not sure which one is for you? Pick the child theme.

Fare il rebuild di Kaspian con Docker 

docker-compose down
docker-compose rm -f
docker-compose pull
docker-compose up --build -d
docker-compose logs -f

Installare le librerie JS 

npm install

Controllare la installazione

La creazione della piattaforma è gestita interamente con docker, ma prima di collegare sensori e altro è necessario testare il sistema, in particolare il software di cache REDIS e il database Postgres.

docker ps

se tutto il sitema è stato installato correttamente dovrebbe qualcosa di simile a questo:

CONTAINER ID   IMAGE                                            COMMAND                  CREATED         STATUS       PORTS                                                                                  NAMES
8b3ad08c73aa   k4_celery-beat                                   "/code/docker-entryp…"   2 hours ago     Up 2 hours   8005/tcp                                                                               k4_celery-beat_1
f72c057c6b70   k4_celery                                        "/code/docker-entryp…"   2 hours ago     Up 2 hours   8005/tcp                                                                               k4_celery_1
8db42dcf3304   k4_app                                           "/code/docker-entryp…"   2 hours ago     Up 2 hours   0.0.0.0:8005->8005/tcp, :::8005->8005/tcp                                              k4_app_1
5d6d7a3149ed   postgres:9.6                                     "docker-entrypoint.s…"   2 hours ago     Up 2 hours   5432/tcp                                                                               k4_db_1
31b16a25b5e0   redis:3.0                                        "docker-entrypoint.s…"   2 hours ago     Up 2 hours   6379/tcp
La piattaforma in cloud →