Installation et configuration de l'interface de ligne de commande Blockchain App Builder

Prérequis

Avant d'installer l'interface de ligne de commande Blockchain App Builder sur votre système local, vous devez installer les prérequis.

Remarques :

Blockchain App Builder se coordonne avec Oracle Blockchain Platform et ses compilateurs. Si vous utilisez des versions des prérequis autres que celles mentionnées dans la section suivante, le déploiement de votre code chaîne sur un réseau Oracle Blockchain Platform distant peut échouer.

Lorsque vous installez Blockchain App Builder, une vérification des prérequis s'exécute en premier. Si la vérification des prérequis échoue, le processus d'installation s'arrête.

Prérequis

Rancher Desktop (testé avec la version 1.19.3). Blockchain App Builder peut également fonctionner avec Docker, mais il a été testé et vérifié avec Rancher Desktop. Si vous prévoyez d'utiliser Rancher Desktop, désinstallez complètement Docker avant d'installer Rancher Desktop. Après avoir installé Rancher Desktop, assurez-vous que l'exécution de conteneur est définie sur dockerd (moby). Pour vérifier l'exécution de conteneur dans Rancher Desktop 1.19.3, cliquez sur Paramètres Kubernetes > Exécution de conteneur.
La dernière version de Node.js version 18 (testée avec 18.15.0 et 18.16.0). N'utilisez pas de version de Node.js antérieure ou postérieure à la version 18.
npm v8.x ou v9.x (testés avec les versions 9.5.0 et 9.5.1)
Accédez à la version 1.23.2 ou ultérieure, mais pas à la version 1.24 ou ultérieure. Après avoir installé Blockchain App Builder, reportez-vous à Configuration supplémentaire pour les projets de code chaîne de Go.
Si vous souhaitez utiliser la fonction de synchronisation de Blockchain App Builder, installez Git, puis configurez votre nom d'utilisateur et votre adresse électronique comme indiqué dans les commandes suivantes. Indiquez votre nom d'utilisateur et votre adresse électronique à la place de <your_name> et <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Installer Node.js et npm à l'aide de nvm

L'utilisation de nvm pour installer Node.js et npm vous permet d'exécuter davantage de commandes sans sudo.

Entrez la commande suivante pour installer nvm :

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

Ajoutez le fragment de code suivant au fichier applicable : ~/.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

Déconnectez-vous, puis reconnectez-vous au système d'exploitation.
Entrez la commande suivante pour vérifier l'installation de nvm :
```
nvm version
```
Entrez la commande suivante pour installer Node.js et npm :
```
nvm install 18.16.0
```
Entrez la commande suivante pour définir Node.js 18.16.0 comme valeur par défaut dans nvm :
```
nvm alias default 18.16.0
```

Prérequis

Docker v20.10.0 ou version ultérieure
Docker Compose v1.23.0 ou version ultérieure
La dernière version de Node.js version 18 (testée avec 18.15.0 et 18.16.0). N'utilisez pas de version de Node.js antérieure ou postérieure à la version 18.
npm v8.x ou v9.x (testés avec les versions 9.5.0 et 9.5.1)
Accédez à la version 1.23.2 ou ultérieure, mais pas à la version 1.24 ou ultérieure. Après avoir installé Blockchain App Builder, reportez-vous à Configuration supplémentaire pour les projets de code chaîne de Go.
Si vous souhaitez utiliser la fonction de synchronisation de Blockchain App Builder, installez Git, puis configurez votre nom d'utilisateur et votre adresse électronique comme indiqué dans les commandes suivantes. Indiquez votre nom d'utilisateur et votre adresse électronique à la place de <your_name> et <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Installer Node.js et npm à l'aide de nvm

L'utilisation de nvm pour installer Node.js et npm vous permet d'exécuter davantage de commandes sans sudo.

Entrez la commande suivante pour installer nvm :

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

Ajoutez le fragment de code suivant au fichier applicable : ~/.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

Déconnectez-vous, puis reconnectez-vous au système d'exploitation.
Entrez la commande suivante pour vérifier l'installation de nvm :
```
nvm version
```
Entrez la commande suivante pour installer Node.js et npm :
```
nvm install 18.16.0
```
Entrez la commande suivante pour définir Node.js 18.16.0 comme valeur par défaut dans nvm :
```
nvm alias default 18.16.0
```

Installation de Docker

Assurez-vous que dnf est mis à jour et pointe vers le référentiel actuel en fonction de votre noyau.

Entrez la commande suivante pour ajouter Docker à la liste de référentiels :

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

Entrez la commande suivante pour installer Docker :
```
dnf install docker-ce -y --allowerasing
```
Entrez la commande suivante pour démarrer Docker en tant que service :
```
sudo systemctl enable --now docker
```
Entrez les commandes suivantes pour vous assurer que l'utilisateur en cours a accès à Docker :
```
sudo groupadd docker
sudo usermod -aG docker $USER
```
Entrez la commande suivante pour redémarrer le système :
```
sudo reboot
```

