Setup Hyperledger Fabric Development Environment

Nanra Sukedy
5 min readFeb 25, 2023

Halo teman-teman semua, selamat datang di medium saya. Kali ini saya ingin berbagi cerita tentang bagaimana cara menyiapkan development environment untuk memulai proses pengembangan Blockchain menggunakan Hyperledger Fabric framework. Tulisan ini juga merupakan catatan pribadi saya jika hendak melakukan proses setup environment. Dan merupakan development environment yang biasa saya gunakan selama melakukan proses development dengan Hyperledger Fabric.

Untuk proses setup ataupun konfigurasi yang kita bahas kali ini khusus untuk lingkungan kerja yang menggunakan OS Linux, khususnya distro turunan dari Debian. Dan distro yang digunakan pada tulisan ini adalah Linux Ubuntu 20.04.03 LTS . Teman-teman silahkan menyesuaikan jika versi Ubuntu yang digunakan berbeda dengan yang saya gunakan, seharusnya no issue jika versi Ubuntu yang digunakan adalah Ubuntu versi 18 keatas.

Pre-requisites Tools

Berikut daftar tools yang perlu di-install pada perangkat komputer yang akan kita gunakan untuk proses development nantinya.:

  • build-essential (latest version)
  • git (latest version)
  • make (latest version)
  • curl (latest version)
  • unzip (latest version)
  • g++ (latest version)
  • libtool (latest version)
  • jq (latest version)
  • libtdl-dev (latest version)

Silahkan menyesuaikan saja jika beberapa dari tools diatas sudah pernah Anda install sebelumnya. Tools-tools diatas dapat di-install melalui Linux terminal menggunakan apt get install <nama-tools> .

Fungsi dari tools diatas adalah sebagai pendukung pada proses development Blockchain yang nantinya akan kita lakukan.

Menginstall Docker

Setelah selesai semua tools pendukung telah selesai Anda install, maka selanjutnya kita perlu menginstall docker. Perlu diingat juga bahwa proses development Blockchain Private ini akan sangat akrab dengan penggunaan teknologi containerization seperti Docker.

Semua Network Component yang akan kita buat nanti menggunakan Hyperledger Fabric akan running as container pada local komputer. Maka diharapkan teman-teman coders sudah familiar dengan Docker untuk memudahkan proses development nantinya.

Adapun docker yang perlu diinstall adalah docker dan docker-compose . Untuk versinya sendiri, silahkan gunakan versi terbaru saja.

Silahkan kunjungi link instalasi berikut ini:

Docker-Engine: https://docs.docker.com/engine/install/ubuntu/

Docker Compose: https://docs.docker.com/compose/install/

Ikuti setiap step dari proses instalsi kedua tools tersebut dengan baik dan pastikan kedua tools tersebut terinstall dengan benar. Jika tidak ada muncul error, maka ketika Anda mengetikkan perintah seperti berikut akan muncul tampilan yang menginfokan versi dari docker & docker-compose yang terinstall:

Tampilan Docker Version

Jika Anda mengalami masalah Docker tidak bisa running pertama kali, silahkan kunjungi link berikut: https://stackoverflow.com/questions/48957195/how-to-fix-docker-got-permission-denied-issueß

Menginstall Golang

Golang merupakan core language dari Hyperledger Fabric (HLF). Semua konfigurasi file dan setup file dari framework mostly menggunakan Golang disamping Bash Script.

Selain itu juga nanti, programming language utama yang digunakan untuk membuat smart contract (chaincode) dari HLF adalah golang. Maka dari itu pada step ini kita harus menginstall Golang.

Untuk mendownload dan menginstall Golang, silahkan kunjungi link berikut:

Download Golang Binary File: https://golang.org/dl/

Installation Guide: https://golang.org/doc/install

Silahkan pilih versi Golang terbaru dan sesuaikan dengan OS yang Anda pakai pada komputer Anda.

