Installation d'une application sur votre site

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.

L'assistant d'installation des applications procède en trois étapes : configurer le compte administrateur et les paramètres du site, vérifier ce qui va se passer, puis regarder l'installation s'exécuter et récupérer vos informations de connexion.

Avant de commencer

Vous avez besoin d'une seule chose : un site web actif sur votre compte. L'assistant installe sur un site que vous avez déjà, il n'en crée pas un. Si vous n'en avez pas, l'assistant vous le dit et vous propose un lien pour en créer un. Voir Créer votre premier site web.

Vous avez aussi besoin de la permission apps:write, que détiennent les propriétaires de compte et les administrateurs.

Faites une sauvegarde avant d'installer sur un site qui contient déjà du contenu. L'assistant dispose d'un filet de sécurité pour un site qui détient déjà une application, décrit ci-dessous, mais un point de restauration manuel créé délibérément vaut toujours plus qu'un créé automatiquement. Voir Faire une sauvegarde.

Accéder à l'assistant

Cliquez sur Applications dans la barre latérale de KPanel.
Cliquez sur l'application que vous souhaitez.
Cliquez sur Installer [app] dans le panneau de droite.

L'adresse directe est /apps/<app-slug>/install.

L'assistant d'installation de l'application dans KPanel

Étape 1 : Configurer

L'assistant affiche l'application, puis quatre groupes de champs. Un avis Augmentation de plan recommandée apparaît en haut si l'application suggère un niveau de plan supérieur à celui dont vous disposez : c'est un conseil, et l'installation se poursuit quand même.

Localisation

Installer sur le site. Choisissez parmi vos sites actifs. C'est là que l'application se trouvera.

Compte administrateur

Nom d'utilisateur administrateur. Par défaut admin. C'est le nom d'utilisateur avec lequel vous allez vous connecter, et vous pouvez ajouter d'autres utilisateurs plus tard.
Mot de passe administrateur. Un mot de passe robuste de 16 caractères est généré pour vous au moment du chargement de la page. Afficher le révèle et Générer en crée un nouveau. Vous pouvez aussi taper le vôtre : il doit faire au moins 8 caractères.
E-mail administrateur. Facultatif. Utilisé pour la connexion et la réinitialisation du mot de passe. Laissé vide, votre e-mail de compte est utilisé.

Sauvegardez le mot de passe administrateur avant de quitter l'assistant. Il s'affiche sur l'écran de vérification et à nouveau sur l'écran de succès, puis il disparaît. Kapsule ne conserve pas de copie que vous pouvez récupérer plus tard, donc le perdre signifie réinitialiser le mot de passe par le biais de l'application elle-même.

Paramètres du site

Nom du site, où l'application en demande un.
Langue. La langue dans laquelle l'application est configurée, choisie parmi seize options incluant l'anglais (États-Unis), l'anglais (Royaume-Uni), te reo Māori, et les principales langues européennes et asiatiques. Cela définit la langue de contenu de l'application elle-même, pas celle de KPanel.

Base de données

Affichée uniquement pour les applications qui en ont besoin. L'assistant suggère un nom de base de données dérivé de votre domaine. Lettres et chiffres uniquement, pas de traits de soulignement ou de tirets : le champ l'applique au fur et à mesure que vous tapez. Changez-le si vous le souhaitez.

Les applications qui ont besoin d'une base de données l'ont automatiquement provisionnée dans le cadre de l'installation.

Certaines applications ajoutent leurs propres champs supplémentaires ci-dessous, définis par l'application elle-même, avec du texte d'aide le cas échéant. Les champs obligatoires sont marqués d'un astérisque, et Continuer reste désactivé jusqu'à ce que tous les champs soient remplis.

En bas, l'assistant affiche le résumé des ressources pour cette application : temps d'installation attendu, RAM minimum, et si une base de données est ajoutée.

Cliquez sur Continuer.

Étape 2 : Vérifier et confirmer

L'écran de vérification réaffirme les décisions dans une seule liste : application, site web, nom du site, nom d'utilisateur administrateur, mot de passe administrateur (avec un curseur afficher ou masquer), e-mail administrateur, langue et nom de la base de données. Le sous-titre le dit clairement : rien n'est installé tant que vous ne confirmez pas.

Modifier revient en arrière pour changer quelque chose.
Confirmer et installer lance la tâche.

Utilisez l'écran de vérification pour la seule vérification qui importe vraiment : la ligne Site web. Installer sur le mauvais site est l'erreur d'installation la plus courante, et c'est celle que la protection contre les écrasements ci-dessous est conçue pour attraper.

Étape 3 : Installer

L'assistant passe à une vue de progression. Vous verrez, dans l'ordre :

