Le terminal Web de l’application vous permet d’accéder en ligne de commande au conteneur dans lequel s’exécute le processus web de votre application. Vous pouvez utiliser le terminal web pour exécuter des scripts et lire des fichiers. Cette fonction est utile pour le débogage, le contrôle des performances ou l’exécution manuelle de scripts ad hoc.
Actuellement, le seul processus auquel vous pouvez accéder via le terminal web est le processus web. Les processus d’arrière-plan ou les tâches cron ne sont pas disponibles dans le terminal web.
Terminal web avec un fichier Docker
Si votre application est créée avec un fichier Docker, assurez-vous que Bash est installé dans le conteneur. Dans la plupart des cas, l’image de base (par exemple Ubuntu) inclut un paquet shell et fonctionnera par défaut. Dans certains conteneurs plus rationalisés, le paquet shell peut ne pas être inclus, et vous devrez l’ajouter. L’image de base détermine comment ajouter le paquetage shell :
- Alpine :
apk add bash - Ubuntu/Debian :
apt install bash - Fedora :
dnf install bash
Configurer l’authentification
Pour accéder au terminal web, vous devez :
- Avoir au moins un déploiement réussi de l’application.
- Avoir une application saine qui fonctionne. En cas d’erreur ou d’arrêt de l’application, le terminal web ne sera pas disponible.
- Ajouter au moins une adresse IP valide à la liste d’autorisation.
Les adresses IP ajoutées à la liste d’autorisation doivent être uniques. Si vous essayez d’ajouter une adresse IP qui se trouve déjà dans la liste d’autorisation, vous recevrez une erreur et vous ne pourrez pas ajouter l’adresse IP en double.
Ajouter une adresse IP
La première fois que vous allez sur la page du terminal web pour votre application dans MyKinsta, cliquez sur Configurer l’authentification pour ajouter des adresses IP à la liste d’autorisation. Pour connaître l’adresse à partir de laquelle vous vous connectez, utilisez un outil tel que Test your IPv6.
Saisissez la première adresse IP que vous souhaitez autoriser. Pour ajouter d’autres adresses IP, cliquez sur Ajouter une autre. Une fois que vous avez saisi toutes les adresses IP que vous souhaitez autoriser, cliquez sur Configurer l’authentification.
Si vous devez ajouter d’autres adresses IP à l’avenir, cliquez sur Ajouter une adresse IP dans la section Liste d’autorisation de la page Terminal web.
Supprimer une adresse IP
Pour supprimer une adresse IP de la liste d’autorisation, cliquez sur l’icône Supprimer (corbeille) à côté de l’adresse IP que vous souhaitez supprimer et cliquez sur Supprimer l’adresse IP pour confirmer la suppression.
Démarrer et ouvrir le terminal Web
Pour ouvrir le terminal web, vous devez d’abord vous y connecter, ce qui déploie un pod de terminal web. Cliquez sur Démarrer le terminal web pour commencer à ouvrir la connexion. Pendant l’ouverture de la connexion, les options de la page du terminal web sont désactivées.
Une fois le déploiement du pod de terminal web terminé, l’indication Le terminal web s’exécute apparaît au-dessus de la liste d’autorisation. Cliquez sur Ouvrir le terminal web pour ouvrir le terminal web dans un nouvel onglet de votre navigateur.
Il se peut que la page Démarrer le terminal web s’affiche pendant le chargement du terminal. Une fois le terminal chargé, vous pouvez exécuter des commandes comme dans un terminal normal. Les commandes disponibles dépendent des exécutables présents dans votre application.
Nom d’utilisateur du terminal
Si votre application a été créée avec un buildpack (Configurer automatiquement l’image du conteneur dans l’étape Construire l’environnement), le nom d’utilisateur dans le terminal peut être « heroku » Kinsta utilise des buildpacks, un projet open source maintenu par Heroku, pour déterminer et créer automatiquement un conteneur pour votre application en fonction de votre dépôt, et cela se répercute dans le terminal web.
Si votre application a été créée avec un Dockerfile (Utilisez Dockerfile pour configurer l’image du conteneur dans l’étape Construire l’environnement), le nom d’utilisateur dans le terminal sera généralement « root », mais cela dépend de la façon dont votre Dockerfile est configuré.
Arrêter et fermer le terminal web
Lorsque vous avez fini de travailler dans le terminal, fermez l’onglet dans votre navigateur pour fermer la connexion au terminal web. La fermeture de l’onglet n’arrête pas le terminal, mais si vous voulez l’ouvrir à nouveau, vous devrez cliquer sur Ouvrir le terminal web, attendre environ 30 secondes, et rafraîchir le nouvel onglet pour voir à nouveau le terminal.
Pour arrêter le terminal web, cliquez sur Stopper le terminal web.
Lorsque le terminal est en cours d’exécution, vous ne pouvez pas modifier la liste d’autorisations IP. Si vous devez la modifier, arrêtez le terminal, apportez vos modifications à la liste d’autorisations et ouvrez à nouveau le terminal.
Si la connexion au terminal web est créée mais n’est pas ouverte, elle s’arrêtera automatiquement au bout de 24 heures.
Résolution des problèmes
- Lorsque vous ouvrez le terminal web, si vous voyez une page Erreur 1016 – DNS d’origine au lieu de l’écran du terminal, cela est dû à un léger retard dans la propagation du DNS. Attendez une minute et actualisez la page jusqu’à ce que vous voyiez l’écran du terminal. Si le problème persiste au-delà de quelques minutes, contactez notre équipe de support.
- Si vous voyez une erreur 403 : Interdit lorsque vous ouvrez le terminal web, cela signifie que votre adresse IP n’est pas dans la liste d’autorisation. Arrêtez le terminal web, ajoutez votre adresse IP et redémarrez le terminal web.
- Une erreur similaire à l’erreur ERRO[0000] exec failed indique qu’il manque le paquet shell au conteneur. Vous devez ajouter ce paquet à votre conteneur pour pouvoir exécuter le terminal web.
ERRO[0000] exec failed : container_linux.go:425 : starting container process caused : exec : « bash » : executable file not found in $PATH
la commande s’est terminée avec le code de sortie 1