Setelah selesai menginstall Golang, berikutnya kita harus menambahkan Golang pada path variable agar terminal mengenali sintaks golang saat kita mengetikkannya pada terminal. Untuk menambahkannya silahkan perhatikan langkah-langkah berikut:

  1. Silahkan buka terminal dan ketikkan perintah
    export GOPATH=$HOME/go
  2. Kemudian ketikkan perintah berikut ini
    export PATH=$PATH:$GOPATH/bin

Jika sudah selesai menambahkan GoPath silahkan ketikkan perintah go version pada terminal untuk memastikan apakah Golang sudah terinstall dengan baik dan akan muncul tampilan seperti dibawah ini:

Tampilan Golang version pada Terminal

Untuk versi golang yang muncul pada tampilan diatas, bisa jadi akan berbeda dengan versi yang Anda install saat membaca tulisan ini.

Menginstall Visual Studio Code

Jika pada Ethereum mungkin kita mengenal IDE Remix untuk proses penulisan Smart Contract, maka pada Hyperledger Fabric proses penulisan chaincode (smart contract) akan menggunakan IDE VSCODE.

Visual Studio Code (VSCODE) merupakan IDE tools rekomendasi saya untuk melakukan proses development Blockchain berbasis Hyperledger Fabric. Karena akan ada beberapa plugins pendukung yang bisa kita gunakan untuk membantu proses development nanti. Salah satunya adalah IBM Developer Tools (nanti akan dibahas pada tulisan terpisah).

Untuk proses menginstall VSCODE, silahkan ikuti langkah-langkah dibawah ini:

  1. Silahkan download .deb package pada alamat berikut ini:
    https://code.visualstudio.com/download
  2. Selanjutnya buka terminal dan masuk pada direktori tempat file .deb package tadi terdownload.
  3. Kemudian ketikkan perintah berikut ini:
    sudo apt install ./<filename>.deb
  4. Tunggu hingga proses instalasi selesai dan berhasil.

Jika semua step sudah selesai, maka silahkan buka terminal dan ketikkan perintah code pada terminal dan akan muncul tampilan seperti dibawah ini:

Tampilan Halaman VSCode Editor

Menginstall IBM Blockchain Developer Plugins

Setelah berhasil menginstall VSCODE, maka langkah terakhir adalah menginstall plugins tools pada VSCODE. Plugins tools ini disediakan oleh IBM untuk mendukung proses development smart contract hingga setup mini-network. Namun untuk awal ini kita cukup menginstallnya terlebih dahulu, nanti akan dibuatkan pembahasan lebih detail bagaimana cara menggunakan tools ini.

Untuk menginstallnya silahkan ikuti langkah-langkah berikut ini:

  1. Silahkan masuk ke menu Plugins pada VSCODE, terdapat pada sidebar kiri dengan logo kotak-kota. Atau untuk memudahkan silagkan tekan Ctrl+Shift+X untuk memunculkan menu Plugins.
  2. Kemudian pada search bar marketplace, silahkan ketikkan nama plugin “IBM Blockchain Platform
  3. Jika sudah ditemukan, maka silahkan klik “Install” dan tunggu hingga proses instalasi selesai dan berhasil.
  4. Jika sudah selesai maka akan muncul icon baru pada sidebar kiri Anda, yaitu logo chip ic.

Berikut tampilan dari IBP tools:

Tampilan IBP Tools pada VSCODE

Penutup

Setelah berhasil melakukan semua proses setup dan konfigurasi development environment, maka kita sudah bisa melakukan proses pengembangan Blockchain private dengan Hyperledger Fabric.

Selanjutnya kita akan membahas bagaimana flow dan step development untuk membuat sebuah jaringan Blockchain Private menggunakan HLF pada tulisan terpisah. Termasuk cara membuat mini-network dan juga test-network dengan Hyperledger Fabric.

Semoga tulisan singkat ini bermanfaat untuk kita semua.

Horas ma dihita sasudena :-) …

Source: Hyperledger Fabric Docs

--

--

Nanra Sukedy

Software Engineer & Permissioned Blockchain Engineer from Bandung, Indonesia