Instalar e Configurar a CLI do Blockchain App Builder

Pré-requisitos

Antes de instalar a CLI do Blockchain App Builder no seu sistema local, você deve instalar os pré-requisitos.

Observação:

O Blockchain App Builder coordena com o Oracle Blockchain Platform e seus compiladores. Se você usar qualquer versão dos pré-requisitos além das mencionadas na seção a seguir, a implantação do seu chaincode em uma rede remota do Oracle Blockchain Platform poderá falhar.

Quando você instala o Blockchain App Builder, uma verificação de pré-requisitos é executada primeiro. Se a verificação de pré-requisitos falhar, o processo de instalação será interrompido.

Pré-requisitos

Rancher Desktop (testado com 1.4.1). O Blockchain App Builder também pode trabalhar com o Docker, mas foi testado e verificado com o Rancher Desktop. Se você planeja usar o Rancher Desktop, desinstale o Docker completamente antes de instalar o Rancher Desktop. Depois de instalar o Rancher Desktop, verifique se o tempo de execução do contêiner está definido como dockerd (moby). Para verificar o runtime do contêiner no Rancher Desktop 1.4.1, clique em Definições do Kubernetes e, em seguida, em Runtime do Contêiner.
A versão 18 mais recente do Node.js (testada com 18.15.0 e 18.16.0). Não use versões de Node.js anteriores ou posteriores à versão 18.
npm v8.x ou v9.x (testado com 9.5.0 e 9.5.1)
Vá para a versão 1.20.10. Após instalar o Blockchain App Builder, consulte Configuração Adicional para Projetos de Chaincode Go.
Se você quiser usar o recurso de sincronização do Blockchain App Builder, instale o Git e configure seu nome de usuário e email, conforme mostrado nos comandos a seguir. Especifique seu nome de usuário e endereço de e-mail no lugar de <your_name> e <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Instale Node.js e npm usando nvm

O uso do nvm para instalar o Node.js e o npm permite executar mais comandos sem o sudo.

Informe o comando a seguir para instalar o nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

Adicione o seguinte trecho de código ao arquivo aplicável: ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

Efetue logout e login novamente no sistema operacional.
Digite o seguinte comando para verificar a instalação do nvm:
```
nvm version
```
Digite o seguinte comando para instalar Node.js e npm:
```
nvm install 18.16.0
```
Informe o seguinte comando para definir Node.js 18.16.0 como o padrão no nvm:
```
nvm alias default 18.16.0
```

Pré-requisitos

Docker v20.10.0 ou posterior
Docker Compose v1.23.0 ou posterior
A versão 18 mais recente do Node.js (testada com 18.15.0 e 18.16.0). Não use versões de Node.js anteriores ou posteriores à versão 18.
npm v8.x ou v9.x (testado com 9.5.0 e 9.5.1)
Vá para a versão 1.20.10. Após instalar o Blockchain App Builder, consulte Configuração Adicional para Projetos de Chaincode Go.
Se você quiser usar o recurso de sincronização do Blockchain App Builder, instale o Git e configure seu nome de usuário e email, conforme mostrado nos comandos a seguir. Especifique seu nome de usuário e endereço de e-mail no lugar de <your_name> e <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Instale Node.js e npm usando nvm

O uso do nvm para instalar o Node.js e o npm permite executar mais comandos sem o sudo.

Informe o comando a seguir para instalar o nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

Adicione o seguinte trecho de código ao arquivo aplicável: ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

Efetue logout e login novamente no sistema operacional.
Digite o seguinte comando para verificar a instalação do nvm:
```
nvm version
```
Digite o seguinte comando para instalar Node.js e npm:
```
nvm install 18.16.0
```
Informe o seguinte comando para definir Node.js 18.16.0 como o padrão no nvm:
```
nvm alias default 18.16.0
```

Instalar o Docker

Certifique-se de que dnf esteja atualizado e apontando para o repositório atual com base no kernel.

Digite o seguinte comando para adicionar o Docker à lista de repositórios:

sudo dnf config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo

Digite o seguinte comando para instalar o Docker:
```
dnf install docker-ce -y --allowerasing
```
Digite o seguinte comando para iniciar o Docker como serviço:
```
sudo systemctl enable --now docker
```
Digite os seguintes comandos para garantir que o usuário atual tenha acesso ao Docker:
```
sudo groupadd docker
sudo usermod -aG docker $USER
```
Informe o seguinte comando para reiniciar o sistema:
```
sudo reboot
```

Instale o Docker Compose

Informe o seguinte comando curl para obter o Docker Compose:

sudo curl -L https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compos

