Installazione di un'app sul tuo sito

The Apps install wizard takes three steps: configure the admin account and site settings, review what is about to happen, then watch the install run and collect your login details.

La procedura guidata di installazione delle app prevede tre fasi: configurare l'account amministratore e le impostazioni del sito, verificare cosa sta per accadere, quindi osservare l'installazione in corso e raccogliere i dati di accesso.

Prima di Iniziare

Ti serve una cosa: un sito web attivo sul tuo account. La procedura guidata installa su un sito che già possiedi, non ne crea uno nuovo. Se non ne hai nessuno, la procedura guidata te lo comunica e ti fornisce un collegamento per crearne uno. Vedi Creazione del Tuo Primo Sito Web.

Hai bisogno anche del permesso apps:write, che hanno i proprietari e gli amministratori dell'account.

Fai un backup prima di installare su un sito che contiene già contenuti. La procedura guidata ha una rete di sicurezza per un sito che contiene già un'app, descritta di seguito, ma un punto di ripristino manuale creato deliberatamente vale sempre più di uno creato automaticamente. Vedi Esecuzione di un Backup.

Accesso alla Procedura Guidata

Fai clic su Apps nella barra laterale di KPanel.
Fai clic sull'app desiderata.
Fai clic su Installa [app] nel pannello sulla destra.

L'indirizzo diretto è /apps/<app-slug>/install.

La procedura guidata di installazione dell'app in KPanel

Fase 1: Configurazione

La procedura guidata mostra l'app, quindi quattro gruppi di campi. Un avviso Aggiornamento del piano consigliato appare in alto se l'app suggerisce un livello di piano superiore a quello che hai: è solo un consiglio e l'installazione procede comunque.

Posizione

Installa su sito. Scegli tra i tuoi siti attivi. Qui è dove vivrà l'app.

Account Amministratore

Nome utente amministratore. Impostazione predefinita admin. Questo è il nome utente con cui accederai, e potrai aggiungere altri utenti in seguito.
Password amministratore. Una password sicura di 16 caratteri viene generata per te nel momento in cui la pagina si carica. Mostra la rivela e Genera ne crea una nuova. Puoi anche digitare la tua, ma deve essere almeno 8 caratteri.
Email amministratore. Facoltativa. Usata per l'accesso e il ripristino della password. Se lasciata vuota, viene utilizzata l'email del tuo account.

Salva la password amministratore prima di uscire dalla procedura guidata. Viene mostrata nella schermata di revisione e di nuovo nella schermata di successo, e poi scompare. Kapsule non conserva una copia che tu possa recuperare in seguito, quindi perderla significa reimpostare la password attraverso l'app stessa.

Impostazioni del Sito

Nome del sito, dove l'app lo richiede.
Lingua. La lingua in cui l'app è impostata, scelta tra sedici opzioni che includono English (US), English (UK), Te Reo Māori e le principali lingue europee e asiatiche. Questa imposta la lingua dei contenuti dell'app stessa, non quella di KPanel.

Database

Mostrato solo per le app che ne hanno bisogno. La procedura guidata suggerisce un nome di database derivato dal tuo dominio. Solo lettere e numeri, niente trattini bassi o trattini: il campo lo applica mentre digiti. Cambialo se vuoi.

Le app che necessitano di un database lo hanno automaticamente fornito come parte dell'installazione.

Alcune app aggiungono campi extra propri sotto questo, definiti dall'app stessa, con testo di aiuto dove applicabile. I campi obbligatori sono contrassegnati con un asterisco e Continua rimane disabilitato finché non sono tutti compilati.

In fondo la procedura guidata mostra il riepilogo delle risorse per questa app: tempo di installazione previsto, RAM minima e se viene aggiunto un database.

Fai clic su Continua.

Fase 2: Revisione e Conferma

La schermata di revisione ricapitola le decisioni in un unico elenco: app, sito web, nome del sito, nome utente amministratore, password amministratore (con interruttore mostra o nascondi), email amministratore, lingua e nome del database. Il sottotitolo lo dice chiaramente: nulla viene installato finché non confirmi.

Modifica torna indietro per cambiare qualcosa.
Conferma e installa avvia il lavoro.

Usa la schermata di revisione per il controllo più importante: la riga Sito Web. L'installazione sul sito sbagliato è l'errore di installazione più comune e è quello che la protezione da sovrascrittura di seguito esiste per catturare.

Fase 3: Installazione

La procedura guidata passa a una vista di progresso. Vedrai, in ordine:

