Dépannage de l'interface de ligne de commande de Blockchain App Builder

Les informations suivantes peuvent être utilisées pour résoudre les problèmes système avec l'interface de ligne de commande Blockchain App Builder.

Problèmes de prérequis
Des erreurs peuvent se produire si vous modifiez ou mettez à niveau l'un des logiciels prérequis requis par Blockchain App Builder. Vous pouvez utiliser la commande preReqCheck pour vérifier que votre installation de Blockchain App Builder répond toujours aux prérequis.

Syntaxe :

preReqCheck [options]
my-mac:TsProject myname$ ochain preReqCheck -h 
Usage: patch [options]

Validates the pre-requisites of Blockchain App Builder 

Options :
    -h, --help              output command usage information
    -D, --debug             enable debug logging
Si la vérification des prérequis échoue avec des erreurs et des avertissements lorsque vous tentez d'installer Blockchain App Builder, une erreur semblable à l'exemple suivant peut s'afficher :
npm ERR! code 1
npm ERR! path C:\Users\opc\AppData\Roaming\npm\node_modules\@oracle\ochain-cli
npm ERR! command failed
npm ERR! command C:\Windows\system32\cmd.exe /d /s /c node build/pre-install.js
npm ERR! NodeJs version is correct.
npm ERR! NPM version is correct.
npm ERR! Error:
npm ERR! Found 1 error(s) in pre-requisites check, failed with following errors:
npm ERR! 1. Golang version mismatch. Expected 1.20.x, but found 1.18.5.
npm ERR!
npm ERR! Found 3 warning(s) in pre-requisites check.
npm ERR! 1. Docker is not installed. Please install Docker >= 18.09.0. To deploy chaincodes in the local environment, please install the recommended version of Docker.
npm ERR! 2. Docker Compose is not installed. Please install Docker Compose >= 1.23.0. To deploy chaincodes in the local environment, please install the recommended version of Docker Compose.
npm ERR! 3. Git is not Installed. To sync chaincodes, please install the Git according to the documentation.
npm ERR!     at preRequsiteCheck (C:\Users\opc\AppData\Roaming\npm\node_modules\@oracle\ochain-cli\build\lib\util\pre-install.js:435:15)
npm ERR!     at Object.<anonymous> (C:\Users\opc\AppData\Roaming\npm\node_modules\@oracle\ochain-cli\build\pre-install.js:10:44)
npm ERR!     at Module._compile (node:internal/modules/cjs/loader:1254:14)
npm ERR!     at Module._extensions..js (node:internal/modules/cjs/loader:1308:10)
npm ERR!     at Module.load (node:internal/modules/cjs/loader:1117:32)
npm ERR!     at Module._load (node:internal/modules/cjs/loader:958:12)
npm ERR!     at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:81:12)
npm ERR!     at node:internal/main/run_main_module:23:47
 
npm ERR! A complete log of this run can be found in:
npm ERR!     C:\Users\opc\AppData\Local\npm-cache\_logs\2023-08-25T09_58_34_514Z-debug-0.log
Echec du déploiement
En raison d'un échec de déploiement, d'un déploiement endommagé, d'un conteneur homologue Docker plein ou d'un homologue Docker arrêté dans le réseau local, une erreur semblable à la suivante peut s'afficher :
============ Started instantiate Chaincode ============
[2028-19-01T19:25:lO.372] [ERROR] default - Error instantiating Chaincode GollGl on channel mychannel, detailed 
error: Error: error starting container: error starting container: Failed to generate platform-specific docker 
build: Failed to pull hyperledger/fabric-ccenv:latest : API error (404): manifest for hyperledger/ 
fabric-ccenv:latest not found: manifest unknown: manifest unknown [2020-19-01T19:25:10.372] (INFO) default -
============ Finished instantiate Chaincode ============
[2020-19-01119:25:10.372] [ERROR] default - Error: Error instantiating Chaincode Goll01 on channel mychannel, 
detailed error: Error: error starting container: error starting container: Failed to generate platfom-specific 
docker build: Failed to pull hyperledger/fabric-ccenv: latest : API error (404): manifest for hyperledger/ 
fabric-ccenv:lalest not found: manifest unknown: manifest unknown exited: signal: terminated 
INFO: exited: signal: terminated

ERROR: Error in Chaincode deployment
Cela est dû au fait qu'un conteneur homologue ne peut pas redémarrer correctement. Pour contourner ce comportement, effectuez l'étape suivante.
  • Ouvrez une nouvelle fenêtre de terminal dans le projet de code chaîne et exécutez la commande ochain run -b.
L'interface de ligne de commande Blockchain App Builder reconstruit l'environnement de structure local et déploie le code chaîne vers le nouvel environnement.
Mac OSX : Xcode
Après une mise à niveau de Mac OSX ou si Xcode n'est pas installé, une erreur semblable à la suivante peut s'afficher dans le journal d'erreurs :
gyp: No Xcode or CLT version detected!
gyp ERR! configure error
gyp ERR! stack Error: `gyp` failed with exit code: 1
gyp ERR! stack     at
  • Pour contourner ce comportement, ouvrez une fenêtre de terminal et exécutez les commandes suivantes :
    sudo rm -rf $(xcode-select --print-path)
    xcode-select --install