Pré-requisitos

Antes de iniciar, se ainda não tiver feito isso, você pode verificar se possui todos os pré-requisitos abaixo instalados na(s) plataforma(s) na qual desenvolverá aplicativos blockchain e/ou operará o Hyperledger Fabric.

Instale Git

Baixe a última versão do git se ainda não estiver instalado ou se você tiver problemas ao executar os comandos curl.

Instale cURL

Baixe a última versão da ferramenta cURL se ainda não estiver instalado ou se você receber erros ao executar os comandos curl da documentação.

Nota

Se você estiver no Windows, por favor consulte a nota de especificação abaixo em Windows extras.

Docker e Docker Compose

Você precisará das seguintes instalações em sua plataforma em que estiver operando ou desenvolvendo em (ou para) Hyperledger Fabric:

  • MacOSX, *nix, ou Windows 10: Docker Necessário Docker versão 17.06.2-ce ou superior.
  • Versões antigas do Windows: Docker Toolbox - novamente, necessário Docker versão 17.06.2-ce ou superior.

Você pode checar a versão do Docker instalada com o seguinte comando em um prompt de terminal:

docker --version

Nota

As seguintes instruções se aplicam a sistemas Linux executando o systemd.

Certifique-se de que o daemon do Docker esteja em execução.

sudo systemctl start docker

Opcional: Se você quiser que o daemon do Docker seja iniciado quando o sistema for iniciado, use o comando:

sudo systemctl enable docker

Adicione um usuário para seu grupo docker.

sudo usermod -a -G docker <username>

Nota

A instalação do Docker para Mac ou Windows, ou do Docker Toolbox também instalará o Docker Compose. Se você já instalou o Docker, você deve checar se o Docker Compose está na versão 1.14.0 ou superior instalada. Se não, nós recomendamos que você instale a versão mais recente do Docker.

Você pode checar a versão do Docker Compose instalado com o seguinte comando em um prompt de terminal:

docker-compose --version

Linguagem de programação Go

Hyperledger Fabric utiliza a linguagem de programação Go para muitos de seus componentes.

  • Go versão 1.14.x é necessária.

Dado que nós vamos escrever programas chaincode em Go, existem duas variáveis de ambiente que você precisará definir corretamente; você pode tornar estas configurações permanente colocando-as no arquivo de inicialização apropriado, sendo seu arquivo pessoal ~/.bashrc se você estiver usando o shell bash no Linux.

Primeiro, você deve definir a variável de ambiente GOPATH para o apontar para a área de trabalho Go que contém a base de código do Fabric baixada, algo como:

export GOPATH=$HOME/go

Nota

Você deve definir a variável GOPATH

Mesmo que, no Linux, a variável GOPATH de Go possa ser uma lista de diretórios separados por dois pontos, e usará um valor padrão de $HOME/go se não estiver definido, a estrutura de construção do framework Fabric atual ainda requer a definição e exportação dessa variável, e ela deve conter somente o nome do diretório único para o espaço de trabalho Go. (Esta restrição pode ser removida em uma versão futura)

Em segundo lugar, você deve (novamente, no arquivo de inicialização apropriado) estender seu caminho de pesquisa para incluir o diretório Go bin, tal como é seguido no exemplo a seguir para bash no Linux:

export PATH=$PATH:$GOPATH/bin

Enquanto este diretório possa não existir em uma nova instalação do espaço de trabalho Go, este é preenchido posteriormente pelo sistema de compilação do Fabric com um pequeno número de executavéis Go usados por outras partes do sistema de compilação. Portanto, mesmo que você ainda não tenha esse diretório, estenda o caminho de pesquisa do shell como acima.

Node.js Runtime e NPM

Se você vai desenvolver aplicações para Hyperledger Fabric aproveitando o SDK do Hyperledger Fabric para Node.js, a versão 8 é compatível com a versão 8.9.4 e superior. A versão 10 de Node.js é compatível com 10.15.3 e superior.

Nota

Instalando Node.js vai também instalar o NPM, no enquanto, é recomendado que você confirme a versão do NPM instalada. Você pode atualizar a ferramenta npm com o seguinte comando:

npm install npm@5.6.0 -g

Python

Nota

O seguinte se aplica somente aos usuários do Ubuntu 16.04.

Por padrão o Ubuntu 16.04 vem com Python 3.5.1 instalado como o binário do python3. O Fabric Node.js SDK requer uma iteração do Python 2.7 para que as operações com npm install sejam completadas com sucesso. Recupere a versão 2.7 com o seguinte comando:

sudo apt-get install python

Cheque sua(s) versão(ões):

python --version

Windows extras

Se você estiver desenvolvendo no Windows 7, convém trabalhar dentro do Terminal Docker Quickstart. No enquanto, por padrão, ele usa um antigo Git Bash e a experiencia tem mostrado que este é um ambiente de desenvolvimento escasso e com funcionalidades limitadas. Ele é adequado para executar cenários baseados em Docker, como Getting Started, mas você terá dificuldades com operações envolvendo os comandos make e docker.

Em vez disso, é recomendado usar o ambiente MSYS2 e execute o make e docker a partir do shell de comando MSYS2. Para fazer isso, instale o MSYS2 (junto com o conjunto de ferramentas do desenvolvedor básico e pacotes gcc usando pacman) e inicie o Docker Toolbox a partir do shell MSYS2 com o seguinte comando:

/c/Program\ Files/Docker\ Toolbox/start.sh

Alternativamente, você pode alterar o comando Docker Quickstart Terminal para usar o bash MSYS2 alterando o destino do atalho do Windows de:

"C:\Program Files\Git\bin\bash.exe" --login -i "C:\Program Files\Docker Toolbox\start.sh"

para:

"C:\msys64\usr\bin\bash.exe" --login -i "C:\Program Files\Docker Toolbox\start.sh"

Com a alteração acima, você pode agora simplesmente iniciar o Docker Quickstart Terminal e obter o ambiente adequado.

No Windows 10 você deve usar a distribuição nativa do Docker e pode usar o Windows PowerShell. No entanto, para que o comando binaries tenha sucesso você ainda precisará ter o comando uname disponível. Você pode obtê-lo como parte do Git, porém cuidado, pois apenas a versão de 64bit é compatível.

Antes de executar qualquer comando de git clone, execute os seguintes comandos:

git config --global core.autocrlf false
git config --global core.longpaths true

Você pode checar as configurações desses paramêtros com os seguintes comandos:

git config --get core.autocrlf
git config --get core.longpaths

Eles precisam ser false (falso) e true (verdadeiro) respectivamente.

O comando curl que vem com o Git e Docker Toolbox é antigo e não lida corretamente com o redirecionamento usado em Getting Started. Certifique-se de ter e usar uma versão mais recente, a qual pode ser baixada na página de download cURL.

Para Node.js você também vai precisar necessariamente da ferramenta de compilação do Visual Studio C++, a qual está disponivel gratuitamente e pode ser instalada seguindo o comando:

npm install --global windows-build-tools

Veja a página NPM windows-build-tools para mais detalhes.

Uma vez feito isso, você também deve instalar o módulo NPM GRPC com o seguinte comando:

npm install --global grpc

Seu ambiente deve estar agora pronto para passar para exemplos e tutoriais em Getting Started.

Nota

Se você tem perguntas/dúvidas não respondidas nesta documentação, ou com qualquer um dos tutoriais, visite a página Still Have Questions? para algumas dicas sobre onde encontrar ajuda adicional.