Instale exemplos, executáveis e imagens Docker

Enquanto trabalhamos no desenvolvimento de instaladores de verdade para os executáveis do Hyperledger Fabric, fornecemos um script que irá baixar e instalar exemplos e executáveis para o seu sistema. Pensamos que você irá achar as aplicações de exemplo instaladas úteis para aprender mais sobre os recursos e operações do Hyperledger Fabric.

Nota

Se você estiver executando no Windows, você vai querer usar o Docker Quickstart Terminal para os próximos comandos de terminal. Visite o Pré-requisitos se você não instalou anteriormente isto.

Se você estiver usando o Docker Toolbox ou macOS, você

precisará usar um local em /Users (macOS) para instalar e executar os exemplos.

Se você estiver usando o Docker para Mac, você precisará usar um local em /Users, /Volumes, /private ou /tmp. Para usar uma localização diferente, consulte a documentação do Docker sobre

compartilhamento de arquivos.

Se você estiver usando o Docker para Windows, consulte a documentação do Docker

e use um local em um dos drives compartilhados.

Determine um local em sua máquina onde você deseja colocar o repositório fabric-samples e entre nesse diretório em uma janela de terminal. O comando a seguir executará as seguintes etapas:

  1. Se preciso, clona o repositório hyperledger/fabric-samples
  2. Faz o checkout da tag na versão apropriada
  3. Instala os executáveis e arquivos de configuração do Hyperledger Fabric específicos da sua plataforma,
    para a versão especificada, nos diretórios /bin e /config do fabric-samples
  4. Baixa as imagens docker do Hyperledger Fabric para a versão especificada

Assim que você estiver pronto, e no diretório em que irá instalar os exemplos e executáveis do Fabric, vá em frente e execute o comando para baixar os binários e as imagens.

Nota

Se você quiser a versão de produção mais recente, omita todos os identificadores de versão.

curl -sSL https://bit.ly/2ysbOFE | bash -s

Nota

Se deseja uma versão específica, passe um identificador de versão para as imagens Docker do Fabric e do Fabric-CA. O comando abaixo demonstra como baixar os últimos lançamentos de produção - Fabric v2.2.3 e Fabric CA v1.5.0

curl -sSL https://bit.ly/2ysbOFE | bash -s -- <fabric_version> <fabric-ca_version>
curl -sSL https://bit.ly/2ysbOFE | bash -s -- 2.2.3 1.5.0

Nota

Se você receber um erro ao executar o comando curl acima, você pode ter uma versão muito antiga do curl que não suporta redirecionamentos ou um ambiente não suportado.

Visite a página Pré-requisitos para informações adicionais sobre onde encontrar a versão mais recente do curl e obtenha o ambiente certo. Alternativamente, você pode substituir pela URL não encurtada: https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh

Nota

Para um padrão de uso adicional, você pode usar a flag -h para visualizar a ajuda e os comandos disponíveis para o script de inicialização do Fabric-Samples. Por exemplo: curl -sSL https://bit.ly/2ysbOFE | bash -s -- -h

O comando acima baixa e executa um script bash que irá baixar e extrair todos os executáveis específicos da sua plataforma, que você precisará para configurar sua rede, e irá colocá-los no repositório clonado que você criou anteriormente. Ele obtém os seguintes executáveis específicos da sua plataforma:

  • configtxgen,
  • configtxlator,
  • cryptogen,
  • discover,
  • idemixgen
  • orderer,
  • peer,
  • fabric-ca-client,
  • fabric-ca-server

e os coloca no subdiretório bin do diretório de trabalho atual.

Você pode querer adicionar isso à sua variável de ambiente PATH para que eles possam ser alcançados sem precisar colocar todo o caminho para cada executável. Ex.:

export PATH=<caminho para o local de download>/bin:$PATH

Por fim, o script fará o download das imagens docker do Hyperledger Fabric do Docker Hub para dentro do seu registro Docker local e irá marcá-las como “latest”.

O script lista as imagens Docker instaladas após a conclusão.

Observe os nomes de cada imagem; estes são os componentes que irão por fim compor nossa rede Hyperledger Fabric. Você também notará que terá duas instâncias do mesmo ID de imagem - uma marcada como «amd64-1.x.x» e uma marcada como «latest». Antes da 1.2.0, a imagem que estava sendo baixada era determinada pelo uname -m e mostrada como «x86_64-1.x.x».

Nota

Em arquiteturas diferentes, o x86_64/amd64 seria substituído com a string identificando sua arquitetura.

Nota

Se você tiver dúvidas não abordadas por esta documentação, ou se deparar com problemas com qualquer um dos tutoriais, visite a página Still Have Questions? para obter algumas dicas sobre onde encontrar ajuda adicional.