Installa e configura CLI App Builder Blockchain

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 suoi compilatori. Se si utilizzano versioni dei prerequisiti diverse da quelle indicate nella sezione seguente, la distribuzione del codice concatenato in una rete Oracle Blockchain Platform remota 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 viene interrotto.

Prerequisiti

Rancher Desktop (testato con 1.4.1). Blockchain App Builder può anche funzionare con Docker, ma è stato testato e verificato con Rancher Desktop. Se si prevede di utilizzare Rancher Desktop, disinstallare Docker completamente 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 dei container in Rancher Desktop 1.4.1, fare clic su Impostazioni Kubernetes, quindi su Runtime container.
L'ultima release di Node.js versione 18 (testata con le versioni 18.15.0 e 18.16.0). Non utilizzare versioni precedenti o successive alla versione 18 di Node.js.
npm v8.x o v9.x (testato con 9.5.0 e 9.5.1)
Vai alla versione 1.20.10. 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'indirizzo di posta elettronica come mostrato nei comandi riportati di seguito. Specificare il nome utente e l'indirizzo di posta elettronica al posto di <your_name> e <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Installazione di Node.js e npm mediante nvm

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

Immettere 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

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

Prerequisiti

Docker v20.10.0 o versione successiva
Composizione Docker versione 1.23.0 o successiva
L'ultima release di Node.js versione 18 (testata con le versioni 18.15.0 e 18.16.0). Non utilizzare versioni precedenti o successive alla versione 18 di Node.js.
npm v8.x o v9.x (testato con 9.5.0 e 9.5.1)
Vai alla versione 1.20.10. 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'indirizzo di posta elettronica come mostrato nei comandi riportati di seguito. Specificare il nome utente e l'indirizzo di posta elettronica al posto di <your_name> e <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Installazione di Node.js e npm mediante nvm

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

Immettere 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

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

Installa Docker

Assicurarsi che dnf venga aggiornato e che 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 seguente comando per installare Docker:
```
dnf install docker-ce -y --allowerasing
```
Immettere il seguente comando per avviare Docker come servizio:
```
sudo systemctl enable --now docker
```
Immettere i comandi riportati di seguito per assicurarsi che l'utente corrente abbia accesso al Docker.
```
sudo groupadd docker
sudo usermod -aG docker $USER
```
Immettere il seguente comando per riavviare il sistema:
```
sudo reboot
```

Installa composizione Docker

Immettere il seguente comando curl per ottenere la composizione Docker:

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 1.4.1). Blockchain App Builder può anche funzionare con Docker, ma è stato testato e verificato con Rancher Desktop.
L'ultima release di Node.js versione 18 (testata con le versioni 18.15.0 e 18.16.0). Non utilizzare versioni precedenti o successive alla versione 18 di Node.js.
npm v8.x o v9.x (testato con 9.5.0 e 9.5.1)
Vai alla versione 1.20.10. 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'indirizzo di posta elettronica come mostrato nei comandi riportati di seguito. Specificare il nome utente e l'indirizzo di posta elettronica al posto di <your_name> e <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Installa Rancher Desktop

Per installare Rancher Desktop in Microsoft Windows, procedere come segue.

Se Docker è installato sul computer locale, disinstallarlo completamente.
Scarica e installa 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 dei container in Rancher Desktop 1.4.1, fare clic su Impostazioni Kubernetes, quindi su Runtime container.

Installa App Builder Blockchain

Scaricare il pacchetto 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
```

Si noti che Mac OS Catalina può avere problemi con xcode-select. Se si verificano questi problemi, utilizzare il seguente comando 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 in modo che l'appartenenza al gruppo diventi effettiva.

Dopo aver installato tutto il software dei prerequisiti, 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

Verificare l'installazione

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

Impostazione aggiuntiva per progetti codice concatenato Go

Per sviluppare un progetto Go, è necessario impostare la variabile di ambiente GOPATH. Ciò 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 effettive immediatamente 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 effettive immediatamente 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.