Outil de requêtes de configuration: guide complet
Exécutez dans le navigateur des requêtes YAML de style yq pour vérifier des chemins de champs, des éléments de tableau et des conversions dans des configurations, manifests et extraits de déploiement, sans téléverser de fichier.
Ce que fait cet outil
Il analyse le YAML et exécute des expressions de chemin courantes comme .service.image, .items[0].name et les jokers de tableau.
Il prend en charge des opérations pratiques comme keys, length, to_json et to_yaml pour passer rapidement entre les vues YAML et JSON.
Il affiche les erreurs d'analyse et les syntaxes non prises en charge près de la sortie, afin de clarifier qu'il s'agit d'un sous-ensemble local léger et non d'un runtime yq complet.
Cas d'utilisation courants
- Extraire rapidement une valeur imbriquée depuis une configuration Kubernetes, Docker Compose ou CI.
- Vérifier qu'une expression de chemin cible le bon noeud avant de modifier un overlay YAML.
- Convertir un extrait YAML en JSON pour le coller dans une requête de débogage, une documentation ou un jeu de test.
Exemples d'entrée
Configuration YAML
service:
image: nginx:alpine
ports:
- 8080:80Expression de requête
.service.image
Exemples de sortie
Résultat de champ
nginx:alpine
Sortie JSON
{"image":"nginx:alpine","ports":["8080:80"]}Erreurs courantes et correctifs
Utiliser une syntaxe complexe disponible seulement dans yq complet
Décomposez la vérification avec les opérations prises en charge : chemin, index, joker, keys, length, to_json ou to_yaml.
Indentation YAML ou format de liste invalide
Corrigez l'indentation, les deux-points et les tirets de tableau, puis relancez la requête.
Le chemin de requête ne correspond à aucun noeud
Commencez par . ou keys pour inspecter la structure racine, puis resserrez le chemin étape par étape.
Notes de sécurité et de confidentialité
Pour les termes de confidentialité, le modèle de traitement local, les libellés de requête externe et la vérification DevTools, consultez le Centre de confiance.
- L'analyse YAML et les requêtes s'exécutent entièrement dans le navigateur.
- Supprimez les clés, jetons et noms d'hôtes internes avant de copier une sortie dans un ticket ou un chat.
- Pour une configuration de production, utilisez de préférence un extrait minimal déjà masqué.
Procédure pas à pas
- Collez un extrait YAML minimal et utilisez d'abord . pour vérifier la structure globale.
- Saisissez progressivement les chemins de champs, index de tableau ou jokers, puis comparez la sortie.
- Ne copiez la sortie qu'après avoir masqué les valeurs sensibles.
Checklist qualité avant partage
- Confirmez que l'expression utilise uniquement le sous-ensemble pris en charge par l'outil.
- Comparez la sortie avec la hiérarchie cible pour éviter un mauvais noeud dû à l'indentation.
- Avant partage, vérifiez l'absence de jetons, mots de passe, domaines internes et données client.
Conseils d'utilisation
Utile pour les précontrôles locaux et le diagnostic ; l'automatisation de production doit toujours être testée avec la version yq standard de l'équipe.
Questions fréquentes
Est-ce un yq complet ?
Non. L'outil couvre les requêtes locales fréquentes et les conversions de format ; les filtres complexes doivent être validés avec yq officiel.
Les YAML multi-documents sont-ils pris en charge ?
Les contenus YAML courants sont analysés. Pour des flux multi-documents complexes, découpez les fragments importants et vérifiez-les séparément.
Les données sont-elles téléversées ?
Non. Les requêtes et conversions restent dans la session de navigateur actuelle.