Installer Docker Compose

Entrez la commande curl suivante pour obtenir 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

Entrez la commande suivante pour ajouter des droits d'accès exécutables à Docker Compose :
```
sudo chmod +x /usr/local/bin/docker-compose
```

Prérequis

Rancher Desktop (testé avec la version 1.19.3). Blockchain App Builder peut également fonctionner avec Docker, mais il a été testé et vérifié avec Rancher Desktop.
La dernière version de Node.js version 18 (testée avec 18.15.0 et 18.16.0). N'utilisez pas de version de Node.js antérieure ou postérieure à la version 18.
npm v8.x ou v9.x (testés avec les versions 9.5.0 et 9.5.1)
Accédez à la version 1.23.2 ou ultérieure, mais pas à la version 1.24 ou ultérieure. Après avoir installé Blockchain App Builder, reportez-vous à Configuration supplémentaire pour les projets de code chaîne de Go.
Si vous souhaitez utiliser la fonction de synchronisation de Blockchain App Builder, installez Git et configurez votre nom d'utilisateur et votre adresse électronique comme indiqué dans les commandes suivantes. Indiquez votre nom d'utilisateur et votre adresse électronique à la place de <your_name> et <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Installer le bureau Rancher

Pour installer Rancher Desktop sur Microsoft Windows, procédez comme suit :

Si Docker est installé sur votre ordinateur local, désinstallez-le complètement.
Téléchargez et installez Rancher Desktop.
Une fois l'assistant d'installation terminé, avant d'ouvrir Rancher Desktop, exécutez les commandes suivantes :
```
wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
```
Ouvrez Rancher Desktop pour terminer le processus de configuration.
Après avoir installé Rancher Desktop, assurez-vous que l'exécution de conteneur est définie sur dockerd (moby). Pour vérifier l'exécution de conteneur dans Rancher Desktop 1.19.3, cliquez sur Paramètres Kubernetes > Exécution de conteneur.

Installer Blockchain App Builder

Téléchargez le package de l'interface de ligne de commande Blockchain App Builder (oracle-ochain-cli-x.x.x.tgz) dans l'onglet Outils de développeur du panneau Générateur d'applications Blockchain de la console Oracle Blockchain Platform.

Entrez la commande suivante pour installer Xcode ou les outils de ligne de commande XCode (xcode-select).
```
sudo xcode-select –install
```
Entrez la commande suivante pour installer Blockchain App Builder (ajustez le nom du fichier .tgz pour la version que vous installez) :
```
npm install -g oracle-ochain-cli-x.x.x.tgz
```

Mac OS Catalina peut avoir des problèmes avec xcode-select. Si vous rencontrez ces problèmes, utilisez la commande suivante pour réinitialiser et redémarrer xcode-select :

xcode-select –-reset

Entrez la commande suivante pour installer Blockchain App Builder (ajustez le nom du fichier .tgz pour la version que vous installez) :
```
npm install -g oracle-ochain-cli-x.x.x.tgz
```
Déconnectez-vous en tant qu'utilisateur en cours, puis reconnectez-vous pour que l'appartenance au groupe prenne effet.

Après avoir installé tous les logiciels prérequis, entrez la commande suivante pour installer Blockchain App Builder (ajustez le nom du fichier .tgz pour la version que vous installez) :

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

Vérification de l'installation

Dans votre terminal, saisissez ochain -v. La sortie affiche l'utilisation, les options et les commandes de l'interface de ligne de commande Blockchain App Builder.

Configuration supplémentaire pour les projets de code chaîne Go

Pour développer un projet Go, vous devez définir la variable d'environnement GOPATH. Cela permet à Go de localiser votre espace de travail et d'exécuter votre code.

Avant de définir la variable d'environnement GOPATH, assurez-vous qu'un dossier go/ existe dans votre répertoire $HOME. Sinon, entrez la commande suivante pour créer un répertoire go/ dans votre répertoire de base :

mkdir $HOME/go

Définissez la variable d'environnement GOPATH en ajoutant les variables suivantes au fichier applicable : ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.

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

Après avoir modifié le fichier, exécutez la commande suivante pour que vos modifications prennent effet immédiatement :

source ~/.bash_profile

Vous pouvez également appliquer la modification à l'échelle du système en ajoutant les variables précédentes au fichier /etc/bashrc.

Avant de définir la variable d'environnement GOPATH, assurez-vous qu'un dossier go/ existe dans votre répertoire $HOME. Sinon, entrez la commande suivante pour créer un répertoire go/ dans votre répertoire de base :

mkdir $HOME/go

Définissez la variable d'environnement GOPATH en ajoutant les variables suivantes au fichier applicable : ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.

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

Après avoir modifié le fichier, exécutez la commande suivante pour que vos modifications prennent effet immédiatement :

source ~/.bash_profile

Vous pouvez également appliquer la modification à l'échelle du système en ajoutant les variables précédentes au fichier /etc/bashrc.

Créez un répertoire go/ dans votre répertoire de base : C:\Users\<username>\go.