Note

Flower Gestion de la fédération est une nouvelle fonctionnalité introduite dans Flower 1.24.0. Elle gagne de nouvelles fonctionnalités dans les versions ultérieures. Les modifications à la fonctionnalité décrite dans ce guide sont également attendues, car les fonctionnalités fournies via les commandes flwr federation mûrissent.

Gérer les fédérations Flower

Une fédération Flower est composée d’un ensemble d’utilisateurs et de certains ou tous les SuperNodes qu’ils possèdent qui sont enregistrés avec le même SuperLink. Les membres d’une fédération Flower peuvent exécuter des runs (par exemple, pour fédérer l’entraînement d’un modèle AI) sur tous les SuperNodes qui en font partie.

Les fédérations peuvent être adressées par leur identifiant unique, qui a la forme @<account-name>/<federation-name> étant donné que <account-name> est le nom de l’account qui a créé la fédération et <federation-name> est le nom donné à la fédération au moment du création.

Dans ce guide pratique, vous allez:

  • Apprendre à voir les fédérations dont vous faites partie.

  • Apprendre à afficher des informations sur une fédération spécifique.

Note

Ce guide couvre l’inspection de fédérations via la ligne de commande Flower lorsqu’on utilise un SuperLink auto-hébergé. Pour créer et gérer les fédérations dans le tableau de bord SuperGrid, voir Créez et Gérez les Fédérations sur SuperGrid.

Lister les Fédérations

Avec le Flower CLI, vous pouvez facilement inspecter les fédérations dont votre compte Flower fait partie:

$ flwr federation list

Le commande ci-dessus affichera une table avec une ligne pour chaque fédération dont vous faites partie. Dans ce cas, il n’y a qu’une seule fédération nommée default sous le compte none :

📄 Listing federations...
┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━┓
┃  Federation   ┃                    Description                     ┃  Runtime   ┃ Status ┃
┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━┩
│ @none/default │ A federation for testing and development purposes. │ deployment │ active │
└───────────────┴────────────────────────────────────────────────────┴────────────┴────────┘

Inspecter une Fédération

Vous pouvez inspecter une fédération spécifique en fournissant l’identifiant de la fédération à la commande flwr federation list. Avec cette commande, vous pourrez voir les informations suivantes sur une fédération :

  • Les membres de la fédération.

  • Les SuperNodes enregistrés avec la fédération et leur statut.

  • Les runs exécutés via la fédération.

La commande flwr federation list --federation <federation> nécessite l’identifiant de la fédération à inspecter comme argument :

$ flwr federation list local-deployment --federation="@none/default"

Ensuite, supposons qu’il y ait deux SuperNodes connectés et que trois exécutions aient été soumises via la fédération, un exemple d’sortie représentatif serait similaire à :

📄 Showing ' @none/default' federation ...
    Federation Members
┏━━━━━━━━━━━━━━┳━━━━━━━━┓
┃ Account Name ┃  Role  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━┩
│ none         │ Member │
└──────────────┴────────┘
       SuperNodes in the Federation
┏━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━┓
┃       Node ID        ┃ Owner ┃ Status ┃
┡━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━┩
│ 1277309880252492806  │ none  │ online │
├──────────────────────┼───────┼────────┤
│ 13280365719060659445 │ none  │ online │
└──────────────────────┴───────┴────────┘
                            Runs in the Federation
┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃       Run ID        ┃             App            ┃       Status       ┃ Elapsed  ┃
┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ 6665860355925098787 │ @flwrlabs/vision==1.0.0    │ finished:completed │ 00:00:24 │
├─────────────────────┼────────────────────────────┼────────────────────┼──────────┤
│ 6896250833792831197 │ @flwrlabs/analytics==2.0.0 │ finished:stopped   │ 00:00:08 │
├─────────────────────┼────────────────────────────┼────────────────────┼──────────┤
│ 3918106370412458251 │ @flwrlabs/llm==1.5.0       │ running            │ 00:00:02 │
└─────────────────────┴────────────────────────────┴────────────────────┴──────────┘

Notez comment la table SuperNodes montre un sous-ensemble des informations disponibles via la commande flwr supernode list (En savoir plus sur cette commande dans le guide Authentifier les SuperNodes). De même, la table Runs montre un sous-ensemble des informations disponibles via la commande flwr list.