Dépanner l'interface de ligne de commande du générateur d'applications Blockchain

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

Problèmes liés aux conditions requises
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 votre installation du générateur d'applications Blockchain répond toujours aux conditions requises.

Utilisation :

preReqCheck [options]
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, une erreur similaire à 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.21.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'une défaillance du déploiement, d'un déploiement corrompu, d'un conteneur pair Docker plein ou d'un pair Docker arrêté dans le réseau local, une erreur similaire à 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û à un conteneur pair qui n'a pas démarré 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 créateur d'applications Blockchain reconstruit l'environnement fabric local et déploie votre code de chaîne dans le nouvel environnement.
macOS : Xcode
Après une mise à niveau de macOS ou si Xcode n'est pas installé, une erreur similaire à 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