Docker

Cette page décrit l’exécution de l’image officielle de RustFS avec Docker : une instance à nœud unique avec stockage persistant, les droits des répertoires de l’hôte pour l’utilisateur non root du conteneur, Docker Compose avec des services d’observabilité facultatifs, TLS et un déploiement multi-nœuds. Vous avez besoin d’un moteur Docker opérationnel et du droit d’exécuter des conteneurs.

docker pull rustfs/rustfs:latest

docker volume create rustfs-data

docker run -d \
  --name rustfs \
  --restart unless-stopped \
  -p 9000:9000 \
  -p 9001:9001 \
  -v rustfs-data:/data \
  -e RUSTFS_ACCESS_KEY="<your-access-key>" \
  -e RUSTFS_SECRET_KEY="<your-secret-key>" \
  -e RUSTFS_ADDRESS=":9000" \
  -e RUSTFS_CONSOLE_ADDRESS=":9001" \
  -e RUSTFS_CONSOLE_ENABLE=true \
  -e RUSTFS_OBS_LOGGER_LEVEL=error \
  -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \
  rustfs/rustfs:latest \
  /data

docker run -d \
  --name rustfs \
  -p 9000:9000 \
  -p 9001:9001 \
  -v rustfs-data:/data \
  rustfs/rustfs:latest \
  --access-key "<your-access-key>" \
  --secret-key "<your-secret-key>" \
  --address :9000 \
  --console-enable \
  /data

chown -R 10001:10001 /path/to/host_directory

docker ps --filter name=rustfs
curl --fail http://localhost:9000/health

Docker ComposeCopy Anchor Link

Le dépôt RustFS fournit un fichier docker-compose.yml qui inclut les services grafana, prometheus, otel-collector et jaeger, principalement pour l’observabilité. Pour déployer RustFS avec ces services, clonez le dépôt de code RustFS en local :

git clone https://github.com/rustfs/rustfs.git

Exécutez la commande depuis la racine du dépôt :

docker compose --profile observability up -d

Le fichier Compose utilise un conteneur d’initialisation pour accorder les droits d’accès corrects à rustfs : le service rustfs_perms ci-dessous attribue la propriété des volumes montés à 10001 avant le démarrage de rustfs, et depends_on attend la fin de cette opération. Pour conserver des journaux persistants et accessibles, le répertoire de journaux de l’hôte est mappé sur le chemin /var/log/rustfs/ du conteneur :

  services:
    # grant the necessary permissions to RUSTFS volumes path
    rustfs_perms:
      image: alpine
      user: root
      volumes:
        - /path/to/host_directory/volumes:/fix_path
      command: chown -R 10001:10001 /fix_path

    rustfs:
      image: rustfs/rustfs:latest
      depends_on:
        rustfs_perms:
          condition: service_completed_successfully
      volumes:
        - /path/to_host_directory/volumes/data:/data
        - /path/to_host_directory/volumes/logs:/var/log/rustfs/
      environment:
        - RUSTFS_ADDRESS=":9000"
        - RUSTFS_CONSOLE_ADDRESS=":9001"
        - RUSTFS_CONSOLE_ENABLE=true
        - RUSTFS_OBS_LOGGER_LEVEL=error
        - RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/"

      # ... other configurations

Si vous ne voulez que RustFS, sans Grafana, Prometheus ni les autres services d’observabilité, démarrez uniquement le service rustfs (le fichier Compose marque la dépendance au collecteur comme facultative) :

docker compose -f docker-compose.yml up -d rustfs

Cela ne démarre que le conteneur rustfs-server. Que vous démarriez uniquement rustfs-server ou la pile complète, l’API S3 est servie à l’adresse http://localhost:9000 et la Console RustFS à l’adresse http://localhost:9001. Ouvrez la Console dans un navigateur et connectez-vous avec la clé d’accès et la clé secrète configurées ci-dessus. Générez une clé secrète robuste, par exemple avec openssl rand -base64 24, et n’utilisez jamais les valeurs indicatives en production.

Pour Docker Compose, définissez des valeurs uniques de RUSTFS_ACCESS_KEY et RUSTFS_SECRET_KEY dans l’environnement du service rustfs, ou dans le fichier d’environnement utilisé pour la substitution de variables, puis recréez le service avec docker compose up -d rustfs.

Déploiement multi-nœudsCopy Anchor Link

Le réseau bridge par défaut de Docker ne prend pas en charge les déploiements multi-nœuds. Utilisez --network host pour que chaque conteneur puisse communiquer directement avec les autres nœuds.

Exécutez ce qui suit sur chaque nœud :

docker run -d \
  --name rustfs \
  --network host \
  -v /mnt/rustfs/data:/data \
  -e RUSTFS_ACCESS_KEY="<your-access-key>" \
  -e RUSTFS_SECRET_KEY="<your-secret-key>" \
  -e RUSTFS_ADDRESS=":9000" \
  -e RUSTFS_CONSOLE_ADDRESS=":9001" \
  -e RUSTFS_CONSOLE_ENABLE=true \
  -e RUSTFS_OBS_LOGGER_LEVEL=error \
  -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \
  -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \
  rustfs/rustfs:latest

Ajoutez les entrées à /etc/hosts sur chaque nœud :

192.168.1.1 node1
192.168.1.2 node2
192.168.1.3 node3
192.168.1.4 node4

Configuration TLSCopy Anchor Link

Si vous utilisez TLS, montez le répertoire des certificats et indiquez-le à RustFS :

-v /path/to/certs:/certs \
-e RUSTFS_TLS_PATH=/certs \

Avant la productionCopy Anchor Link

Parcourez les listes de contrôle préalables à l’installation — matériel, réseau, logiciels et sécurité — avant de déployer en production. Utilisez un déploiement multi-nœuds, activez TLS, configurez la rotation des journaux et planifiez des sauvegardes régulières.

Étapes suivantesCopy Anchor Link

• Console RustFS
• Configurer un client S3
• Configuration TLS