ACLClouds
ACLClouds

Comment trouver rapidement la bonne procédure ?

Utiliser la recherche par message d’erreur, logiciel ou action dans les 80 guides ACLClouds.

La recherche indexe les titres, résumés, mots-clés et catégories. Une partie distinctive du message d’erreur donne généralement de meilleurs résultats qu’une phrase entière.

Procédure étape par étape

  1. Copier le terme utile

    Relevez par exemple MODULE_NOT_FOUND, Connection refused, code 137 ou No space left on device sans copier de token.

  2. Préciser le logiciel

    Ajoutez Node.js, Python, Minecraft, Docker, SSH ou noVNC pour réduire les résultats.

  3. Suivre la vérification rapide

    Lorsqu’un guide se termine par une « Vérification rapide », contrôlez chaque point avant de considérer l’incident résolu.

  4. Faire remonter le problème avec contexte

    Si le problème persiste, joignez au ticket le guide suivi, l’étape bloquante et les lignes de logs concernées.

Exemples de recherches qui donnent un résultat

ModuleNotFoundError
MODULE_NOT_FOUND
137 minecraft
no space left
connection refused

Ce que la recherche consulte

La recherche de la page Documentation compare votre saisie au titre, au résumé, à l’introduction, aux mots-clés et à la catégorie de chacun des 80 guides. Elle ne lit ni le texte des étapes ni les blocs de code : un terme qui n’apparaît que dans une étape ne fait pas remonter le guide.

Les accents et les majuscules sont ignorés : « sauvegarde », « Sauvegarde » et « sauvegardé » donnent les mêmes résultats. Si vous tapez plusieurs mots, chacun doit figurer dans le guide, dans n’importe quel ordre et pas forcément côte à côte.

Chaque mot est cherché comme un fragment, même au milieu d’un autre mot : « ram » trouve aussi un guide qui contient « paramètres ». Si la liste est trop longue, ajoutez un deuxième mot, par exemple le nom du logiciel.

Choisir les bons mots

Les meilleurs résultats viennent d’un fragment court et stable, copié tel quel depuis la console ou le message d’erreur.

  • Gardez le nom de l’erreur sans la ponctuation qui l’entoure : ModuleNotFoundError plutôt que ModuleNotFoundError: suivi du reste de la ligne.
  • Pour un code de sortie, tapez le nombre seul, puis ajoutez le logiciel si besoin : 137, puis 137 minecraft.
  • Retirez ce qui est propre à votre service : adresse IP, nom de fichier, chemin, identifiant ou numéro de ligne.
  • Sans message d’erreur, décrivez l’action avec un nom simple : « sauvegarde », « renouvellement », « sous-domaine » ou « SFTP ».

Préparer un ticket utile

Si aucun guide ne règle le problème, ouvrez « Créer un ticket de support », choisissez la catégorie et renseignez le « Service concerné ». Collez les lignes de log en texte plutôt qu’en capture : un message est limité à 5 000 caractères et accepte une image de 5 Mo au maximum.

Questions fréquentes

Pourquoi la recherche ne trouve aucun guide alors que le sujet existe ?

Tous les mots saisis doivent être présents, et l’un d’eux manque probablement dans le titre, le résumé, l’introduction ou les mots-clés du guide. Retirez des mots jusqu’à n’en garder qu’un ou deux. L’écran « Aucune réponse ne correspond exactement » propose aussi d’essayer un terme plus court.

Faut-il coller le message d’erreur complet dans la recherche ?

Non. Une ligne complète comme ModuleNotFoundError: No module named 'discord' contient des mots absents des guides, comme le nom de votre module, et ne donne alors souvent aucun résultat. Gardez la partie stable, ici ModuleNotFoundError, et ajoutez au besoin le logiciel, par exemple python.

Peut-on envoyer un lien vers une recherche ?

Non. La recherche ne modifie pas l’adresse de la page et n’a pas de raccourci clavier. Pour orienter quelqu’un, envoyez le lien du guide lui-même, ou indiquez le terme à saisir dans le champ de recherche.