Installazione e configurazione dell'interfaccia CLI di Blockchain App Builder

Prerequisiti

Prima di installare l'interfaccia CLI di Blockchain App Builder nel sistema locale, è necessario installare i prerequisiti.

Nota

Blockchain App Builder si coordina con Oracle Blockchain Platform e i relativi compilatori. Se si utilizzano versioni dei prerequisiti diverse da quelle menzionate nella sezione seguente, la distribuzione del codice concatenato in una rete remota di Oracle Blockchain Platform potrebbe non riuscire.

Quando si installa Blockchain App Builder, viene eseguito prima un controllo dei prerequisiti. Se il controllo dei prerequisiti non riesce, il processo di installazione si interrompe.

Prerequisiti

Rancher Desktop (testato con la versione 1.19.3). Blockchain App Builder può anche funzionare con Docker, ma è stato testato e verificato con Rancher Desktop. Se si prevede di utilizzare Rancher Desktop, disinstallare completamente Docker prima di installare Rancher Desktop. Dopo aver installato Rancher Desktop, assicurarsi che il runtime del contenitore sia impostato su dockerd (moby). Per verificare il runtime del contenitore in Rancher Desktop 1.19.3, fare clic su Impostazioni Kubernetes > Runtime del contenitore.
Ultima release di Node.js versione 18 (testato con 18.15.0 e 18.16.0). Non utilizzare versioni di Node.js precedenti o successive alla versione 18.
npm v8.x o v9.x (testato con 9.5.0 e 9.5.1)
Andare alla versione 1.23.2 o successiva, ma non alla versione 1.24 o successiva. Dopo aver installato Blockchain App Builder, vedere Impostazione aggiuntiva per i progetti Go Chaincode.
Se si desidera utilizzare la funzione di sincronizzazione di Blockchain App Builder, installare Git e quindi configurare il nome utente e l'e-mail come mostrato nei comandi seguenti. Specificare il nome utente e l'indirizzo e-mail al posto di <your_name> e <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Installare Node.js e npm utilizzando nvm

L'utilizzo di nvm per installare Node.js e npm consente di eseguire più comandi senza sudo.

Inserire il seguente comando per installare nvm:

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

Aggiungere il seguente snippet di codice al file applicabile: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.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

Eseguire il logout e quindi nuovamente il login al sistema operativo.
Immettere il comando seguente per verificare l'installazione di nvm:
```
nvm version
```
Inserire il comando seguente per installare Node.js e npm:
```
nvm install 18.16.0
```
Inserire il comando seguente per impostare Node.js 18.16.0 come valore predefinito in nvm:
```
nvm alias default 18.16.0
```

Prerequisiti

Docker v20.10.0 o versione successiva
Docker Compose v1.23.0 o versione successiva
Ultima release di Node.js versione 18 (testato con 18.15.0 e 18.16.0). Non utilizzare versioni di Node.js precedenti o successive alla versione 18.
npm v8.x o v9.x (testato con 9.5.0 e 9.5.1)
Andare alla versione 1.23.2 o successiva, ma non alla versione 1.24 o successiva. Dopo aver installato Blockchain App Builder, vedere Impostazione aggiuntiva per i progetti Go Chaincode.
Se si desidera utilizzare la funzione di sincronizzazione di Blockchain App Builder, installare Git e quindi configurare il nome utente e l'e-mail come mostrato nei comandi seguenti. Specificare il nome utente e l'indirizzo e-mail al posto di <your_name> e <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Installare Node.js e npm utilizzando nvm

L'utilizzo di nvm per installare Node.js e npm consente di eseguire più comandi senza sudo.

Inserire il seguente comando per installare nvm:

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

Aggiungere il seguente snippet di codice al file applicabile: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.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

Eseguire il logout e quindi nuovamente il login al sistema operativo.
Immettere il comando seguente per verificare l'installazione di nvm:
```
nvm version
```
Inserire il comando seguente per installare Node.js e npm:
```
nvm install 18.16.0
```
Inserire il comando seguente per impostare Node.js 18.16.0 come valore predefinito in nvm:
```
nvm alias default 18.16.0
```

Installa Docker

Assicurarsi che dnf venga aggiornato e punti al repository corrente in base al kernel.

Immettere il comando seguente per aggiungere Docker alla lista di repository:

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

Immettere il comando seguente per installare Docker:
```
dnf install docker-ce -y --allowerasing
```
Immettere il comando seguente per avviare Docker come servizio:
```
sudo systemctl enable --now docker
```
Immettere i comandi seguenti per assicurarsi che l'utente corrente disponga dell'accesso a Docker:
```
sudo groupadd docker
sudo usermod -aG docker $USER
```
Immettere il seguente comando per riavviare il sistema:
```
sudo reboot
```

