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.

Federations can be addressed by their federation ID, which has the form @<account-name>/<federation-name>. The <account-name> is the name of the account that created the federation, and <federation-name> is the name of the federation.

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

The above command will display a table with a row for each federation you are part of. In this case there is one federation: @none/default. Its federation name is default, and it belongs to the none account:

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

Inspecter une Fédération

You can inspect a specific federation by passing its federation ID to flwr federation list. With this command, you will be able to see the following information about a federation:

  • 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.

The flwr federation list --federation <federation-id> command expects the federation ID as an 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.