Инструменты Hyperledger Fabric

Что такое инструменты Hyperledger Fabric?

Инструменты Hyperledger Fabric — это программы командной строки, бинарные файлы, скрипты и вспомогательные утилиты для создания, настройки, эксплуатации, тестирования и устранения неполадок в блокчейн-сетях Hyperledger Fabric.

В контексте криптовалют и блокчейна эти инструменты помогают разработчикам и администраторам управлять сетью с ограниченным доступом, а не общедоступной криптовалютной сетью.

В официальном руководстве по установке Hyperledger Fabric перечислены распространенные бинарные файлы Fabric: peer, orderer, configtxgen, configtxlator, cryptogen, discover, ledgerutil, osnadmin, fabric-ca-client и fabric-ca-server.

Эти инструменты важны, поскольку сеть Fabric нельзя развернуть, просто запустив один кошелек или один узел.

Обычно сеть Fabric включает организации, поставщиков услуг членства (MSP), пиры, ордереры, каналы, чейнкод, политики, сертификаты и клиентские приложения.

Для каждого компонента необходимы собственные настройки и процедуры эксплуатации.

Инструменты Hyperledger Fabric позволяют создавать сертификаты, задавать конфигурацию каналов, устанавливать смарт-контракты, запрашивать данные реестра, управлять каналами ордереров, находить пиры для подтверждения транзакций и исследовать проблемы сети.

Для пользователей криптовалют инструменты Fabric показывают, чем инструментарий для блокчейнов с ограниченным доступом отличается от инструментов для публичных сетей.

Вместо открытого майнинга, публичного стейкинга или переводов нативных токенов инструменты Fabric предназначены для управления идентификацией и доступом, закрытыми каналами, корпоративным управлением, подтверждением транзакций и контролируемым членством в сети.

Почему инструменты Hyperledger Fabric важны

Инструменты Hyperledger Fabric важны, потому что сеть Fabric требует тщательной настройки и постоянного администрирования.

В публичной криптовалютной сети часто достаточно создать адрес и отправить транзакцию, заплатив сетевую комиссию.

Сеть Fabric обычно имеет ограниченный доступ: прежде чем управлять узлами или отправлять транзакции, участникам нужны одобренные идентификаторы и сертификаты.

Поэтому инструментарий необходим для обеспечения доверия к сети.

С его помощью можно определить, кто входит в сеть, что разрешено организациям, какой чейнкод может выполняться, какие пиры должны подтверждать транзакции и как ордереры участвуют в каналах.

Без подходящих инструментов администраторам было бы сложно безопасно управлять файлами политик, сертификатами, артефактами каналов, пакетами чейнкода и проверками реестра.

Инструменты Fabric важны и для разработчиков: чейнкод нужно упаковать, установить, одобрить, зафиксировать в канале, вызвать и запрашивать.

Это не просто технические задачи.

Они обеспечивают соблюдение модели управления блокчейном с ограниченным доступом.

Хорошо настроенный набор инструментов Fabric помогает уменьшить количество ошибок конфигурации, проблем с идентификацией, сбоев подтверждения транзакций и небезопасных развертываний в рабочей среде.

Инструменты Hyperledger Fabric и блокчейн-сети с ограниченным доступом

Hyperledger Fabric — это блокчейн-фреймворк с ограниченным доступом для сетей, где участники известны, а доступ контролируется.

Поэтому его набор инструментов отличается от инструментов для многих публичных криптосетей.

Инструменты Fabric в значительной степени предназначены для работы с идентификацией, членством, сертификатами, политиками каналов и контролем на уровне организаций.

Администратору Fabric может потребоваться создать новую организацию, подключить пир к каналу, одобрить чейнкод от имени этой организации, проверить изменение конфигурации канала или сравнить снимки реестра пиров.

Для этих задач нужны инструменты, учитывающие архитектуру Fabric.

Например, обычного обозревателя блокчейна или публичного кошелька недостаточно для управления политиками подтверждения транзакций Fabric.

Обычного криптокошелька также недостаточно, чтобы зарегистрировать идентификаторы пиров в центре сертификации Fabric.

Поэтому инструменты Hyperledger Fabric следует рассматривать прежде всего как инфраструктурные средства для эксплуатации корпоративного блокчейна.

Они помогают объединить несколько независимых организаций в общую управляемую сеть-реестр.

