KoaVM
Pagine della guida

Guida · Per gli amministratori

Self-service e uso a ore

Dalla 0.12, oltre alle VPS dei piani, puoi vendere un pacchetto di risorse: il cliente crea, cambia piano e cancella da solo le sue VPS, fino ai limiti del pacchetto. Il self-service è spento finché non lo accendi: se vendi solo VPS predefinite non cambia niente, né per te né per i clienti.

Accenderlo

  1. Impostazioni › Self-service: spunta «I clienti con un pacchetto creano da soli le loro VPS».
  2. Clienti e piani › piano: spunta «Offerto nel self-service» sui piani che i clienti possono scegliere. Gli altri piani restano solo per le VPS che vendi tu.
  3. Clienti e piani › cliente › Self-service: i limiti del pacchetto (VPS, vCPU, RAM, disco; 0 = senza limite), i piani compresi (nessuno = tutti quelli offerti nel self-service) e i nodi (nessuno = tutti i nodi del pannello). Il cliente sceglie la città, non il nodo.

Nell'elenco dei clienti chi ha un pacchetto ha l'etichetta «Self-service» con il numero di VPS; i piani offerti hanno l'etichetta «self-service».

Cosa fa il cliente

  • In Servizi vede il pacchetto, quanto ne ha usato e Crea VPS: piano, città, sistema, applicazione al primo avvio, password, chiavi SSH salvate, script al primo avvio, rete privata. I piani che non ci stanno nel pacchetto restano visibili ma spenti, con il motivo.
  • Nella pagina di una VPS del pacchetto: Cambia piano (solo i piani del pacchetto; il disco non si riduce) ed Elimina VPS (scrivendo il nome host).
  • Le VPS vendute a parte (da te, da WHMCS o da KoaBilling) non contano nel pacchetto e il cliente non le può cambiare né cancellare.
  • I volumi staccati del cliente contano nel disco del pacchetto (occupano ancora spazio).
  • Le VPS del pacchetto vanno solo sui nodi del pannello, non sulle zone dei fornitori.

Nella pagina della VPS, riquadro Amministrazione, una VPS del pacchetto ha «Origine: creata dal cliente nel pacchetto self-service».

Sospendere e togliere il pacchetto

  • Sospeso (nel pacchetto): le VPS del pacchetto si spengono con il motivo «fatturazione» e non se ne creano di nuove; togliendo la spunta si riaccendono.
  • Togli il pacchetto: scegli se tenere le VPS (diventano VPS normali, il cliente non le può più cambiare) o cancellarle (con i dischi, gli snapshot e i backup; va confermato scrivendo l'email del cliente).
  • I rivenditori non hanno un pacchetto: creano già le VPS dalla loro pagina, dentro i loro limiti. Il cliente di un rivenditore può avere un pacchetto: valgono anche i limiti, i piani e i nodi del rivenditore.

Chiavi SSH e script al primo avvio

Valgono per tutti, anche per le VPS che crei tu:

  • Il mio account › Chiavi SSH: le chiavi pubbliche salvate si scelgono con un clic quando crei o reinstalli una VPS.
  • Script al primo avvio (Linux, al massimo 64 KB): gira una volta come root, dopo la rete e dopo l'applicazione scelta (se c'è). Il registro è in /var/log/koavm-script.log, il codice di uscita in /var/lib/koavm-script/exit. Dall'API: user_script nella creazione.

Uso a ore

Ogni ora il pannello conta, per ogni VPS (anche quelle vendute a parte) e per ogni volume staccato, le risorse assegnate: ore, vCPU-ore, RAM-ore, disco-ore (con i dischi collegati) e ore di IPv4. Le righe sono per mese e si tengono 24 mesi; le ore in cui il pannello è spento non si contano. Una VPS cancellata resta nell'uso del mese.

  • Il pacchetto mostra l'uso del mese al cliente e a te.
  • GET /usage?month=AAAA-MM dell'API dà il dettaglio riga per riga (client_id per un cliente, self_service=1 per le sole VPS dei pacchetti): KoaBilling lo legge per fatturare a ore.
  • Il modulo WHMCS (1.5) ha il tipo di prodotto «pacchetto»: crea il cliente e il pacchetto, sospende, riattiva, cambia i limiti e cancella; in più offre all'Usage Billing di WHMCS le ore del mese (VPS, vCPU, RAM, disco) da mettere a prezzo nel prodotto.

Dall'API

ChiamataCosa fa
GET /clients/{id}/quotapacchetto del cliente, uso e ore del mese
PUT /clients/{id}/quotadà o cambia il pacchetto: max_vps, max_vcpu, max_ram_mb, max_disk_gb, plans, nodes, suspended, external_id
DELETE /clients/{id}/quotatoglie il pacchetto; con ?delete_vps=1&confirm=<email> cancella anche le sue VPS
GET /usage?month=AAAA-MMuso a ore del mese (client_id, self_service=1)
POST /vpsanche ssh_key_ids (chiavi salvate di chi ha la chiave API) e user_script

Vedi anche Clienti e VPS e API e integrazioni.