Gestion des instances
Les instances de l'agent redirection.io sont chargées de traiter chaque requête pour trouver une action applicable à exécuter (une redirection, une surcharge SEO, etc.). Elles enregistrent également toutes les requêtes et gèrent le dialogue avec les API de redirection.io.
Il existe deux types d'instances :
- instances gérées, qui sont des instances hébergées et gérées par redirection.io. Pour les utiliser, vous devez suivre les instructions d'installation, qui impliquent notamment de pointer votre nom de domaine vers notre infrastructure. Vous pouvez en savoir plus sur les instances gérées dans la section de documentation dédiée.
- instances auto-hébergées, qui sont des instances hébergées sur votre infrastructure (ou chez votre fournisseur de périphérie, comme Fastly ou Cloudflare)
Cette page de documentation concerne la gestion des instances auto-hébergées.
Ajouter une nouvelle instance
Afin de gérer le trafic de votre site web avec une instance auto-hébergée, vous devez installer cette instance sur votre site web. La page "instances" du gestionnaire fournit des informations sur la manière d'y parvenir :
Cet écran est divisé en deux parties :
- la liste des "clés de projet" permet de gérer les clés de projet, une chaîne secrète que l'agent utilise pour envoyer et récupérer des informations depuis/vers les API du gestionnaire
- la liste des instances elle-même, où vous pouvez voir les instances actuellement déployées
Afin d'ajouter une nouvelle instance :
- suivez les instructions pour installer l'instance
Voir les informations sur les instances
Dans le gestionnaire, vous pouvez voir vos instances de l'agent redirection.io sur l'écran "instances" :
Chaque boîte d'instance donne des détails sur une instance configurée. Vous pouvez obtenir :
- la version de l'agent. Nous vous conseillons vivement de maintenir vos agents à jour, afin de pouvoir utiliser toutes les dernières fonctionnalités de redirection.io. Notre changelog donne des informations sur les nouvelles versions.
- l'état de la journalisation: cette section fournit des détails sur la dernière réception des logs. Si votre instance n'a pas journalisé depuis plus de 10 minutes, une alerte s'affichera.
- l'état des règles: cette section explique si l'agent est à jour et combien de règles il a chargées. Si votre agent n'a pas été mis à jour depuis longtemps, cette section affichera une alerte et fournira de l'aide sur la façon de résoudre le problème.
L'écran "instances" du gestionnaire permet également de définir certains paramètres pour vos instances d'agent :
- autoriser ou non la journalisation
- activer le "mode test", qui permet de charger des règles qui ne sont pas encore publiées
Autoriser les instances à journaliser le trafic
Chacun de nos plans est livré avec un nombre illimité d'instances de journalisation. Par exemple, considérez que l'infrastructure de votre site web est répliquée et partagée entre 8 serveurs frontend. Vous pourriez vouloir répliquer le service d'agent redirection.io sur tous ces serveurs, et déployer un agent sur tous ces serveurs :
Il n'y a pas de limite au nombre d'agents que vous pouvez lier à votre projet. Vous pouvez avoir autant d'instances que vous le souhaitez, mais nous limitons le nombre de lignes de log par jour et par projet à 2 millions de lignes de log (avec des pics temporaires et une protection contre les surcharges). Si la configuration de votre infrastructure utilise de nombreux agents, ou si vous utilisez également les agents dans des environnements de staging ou de pré-production, vous pouvez choisir d'activer ou de désactiver la fonction de journalisation instance par instance.
Sur demande, nous pouvons augmenter le quota de logs pour votre projet - n'hésitez pas à nous contacter !
Pour désactiver la fonction de journalisation pour une instance donnée, suivez ces étapes :
Désormais, cette instance continuera à récupérer les règles de redirection.io et à rediriger correctement le trafic, mais elle n'enverra plus de logs au gestionnaire.
Attention, si vous utilisez les logs pour votre analyse SEO. Dans ces cas, être exhaustif est toujours une bonne idée, et vous devriez préférer collecter les logs de toutes vos instances. Cela permettra une analyse plus précise, notamment si vous ciblez le comportement des crawlers.
Activer le "mode test"
Lors de la maintenance d'une pile web, il est assez courant de disposer d'une infrastructure de pré-production, pour effectuer des tests avant le déploiement en production.
Comme pour d'autres parties de votre stack, vous pouvez vouloir tester et essayer des redirections en pré-production avant de les appliquer à votre production. C'est exactement ce que permet le "mode test" : en activant ce mode sur une instance, elle chargera toutes les règles du ruleset, même celles non publiées.
Pour activer le "mode test" pour une instance donnée, suivez ces étapes :
Désormais, cette instance chargera le ruleset "en direct" : les règles nouvellement créées seront appliquées en quelques secondes sur cette instance, même si elles n'ont pas encore été publiées.
Veuillez noter, cependant, que si les règles "BROUILLON" de votre ruleset dépassent le nombre de règles autorisées pour votre plan, ces règles ne seront pas poussées aux instances "Instance de test" de votre projet - veuillez donc vérifier que les règles non publiées restent dans les limites du plan de projet.
Afficher ou masquer les instances disparues
Dans certaines configurations d'infrastructure, les serveurs peuvent avoir une durée de vie éphémère - pour des raisons de scalabilité ou d'utilisation d'instances à la demande. Si cela se produit dans votre environnement d'hébergement, vous pouvez vouloir réduire le fardeau de voir de nombreuses "anciennes" instances, en configurant la façon dont les instances sont affichées. Cliquez simplement sur le bouton "Paramètres", en haut à droite de la liste des instances, et modifiez les paramètres des instances.
Par défaut, les instances qui n'ont pas journalisé ni mis à jour le ruleset depuis plus de 7 jours sont masquées - vous pouvez vouloir désactiver ce comportement, ou au contraire réduire la durée d'affichage.
Gérer les clés de projet
La "clé de projet" est une chaîne complexe unique à chaque projet redirection.io. C'est le seul secret de configuration utilisé pour lier une instance à un projet redirection.io spécifique.
La "clé de projet" permet aux instances de récupérer la liste des règles du projet auquel elles sont liées, et d'envoyer des logs à ce projet.
Par défaut, chaque projet nouvellement créé reçoit une clé de projet qui peut être directement utilisée pour configurer l'instance de l'agent redirection.io. Cependant, il peut y avoir des cas où vous pourriez vouloir changer cette clé de projet, ou ajouter plusieurs autres clés de projet :
- elle a fuité publiquement et vous ne voulez pas que des personnes puissent lister vos règles redirection.io ou envoyer des logs à votre projet redirection.io ;
- vous voulez utiliser une clé secrète spécifique en mode développement, afin que votre équipe de développement ne connaisse pas la clé de projet de production.
redirection.io offre la possibilité de créer autant de clés de projet que vous en avez besoin. Chaque clé de projet peut avoir un nom (pour expliquer pourquoi elle a été créée) et une date d'expiration facultative (après laquelle la clé ne fonctionnera plus) :