Поэтому инструментарий Fabric особенно важен для цепочек поставок, финансов, здравоохранения, торговли, логистики, аудита и других сценариев с несколькими участниками.

CLI peer

CLI peer — один из важнейших инструментов Hyperledger Fabric.

В официальной документации по командам peer chaincode указано, что эти команды позволяют вызывать чейнкод и отправлять запросы к нему.

CLI peer используется для многих сетевых операций, включая управление жизненным циклом чейнкода, операции с каналами, запросы к реестру, операции с узлами и проверку версий.

На практике команда peer — основной инструмент, с помощью которого администраторы и разработчики взаимодействуют с пирами через терминал.

Пир — это узел Fabric, который хранит данные реестра и может выполнять чейнкод для моделирования транзакций и их подтверждения.

Поскольку пиры играют центральную роль в обработке транзакций, CLI peer занимает важное место в работе с сетью Fabric.

Разработчики используют его при локальном тестировании для упаковки и установки чейнкода.

Администраторы подключают с его помощью пиры к каналам и проверяют информацию о каналах.

Операторы запрашивают чейнкод и проверяют, правильно ли отвечает сеть.

В контексте криптовалют CLI peer похож на инструмент администрирования узла, но создан для модели Fabric с ограниченным доступом и организациями.

Жизненный цикл чейнкода в peer

Набор инструментов peer lifecycle chaincode управляет современным жизненным циклом чейнкода в Fabric.

В официальной документации по peer lifecycle chaincode объясняется, что администраторы могут упаковывать чейнкод, устанавливать его на пиры, одобрять определение чейнкода для организации и фиксировать это определение в канале.

Этот жизненный цикл важен, поскольку смарт-контракты Fabric регулируются организациями, а не развертываются одним анонимным аккаунтом.

Пакет чейнкода необходимо установить на пиры, которым предстоит его выполнять.

Организации должны одобрить определение чейнкода в соответствии с правилами управления каналом.

Определение содержит такие важные параметры, как имя и версия чейнкода, номер последовательности, политика подтверждения и настройки коллекций.

После того как определение одобрят достаточное количество организаций, его можно зафиксировать в канале.

Этот процесс обеспечивает контролируемое развертывание смарт-контрактов.

Для тех, кто изучает криптовалюты, это отличается от непосредственного развертывания контракта в публичной сети, где один разработчик платит комиссию за газ и публикует код.

В Fabric развертывание чейнкода — это совместное действие в рамках управления сетью, требующее участия одобренных ее членов.

Команда peer channel

Команда peer channel помогает администраторам выполнять операции с каналами со стороны пира.

В официальной документации по peer channel описаны такие операции, как получение блоков, запрос информации о канале, подключение пира к каналу или по снимку, просмотр подключенных каналов, подписание изменений конфигурации и обновление каналов.

Канал Fabric — это закрытое пространство для коммуникации и ведения реестра, общее для выбранных участников сети.

Каналы позволяют разным группам организаций проводить транзакции конфиденциально, используя общую инфраструктуру Fabric.

Поэтому инструменты для работы с каналами важны для обеспечения конфиденциальности и управления.

Например, администратору может понадобиться подключить пир к каналу, чтобы тот вел реестр этого канала.

Другому администратору может понадобиться подписать изменение конфигурации канала, прежде чем сеть примет его.

В терминологии криптовалют канал Fabric — это не то же самое, что платежный канал в публичном блокчейне.

В Fabric канал — это раздел реестра с ограниченным доступом, у которого есть собственные участники, политики, чейнкод и блоки.

Бинарный файл orderer

Бинарный файл orderer запускает узлы службы упорядочивания в сети Fabric.

Узлы службы упорядочивания получают подтвержденные транзакции, упорядочивают их в блоки и передают блоки пирам для проверки и фиксации.

Ордерер — это не майнер в публичном смысле Proof of Work.

Он не конкурирует за решение хеш-задач и не выпускает вознаграждение в виде публичной криптовалюты.

Вместо этого он упорядочивает транзакции в соответствии с настроенной в сети моделью консенсуса.

В современных рабочих сетях Fabric использовался алгоритм упорядочивания Raft с отказоустойчивостью при сбоях. В официальной документации «Что нового в Hyperledger Fabric» отмечено, что в Fabric v3.0 появилась служба упорядочивания с византийской отказоустойчивостью на базе SmartBFT.

