Utilisation de ngrok
Ngrok est un outil facile à utiliser qui vous permet de créer un tunnel sécurisé sur votre machine locale avec une URL publique que vous pouvez utiliser pour tester votre projet local, ou pour partager votre travail en vue d’une révision avec un client ou un collègue. Vous pouvez configurer HTTP ou HTTPS, et en raison de la popularité de cet outil, si quelque chose ne fonctionne pas, il existe de nombreux articles décrivant différentes façons de résoudre votre problème. Cet article couvre quelques méthodes simples pour installer ngrok, et que faire si vous n’arrivez pas à faire communiquer votre application web avec ngrok.
ngrok
Nos amis de ngrok ont rédigé un excellent article consacré à la prise en charge des webhooks Frame.io via ngrok. Consultez-le ici.
Installer ngrok
Vous pouvez utiliser ngrok de différentes manières
Installation via le programme d’installation ngrok
- Accédez au site web ngrok et suivez les instructions : https://ngrok.com/download
- Si vous souhaitez bénéficier des fonctionnalités offertes par la connexion d’un compte, suivez ces instructions pour obtenir un compte et un jeton.
Vous n’êtes pas obligé d’obtenir un compte ou d’ajouter le jeton, mais consultez définitivement la page de téléchargement pour voir si c’est quelque chose que vous souhaitez ou dont vous avez besoin.
Remarque :
Si vous utilisez cette méthode, ngrok s’exécute à partir de l’emplacement où vous le stockez, sauf si vous le rendez disponible dans l’ensemble de votre système.
Installer avec Homebrew
C’est ma méthode préférée pour installer ngrok. Si Homebrew est installé, il vous suffit de taper homebrew cask install ngrok. ngrok est installé pour vous et vous pouvez l’utiliser de n’importe où ! Le mieux, c’est que vous n’avez pas besoin de taper ./ngrok dans le terminal au début de chaque commande : vous pouvez simplement taper ngrok. Vous pouvez en savoir plus sur cette option ici.
Utiliser ngrok
Après avoir configuré ngrok, choisissez un port comme 3000 et lancez-le à partir d’une ligne de commande de terminal avec la commande ngrok http 3000. Vous n’êtes pas obligé d’utiliser le port 3000, mais c’est un port couramment utilisé lors de la configuration. Si vous configurez ngrok pour qu’il s’exécute depuis un dossier spécifique, vous devez vous trouver dans le dossier où vous avez placé ngrok et utiliser la commande ./ngrok http 3000.
Démarrez votre serveur pour que votre projet écoute sur le même port et vous pourrez accéder à votre travail en utilisant l’adresse publique fournie par ngrok.
Résolution des problèmes ngrok avec votre appli web - Barre oblique finale
Un problème que vous pourriez rencontrer avec ngrok est l’impossibilité de vous connecter à votre serveur lorsque vous configurez une URL ngrok à utiliser avec votre appli web. Ce qui est frustrant avec ce problème, c’est que ngrok n’enregistrera pas que vous lui avez envoyé quelque chose. Vous pouvez ouvrir localhost:4040 pour voir ce qui se passe, et cela ne vous montrera rien. (localhost:4040 est fourni par ngrok pour que vous puissiez surveiller toutes les requêtes entrantes vers votre serveur.) Ngrok semble faire correspondre les adresses à /(.) plutôt qu’à (/.), donc si vous n’incluez pas de barre oblique finale à la fin de votre adresse et que vous ne voyez rien dans les outils de surveillance ngrok, c’est parce que ngrok ne trouve pas de correspondance pour l’adresse que vous indiquez.
Voici un exemple d’ajout d’une barre oblique finale : http://something.ngrok.io/ Vous pouvez également écrire vos applications d’exemple pour qu’elles se résolvent vers un point d’entrée qui inclut une barre oblique. Souvenez-vous simplement que pour que l’appli Frame.io atteigne votre serveur, si votre appli d’exemple utilise le point d’entrée /actions, vous devez ajouter le point d’entrée /actions à la fin de votre adresse ngrok. Par exemple, si l’adresse ngrok est http://something.ngrok.io, vous devrez la fournir dans la configuration de votre action personnalisée comme http://something.ngrok.io/actions. Cela peut être différent pour d’autres applis web, donc expérimentez avec la fin de l’adresse ngrok si vous n’arrivez pas à faire fonctionner les choses immédiatement.
Puis-je utiliser autre chose que ngrok ? Essayez Glitch !
Glitch est une alternative plutôt cool à ngrok et plus rapide à configurer. Glitch vous permet de créer un compte puis de créer vos propres applis en utilisant leurs serveurs avec une URL accessible publiquement. Vous pouvez collaborer avec d’autres, rendre votre code public ou privé, et choisir parmi une grande variété de langages et de plateformes. Consultez https://glitch.com/create pour voir ce qui est disponible. Lorsque vous configurez votre projet sur Glitch, pour certaines applis web, le problème de la barre oblique finale s’applique. Dans le cas de Frame.io, lorsque vous configurez une action personnalisée dans developer.frame.io, vous devez inclure la barre oblique finale à la fin de l’URL fournie par Glitch. Vous n’avez pas besoin d’ajouter quoi que ce soit d’autre, même pour le point d’entrée /actions.
Y a-t-il quelque chose de configuré que je pourrais essayer maintenant ?
Oui. Si vous ne voulez pas utiliser ngrok ou créer votre propre projet Glitch, nous avons configuré une application d’exemple que vous pouvez essayer ici : https://frameio-custom-action.glitch.me. Souvenez-vous d’inclure une barre oblique finale lorsque vous ajoutez cette adresse dans la zone Actions personnalisées de [/).