En cours d'exécution Iroha sur métal nu

Utilisez ce flux de travail lorsque vous voulez exécuter des pairs directement sur les hôtes au lieu de via Docker Compose. L'arbre source actuel fournit Kagami générateurs qui écrivent des génétises correspondantes, configures de pairs, configure du client et scripts de démarrage / arrêt.

1. Construire les binaires

Dans l'espace de travail Iroha en amont:

cargo build --release -p irohad -p iroha_cli -p iroha_kagami

Ce qui produit:

• target/release/irohad pour le daimon par rapport à l'autre
• target/release/iroha pour le CLI
• target/release/kagami pour la génération de clés, d'origine et de réseaux locaux

2. Générer un réseau local

Générer un localnet Iroha 3 à quatre pairs:

target/release/kagami localnet --build-line iroha3 --peers 4 --out-dir ./localnet

Le répertoire de sortie contient les fichiers générés genesis.json, genesis.signed.nrt, peer config.toml, client.toml, scripts d'aide et un README.md généré avec des commandes exactes pour ce paquet.

3. Commencez par des pairs

Pour un localnet jetable généré, utilisez le script généré:

./localnet/start.sh

Si vous devez brancher chaque pair dans un gestionnaire de processus tel que systemd, utilisez la commande de lancement enregistrée en ./localnet/README.md pour chaque pair. Gardez séparément le config.toml, la clé privée, le répertoire de stockage et les ports de chaque pair.

4. Opérer le réseau

Utilisez la configuration du client générée:

target/release/iroha --config ./localnet/client.toml ledger domain list all
target/release/iroha --config ./localnet/client.toml --output-format text ops sumeragi status

Arrêtez le localnet généré avec:

./localnet/stop.sh

5. Notes de production

• Générer de nouvelles clés privées pour la production et les stocker à l'extérieur du dépôt.
• Faites en sorte que tous les pairs soient d'accord sur la même transaction de génèse signée, la topologie, les pairs de confiance et le validateur PoPs.
• Bind l'auditeur s'adresse aux interfaces locales de l'hôte uniquement lorsque le pair ne doit pas être accessible depuis d'autres machines.
• Utilisez un proxy inverse ou un pare-feu pour l'exposition Torii, l'auth de base, TLS et la limitation du taux.
• Traiter les changements apportés à la génèse ou à la topologie du consensus comme des migrations coordonnées, et non comme des modifications de fichiers uniques.

Pour le développement local en container, utilisez le flux de travail Launch Iroha 3 Docker Compose.