Поэтому бинарный файл orderer — ключевой компонент эксплуатации, а не просто вспомогательная утилита.

Администраторам нужно тщательно настраивать ордереры, поскольку упорядочивание влияет на создание каналов, доставку блоков, отказоустойчивость и управление сетью.

В рабочих сетях критически важны безопасность ордереров, настройки TLS, выбор консенсуса, административные конечные точки и мониторинг.

osnadmin

osnadmin — инструмент командной строки для администрирования узлов службы упорядочивания.

В официальной документации по osnadmin channel объясняется, что команда позволяет подключить ордерер к каналу, просматривать список каналов, удалять и обновлять каналы, а также получать блок.

Этот инструмент стал особенно важен, когда Fabric начал отходить от прежних моделей управления через системный канал.

С помощью osnadmin операторы могут работать с API участия в каналах узла службы упорядочивания.

Это важно для сетей, в которых организации ордереров должны управлять тем, в каких каналах участвуют их узлы.

Для работы с osnadmin нужны административные учетные данные, материалы TLS и правильно настроенные конечные точки.

Неправильная команда может повлиять на участие в канале, поэтому инструмент следует использовать в соответствии с четкими эксплуатационными процедурами.

С точки зрения безопасности криптоинфраструктуры osnadmin — инструмент с высокими привилегиями.

Его нельзя считать обычной командой для пользовательского кошелька.

Доступ нужно ограничивать, действия — регистрировать и защищать, а команды — тестировать в среде, не предназначенной для эксплуатации, прежде чем применять их в рабочей сети.

configtxgen

configtxgen — инструмент для генерации конфигурации каналов Hyperledger Fabric.

В официальной документации по configtxgen объясняется, что инструмент создает и проверяет артефакты конфигурации каналов на основе файла configtx.yaml.

Конфигурация канала Fabric определяет организации, политики, возможности, настройки консенсуса, опорные пиры и другие данные управления.

Поскольку Fabric работает с ограниченным доступом, конфигурационные артефакты — не второстепенная деталь.

Они определяют, кто и что может делать в сети.

configtxgen позволяет создавать блоки генезиса, проверять конфигурационные артефакты и выводить определения организаций.

В прежних рабочих процессах этот инструмент также использовался для создания транзакций создания канала, хотя некоторые способы создания каналов менялись с выходом новых версий Fabric.

Разработчики часто впервые сталкиваются с configtxgen при запуске тестовых сетей.

Для администраторов рабочих сетей это серьезный инструмент управления.

Ошибки в configtx.yaml могут привести к некорректным политикам, неправильным определениям организаций или сбоям при настройке каналов.

configtxlator

configtxlator преобразует конфигурационные данные Fabric из двоичного формата protobuf в JSON, удобный для чтения, и обратно.

Блоки конфигурации и обновления Fabric хранятся в структурированных форматах, которые сложно редактировать напрямую.

configtxlator помогает администраторам декодировать, проверять, сравнивать и повторно кодировать конфигурационные данные.

Это полезно при подготовке обновлений конфигурации канала.

Например, администратор может получить блок конфигурации канала, декодировать его в JSON, внести контролируемое изменение, сформировать обновление, закодировать результат, собрать подписи и отправить изменение.

Этот процесс упрощает аудит конфигурации Fabric, но требует осторожности.

Изменение не того поля может повлиять на политику сети или нарушить ожидаемую работу.

В контексте управления криптосетями configtxlator помогает сделать процесс изменения конфигурации прозрачным.

Он позволяет администраторам точно видеть, что изменится, прежде чем обновление будет подписано и зафиксировано.

Командам следует хранить конфигурационные файлы в системе контроля версий и проверять изменения конфигурации так же тщательно, как код смарт-контрактов.

cryptogen

cryptogen создает криптографические материалы для сетей Fabric, прежде всего для демонстрационных и тестовых сред.

В руководстве по установке Hyperledger Fabric cryptogen указан среди бинарных файлов CLI Fabric для взаимодействия с тестовой сетью.

На основе файла crypto-config cryptogen может быстро создавать сертификаты, ключи, папки MSP и материалы TLS.

Поэтому он полезен для учебных материалов, тестирования концепций и локальной разработки.

Однако для управления идентификацией в рабочей среде cryptogen обычно не подходит.