Digite o seguinte comando para adicionar permissões executáveis ao Docker Compose:
```
sudo chmod +x /usr/local/bin/docker-compose
```

Pré-requisitos

Rancher Desktop (testado com 1.4.1). O Blockchain App Builder também pode trabalhar com o Docker, mas foi testado e verificado com o Rancher Desktop.
A versão 18 mais recente do Node.js (testada com 18.15.0 e 18.16.0). Não use versões de Node.js anteriores ou posteriores à versão 18.
npm v8.x ou v9.x (testado com 9.5.0 e 9.5.1)
Vá para a versão 1.20.10. Após instalar o Blockchain App Builder, consulte Configuração Adicional para Projetos de Chaincode Go.
Se você quiser usar o recurso de sincronização do Blockchain App Builder, instale o Git e configure seu nome de usuário e email, conforme mostrado nos comandos a seguir. Especifique seu nome de usuário e endereço de e-mail no lugar de <your_name> e <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Instalar Área de Trabalho do Rancher

Siga as etapas abaixo para instalar o Rancher Desktop no Microsoft Windows.

Se o Docker estiver instalado no seu computador local, desinstale-o completamente.
Baixe e instale o Rancher Desktop.
Depois que o assistente de instalação for concluído, antes de abrir o Rancher Desktop, execute os seguintes comandos:
```
wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
```
Abra o Rancher Desktop para concluir o processo de configuração.
Depois de instalar o Rancher Desktop, verifique se o tempo de execução do contêiner está definido como dockerd (moby). Para verificar o runtime do contêiner no Rancher Desktop 1.4.1, clique em Definições do Kubernetes e, em seguida, em Runtime do Contêiner.

Instalar o Blockchain App Builder

Faça download do pacote da CLI do Blockchain App Builder (oracle-ochain-cli-x.x.x.tgz) na guia Ferramentas do Desenvolvedor no painel Blockchain App Builder da console do Oracle Blockchain Platform.

Digite o comando a seguir para instalar o Xcode ou as ferramentas de linha de comando XCode (xcode-select).
```
sudo xcode-select –install
```
Digite o seguinte comando para instalar o Blockchain App Builder (ajuste o nome do arquivo .tgz para a versão que você está instalando):
```
npm install -g oracle-ochain-cli-x.x.x.tgz
```

Note que o Mac OS Catalina pode ter problemas com xcode-select. Se você encontrar esses problemas, use o seguinte comando para redefinir e reiniciar xcode-select:

xcode-select –-reset

Digite o seguinte comando para instalar o Blockchain App Builder (ajuste o nome do arquivo .tgz para a versão que você está instalando):
```
npm install -g oracle-ochain-cli-x.x.x.tgz
```
Efetue log-out como o usuário atual e, em seguida, efetue log-in novamente para que a associação ao grupo entre em vigor.

Depois de instalar todo o software de pré-requisito, digite o seguinte comando para instalar o Blockchain App Builder (ajuste o nome do arquivo .tgz para a versão que você está instalando):

npm install -g oracle-ochain-cli-x.x.x.tgz

Verifique a Instalação

Em seu terminal, digite ochain -v. A saída mostra o uso, as opções e os comandos da CLI do Blockchain App Builder.

Configuração Adicional para Projetos de Codificação Ir

Para desenvolver um projeto Go, defina a variável de ambiente GOPATH. Isso permite localizar seu espaço de trabalho e executar seu código.

Antes de definir a variável de ambiente GOPATH, verifique se existe uma pasta go/ no diretório $HOME. Caso contrário, informe o seguinte comando para criar um diretório go/ no diretório home:

mkdir $HOME/go

Defina sua variável de ambiente GOPATH adicionando as seguintes variáveis ao arquivo aplicável: ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

Depois de editar o arquivo, execute o seguinte comando para fazer com que suas alterações entrem em vigor imediatamente:

source ~/.bash_profile

Como alternativa, você pode aplicar a alteração em todo o sistema adicionando as variáveis anteriores ao arquivo /etc/bashrc.

Antes de definir a variável de ambiente GOPATH, verifique se existe uma pasta go/ no diretório $HOME. Caso contrário, informe o seguinte comando para criar um diretório go/ no diretório home:

mkdir $HOME/go

Defina sua variável de ambiente GOPATH adicionando as seguintes variáveis ao arquivo aplicável: ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

Depois de editar o arquivo, execute o seguinte comando para fazer com que suas alterações entrem em vigor imediatamente:

source ~/.bash_profile

Como alternativa, você pode aplicar a alteração em todo o sistema adicionando as variáveis anteriores ao arquivo /etc/bashrc.

Crie um diretório go/ em seu diretório home: C:\Users\<username>\go.