1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/thoughtworks-fabric-sdk-go

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
Внести вклад в разработку кода
Синхронизировать код
Отмена
Подсказка: Поскольку Git не поддерживает пустые директории, создание директории приведёт к созданию пустого файла .keep.
Loading...
README.md

Гиперледжер Фабрик Клиент SDK для Go

Релиз Лицензия Документация GoDoc

Статус сборки Codecov Отчет GoReportCard

Этот SDK позволяет разработчикам на Go создавать решения, взаимодействующие с Hyperledger Fabric.

Начало работы

Получите пакеты клиентского SDK для Fabric и Fabric CA.

go get github.com/hyperledger/fabric-sdk-go

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

Документация

Документация SDK доступна по адресу GoDoc.

Пакеты, предназначенные для конечного пользователя, находятся в папке pkg/client вместе с основным пакетом SDK (pkg/fabsdk).

Если вы хотите использовать модель программирования Fabric "Gateway", то API находится в папке pkg/gateway.

Примеры- E2E Тест: Базовый пример, использующий SDK для запросов и выполнения транзакций

Сообщество

  • Обсуждение происходит в Rocket Chat.
  • Отслеживание проблем осуществляется в Jira.

Клиентский SDK

Текущая совместимость

Тесты интеграции SDK выполняются против трёх версий Fabric с тэгами:

  • prev (текущая v1.4.7)
  • stable (текущая v2.2.0)
  • prerelease (текущая отключена)

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

Устаревшие версии

Когда уровень кода 'prev' обновляется, последний протестированный коммит или тэг fabric-sdk-go указан ниже.

  • fabric v1.3: ac70276
  • fabric v1.2: 5e291d3
  • fabric v1.1: f7ae259
  • fabric v1.0: 5ac5226### Выполнение набора тестов

Получите пакеты клиентского SDK для Fabric и Fabric CA.

git clone https://github.com/hyperledger/fabric-sdk-go.git
# В директории Fabric SDK Go
cd fabric-sdk-go/

# Опционально — автоматическая установка Go инструментов, используемых тестовым набором
# make depend

# Выполнение тестового набора
make

# Очистка артефактов выполненного тестового набора
make clean

Теги Go

Следующие теги Go могут быть предоставлены для включения дополнительной функциональности:

  • experimental: включает поддержку экспериментальных функций.

Вклад в Go SDK

Если вы хотите внести свой вклад в Go SDK, пожалуйста, выполните тестовый набор и отправьте патчи для проверки. Для общих руководств обратитесь к странице вклада проекта Fabric.

Необходимо иметь:

  • Go 1.14
  • Make
  • Docker
  • Docker Compose
  • Git
  • gobin (GO111MODULE=off go get -u github.com/myitcv/gobin)
  • libtool

Примечания:

  • Зависимости обрабатываются с помощью Go модулей.

Выполнение части тестового набора

# В директории Fabric SDK Go
cd fabric-sdk-go/

# Опционально — автоматическая установка Go инструментов, используемых тестовым набором
# make depend

# Опционально — выполнение только проверок кода (линтеры, лицензия, орфография и т.д.)
# make checks

# Выполнение всех юнит-тестов и проверок
make unit-test

# Выполнение всех тестов интеграции
make integration-test
```### Выполнение юнит-тестов пакета вручную

```bash
# В директории пакета
go test

Запуск интеграционных тестов вручную

Для этого вам потребуется:

  • Установленная рабочая среда Fabric и fabric-ca. Рекомендуется использовать файл docker-compose, предоставленный в test/fixtures/dockerenv. Также рекомендуется использовать стандартные настройки .env, предоставляемые в test/fixtures/dockerenv. См. шаги ниже.
  • Настроенные параметры в файле test/fixtures/config/config_test.yaml, если ваша сеть Hyperledger Fabric не работает на localhost или использует другие порты.

Тестирование с образами Fabric на Docker Hub

Пакет тестов по умолчанию использует последнюю совместимую версию образов Fabric на Docker Hub. Следующие команды запускают Fabric:

# В директории Fabric SDK Go
cd fabric-sdk-go

# Запустить Fabric (стабильная версия)
make dockerenv-stable-up

# Или более общее запуск Fabric на другом уровне кода (prev, stable, prerelease, devstable)
# make dockerenv-[CODELEVEL]-up

Запуск интеграционных тестов

Fabric теперь должен быть запущен. В другой консоли запустите интеграционные тесты

# В директории Fabric SDK Go
cd fabric-sdk-go
```# Используйте скрипт для установки параметров для интеграционных тестов и выполнения их
# Ранее мы использовали хостнеймы, такие как сервер Fabric CA, заказчик и пир, указывающие на localhost
# Теперь, так как это было удалено, мы будем использовать другой файл конфигурации config_test_local.yaml,
# который имеет сервер Fabric CA, заказчика и пиры, указывающие на localhost
# Также можно запустить интеграционные тесты непосредственно через go test. Например:
# cd fabric-sdk-go/test/integration/
# go test -args testLocal=true# cd fabric-sdk-go/test/integration/orgs
# go test -args testLocal=true 

# Вы должны просмотреть файл test/scripts/integration.sh для вариантов и деталей.
# Примечание: вы обычно предпочитаете скриптовую версию для установки параметров.
# Раньше мы использовали хостнеймы, такие как сервер Fabric CA, заказчик и пир, указывающие на localhost
# Теперь, поскольку это было удалено, мы будем использовать другой файл конфигурации config_test_local.yaml,
# который имеет сервер Fabric CA, заказчика и пиры, указывающие на localhost
# Также можно запустить интеграционные тесты непосредственно через go test. Например:
# cd fabric-sdk-go/test/integration/
# go test -args testLocal=true

# cd fabric-sdk-go/test/integration/orgs
# go test -args testLocal=true 

# Вы должны просмотреть файл test/scripts/integration.sh для вариантов и деталей.
# Примечание: вы обычно предпочитаете скриптовую версию для установки параметров.

Тестирование с локальной сборкой Fabric (Продвинутый)

Вместо этого вы можете использовать локальное сборочное окружение Fabric с помощью следующих команд:

# Запустите Fabric (уровень кода devstable с последними тегами Docker)
make dockerenv-latest-up

Лицензия

Программное обеспечение Hyperledger Fabric SDK Go лицензировано под лицензией Apache License Version 2.0.


Этот документ лицензирован под лицензией Creative Commons Attribution 4.0 International License.

Комментарии ( 0 )

Вы можете оставить комментарий после Вход в систему

Введение

Описание недоступно Развернуть Свернуть
Go и 3 других языков
Apache-2.0
Отмена

Обновления

Пока нет обновлений

Участники

все

Недавние действия

Загрузить больше
Больше нет результатов для загрузки
1
https://api.gitlife.ru/oschina-mirror/thoughtworks-fabric-sdk-go.git
git@api.gitlife.ru:oschina-mirror/thoughtworks-fabric-sdk-go.git
oschina-mirror
thoughtworks-fabric-sdk-go
thoughtworks-fabric-sdk-go
v1.0.0-gm