В рабочих сетях следует использовать надлежащий процесс центра сертификации, контролируемую регистрацию, процедуры отзыва, безопасное хранение ключей и управление на уровне организаций.

С точки зрения безопасности криптовалют cryptogen удобен, но не обеспечивает полный жизненный цикл управления идентификаторами.

Он помогает разработчикам изучить структуру идентификаторов Fabric.

Кроме того, с его помощью команды могут быстро развернуть тестовые сети.

Для реальных развертываний обычно предпочтительнее Fabric CA или корпоративная инфраструктура открытых ключей.

fabric-ca-server

fabric-ca-server запускает службу центра сертификации для идентификаторов Hyperledger Fabric.

В официальном руководстве пользователя Fabric CA объясняется, что взаимодействовать с сервером Fabric CA можно через клиент Fabric CA или SDK Fabric.

Идентификаторы играют в Fabric центральную роль: организации, пиры, ордереры, администраторы и приложения используют сертификаты, чтобы подтверждать свою личность.

fabric-ca-server поддерживает регистрацию, получение сертификатов, повторное получение сертификатов, их отзыв, управление подразделениями, атрибутами и выдачей сертификатов.

Это критически важно для безопасности блокчейна с ограниченным доступом.

Если идентификаторами управляют ненадлежащим образом, модель доверия сети оказывается слабой.

Например, идентификатор пира не следует использовать повторно как идентификатор пользователя приложения.

Административный идентификатор не следует хранить на ноутбуке разработчика без необходимых мер контроля.

Fabric CA помогает организациям управлять жизненным циклом идентификаторов.

В контексте криптовалют Fabric CA выступает своеобразным регулятором доступа к сети, тогда как в публичных блокчейнах чаще используют анонимные пары открытых и закрытых ключей.

fabric-ca-client

fabric-ca-client — клиент командной строки для взаимодействия с сервером Fabric CA.

Он позволяет получать и регистрировать идентификаторы, отзывать сертификаты, создавать списки отозванных сертификатов, управлять подразделениями и обновлять сведения об идентификаторах.

В руководстве пользователя Fabric CA приведены примеры регистрации идентификаторов, получения идентификаторов пиров и управления атрибутами через fabric-ca-client.

Этот инструмент особенно важен при подключении новых пиров, ордереров, администраторов и пользователей приложений.

Например, организация может зарегистрировать идентификатор пира, а затем получить его, чтобы создать материалы MSP для этого узла пира.

Кроме того, можно регистрировать идентификаторы клиентов, которые приложения используют для отправки транзакций.

Поскольку fabric-ca-client может влиять на идентификацию и контроль доступа, обращаться с ним нужно осторожно.

Необходимо защищать секреты получения сертификатов, сертификаты администраторов, ключи TLS и папки MSP.

В рабочей среде управление идентификаторами должно включать безопасное резервное копирование, процедуры отзыва, разделение ролей и аудит действий.

Доверие к сети Fabric зависит от надежности идентификаторов, которым разрешено в ней участвовать.

Инструмент discover

Инструмент discover — интерфейс командной строки для функции обнаружения сервисов Fabric.

В официальной документации по обнаружению сервисов объясняется, что служба обнаружения работает на пирах и использует сетевые метаданные, поддерживаемые gossip-протоколом, чтобы находить доступные пиры и соответствующую информацию о политике подтверждения.

Инструмент discover помогает приложениям и администраторам выяснять, какие пиры доступны, какая конфигурация канала используется и какие пиры могут подтвердить транзакцию.

Это полезно, поскольку требования Fabric к подтверждению транзакций могут меняться вместе с определениями чейнкода, политиками и составом участников канала.

Если жестко задавать адреса пиров в каждом приложении, системы могут стать хрупкими.

Обнаружение сервисов позволяет приложениям запрашивать у сети актуальную информацию о конфигурации подтверждения транзакций.

Разработчикам discover помогает находить и устранять проблемы с подключением и подтверждением.

Операторы могут с его помощью проверить, видны ли пиры в сети и правильно ли они настроены.

В контексте криптовалют обнаружение помогает надежно направлять транзакции в сети с ограниченным доступом, где подтверждение зависит от конкретных организаций и пиров.

ledgerutil

ledgerutil — набор утилит для устранения проблем с расхождением данных в реестрах Fabric.

