Exécuter les Exemples de Démarrage Rapide Flower avec Docker Compose¶

Flower fournit un ensemble de quickstart examples pour vous aider à démarrer avec le framework. Ces exemples sont conçus pour démontrer les capacités de Flower et s’exécutent par défaut en utilisant le Simulation Runtime. Ce guide démontre comment les exécuter en utilisant Flower Deployment Runtime via Docker Compose.

Important

Certaines exemples de démarrage rapide peuvent avoir des limitations ou des exigences qui les empêchent de fonctionner sur tous les environnements. Pour en savoir plus, veuillez consulter Limitations.

Prérequis¶

Avant de commencer, assurez-vous que :

Le flwr CLI est installed localement.
Le daemon Docker est en cours d’exécution.
Docker Compose V2 est installed.

Exécuter l’Exemple de Démarrage Rapide¶

Cloner l’exemple quickstart que vous souhaitez exécuter. Par exemple, quickstart-pytorch:

$ git clone --depth=1 https://github.com/flwrlabs/flower.git \
     && mv flower/examples/quickstart-pytorch . \
     && rm -rf flower && cd quickstart-pytorch

Télécharger le fichier compose.yml dans le répertoire exemple :

$ curl https://raw.githubusercontent.com/flwrlabs/flower/refs/tags/v1.31.0/framework/docker/complete/compose.yml \
    -o compose.yml

Exporter la version de Flower utilisée par votre environnement. Ensuite, construisez et démarrez les services à l’aide de la commande suivante :
```
$ export FLWR_VERSION="1.31.0" # update with your version
$ docker compose up --build -d
```

Localisez le fichier de configuration Flower TOML sur votre machine.

$ flwr config list

Flower Config file: /path/to/.flwr/config.toml
SuperLink connections:
  supergrid
  local (default)

Ajouter une nouvelle connexion SuperLink à votre fichier config.toml et en sauvegarder :
config.toml¶
```
[superlink.local-deployment]
address = "127.0.0.1:9093"
insecure = true
```
Note

Vous pouvez personnaliser la chaîne qui suit superlink. pour répondre à vos besoins. Cependant, veuillez noter que la chaîne ne peut pas contenir un point (.).

Dans cet exemple, local-deployment a été utilisé. N’oubliez simplement de remplacer local-deployment par votre nom choisi dans les deux chaînes superlink. et le commande correspondant flwr run .. Référez-vous au Flower Configuration pour plus d’informations.
Exécuter l’exemple et suivre les journaux du ServerApp :
```
$ flwr run . local-deployment --stream
```

C’est tout ce qu’il vous faut ! Vous pouvez surveiller le progrès de l’exécution à travers les journaux du ServerApp.

Exécuter un Exemple de Démarrage Rapide différent¶

Pour exécuter un autre exemple quickstart, tel que quickstart-tensorflow, commencez par arrêter les services Compose de l’application actuelle :

$ docker compose down

Après cela, vous pouvez répéter les étapes au-dessus.

Limitations¶

Exemple de Démarrage Rapide	Limitations
quickstart-fastai	Aucun
quickstart-huggingface	Aucun
quickstart-jax	Aucun
quickstart-mlcube	L’exemple n’a pas encore été mis à jour pour fonctionner avec la dernière version de `flwr`.
quickstart-mlx	Nécessite une exécution sur macOS avec Apple Silicon.
quickstart-monai	Aucun
quickstart-pandas	Aucun
quickstart-pytorch-lightning	Exige une version pip plus ancienne qui n’est pas prise en charge par les images Docker Flower.
quickstart-pytorch	Aucun
quickstart-sklearn	Aucun
quickstart-tensorflow	Aucun