Hyperledger Fabric «Создание вашей первой сети»
Hyperledger Fabric — это инфраструктура блокчейна, которая служит основой для разработки приложений с модульной архитектурой. Это движок с открытым исходным кодом для блокчейна, который заботится о наиболее важных функциях для оценки и использования блокчейна для бизнес-применений. Hyperledger входит в проект Umbrella Project с открытым исходным кодом в рамках Linux Foundation, который помогает в различных областях финансов, банковского дела, IoT, цепочки поставок, производства и технологий. В этой статье основное внимание уделяется обсуждению того, как установить образцы Fabric и как «построить нашу первую сеть».
Предпосылки для образцов ткани Hyperledger
Для запуска первой сети Hyperledger Fabric будет использоваться репозиторий Fabric-samples. Этот репозиторий представляет собой набор двоичных файлов инструментов CLI и образов Docker Fabric, которые помогут вам понять и использовать основы Fabric. Перед запуском проекта установите следующие зависимости:
1. Установите Докер
Установка в Windows: перейдите по ссылке, чтобы установить установку Docker в Windows. Используемые здесь образцы Hyperledger Fabric сильно зависят от сценария bash. Поэтому в окнах, где вам нужно установить докер, рекомендуется использовать WSL2 (подсистема Windows для Linux). Вы можете напрямую установить любую систему Linux по вашему выбору через магазин Windows.
Для WSL2 вам необходимо убедиться, что на рабочем столе Docker включена интеграция, чтобы WSL2 мог правильно взаимодействовать с элементами Docker. вы можете сделать это, зайдя в настройки в графическом интерфейсе рабочего стола docker и на вкладке «Ресурсы», вам нужно найти интеграцию wsl и убедиться, что установлен флажок для включения интеграции.
Примечание:
In case if you are using wsl2 in windows you need to mount your local disk or alternatively you can use mnt command to temporarily mount your local disk at a time.
Установка в Linux: установите последнюю версию Docker, если она еще не установлена. Запустите следующую команду для установки:
sudo apt-get -y install docker-compose
Установка на Mac: для macOS рекомендуется использовать Homebrew для управления предварительными требованиями.
/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)”
Инструменты командной строки Xcode будут установлены как часть установки Homebrew. Как только Homebrew будет готов, установить необходимые предварительные условия очень просто:
Доморощенный v3.x:
brew install –cask –appdir=”/Applications” docker
Для завершения установки необходимо запустить Docker Desktop, поэтому обязательно откройте приложение после его установки:
open /Applications/Docker.app
2. Установите Голанг-го
Установите последнюю версию Go, если она еще не установлена (требуется только при написании приложений Go chaincode или SDK).
Установка на Linux/Windows-wsl2:
sudo apt install golang-go
Установка на Mac:
brew install go@1.18.7
3. Установите JQ
Установите последнюю версию jq, если она еще не установлена (требуется только для транзакций конфигурации канала).
Установка на Linux/Windows-wsl2:
sudo apt install jq
Установка на Mac:
brew install jq
4. Установите узел/java
Вы можете установить Node/java или использовать машинописный текст для запуска запросов по умолчанию, представленных в примерах структуры.
Установка на Linux/Windows-wsl2:
Вы можете установить узел в Linux/wsl2, используя следующую команду:
npm install node
При необходимости для Linux вы можете установить npm с помощью следующей команды:
sudo apt install npm
Установка на Mac:
Установите Node на Mac с помощью следующей команды (npm будет установлен вместе с Node):
brew install node
5. Установка репозитория Fabric-samples
Чтобы начать работу с образцами ткани, установите bash-скрипт Fabric-samples:
curl -sSLO https://raw.githubusercontent.com/hyperledger/fabric/main/scripts/install-fabric.sh && chmod +x install-fabric.sh
Затем вы можете вытащить контейнеры докеров, выполнив одну из этих команд:
./install-fabric.sh docker samples
./install-fabric.sh d s
Чтобы установить двоичные файлы для образцов Fabric, вы можете использовать следующую команду:
./install-fabric.sh binary
После установки всех вышеперечисленных двоичных файлов и контейнеров для компоновки docker вы можете проверить контейнеры для компоновки либо через рабочий стол docker, либо, в случае Linux, вы можете использовать команду docker ps -a для проверки всех доступных контейнеров и их соответствующего статуса.
Создание первой сети
Образцы структуры по умолчанию предоставляют тестовую сеть, которую мы можем использовать для запуска нашей первой сети. Выполните следующие шаги, чтобы построить первую сеть:
Шаг 1: Перейдите через папку Fabric-samples, а затем через сетевую папку Test, где вы можете найти файлы сценариев, с помощью которых мы можем запустить нашу сеть. Тестовая сеть предназначена для изучения Fabric путем запуска узлов на вашем локальном компьютере. Разработчики могут использовать сеть для тестирования своих смарт-контрактов и приложений. Не рекомендуется изменять файл скрипта.
cd fabric-samples/test-network
Шаг 2: Внутри этого каталога вы можете напрямую запустить файл сценария ./network.sh, через который мы запускаем тестовую сеть. По умолчанию мы будем запускать команду ./network.sh down, чтобы удалить все предыдущие сетевые контейнеры или артефакты, которые все еще существуют. Это делается для того, чтобы не возникало конфликтов при запуске новой сети.
./network.sh down
Шаг 3: Теперь вы можете запустить сеть с помощью следующей команды. Эта команда создает коммутационную сеть, состоящую из двух одноранговых узлов и одного узла заказа. Канал не создается при запуске ./network.sh up
./network.sh up
Если вышеуказанная команда завершится успешно, вы увидите журналы создаваемых узлов на картинке ниже:
Поздравляем, вы успешно запустили свою первую сеть Hyperledger Fabric.