В официальной документации по ledgerutil объясняется, что инструмент позволяет сравнивать снимки каналов с разных пиров и выявлять расхождения в базах данных состояния.

Согласованность реестра критически важна для любой блокчейн-системы.

В Fabric пиры проверяют блоки и поддерживают базу данных состояния реестра.

Если на пирах одного канала для снимков на одной и той же высоте блока отображаются разные хеши состояния, администраторам нужен инструмент для расследования.

ledgerutil сравнивает снимки, выявляет различия в ключах и помогает отследить транзакции, которые изменили соответствующие ключи.

Это не инструмент для ежедневного использования.

Это средство эксплуатации и реагирования на инциденты для администраторов.

В криптоинфраструктуре ledgerutil важен, поскольку даже в блокчейнах с ограниченным доступом необходимы надежные проверки целостности данных.

Даже без публичного майнинга и анонимных валидаторов могут возникать повреждения реестра, сбои базы данных, ошибки конфигурации и эксплуатационные неполадки.

Опытные команды используют ledgerutil и подобные инструменты для диагностики проблем до того, как они приведут к спорам между участниками бизнеса.

Примеры Fabric и инструменты тестовой сети

fabric-samples — распространенная отправная точка для знакомства с инструментами Hyperledger Fabric.

В официальном руководстве по установке объясняется, что установочный скрипт может клонировать репозиторий fabric-samples, загрузить Docker-образы Fabric и бинарные файлы CLI для нужной платформы в каталоги bin и config в fabric-samples.

Тестовая сеть Fabric позволяет изучать Fabric, запуская небольшую сеть локально.

Она подходит для тестирования чейнкода, изучения создания каналов, практики настройки сертификатов и освоения рабочих процессов CLI.

Однако тестовую сеть не следует напрямую копировать в качестве архитектуры для рабочей среды.

Рабочим сетям необходимы более надежное управление сертификатами, политики безопасности, высокая доступность, мониторинг, резервное копирование, защита оборудования и процедуры на уровне организаций.

Для разработчиков тестовая сеть — отличная учебная среда.

Для операторов это изолированная среда, в которой можно отработать команды перед изменением реальных сетей.

Тем, кто изучает криптовалюты, тестовая сеть показывает, как транзакции Fabric проходят подтверждение, упорядочивание, проверку и фиксацию.

Этот процесс сильно отличается от обычной отправки токенов через публичный кошелек.

Docker-образы и инструменты среды выполнения

Инструменты Hyperledger Fabric часто работают совместно с контейнерными образами.

Согласно официальному руководству по установке, установочный скрипт может загружать Docker-образы Fabric и бинарные файлы Fabric CLI.

Docker-образы обычно используются для запуска пиров, ордереров, центров сертификации, сред выполнения чейнкода и компонентов тестовой сети.

Это упрощает локальную разработку: разработчики могут запускать несколько компонентов Fabric на одном компьютере.

Контейнеры часто используются и в рабочей среде, но для этого нужны более надежные средства оркестрации, ведения журналов, мониторинга, управления секретами и защиты сети.

Инструменты среды выполнения нужны не только для запуска контейнеров.

Они помогают убедиться, что узлы используют правильные материалы MSP, сертификаты TLS, переменные среды, файлы конфигурации, тома и порты.

Небольшая ошибка в конфигурации среды выполнения может привести к тому, что пир не сможет подключиться к каналу, а ордерер — безопасно обмениваться данными.

Командам следует считать определения контейнеров и манифесты развертывания частью границы безопасности блокчейн-системы.

Проверка инфраструктуры как кода не менее важна, чем проверка чейнкода.

Fabric Gateway и инструменты приложений

Fabric Gateway — часть более новой модели взаимодействия приложений с Hyperledger Fabric.

В официальной документации «Что нового» отмечено, что в Fabric v2.5 появились новый Fabric Gateway и связанные с ним библиотеки клиентских приложений в рамках выпуска с долгосрочной поддержкой.

Gateway помогает клиентским приложениям отправлять транзакции, избавляя их от необходимости вручную управлять всеми деталями подтверждения.

Для поиска пиров и конфигураций подтверждения он использует обнаружение сервисов.

Для разработчиков это снижает сложность приложений.

Для операторов это помогает сделать процессы выполнения клиентских транзакций более согласованными.

Инструменты приложений важны, поскольку блокчейн-сеть полезна только тогда, когда приложения могут безопасно с ней взаимодействовать.

