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.
- Node.js download
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.