In coda: in attesa di worker. Il tuo lavoro è in coda e inizierà tra poco.
Installazione [app], con secondi trascorsi rispetto al tempo di installazione tipico e una barra di progresso.

Mantieni la pagina aperta. L'installazione continua in background se navighi altrove, ma perdi la vista dal vivo e il riepilogo delle credenziali alla fine.

Se l'installazione incontra un problema, riprova automaticamente, mostrando Nuovo tentativo di installazione con il numero del tentativo. Se funziona molto oltre il tempo previsto, appare una nota che offre di continuare ad aspettare o di annullare.

Annullamento

Annulla installazione ferma il lavoro. La schermata dei risultati lo conferma: L'installazione è stata arrestata. Nulla è stato modificato sul tuo sito.

Quando il Sito Contiene Già un'App

Se la directory del sito di destinazione contiene già un sito, l'installazione si ferma con un avviso che nomina quello che ha trovato:

Questa directory contiene già [app]. L'installazione di [nuova app] la SOVRASCRIVERÀ e non può essere annullata. Verrà effettuato un backup completo del tuo sito attuale in modo che tu possa ripristinarlo.

Due scelte: annullare o Esegui backup e sovrascrivi. Se consenti, il lavoro effettua un backup completo del sito esistente prima di scrivere qualcosa, in modo che ci sia un punto di ripristino.

Questo è il punto di non ritorno nella procedura guidata. La sovrascrittura sostituisce i file del sito esistente. Il backup automatico significa che è recuperabile, non che è reversibile con un clic. Se non sei sicuro che il sito sia eliminabile, annulla e installa su un sito diverso.

App Installate Manualmente dal Nostro Team

Alcune app non hanno un programma di installazione automatico comprovato. Per queste, la procedura guidata salta completamente la barra di progresso e mostra una conferma calorosa:

Stiamo configurando [app] per te. Questa app necessita di un setup manuale, quindi il nostro team la installa sul tuo sito per te dopo che l'hai ordinata. Ti manderemo un'email nel momento in cui sarà live; non c'è nient'altro che devi fare.

Nulla è fallito e nulla è in sospeso per te. Le app sono gratuite, quindi non c'è nessun addebito in entrambi i casi.

Fase 4: Sei Online

Al successo, la procedura guidata mostra [app] è online, un collegamento al tuo dominio e il riepilogo delle credenziali:

Nome utente amministratore
Password amministratore, con mostra o nascondi
Email amministratore
Titolo del sito

Mostra anche il log di installazione, riga per riga, con ogni fase contrassegnata come riuscita, fallita o saltata. Vale la pena dare un'occhiata a quel log anche con un'installazione pulita: ti dice esattamente cosa è stato configurato.

Due pulsanti concludono il flusso: Apri [app] va direttamente all'app e Torna al Catalogo ritorna alla pagina del catalogo.

Se Fallisce

Installazione non riuscita. La schermata dei risultati mostra cosa è accaduto e afferma la parte importante: Tutte le modifiche parziali sono state ripristinate. Il tuo sito è pulito. Vengono offerte due azioni, Riprova e Contatta il Supporto.

Cause comuni e cosa fare:

Limiti di risorse. Se la RAM minima dell'app è superiore a quella che il tuo piano le fornisce, l'installazione può fallire a metà. Controlla la cifra Min RAM nella pagina dell'app. Vedi Aggiornamento del Tuo Piano.
Un campo rifiutato. La procedura guidata rifiuta l'input contenente caratteri non sicuri per la shell prima ancora che il lavoro sia messo in coda e nomina il campo. Semplifica il valore: un nome utente semplice, una password generata, un nome di database solo lettere e numeri.
Il sito non è attivo. Solo i siti con stato ATTIVO appaiono nel dropdown del sito. Un sito ancora in provisioning non sarà elencato.

L'installazione è riuscita ma il sito mostra un errore. Controlla il log di installazione per un passaggio non riuscito, quindi controlla la documentazione dell'app stessa per il setup post-installazione. Le app della comunità in particolare spesso necessitano di una procedura guidata di setup finale eseguita nel browser. Vedi Sito Web Non Caricato.

Hai perso la password amministratore. Usa il ripristino della password dell'app stessa con l'email amministratore che hai impostato. Per WordPress specificamente, vedi Reimpostare una Password WordPress.

L'installazione è bloccata su In coda. La coda di lavoro è occupata. Inizierà. Se è ancora in coda molto oltre il tempo di installazione previsto, annullala e riprova, quindi apri un ticket di supporto se si ripete.