Приложения Fabric часто используют кошельки, идентификаторы, профили подключений, клиенты Gateway, ключи для подписания и логику транзакций.

Эти компоненты не относятся к чейнкоду, но не менее важны для реальных развертываний.

В контексте криптовалют инструменты Fabric для приложений связывают бизнес-пользователей с реестром и при этом сохраняют контроль доступа на основе идентификаторов и правила подтверждения транзакций.

Инструменты Hyperledger Fabric и разработка чейнкода

Чейнкод — термин Fabric для логики смарт-контрактов.

Инструменты Hyperledger Fabric поддерживают разработку чейнкода от локального тестирования до утверждения для рабочей среды.

Разработчики пишут чейнкод на поддерживаемых языках общего назначения, упаковывают его, устанавливают на пиры, одобряют определения, фиксируют их в каналах, вызывают функции и запрашивают состояние.

Команды peer lifecycle chaincode занимают центральное место в этом процессе.

Для разработки чейнкода также нужны инструменты тестирования, журналы, сборка контейнеров, управление зависимостями и понимание работы базы данных состояния.

Разработчикам следует избегать недетерминированной логики, поскольку пиры, подтверждающие транзакции, должны выдавать совпадающие результаты для их проверки.

Кроме того, важно понимать политики подтверждения: для выполнения функции чейнкода могут требоваться подписи определенных организаций.

При разработке публичных смарт-контрактов основное внимание часто уделяют необратимости развертывания и расходам на газ.

При разработке чейнкода Fabric важнее управляемое развертывание, корректность подтверждения, правила идентификации, приватные данные и детерминированное выполнение.

Инструменты Fabric помогают соблюдать этот жизненный цикл корпоративных смарт-контрактов.

Инструменты Hyperledger Fabric и безопасность

Безопасность — одна из главных причин, по которым с инструментами Fabric нужно обращаться осторожно.

Многим инструментам нужен доступ к приватным ключам, сертификатам администраторов и TLS, папкам MSP, артефактам каналов или конечным точкам сети.

Если эти файлы окажутся раскрыты, злоумышленник может выдать себя за администратора, отправить несанкционированные транзакции или нарушить работу сети.

Команды fabric-ca-client, osnadmin, peer channel и peer lifecycle могут влиять на важные данные состояния сети.

Поэтому доступ к инструментам должен предоставляться только уполномоченным операторам на основе ролей.

Секреты нельзя хранить в общедоступных репозиториях.

При необходимости сертификаты нужно менять.

Процедуры отзыва следует тестировать.

Инструменты для рабочей среды должны запускаться с защищенных административных компьютеров или в контролируемых конвейерах CI/CD.

В журналах аудита нужно фиксировать, кто и когда выполнял команды, существенно влияющие на работу сети.

В криптоинфраструктуре даже мощный инструмент опасен, если для его использования не предусмотрены надежные меры контроля.

Инструменты Hyperledger Fabric и приватные данные

Fabric поддерживает коллекции приватных данных, которые позволяют выбранным организациям обмениваться конфиденциальными данными о транзакциях, одновременно записывая их хеши в реестр канала.

Здесь инструменты важны, поскольку настройки приватных данных входят в конфигурацию чейнкода и управление каналом.

Администраторам может понадобиться одобрить определения чейнкода с настройками коллекций приватных данных.

Разработчикам может понадобиться проверить, видны ли приватные данные только авторизованным пирам.

Операторам может потребоваться устранить сбои подтверждения, вызванные проблемами с доступом к приватным данным.

Это важно для корпоративных блокчейнов: не все данные в них могут быть общедоступными.

Например, в сети цепочки поставок может потребоваться предоставить общее подтверждение, не раскрывая всем участникам каждую коммерческую деталь.

Инструменты Fabric помогают найти баланс между проверяемостью и конфиденциальностью.

Однако проектировать работу с приватными данными всё равно нужно тщательно.

Ошибки в политиках коллекций могут привести к раскрытию избыточных данных или помешать необходимым участникам подтверждать транзакции.

Инструменты Hyperledger Fabric и мониторинг

Инструменты Fabric предназначены не только для настройки сети.

Они также полезны для мониторинга и обслуживания.

Администраторы могут использовать команды peer, чтобы проверять членство в каналах и состояние узлов.

