La scheda Addon consente di collegare a un sito un database PostgreSQL gestito o un'istanza Redis gestita, senza dover costruire o mantenere un server dedicato. KapsuleHost lo predispone, fornisce una stringa di connessione e lo smantella in modo pulito quando lo rimuovi.
Dove si Trovano gli Addon
Apri Siti web, fai clic sul sito, apri il gruppo App nel menu laterale del sito e scegli Add-on. La pagina è intitolata Addon gestiti.
Due opzioni sono presenti nel catalogo:
| Addon | Uso tipico |
|---|---|
| PostgreSQL | Il datastore principale per un'applicazione che non utilizza MySQL |
| Redis | Caching, memorizzazione delle sessioni e code di lavoro in background |
Questi sono separati dal database MySQL fornito con un sito di hosting standard. Quello si trova nella scheda Database e non richiede alcuna predisposizione: vedi Connessione al Database Tramite un Tunnel SSH.
Richiedere un Addon
- Trova l'addon nella sezione Aggiungi un database gestito.
- Fai clic su Aggiungi al sito.
La richiesta viene registrata immediatamente e l'addon compare in I tuoi addon con un badge PENDING e la nota Waiting for provisioner. La pagina si aggiorna automaticamente ogni quindici secondi, quindi puoi lasciarla aperta.
Un processo in background elabora le richieste in sospeso ogni pochi minuti, crea un database dedicato e un utente dedicato per il tuo sito e scrive una stringa di connessione crittografata. Lo stato passa quindi a ACTIVE.
Richiedere o rimuovere un addon richiede il permesso sites:write. I membri del team con accesso in sola lettura possono vedere quali addon esistono e il loro stato, ma i pulsanti sono nascosti.
Uno di Ciascuno, Per Sito
Un sito può contenere un addon PostgreSQL e un addon Redis. Richiedere un secondo addon dello stesso tipo viene rifiutato con un messaggio che indica che è già predisposto, e il catalogo nasconde un'opzione una volta installata. Quando entrambi sono installati, la sezione del catalogo mostra All available addons are installed.
Interpretare lo Stato
| Stato | Significato |
|---|---|
| PENDING | Richiesto, in coda per la predisposizione |
| PROVISIONING | In fase di creazione |
| ACTIVE | Pronto all'uso |
| FAILED | La predisposizione non è stata completata; il motivo viene mostrato nella riga |
| DELETED | Rimosso, non più elencato |
Una riga FAILED mostra il testo effettivo dell'errore sotto di essa anziché un messaggio generico. Se il motivo non è qualcosa su cui puoi agire, citalo testualmente in un ticket di supporto: vedi Aprire un Ticket di Supporto.
Ottenere la Stringa di Connessione
Una volta che un addon è ACTIVE, la sua riga mostra una stringa di connessione mascherata con la password sostituita da puntini, in modo da poter confermare l'host e il nome del database a colpo d'occhio senza esporre la credenziale.
Fai clic su Copia connessione per copiare la stringa di connessione completa negli appunti. Viene decrittografata lato server per quella singola richiesta e non viene mai mostrata sulla pagina, così che condivisioni dello schermo e screenshot non la espongano. Ogni rivelazione viene registrata nel registro delle attività del sito e compare nel Registro delle Attività del Sito.
La stringa è nella consueta forma URL per ciascun motore, e contiene host, porta, utente, password e nome del database creati per questo sito.
Usarla Nella Tua Applicazione
Incolla la stringa di connessione ovunque la tua applicazione legga la propria configurazione. Su un sito Node.js, il posto giusto è la scheda Secrets, sotto una chiave come DATABASE_URL o REDIS_URL, nell'ambiente production.
Non inserire la stringa di connessione come valore fisso in un file che carichi su un repository. Contiene una password attiva. Se finisce su un remote git, va trattata come compromessa, e l'unica soluzione reale è eliminare l'addon e richiederne uno nuovo, perché la credenziale non può essere ruotata direttamente dal pannello.
Rimuovere un Addon
Fai clic su Delete sulla riga. KPanel chiede conferma ed è esplicito su cosa succede: questo rimuove il database gestito e i dati sono irrecuperabili.
La riga viene contrassegnata come eliminata immediatamente e il sistema di predisposizione smantella il database e l'utente sottostanti al passaggio successivo. Le connessioni esistenti vengono terminate come parte di questo smantellamento.
Non viene effettuato alcun backup di un addon gestito al momento dell'eliminazione, e non è possibile annullare l'operazione. Se c'è qualcosa al suo interno che vuoi conservare, esportalo prima con pg_dump o redis-cli --rdb mentre l'addon è ancora attivo e la stringa di connessione funziona ancora.
Scegliere Tra le Opzioni
Usa PostgreSQL quando la tua applicazione necessita di un database relazionale ed è scritta per Postgres: vincoli rigorosi, transazioni, colonne JSON e ricerca full-text che altrimenti dovresti aggiungere separatamente.
Usa Redis per cose che possono scomparire senza problemi: frammenti in cache, contatori di rate-limit, memorizzazione delle sessioni e code di lavoro. Trattalo come veloce ma volatile, non come un sistema di registrazione permanente.
Usa il database MySQL integrato per WordPress e per qualsiasi cosa già scritta per MySQL. Aggiungere un addon Postgres a un sito WordPress non ha alcuna utilità, perché WordPress non può comunicare con esso.
Risoluzione dei Problemi
L'addon è rimasto in PENDING per molto tempo. Il sistema di predisposizione funziona secondo una pianificazione, non istantaneamente. Lascia la pagina aperta, dato che si aggiorna da sola, e controlla di nuovo più tardi. Se non è cambiato dopo diversi passaggi, apri un ticket di supporto indicando il dominio del sito e il tipo di addon.
La predisposizione è FAILED. Leggi l'errore sulla riga. Elimina l'addon non riuscito e richiedilo di nuovo, operazione sicura: una riga fallita non ha mai avuto un database attivo dietro di sé.
Copia connessione non fa nulla. Alcuni browser bloccano la scrittura negli appunti quando la scheda non è attiva. Fai clic prima sulla pagina, poi fai nuovamente clic sul pulsante.
L'applicazione non riesce a connettersi. Controlla tre cose in ordine: che lo stato dell'addon sia ACTIVE, che tu abbia copiato la stringa anziché digitarla nuovamente, e che la tua applicazione stia leggendo il valore effettivamente impostato e non uno obsoleto di un deploy precedente. Di solito è necessario un riavvio prima che la nuova configurazione venga rilevata.
Le connessioni vengono rifiutate dopo un nuovo deploy. Conferma che la stringa di connessione nella tua configurazione corrisponda ancora a quella mostrata in questa pagina. Eliminare e richiedere nuovamente un addon crea un nuovo utente e una nuova password, quindi una stringa vecchia non funzionerà.
Prossimi Passi
- Conservare i Secret dell'App Per un Sito, il posto giusto dove conservare la stringa di connessione.
- Connessione al Database Tramite un Tunnel SSH per il database MySQL integrato.
- Impostazioni del Sito per il resto della configurazione a livello di sito.