- Installazione di Node.js
- Installazione di npm
- Installazione di Postgres 10
- Download del pacchetto da github e configurazione
La versione di riferimento è Node.js 16.4.0. Per installare la versione si può far riferimento alla documentazione di Node.js, oppure seguire i seguenti passi se si tratta di ambiente Linux Ubuntu.
curl -sL https://deb.nodesource.com/setup_16.x | sudo bash
sudo apt-get install -y nodejs
Per installare pm2 è consigliabile aggiornare prima la versione di npm
npm install npm@latest -g
e poi installare pm2
npm install pm2 -g
- installazione di Postgres
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add - sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ $(lsb_release -sc)-pgdg main" > /etc/apt/sources.list.d/PostgreSQL.list' apt-get -y update apt-get install postgresql-10
Per il download del pacchetto su linux da riga di comando è possibile usare
wget https://github.com/progamma/instant-developer-platform/archive/master.zip
Dopodiché è necessario:
- decomprimere la cartella sull'hd. In questa guida si prenderà in considerazione l'installazione in root.
- rinominare instant-developer-platform-master in idcloud.
- rinominare e spostare public-html in idcloud/idserver.
- rimuovere idcloud/nbproject
- creare le cartelle idcloud/config, idcloud/idserver/apps/apps, idcloud/idserver/apps/db, idcloud/idserver/apps/backups, idcloud/node_modules, idcloud/idserver/log
- copiare config-example.json in idcloud/config/config.json
- editare idcloud/config/config.json
- appDirectory = /idcloud/idserver/apps
- alias = lista di ip o domini del server separati da ,
- dbUser = postgres username
- dbPassword = postgres password
- dbUser = postgres username
- Aggiornare i node modules
- Aggiungere l'utente e il gruppo indert
- dare i permessi di scrittura a postgres su idclous/apps/db - vedi [#Postgres e permessi](Postgres e permessi)
- creare un database postgress di nome root
- Avviare server.js con PM2
chown postgres:postgres /idcloud/idserver/apps/db chmod 700 /idcloud/idserver/apps/db
Alla prima installazione e per tutti i nuovi aggiornamenti è necessari aggiornare i pacchetti node modules per allinearli alla definizione contenuta in package.json. Andare in idcloud/idserver e lanciare
cd /idcloud/idserver npm install
In caso di errori nell'aggiornamento tramite il comando npm install è necessario procedere con l'installazione manuale dei pacchetti che falliscono l'aggiornamento, cercando di risolvere i problemi uno per uno.
Di seguito alcuni problemi noti all'installazione di pacchetti specifici:
- puppeteer@2.1.1 - alcune distribuzioni di linux dànno errore con l'installazione di puppeteer@2.1.1, dando errore Error: EACCES: permission denied, mkdir '/idcloud/idserver/node_modules/puppeteer/.local-chromium'. In questo caso una possibile soluzione è installarlo tramite il comando sudo npm install puppeteer#2.1.1 --unsafe-perm=true.
sudo adduser indert sudo chown -R indert:indert /idcloud sudo chmod -R 755 /idcloud
Per avviare server.js con PM2 e impostare il reboot automatico eseguire i comandi:
cd /idcloud/idserver/server pm2 start server.js pm2 save pm2 startup ubuntu
È possibile scaricare una build da Instant Developer Cloud e installarla sulla propria piattaforma
- scaricare la build e decoprimerla in idcloud/apps/apps/app-name
- editare idcloud/config/config.json
- apps = [{ "cl" : "Node.App", "name" : "app-name", "date" : "current-date in ISO string", "stopped" : false}]
Per attivare la server session è necessario editare idcloud/config/config.json impostando a true la proprietà startSS dei parametri dell'applicazione.
{
"cl" : "Node.App",
"name" : "app-name",
"date" : "current-date in ISO string",
"stopped" : false,
"startSS": true
}
Per attivare il protocollo https ed utilizzare i propri certificati SSL sul server, è sufficiente copiare i file sul server stesso e modificare opportunamente il file idcloud/config/config.json.
Ipotizzando che il server risponda all'indirizzo https://mysrv.mydomain.it sulla porta default 443 e che i file dei certificati siano stati copiati nella directory /idcloud/config/cert il file idcloud/config/config.json deve essere modificato nel seguente modo:
"domain": "mydomain.com",
"alias" : "mysrv.mydomain.it",
"protocol": "https",
"portHttps": 443,
"SSLCert": "/idcloud/config/cert/mydomain_it_certificate.crt",
"SSLKey": "/idcloud/config/cert/mydomain_it_private.key",
"SSLCABundles": [
"/idcloud/config/cert/mydomain_it_ca_bundle.crt"
],
È possibile aggiungere al file di configurazione la proprietà customSSLCerts per fare in modo di utilizzare uno specifico certificato a seconda della URL di destinazione del server.
Se ad esempio il server è configurato, tramite DNS, a rispondere anche all’indirizzo https://mysrv.myotherdomain.it, modificando la proprietà alias ed aggiungendo customSSLCerts è possibile utilizzare un diverso certificato se il server è stato raggiunto utilizzando questo nome. Ad esempio:
“alias” : “mysrv.mydomain.it, mysrv.myotherdomain.it”,
…
"customSSLCerts": [{
"SSLDomain": "myotherdomain.it",
"SSLCert": "/idcloud/config/cert/myotherdomain_it_certificate.crt",
"SSLKey": "/idcloud/config/cert/myotherdomain_it_private.key",
"SSLCABundles": [
"/idcloud/config/cert/myotherdomain_it_ca_bundle.crt"
]
}],
È possibile impostare quale applicazione deve essere eseguita impostando nel file idcloud/config/config.json la proprietà alias aggiungendo il nome dell'applicazione al nome del dominio o indirizzo ip preceduta dal carattere '|'. Ad esempio:
"alias" : "mysrv.mydomain.it|app-name"
Per configurare i valori di default per i worker delle applicazioni installate, è necessario modificare il file config.json aggiungendo i valori desiderati per le proprietà maxAppUsers, minAppUsersPerWorker e maxAppWorkers, come nel seguente esempio:
"maxAppUsers": 1000,
"minAppUsersPerWorker": 50,
"maxAppWorkers": 4,
Specificando il maxAppUsers è possibile definire il numero di processi worker che verranno creati dal server per gestire le sessioni di ogni applicazione.
minAppUsersPerWorker indica qual è il numero di sessioni che ogni worker gestirà prima che venga avviato un nuovo processo che prenda in carico nuove sessioni client.
maxAppWorkers indica il numero massimo di sessioni gestite contemporaneamente da un’applicazione prima che questa rifiuti l'avvio di una nuova sessione.
In questo caso il valore tiene conto della somma di tutte le sessioni dei worker della stessa app.
L’accesso al Servizio di Supporto Tecnico non è consentito per richieste di supporto relative a problematiche riguardanti la pubblicazione su server manuale.