Команда osnadmin позволяет просматривать участие ордереров в каналах.

С помощью discover можно проверить видимость пиров и конфигурации подтверждения.

В редких, но серьезных случаях расследования проблем с согласованностью реестра можно использовать ledgerutil.

Эксплуатационный мониторинг должен также охватывать журналы, метрики, срок действия сертификатов, использование диска, высоту блоков, сбои подтверждения, коды проверки транзакций и состояние ордереров.

Сбои блокчейн-систем могут отличаться от сбоев обычных веб-приложений.

Пользователь может увидеть ошибку отправки транзакции, хотя ее причиной на самом деле окажутся политика подтверждения, истекший срок действия идентификатора, неправильная настройка gossip-протокола, недоступность ордерера или проблемы с базой данных состояния.

Инструменты Fabric помогают сузить круг причин.

Опытная эксплуатационная команда использует их вместе с панелями мониторинга, оповещениями, инструкциями и процедурами реагирования на инциденты.

Использование в рабочей и тестовой среде

Некоторые инструменты Hyperledger Fabric подходят и для разработки, и для рабочей среды, тогда как другие предназначены в основном для тестирования.

CLI peer, osnadmin, fabric-ca-client и инструменты configtx можно использовать в рабочей среде при условии правильного обращения с ними.

cryptogen полезен для тестирования и обучения, но в рабочей среде его обычно следует заменить надлежащим процессом центра сертификации.

Тестовая сеть отлично подходит для обучения, но не должна служить образцом архитектуры рабочей сети.

Для рабочих сетей нужны формальное управление, безопасное управление ключами, аварийное восстановление, высокая доступность пиров и ордереров, мониторинг, политика резервного копирования, управление жизненным циклом сертификатов и одобрение изменений.

Разработчики могут ставить во главу угла скорость и простоту.

Операторы рабочих сетей должны в первую очередь заботиться о безопасности, воспроизводимости, возможности аудита и устойчивости.

Это различие важно, поскольку многие начинающие пользователи Fabric сначала осваивают локальные скрипты.

Такие скрипты полезны, но для реальных сетей нужна более надежная эксплуатационная архитектура.

Распространенные проблемы с инструментами Hyperledger Fabric

Одна из распространенных проблем — использование бинарных файлов Fabric неподходящей версии для версии сети.

Несоответствие версий может вызвать неожиданное поведение команд или проблемы совместимости.

Другая распространенная проблема — неправильно заданные переменные среды, особенно путь MSP, настройки TLS, адрес пира, адрес ордерера и имя канала.

Третья проблема — истекший срок действия сертификатов или отсутствие файлов центра сертификации.

Четвертая — использование материалов, созданных cryptogen, там, где требуется полноценное управление жизненным циклом идентификаторов.

Пятая — одобрение определений чейнкода с несогласованными номерами последовательности, идентификаторами пакетов или политиками подтверждения.

Шестая — изменение конфигурации канала без тщательной проверки.

Седьмая — предположение, что команда сработала, без проверки высоты блока, зафиксированного определения, статуса проверки или журналов пира.

Инструменты Fabric обладают широкими возможностями, но требуют точности.

Небольшая ошибка в имени, пути или политике может остановить даже правильно выстроенный рабочий процесс.

Рекомендации по использованию инструментов Hyperledger Fabric

Используйте официальную документацию и бинарные файлы, соответствующие версии вашей сети Fabric.

Храните инструменты Fabric CLI в контролируемом каталоге и не допускайте случайного смешивания версий.

Перед изменениями в рабочей сети отрабатывайте команды на тестовых сетях.

Защищайте папки MSP, приватные ключи, материалы TLS и сертификаты администраторов.

Для управления жизненным циклом идентификаторов в рабочей среде используйте Fabric CA или корпоративную инфраструктуру открытых ключей.

Храните файлы конфигурации в системе контроля версий, включая configtx.yaml, core.yaml, orderer.yaml и файлы коллекций чейнкода.

Проверяйте обновления конфигурации каналов до их подписания.

Во всех организациях последовательно используйте команды peer lifecycle.

После важных изменений проверяйте журналы пиров, ордереров, центров сертификации и Gateway.

Документируйте каждую рабочую команду, которая меняет состояние сети.

FAQ

Что такое инструменты Hyperledger Fabric?

