Dépanner l'interface de ligne de commande du générateur d'applications de chaîne de blocs

Les informations suivantes peuvent être utilisées pour résoudre les problèmes de système avec l'interface de ligne de commande du générateur d'applications de chaîne de blocs.

Problèmes liés aux préalables
Des erreurs peuvent se produire si vous modifiez ou mettez à niveau l'un des logiciels préalables requis par Blockchain App Builder. Vous pouvez utiliser la commande preReqCheck pour vérifier que l'installation du générateur d'applications de chaîne de blocs respecte toujours les préalables.

Utilisation :

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éalables échoue avec des erreurs et des avertissements lorsque vous tentez d'installer Blockchain App Builder, vous pouvez voir une erreur similaire à l'exemple suivant :
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
Échec du déploiement
En raison d'un échec de déploiement, d'un déploiement corrompu, d'un conteneur pair Docker plein ou d'un pair Docker tué dans le réseau local, une erreur peut se produire comme suit :
============ 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 pair 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 de chaîne et exécutez la commande ochain run -b.
L'interface de ligne de commande du générateur d'applications de chaîne de blocs reconstruit l'environnement de structure locale et déploie votre code de chaîne dans le nouvel environnement.
Mac OSX : Xcode
Après une mise à niveau de Mac OSX, ou si Xcode n'est pas installé, vous pouvez voir une erreur similaire à ce qui suit dans le journal des 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