Docs/ Opérations/ Gestionnaire de fichiers

Gestionnaire de fichiers

Parcourez et gérez les fichiers à l'intérieur de vos conteneurs avec un explorateur de fichiers visuel. Consultez, modifiez, uploadez et téléchargez des fichiers sans ouvrir un terminal.

Parcourir les fichiers du conteneur

Le gestionnaire de fichiers fournit une interface visuelle du système de fichiers à l'intérieur de n'importe quel conteneur en cours d'exécution. Accédez-y depuis la page de détail du service en cliquant sur l'onglet Fichiers.

  1. Accédez à votre service au sein de son stack.
  2. Cliquez sur l'onglet Fichiers.
  3. Le navigateur de fichiers s'ouvre au répertoire racine du conteneur (/).
File manager main view -- showing a directory listing with file names, sizes, modification dates, and permission indicators

La liste des fichiers affiche les informations suivantes pour chaque entrée :

  • Nom -- Nom du fichier ou du répertoire, avec des icônes distinguant les fichiers des dossiers.
  • Taille -- Taille du fichier en format lisible (Ko, Mo, Go).
  • Modifié -- Horodatage de la dernière modification.
  • Permissions -- Permissions Unix affichées sous forme de chaîne (par ex., rwxr-xr-x).
  • Propriétaire -- Propriétaire et groupe du fichier.

Cliquez sur n'importe quel nom de répertoire pour y entrer. Le fil d'Ariane en haut affiche votre emplacement actuel et vous permet de revenir à n'importe quel répertoire parent.

Breadcrumb navigation -- showing path segments / > app > src > routes with each segment clickable

Vous pouvez également taper un chemin directement dans la barre de chemin pour accéder à un répertoire spécifique. Appuyez sur Entrée pour naviguer.

Tip
Chemins courants à vérifier : /app (code applicatif), /var/log (logs), /etc (configuration) et /tmp (fichiers temporaires).

Visualisation du contenu des fichiers

Cliquez sur n'importe quel fichier pour l'ouvrir dans la visionneuse intégrée. La visionneuse prend en charge la coloration syntaxique pour les types de fichiers courants :

  • Fichiers de code source (JavaScript, Python, Ruby, Go, Rust, PHP, etc.)
  • Fichiers de configuration (JSON, YAML, TOML, INI, XML)
  • Fichiers texte brut et de log
  • Scripts shell
  • Dockerfiles et fichiers docker-compose
File viewer -- showing a package.json file with syntax highlighting and line numbers
Note
Les fichiers binaires (images, binaires compilés, archives) ne peuvent pas être affichés dans la visionneuse. Vous pouvez les télécharger à la place.

Modification de fichiers

Le gestionnaire de fichiers inclut un éditeur intégré pour effectuer des modifications rapides. Cliquez sur le bouton Modifier lors de la visualisation d'un fichier pour passer en mode édition.

  1. Ouvrez un fichier dans la visionneuse.
  2. Cliquez sur Modifier dans le coin supérieur droit.
  3. Effectuez vos modifications dans l'éditeur.
  4. Cliquez sur Enregistrer pour écrire les modifications dans le conteneur.
File editor -- showing an editable text area with syntax highlighting, a Save button, and a Discard button
Warning
Les modifications de fichiers sont écrites directement dans le système de fichiers du conteneur. Si le fichier n'est pas dans un volume monté, les modifications seront perdues lorsque le conteneur redémarre ou est redéployé. Pour des modifications permanentes, mettez à jour votre code source et redéployez.

Upload de fichiers

Uploadez des fichiers depuis votre machine locale vers le conteneur. C'est utile pour transférer des fichiers de configuration, des certificats, des fichiers de données ou des ressources.

  1. Accédez au répertoire cible dans le gestionnaire de fichiers.
  2. Cliquez sur le bouton Upload.
  3. Sélectionnez un ou plusieurs fichiers depuis votre machine (ou glissez-déposez-les sur la liste des fichiers).
  4. Les fichiers sont uploadés et apparaissent dans le répertoire.
File upload dialog -- showing a drag-and-drop zone and a file picker button with upload progress indicators
Note
La taille maximale de fichier uploadé est de 100 Mo par fichier. Pour les fichiers plus volumineux, utilisez le Terminal avec wget ou curl pour télécharger des fichiers directement dans le conteneur.

Téléchargement de fichiers

Téléchargez des fichiers du conteneur vers votre machine locale. Faites un clic droit sur un fichier (ou utilisez le menu d'actions) et sélectionnez Télécharger.

Vous pouvez également télécharger des répertoires entiers sous forme d'archive .tar.gz. C'est utile pour récupérer des répertoires de logs, des fichiers de sauvegarde ou des données applicatives.

File context menu -- showing options for Download, Rename, Copy path, and Delete

Permissions des fichiers

Le gestionnaire de fichiers affiche les permissions Unix pour chaque fichier et répertoire. Vous pouvez modifier les permissions via le panneau de propriétés :

  1. Faites un clic droit sur un fichier et sélectionnez Propriétés.
  2. Consultez ou modifiez le mode de permission (par ex., 644, 755).
  3. Cliquez sur Appliquer pour mettre à jour les permissions.
Common permission patterns
644  - Owner read/write, group/others read-only (files)
755  - Owner full, group/others read+execute (directories, scripts)
600  - Owner read/write only (private keys, secrets)
777  - Full access for everyone (avoid this in production)

Fichiers persistants vs éphémères

Comprendre quels fichiers persistent à travers les redémarrages de conteneurs est essentiel :

TypeSurvit au redémarrage ?Exemples
Volumes montésOuiDonnées de base de données, fichiers uploadés, configuration persistante
Système de fichiers du conteneurNonCode applicatif, fichiers temporaires, logs (sauf si montés sur un volume)
Tip
Dans le gestionnaire de fichiers, les répertoires sauvegardés par un volume sont marqués avec une icône de volume. Cela facilite l'identification des chemins qui persisteront à travers les redémarrages.