Инструменты Hyperledger Fabric — это утилиты командной строки, бинарные файлы, скрипты и вспомогательные программы для настройки, эксплуатации, разработки и устранения неполадок в блокчейн-сетях Fabric.

Какой инструмент Hyperledger Fabric самый важный?

CLI peer — один из самых важных инструментов, поскольку он поддерживает операции с чейнкодом, каналами, узлами и реестром.

Что делает configtxgen?

configtxgen создает и проверяет артефакты конфигурации каналов на основе файлов конфигурации Fabric.

Что делает configtxlator?

configtxlator преобразует конфигурационные данные Fabric из двоичного формата protobuf в JSON и обратно, чтобы администраторы могли проверять данные и готовить изменения конфигурации.

Что делает cryptogen?

cryptogen создает криптографические материалы для сетей Fabric, в основном для разработки, тестирования и демонстрационных сред.

Что делает fabric-ca-client?

fabric-ca-client взаимодействует с сервером Fabric CA, позволяя получать и регистрировать идентификаторы, отзывать сертификаты, управлять подразделениями и выполнять другие задачи, связанные с сертификатами.

Что делает fabric-ca-server?

fabric-ca-server запускает службу центра сертификации, которая выдает идентификаторы и управляет ими в сети Fabric.

Что делает osnadmin?

osnadmin управляет участием ордереров в каналах: подключает и отключает каналы, показывает их список, обновляет каналы и получает информацию о них с узлов службы упорядочивания.

Что делает discover в Hyperledger Fabric?

discover обращается к службе обнаружения Fabric, чтобы находить пиры, получать конфигурацию каналов и сведения о подтверждении транзакций.

Что делает ledgerutil?

ledgerutil помогает администраторам устранять расхождения в реестре: сравнивать снимки и выявлять различия состояния, связанные с транзакциями.

Используются ли инструменты Hyperledger Fabric для публичной торговли криптовалютами?

Нет. Инструменты Hyperledger Fabric применяются для администрирования и разработки блокчейн-сетей с ограниченным доступом, а не для публичной торговли криптовалютами.

Можно ли использовать cryptogen в рабочей среде?

cryptogen предназначен главным образом для тестирования и обучения, а в рабочих сетях обычно следует использовать Fabric CA или другой контролируемый процесс на базе инфраструктуры открытых ключей.

Заключение

Инструменты Hyperledger Fabric — это практические утилиты командной строки и средства эксплуатации, с помощью которых можно создавать сети Fabric и управлять ими.

Они охватывают идентификацию, сертификаты, каналы, пиры, ордереры, чейнкод, конфигурацию, обнаружение сервисов и поиск проблем в реестре.

К наиболее распространенным инструментам относятся peer, orderer, configtxgen, configtxlator, cryptogen, discover, ledgerutil, osnadmin, fabric-ca-client и fabric-ca-server.

Каждый инструмент поддерживает отдельную часть архитектуры Fabric.

Команды peer управляют чейнкодом, каналами и операциями на стороне пиров.

configtxgen и configtxlator предназначены для управления конфигурацией каналов.

Инструменты fabric-ca управляют идентификаторами и жизненным циклом сертификатов.

osnadmin управляет участием ордереров в каналах.

discover помогает приложениям и администраторам находить пиры и конфигурации подтверждения.

ledgerutil помогает расследовать серьезные проблемы с согласованностью реестра.

Для тех, кто изучает криптовалюты, эти инструменты показывают, чем работа с блокчейном с ограниченным доступом отличается от использования кошелька в публичной сети.

Fabric не зависит от анонимных майнеров или нативного токена для публичной торговли.

Работа Fabric основана на организациях, политиках, сертификатах, каналах, подтверждении и упорядочивании транзакций, а также контролируемом членстве.

Поэтому набор инструментов — ключевая часть доверия к сети.

При правильном использовании инструменты Hyperledger Fabric помогают создавать безопасную, поддающуюся аудиту и управляемую блокчейн-инфраструктуру.

При неосторожном использовании те же инструменты могут привести к ошибкам идентификации, нарушению политик, сбоям развертывания и рискам для безопасности при эксплуатации.

Надежнее всего сначала освоить инструменты в тестовой сети, пользоваться официальной документацией, защищать учетные данные, проверять каждое изменение конфигурации и относиться к командам Fabric для рабочей среды как к операциям с критически важной инфраструктурой.