Installer et configurer l'interface de ligne de commande du générateur d'applications de chaîne de blocs
- macOS
- Oracle Linux 8.0 ou 9.0
- Microsoft Windows 10 ou 11
- Vérifiez votre installation.
- Si vous utilisez des projets de code de chaîne Go, effectuez les étapes de configuration supplémentaires.
Conditions requises
Avant d'installer l'interface de ligne de commande Blockchain App Builder sur votre système local, vous devez installer les préalables.
Note :
Le générateur d'applications Blockchain est coordonné avec Oracle Blockchain Platform et ses compilateurs. Si vous utilisez des versions des préalables autres que celles mentionnées dans la section suivante, le déploiement de votre code de chaîne sur un réseau Oracle Blockchain Platform distant peut échouer.Lorsque vous installez Blockchain App Builder, une vérification des préalables s'exécute en premier. Si la vérification des préalables échoue, le processus d'installation est arrêté.
Conditions requises
- Rancher Desktop (testé avec 1.4.1). 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 Docker complètement avant d'installer Rancher Desktop. Après avoir installé Rancher Desktop, assurez-vous que l'environnement d'exécution du conteneur est réglé à dockerd (moby). Pour vérifier l'exécution du conteneur dans Rancher Desktop 1.4.1, cliquez sur .
- La dernière version de Node.js version 18 (testée avec les versions 18.15.0 et 18.16.0). N'utilisez pas de versions de Node.js antérieures ou ultérieures à la version 18.
- npm v8.x ou v9.x (testé avec les versions 9.5.0 et 9.5.1)
- Allez à la version 1.20.10. Après avoir installé le générateur d'applications de chaîne de blocs, voir Configuration supplémentaire pour les projets Go Chaincode.
- Si vous souhaitez utiliser la fonction de synchronisation de Blockchain App Builder, installez Git, puis configurez votre nom d'utilisateur et votre adresse de courriel comme indiqué dans les commandes suivantes. Spécifiez votre nom d'utilisateur et votre adresse de courriel à la place de
<your_name>
et<email>
.git config --global user.name "<your_name>"
git config --global user.email "<email>"
Installez Node.js et npm à l'aide de nvm
sudo
.
- Entrez la commande suivante pour installer nvm :
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
- Ajoutez l'extrait 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 à votre 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
Conditions requises
- 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 les versions 18.15.0 et 18.16.0). N'utilisez pas de versions de Node.js antérieures ou ultérieures à la version 18.
- npm v8.x ou v9.x (testé avec les versions 9.5.0 et 9.5.1)
- Allez à la version 1.20.10. Après avoir installé le générateur d'applications de chaîne de blocs, voir Configuration supplémentaire pour les projets Go Chaincode.
- Si vous souhaitez utiliser la fonction de synchronisation de Blockchain App Builder, installez Git, puis configurez votre nom d'utilisateur et votre adresse de courriel comme indiqué dans les commandes suivantes. Spécifiez votre nom d'utilisateur et votre adresse de courriel à la place de
<your_name>
et<email>
.git config --global user.name "<your_name>"
git config --global user.email "<email>"
Installez Node.js et npm à l'aide de nvm
sudo
.
- Entrez la commande suivante pour installer nvm :
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
- Ajoutez l'extrait 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 à votre 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
Installer Docker
dnf
est mis à jour et pointe vers le référentiel courant en fonction de votre noyau.
- Entrez la commande suivante pour ajouter Docker à la liste de référentiel :
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 courant 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 autorisations exécutables à Docker Compose :
sudo chmod +x /usr/local/bin/docker-compose
Conditions requises
- Rancher Desktop (testé avec 1.4.1). 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 les versions 18.15.0 et 18.16.0). N'utilisez pas de versions de Node.js antérieures ou ultérieures à la version 18.
- npm v8.x ou v9.x (testé avec les versions 9.5.0 et 9.5.1)
- Allez à la version 1.20.10. Après avoir installé le générateur d'applications de chaîne de blocs, voir Configuration supplémentaire pour les projets Go Chaincode.
- Si vous souhaitez utiliser la fonction de synchronisation de Blockchain App Builder, installez Git et configurez votre nom d'utilisateur et votre adresse de courriel comme indiqué dans les commandes suivantes. Spécifiez votre nom d'utilisateur et votre adresse de courriel à la place de
<your_name>
et<email>
.git config --global user.name "<your_name>"
git config --global user.email "<email>"
Installer Rancher Desktop
- 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'environnement d'exécution du conteneur est réglé à dockerd (moby). Pour vérifier l'exécution du conteneur dans Rancher Desktop 1.4.1, cliquez sur .
Installer le générateur d'applications Blockchain
Téléchargez l'ensemble d'interface de ligne de commande du générateur d'applications de chaîne de blocs (oracle-ochain-CLI-x.x.x.tgz
) à partir de l'onglet Outils pour développeurs du volet Générateur d'applications de chaîne de blocs 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
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 courant, puis reconnectez-vous afin que l'appartenance au groupe prenne effet.
.tgz
pour la version que vous installez) :npm install -g oracle-ochain-cli-x.x.x.tgz
Vérifier l'installation
Dans votre terminal, entrez ochain -v
. La sortie présente l'utilisation, les options et les commandes de l'interface de ligne de commande du générateur d'applications de chaîne de blocs.
Configuration supplémentaire pour les projets de code de 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.
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
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
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
.
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
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
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
.