Smartkit Rest API è la Smartkit APP di Smeup Rest API.
Software versions:
Application | App Version | Payara Version |
---|---|---|
smeup-rest-api | 2.0.1 | Micro 6.2023.4-jdk17 |
Features:
Tipologia Hardware | Requisito minimo |
---|---|
CPU | 4 CPU * |
Memoria | 8 GB * |
Disco | 100 GB |
*: valore per una singola installazione
Attraverso Smartkit-CLI, lanciare il comando:
smartkit install smartkit-rest-api
Per scaricare e installare l'ultima versione dello smartkit-rest-api.
Verrà creata la directory /home/smeup/smartkit/smartkit-rest-api
Per interagire con lo smarktit-rest-api, posizionarsi nella directory:
cd /home/smeup/smartkit/smartkit-rest-api/scripts
E successivamente lanciare il comando:
./smart.sh -h
Verrà visualizzata la lista completa dei comandi eseguibili:
./smart.sh -h
Usage: ./smart.sh command [ parameters command ]
Commands:
detail
releases
wupnet-list
wupnet-create-config <ID> [VERSION]
wupnet-update-config <ID> [VERSION]
wupnet-apply-config <ID> [VERSION]
wupnet-detail <ID>
wupnet-stop <ID>
wupnet-start <ID>
wupnet-backup <ID>
wupnet-destroy <ID>
wupnet-remove <ID>
wupnet-restore <ID> <BACKUPID>
/home/smeup/smartkit/backups
Il BACKUPID sarà il codice che viene visualizzato sulla cartella backuppata e visualizzato a video.Con 'wupnet' si intende una singola istanza di smartkit-rest-api - è possibile installare N wupnet da un singolo smartkit-rest-api.
Vediamo gli step per l'installazione di una wupnet:
Ci spostiamo sulla directory /home/smeup/smartkit/smartkit-rest-api/scripts
Lanciamo il comando di creazione wupnet:
./smart.sh wupnet-create-config prod01
Abbiamo creato un'istanza di wupnet (wn-prod01), identificata dal suo ID (prod01).
è creata una cartella nella directory smartkit-rest-api, con il nome wn-<ID>
(in questo caso /home/smeup/smartkit/smartkit-rest-api/wn-prod01
) con i file necessari al funzionamento e alla configurazione di questa istanza.
Ora possiamo configurare la nostra wupnet. Per farlo lanciamo il comando:
nano /home/smeup/smartkit/smartkit-rest-api/wn-prod01/env/custom.tfvars
In questo file si trovano tutte le variabili configurabili della wupnet.
NB: i parametry identificati nella sezione "MANDATORY" sono obbligatori e devono essere necessariamente configurati. Gli altri sono opzionali.
Una volta compilato il file di configurazione, avviamo la wupnet tornando nella directory
/home/smeup/smartkit/smartkit-rest-api/scripts
E lanciando il comando:
./smart.sh wupnet-apply-config prod01
Una volta che abbiamo creato, configurato e avviato la wupnet, possiamo controllare che stia funzionando correttamente.
Per farlo lanciamo il comando:
./smart.sh wupnet-detail prod01
Che stamperà a schermo una serie di informazioni sullo stato delle varie applicazioni interne allo smartkit-rest-api.
smeup-rest-api ci mette qualche minuto per avviarsi - nel caso sia "KO" subito dopo l'avvio della wupnet, aspettare qualche minuto e lanciare nuovamente il comando.
Aggiornare lo smartkit-rest-api significa aggiornare lo strumento che facilita l’installazione e la manutenzione di una o più wupnet (istanze di smeup-rest-api). Per aggiornare la singola istanza andrà effettuato l’aggiornamento della singola wupnet, come descritto nelle sezione successiva "Aggiornamento versione wupnet".
L'aggiornamento di versione di smartkit-rest-api NON provoca downtime per le singole wupnet
Per controllare se ci sono nuove versioni di smartkit-rest-api possiamo lanciare il comando della Smartkit CLI:
smartkit detail smartkit-rest-api
Per aggiornare la versione di smartkit-rest-api possiamo lanciare il comando della Smartkit CLI:
smartkit install smartkit-rest-api
al prompt Found an old version of smartkit-rest-api. Update it's scripts and docs (y/n)?
rispondere y
e premere invio.
L'aggiornamento di versione di wupnet comporta un breve periodo di downtime (pochi minuti) della specifica wupnet.
Per aggiornare la versione di una specifica wupnet è necessario spostarsi nella directory:
/home/smeup/smartkit/smartkit-rest-api/scripts
per aggiornare all'ultima versione disponibile lanciare il comando:
./smart.sh wupnet-update-config <WUPNET-ID>
per aggiornare a una versione specifica lanciare il comando:
./smart.sh wupnet-update-config <WUPNET-ID> <VERSION>
Il comando effettua un backup della directory della wupnet con id <WUPNET-ID>.
Successivamente la wupnet viene "distrutta", quindi l'istanza di smeup-rest-api sarà momentaneamente non disponibile.
Opzionalmente, in questo momento si possono modificare delle configurazioni della wupnet, editando il file:
/home/smeup/smartkit/smartkit-rest-api/<WUPNET-ID>/env/custom.tfvars
Per concludere il processo di aggiornamento è necessario lanciare il comando:
./smart.sh wupnet-apply-config <WUPNET-ID>
Per aggiornare le configurazioni di una wupnet, basta modificare il file:
/home/smeup/smartkit/smartkit-rest-api/wn-<WUPNET-ID>/env/custom.tfvars
e successivamente lanciare il comando
./smart.sh wupnet-apply-config <WUPNET-ID>
è possibile trovare log specifici di ogni applicazione nella cartella var del rispettivo container, es:
/home/smeup/smartkit/smartkit-rest-api/wn-prod01/containers/smeup-rest-api/logs
Un altro modo per vedere i log delle applicazioni è usare Docker:
# troviamo il container di cui vogliamo vedere i log dalla lista dei container attivi:
docker ps
# vediamo i log dello specifico container
docker logs <ID_CONTAINER_DOCKER>