Installa composizione Docker

Immettere il comando curl seguente per ottenere 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

Immettere il comando seguente per aggiungere le autorizzazioni eseguibili a Docker Compose:
```
sudo chmod +x /usr/local/bin/docker-compose
```

Prerequisiti

Rancher Desktop (testato con la versione 1.19.3). Blockchain App Builder può anche funzionare con Docker, ma è stato testato e verificato con Rancher Desktop.
Ultima release di Node.js versione 18 (testato con 18.15.0 e 18.16.0). Non utilizzare versioni di Node.js precedenti o successive alla versione 18.
npm v8.x o v9.x (testato con 9.5.0 e 9.5.1)
Andare alla versione 1.23.2 o successiva, ma non alla versione 1.24 o successiva. Dopo aver installato Blockchain App Builder, vedere Impostazione aggiuntiva per i progetti Go Chaincode.
Se si desidera utilizzare la funzione di sincronizzazione di Blockchain App Builder, installare Git e configurare il nome utente e l'e-mail come mostrato nei comandi seguenti. Specificare il nome utente e l'indirizzo e-mail al posto di <your_name> e <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Installa desktop Rancher

Completare i seguenti passaggi per installare Rancher Desktop su Microsoft Windows.

Se Docker è installato sul computer locale, disinstallarlo completamente.
Scaricare e installare Rancher Desktop.
Al termine dell'installazione guidata, prima di aprire Rancher Desktop, eseguire i seguenti comandi:
```
wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
```
Aprire Rancher Desktop per completare il processo di installazione.
Dopo aver installato Rancher Desktop, assicurarsi che il runtime del contenitore sia impostato su dockerd (moby). Per verificare il runtime del contenitore in Rancher Desktop 1.19.3, fare clic su Impostazioni Kubernetes > Runtime del contenitore.

Installa App Builder Blockchain

Scaricare il package CLI di Blockchain App Builder (oracle-ochain-cli-x.x.x.tgz) dalla scheda Strumenti di sviluppo nel riquadro Blockchain App Builder della console di Oracle Blockchain Platform.

Immettere il comando seguente per installare Xcode o gli strumenti della riga di comando XCode (xcode-select).
```
sudo xcode-select –install
```
Immettere il comando seguente per installare Blockchain App Builder (adeguare il nome del file .tgz per la versione che si sta installando):
```
npm install -g oracle-ochain-cli-x.x.x.tgz
```

Mac OS Catalina può avere problemi con xcode-select. Se si verificano questi problemi, utilizzare il comando seguente per reimpostare e riavviare xcode-select:

xcode-select –-reset

Immettere il comando seguente per installare Blockchain App Builder (adeguare il nome del file .tgz per la versione che si sta installando):
```
npm install -g oracle-ochain-cli-x.x.x.tgz
```
Eseguire il logout come utente corrente, quindi eseguire di nuovo il login per rendere effettiva l'appartenenza al gruppo.

Dopo aver installato tutto il software dei prerequisiti, immettere il comando seguente per installare Blockchain App Builder (aggiustare il nome del file .tgz per la versione che si sta installando):

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

Verifica l'installazione

Nel terminale digitare ochain -v. L'output mostra l'uso, le opzioni e i comandi della CLI di Blockchain App Builder.

Impostazione aggiuntiva per Go Chaincode Projects

Per sviluppare un progetto Go, è necessario impostare la variabile di ambiente GOPATH. Consente di individuare l'area di lavoro ed eseguire il codice.

Prima di impostare la variabile di ambiente GOPATH, assicurarsi che nella directory $HOME esista una cartella go/. In caso contrario, immettere il comando seguente per creare una directory go/ nella directory home:

mkdir $HOME/go

Impostare la variabile di ambiente GOPATH aggiungendo le seguenti variabili al file applicabile: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.zshrc.

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

Dopo aver modificato il file, eseguire il comando seguente per rendere immediatamente effettive le modifiche:

source ~/.bash_profile

In alternativa, è possibile applicare la modifica a livello di sistema aggiungendo le variabili precedenti al file /etc/bashrc.

Prima di impostare la variabile di ambiente GOPATH, assicurarsi che nella directory $HOME esista una cartella go/. In caso contrario, immettere il comando seguente per creare una directory go/ nella directory home:

mkdir $HOME/go

Impostare la variabile di ambiente GOPATH aggiungendo le seguenti variabili al file applicabile: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.zshrc.

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

Dopo aver modificato il file, eseguire il comando seguente per rendere immediatamente effettive le modifiche:

source ~/.bash_profile

In alternativa, è possibile applicare la modifica a livello di sistema aggiungendo le variabili precedenti al file /etc/bashrc.

Creare una directory go/ nella directory home: C:\Users\<username>\go.