Aller au contenu principal

Éditeur de ressources de la console

Disponible

Fonctionnalité déployée et prise en charge. Les champs et commandes décrits ici sont stables au sein de la version v1alpha1.

La console propose un éditeur unique pour créer et modifier vos ressources : Registre, Supervision, Applications, ou n'importe quel kind depuis Créer une ressource. Il remplace l'affichage du YAML brut : le bouton Éditer ouvre l'éditeur.

Deux onglets synchronisés​

  • Formulaire : les champs de la ressource, générés à partir de son manifeste. Les objets et les listes sont des blocs repliables ; les valeurs gardent leur type (nombre, case à cocher pour un booléen, texte : "8080" reste un texte). Vous pouvez renommer ou supprimer un champ, en ajouter un (la valeur {} ou [] est acceptée) et ajouter un élément à une liste, qui reprend la forme du dernier.
  • YAML : le manifeste complet, avec coloration, numéros de ligne et un bouton Copier.

Une modification dans un onglet apparaît tout de suite dans l'autre. Les champs inconnus de l'éditeur sont conservés tels quels, et les commentaires de votre YAML aussi.

Si le YAML est invalide, l'onglet YAML affiche un indicateur d'erreur, la ligne fautive est surlignée avec son message, et le formulaire garde le dernier état valide jusqu'à correction.

Créer une ressource​

  1. Choisissez Créer une ressource, puis le kind voulu.
  2. Partez d'un gabarit du catalogue (voir Gabarits de manifestes) ou d'un squelette minimal du kind : apiVersion, kind et metadata.name. Votre tenant est toujours celui avec lequel vous êtes connecté, vous ne le saisissez jamais.
  3. Complétez le formulaire ou le YAML, puis Enregistrer.

Plusieurs objets à la fois​

À la création, séparez les objets par --- dans l'onglet YAML : chacun devient un bloc du formulaire. L'ensemble est validé avant le premier enregistrement ; si un seul objet est refusé, aucun n'est créé. Pour modifier une ressource existante, le YAML ne contient qu'un seul objet.

Comprendre un refus​

Avant d'enregistrer, la console vérifie le manifeste comme sng validate. Chaque refus est affiché sur le champ concerné dans le formulaire et sur la ligne correspondante du YAML, avec la raison. Corrigez, puis enregistrez de nouveau.

Les champs que la plateforme renseigne elle-même (comme status) sont en lecture seule ou masqués.

Sur téléphone​

L'éditeur s'utilise à une main : la page ne défile pas horizontalement (seul le YAML défile), les champs clé/valeur s'empilent, les boutons sont assez grands pour le doigt, la correction automatique est coupée dans les champs YAML, et Enregistrer / Annuler restent affichés en bas de l'écran.

Voir aussi​