En file d'attente : en attente du worker. Votre tâche est dans la file d'attente et démarrera bientôt.
Installation de [app], avec les secondes écoulées par rapport au temps d'installation typique et une barre de progression.

Laissez la page ouverte. L'installation se poursuit en arrière-plan si vous naviguez ailleurs, mais vous perdez la vue en direct et le résumé des identifiants à la fin.

Si l'installation rencontre un problème, elle réessaie automatiquement, affichant Réessai de l'installation avec le numéro de la tentative. Si elle dépasse largement le temps attendu, une note apparaît vous proposant d'attendre ou d'annuler.

Annulation

Annuler l'installation arrête la tâche. L'écran de résultat le confirme : L'installation a été arrêtée. Rien n'a été changé sur votre site.

Quand le site contient déjà une application

Si le répertoire du site cible contient déjà un site, l'installation s'arrête avec un avertissement nommant ce qu'elle a trouvé :

Ce répertoire contient déjà [app]. L'installation de [new app] l'écrasera et ne peut pas être annulée. Une sauvegarde complète de votre site actuel sera d'abord effectuée afin que vous puissiez la restaurer.

Deux choix : annuler, ou Sauvegarder et écraser. Si vous consentez, la tâche effectue une sauvegarde complète du site existant avant d'écrire quoi que ce soit, de sorte qu'il existe un point de restauration.

C'est le point de non-retour dans l'assistant. L'écrasement remplace les fichiers du site existant. La sauvegarde automatique signifie qu'elle est récupérable, non pas qu'elle est réversible en un clic. Si vous n'êtes pas certain que le site est jetable, annulez et installez sur un site différent à la place.

Applications que notre équipe installe à la main

Certaines applications n'ont pas d'installateur automatique éprouvé. Pour celles-ci, l'assistant saute entièrement la barre de progression et affiche une confirmation chaleureuse à la place :

Nous configurons [app] pour vous. Cette application nécessite une installation manuelle, donc notre équipe l'installe sur votre site pour vous après votre commande. Nous vous enverrons un e-mail dès qu'elle sera en ligne ; vous n'avez rien d'autre à faire.

Rien n'a échoué et rien ne vous est en attente. Les applications sont gratuites, donc il n'y a pas de frais de toute façon.

Étape 4 : Vous êtes en ligne

En cas de succès, l'assistant affiche [app] est en ligne, un lien vers votre domaine, et le résumé des identifiants :

Nom d'utilisateur administrateur
Mot de passe administrateur, avec afficher ou masquer
E-mail administrateur
Titre du site

Il affiche également le journal d'installation, ligne par ligne, avec chaque étape marquée comme réussie, échouée ou ignorée. Ce journal vaut le coup d'être consulté, même sur une installation propre : il vous dit exactement ce qui a été configuré.

Deux boutons terminent le flux : Ouvrir [app] va directement à l'application, et Retour à l'application revient à la page du catalogue.

Que faire en cas d'échec

Installation échouée. L'écran de résultat montre ce qui s'est passé et énonce la partie importante : Tous les changements partiels ont été annulés. Votre site est propre. Deux actions sont proposées, Réessayer et Contacter le support.

Les causes courantes et ce qu'il faut faire :

Limites de ressources. Si la RAM minimale de l'application est supérieure à celle que votre plan lui donne, l'installation peut échouer en cours de route. Vérifiez le chiffre de RAM min sur la page de l'application. Voir Augmenter votre plan.
Un champ rejeté. L'assistant refuse l'entrée contenant des caractères dangereux pour le shell avant même que la tâche ne soit mise en file d'attente, et nomme le champ. Simplifiez la valeur : un nom d'utilisateur simple, un mot de passe généré, un nom de base de données avec lettres et chiffres uniquement.
Le site n'est pas actif. Seuls les sites avec le statut ACTIF apparaissent dans la liste déroulante des sites. Un site encore en cours de provisionnement ne sera pas listé.

L'installation a réussi mais le site affiche une erreur. Vérifiez le journal d'installation pour une étape échouée, puis consultez la documentation propre de l'application pour la configuration après l'installation. Les applications communautaires en particulier ont souvent besoin d'un assistant de configuration final lancé dans le navigateur. Voir Site web qui ne charge pas.

Vous avez perdu le mot de passe administrateur. Utilisez la réinitialisation de mot de passe propre de l'application avec l'e-mail administrateur que vous avez défini. Pour WordPress spécifiquement, voir Réinitialiser un mot de passe WordPress.

L'installation est bloquée sur En file d'attente. La file d'attente des tâches est occupée. Elle démarrera. Si elle est toujours en file d'attente bien au-delà du temps d'installation attendu, annulez-la et réessayez, puis ouvrez un ticket de support si cela se reproduit.