1. Utilisation d'Oracle Blockchain Platform
  2. Créer des codes de chaîne avec le générateur d'applications de chaîne de blocs à faible code
  3. Utilisation de l'interface de ligne de commande du générateur d'applications de chaîne de blocs
  4. Déployer le code de chaîne à l'aide de l'interface de ligne de commande

Déployer le code de chaîne à l'aide de l'interface de ligne de commande

Une fois le projet de code de chaîne créé, vous pouvez le déployer localement sur le réseau Hyperledger Fabric généré automatiquement, ou à distance sur votre plate-forme Oracle Blockchain Platform Cloud ou Enterprise Edition. Vous pouvez également encapsuler le projet de code de chaîne pour un déploiement manuel sur Oracle Blockchain Platform.

Déployer le code de chaîne sur un réseau Hyperledger Fabric local

Une fois que vous avez créé votre projet de code de chaîne, vous pouvez le déployer sur un réseau Hyperledger Fabric local. Ce réseau de test à canal unique est créé pour vous lorsque vous installez Blockchain App Builder.

La commande ochain run du générateur d'applications de chaîne de blocs démarre le réseau Hyperledger Fabric, d'autres services, et installe et déploie le code de chaîne pour vous. 

my-mac:GOProject myname$ ochain run -h
Usage: run [options] [...args]
Run chaincode project locally in debug mode.

Arguments :
[...args] (optional) Chaincode instantiate arguments. Arguments should be space separated.

Options:
-h, --help        output command usage information 
-D, --debug       enable debug logging
-P, --debug-port  (optional) specify debug process port
-b, --build       (optional) rebuild runtime if already exists
-p, --project     (optional) Path to Chaincode project to run. If not specified, it defaults to current directory.  

Examples :
$> ochain run

Projets avec jeton

Pour les projets de code de chaîne de jeton, vous devez spécifier une liste d'administrateurs avec la commande ochain run : 
ochain run <adminList array>
Le tableau adminList est un tableau d'informations qui spécifie les administrateurs de jeton. Le tableau adminList est un paramètre obligatoire lorsque vous déployez un projet de code de chaîne de jeton pour la première fois. Si vous déployez à nouveau le projet, vous pouvez transmettre un tableau vide pour le paramètre adminList ou utiliser le paramètre adminList pour ajouter des administrateurs de jeton. Les autres responsables du déploiement qui ne sont pas le premier responsable du déploiement doivent fournir un tableau vide pour le paramètre adminList. Les informations de paramètre sont différentes pour les jetons fongibles et les jetons non fongibles :
  • Pour les jetons fongibles qui utilisent la norme Token Taxonomy Framework, les paramètres sont org_id et user_id.
  • Pour tous les jetons qui utilisent la norme ERC-1155, les paramètres sont orgId et userId.
  • Pour les jetons non fongibles qui utilisent la norme ERC-721 et un projet TypeScript, les paramètres sont orgId et userId.
  • Pour les jetons non fongibles qui utilisent la norme ERC-721 et un projet Go, les paramètres sont OrgId et UserId.

Les exemples suivants sont pour les jetons non fongibles.

Exemple de tableau adminList pour TypeScript sur Mac OSX et Linux :
'[{"userId":"userid", "orgId":"OrgMSPId"}]'
Exemple de tableau adminList pour Go sur Mac OSX et Linux :
'[{"UserId":"userid", "OrgId":"OrgMSPId"}]'
Exemple de tableau adminList pour TypeScript sous Microsoft Windows :
"[{\"userId\":\"userid\", \"orgId\":\"OrgMSPId\"}]"
Exemple de tableau adminList pour Go sous Microsoft Windows :
"[{\"UserId\":\"userid\", \"OrgId\":\"OrgMSPId\"}]"

Pour le réseau Hyperledger Fabric local, le champ OrgMSPId est fixe à la valeur Org1MSP.

Si vous voulez voir les journaux de débogage, vous pouvez transmettre l'option --debug à la commande. Sous Windows, utilisez l'invite de commande au lieu de PowerShell si vous spécifiez l'option --debug. Vous pouvez exécuter le réseau de base et déployer le code de chaîne sur un port différent de celui par défaut en transmettant l'option --port à la commande.

Vérification

Les journaux suivants montrent que le code de chaîne a été installé et déployé.

my-mac:TSProject myname$ ochain run
Recreating orderer.example.com ... done
Recreating ca.example.com ... done
Recreating peer0.org1.example.com ... done
[2020-09-23T18: 04:09.132] [INFO] default -
============ Started Install Chaincode ============
[2020-09-23T18:04:09.193] [INFO] default Chaincode TSProject:l not installed.
[2020-09-23T18:04:09.317] [INFO] default - Successfully sent install Proposal and received ProposalResponse
[2020-09-23T18:04:09.317] [INFO] default - Successfully installed chaincode TSProject
[2020-09-23T18:04:09.317] [INFO] default -
============ Finished Install Chaincode ============
[2020-09-23T18:04:09.317] [INFO] default - Successfully installed chaincode TSProject
[2020-09-23T18:04:09.318] [INFO] default -
============ started instantiate Chaincode ============
[2020-09-23T18:04:09.366] [INFO] default - Successfully sent Proposal and received ProposalResponse
[2020-09-23T18:04:11.434] [INFO] default - The chaincode instantiate transaction has been committed on peer localhost:7051
[2020-09-23T18:04:11.434] [INFO] default - The chaincode instantiate transaction was valid.
[2020-09-23T18:04:11.435] [INFO] default - Successfully sent transaction to the orderer.
[2020-09-23T18:04:11.435] [INFO] default - Successfully instantiated chaincode TSProject on channel mychannel
[2020-09-23T18:04:11.435] [INFO] default - 
============ Finished instantiate Chaincode ============
[2020-09-23T18:04:11.4351 INFO] default - Successfully instantiated chaincode TSProject on channel mychannel 
INFO (Runtime): Chaincode TSProject installed and ready:
INFO (RunCommand): Chaincode TSProject deployed

Dépannage

Vous pouvez rencontrer les problèmes suivants lors de l'exécution de votre projet de code de chaîne sur un réseau local.

Autorisations d'accès manquantes
Lors de l'installation du projet de code de chaîne Go dans le réseau local, une erreur similaire à la suivante peut s'afficher :
My-Mac:GoProj myname$ ochain run
Starting ca.example.com    ... done
Starting orderer.example.com ... done
Starting peer0.orgl.example.com ... done
INFO (Runtime): 2020/06/22 22:57:09 build started

INFO (Runtime): Building ....

INFO (Runtime): go build runtime/cgo: copying /Users/myname/Library/Caches/go-build/f8/.….….d: open /usr/local/go/pkg/darwin_amd64/runtine/ 
cgo.a: permission denied

ERROR (Runtime): go build runtine/cgo: copying /Users/myname/Library/Caches/go-build/f8/.….….d: open /usr/local/go/pkg/darwin_amd64/runtime/
cgo.a: permission denied

INFO (Runtime): An error occurred while building: exit status 1

Stopping peer0.orgl.exmple.com ... done 
Stopping ca.example.com	... done
Stopping orderer.example.con ... done
Cela est dû à des autorisations manquantes pour Go. Cette erreur a été observée uniquement sous Mac OS. Il s'agit d'un problème connu :
Solution : Modifiez les autorisations de votre $GOROOT et réessayez ochain run : 
sudo chmod -R 777 /usr/local/go
É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.
Solution : Réessayez la commande ochain run, mais avec l'option -b. Cette option reconstruit l'exécution pour vous.
ochain run -b
Recréation d'environnement requise
Recréez votre environnement si vous voyez une erreur canal introuvable ou une erreur similaire au texte suivant :
Starting ca.example.com ... 
Starting orderer.example.com ... 
Starting orderer.example.com ... error
ERROR: for orderer.example.com  
Cannot start service orderer.example.com: 
error while creating mount source path '/host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0/node_modules/@oracle/ochain-cli/runtime/network/basic-network/config': mkdir /host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0: operation not permitted
Starting ca.example.com... error
ERROR: for ca.example.com  
Cannot start service ca.example.com: error while creating mount source path '/host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0/node_modules/@oracle/ochain-cli/runtime/network/basic-network/crypto-config/peerOrganizations/org1.example.com/ca': mkdir /host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0: operation not permitted
ERROR: for orderer.example.com  
Cannot start service orderer.example.com: error while creating mount source path '/host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0/node_modules/@oracle/ochain-cli/runtime/network/basic-network/config': mkdir /host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0: operation not permitted
ERROR: for ca.example.com  
Cannot start service ca.example.com: error while creating mount source path '/host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0/node_modules/@oracle/ochain-cli/runtime/network/basic-network/crypto-config/peerOrganizations/org1.example.com/ca': mkdir /host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0: operation not permitted
Encountered errors while bringing up the project.
ERROR: Starting ca.example.com ... 
Starting orderer.example.com ... 
Starting orderer.example.com ... error
ERROR: for orderer.example.com  
Cannot start service orderer.example.com: error while creating mount source path '/host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0/node_modules/@oracle/ochain-cli/runtime/network/basic-network/config': mkdir /host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0: operation not permitted
Starting ca.example.com ... error
ERROR: for ca.example.com  
Cannot start service ca.example.com: error while creating mount source path '/host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0/node_modules/@oracle/ochain-cli/runtime/network/basic-network/crypto-config/peerOrganizations/org1.example.com/ca': mkdir /host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0: operation not permitted
ERROR: for orderer.example.com  
Cannot start service orderer.example.com: error while creating mount source path '/host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0/node_modules/@oracle/ochain-cli/runtime/network/basic-network/config': mkdir /host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0: operation not permitted
ERROR: for ca.example.com  
Cannot start service ca.example.com: error while creating mount source path '/host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0/node_modules/@oracle/ochain-cli/runtime/network/basic-network/crypto-config/peerOrganizations/org1.example.com/ca': mkdir /host_mnt/c/Users/opc/.vscode/extensions/oracle.oracle-blockchain-1.4.0: operation not permitted
Encountered errors while bringing up the project.
ERROR: Error in Chaincode deployment
Pour reconstruire votre environnement local, exécutez la commande suivante : 
ochain run -b

Déployer le code de chaîne sur un réseau Oracle Blockchain Platform distant

Après avoir déployé et testé votre projet de code de chaîne sur un réseau local pour s'assurer qu'il fonctionne comme prévu, vous pouvez le déployer sur Oracle Blockchain Platform.

Déployer le code de chaîne

Utilisation : ochain deploy [options] [...args]

Les arguments et options suivants peuvent être utilisés avec la commande ochain deploy : 

my-mac:TSProject myname$ ochain deploy -h 
Usage: deploy [options] [...args]
Deploy chaincode project to Oracle Blockchain Platform

Arguments:
     [...args]    (optional) Chaincode instantiate arguments. Arguments should be space separated.
 
Options :
    -h, --help                      output command usage information
    -D, --debug                     enable debug logging
    -P, --project <project>         (optional) Path to Chaincode project to deploy. If not specified, it defaults to current directory.
    -c, --channel <channel>         (optional) Blockchain Channel to deploy chaincode to. If not specified, it defaults to the 'default' channel.
    -u, --username <username>       (required) A user name that has install chaincode privileges. Contact your administrator for more details.
    -v, --userversion <userversion> (optional) A user-specified chaincode version.
                             If a version isn't specified, for a new chaincode it will start at v1 and then increment to v2, v3, and so on.
                             For an existing chaincode, v1.a will increment to v1.a1, v1 will increment to v2, and v1.0 will increment to v1.1.
    -s --sign <password>            (required) Password to authenticate user.
    -r --url <url>                  (required) URL of the remote OBP instance. Example: https://<blockchain-instance-url>:7443/

Examples:
$> ochain deploy -u <username> -s <password> -r <url of the remote OBP instance> -c <name of the channel>

Entrez le nom d'utilisateur et le mot de passe d'Oracle Identity Cloud Service pour un utilisateur d'Oracle Blockchain Platform doté des rôles ADMIN ou REST_CLIENT. Pour plus d'informations sur les utilisateurs et les rôles, voir Configurer des utilisateurs et des rôles d'application.

Pour appeler le code de chaîne, seul le rôle REST_CLIENT est nécessaire. Pour déployer ou mettre à niveau le code de chaîne, le rôle ADMIN doit également être affecté à l'utilisateur IDCS.

Une fois le code de chaîne déployé sur la plate-forme Oracle Blockchain Platform distante, le journal indique que les événements suivants se sont produits :
  • Les détails d'Oracle Blockchain Platform ont été extraits.
  • La liste de pairs a été extraite.
  • Le projet de code de chaîne a été installé.
  • Le projet de code de chaîne a été approuvé et validé.
  • Le code de chaîne a été déployé sur chaque pair et sur le canal.

Dans un environnement comportant plusieurs organisations, pour redéployer le code de chaîne sur le même canal au moyen d'une instance de participant, utilisez la console pour déployer le code de chaîne.

Mise à niveau du projet de code de chaîne

La mise à niveau du code de chaîne est gérée automatiquement par le générateur d'applications de chaîne de blocs. Après avoir apporté des modifications à votre code de chaîne, appelez de nouveau la commande ochain deploy, qui mettra automatiquement à niveau le projet pour vous. Lorsque vous exécutez à nouveau la commande ochain deploy, spécifiez un tableau vide pour le paramètre adminList ou utilisez le paramètre adminList pour ajouter des administrateurs de jeton. Si vous n'êtes pas le premier responsable du déploiement, vous devez fournir un tableau vide pour le paramètre adminList.

Si la mise à niveau réussit, le journal indique que les événements suivants se sont produits :
  • Les détails d'Oracle Blockchain Platform ont été extraits.
  • La liste de pairs a été extraite.
  • Une vérification a été effectuée pour déterminer si le projet de code de chaîne est déjà installé et, le cas échéant, si la version a été extraite.
  • La version du code de chaîne a été mise à niveau (par exemple, de la version 1.0 à la version 2.0).

Dans un environnement avec plusieurs organisations, pour mettre à niveau le code de chaîne, utilisez la console et approuvez manuellement le code de chaîne des participants.

Encapsuler le projet de code de chaîne pour un déploiement manuel sur Oracle Blockchain Platform

Vous pouvez emballer vos projets de code de chaîne pour un déploiement manuel dans Oracle Blockchain Platform Cloud ou Enterprise Edition.

Utilisation : ochain package

La commande package crée un fichier d'archive contenant uniquement les fichiers de compilation et de distribution. Les dossiers binary, libs, node_modules et test de votre projet de code de chaîne ne sont pas inclus. Ce fichier d'archives peut être chargé manuellement dans Oracle Blockchain Platform pour déploiement.

En raison des modifications apportées aux préalables logiciels, lorsque vous exécutez la commande ochain package pour le code de chaîne TypeScript, vous êtes invité à indiquer la date de provisionnement de l'instance Oracle Blockchain Platform pour laquelle vous voulez créer l'ensemble. Le code de chaîne TypeScript créé dans le générateur d'applications de chaîne de blocs n'est pas compatible avec les versions précédentes d'Oracle Blockchain Platform sans modification de l'infrastructure sous-jacente. Le générateur d'applications de chaîne de blocs regroupe l'infrastructure de code de chaîne en conséquence en fonction de votre sélection. 

my-mac:~ myname$ ochain package -h 
Usage: package [options]
Package and archive an Ochain chaincode project 
Options :
    -h, --help             output command usage information
    -D, --debug            enable debug logging
    -p, --project <path>   Path to the Ochain chaincode project to be packaged. If not specified, it defaults to current directory.
    -o, --out <path>       Path to the generated chaincode archive file. If not specified, it defaults to current directory.
About:
This CLI command packages and archives an existing chaincode project 
Examples:
$> ochain package --project <Path to the Ochain chaicode project> —out <Path to the generated chaincode archive file>

Lorsque la commande se termine avec succès, l'emplacement du package est retourné.

Cette commande utilise deux arguments facultatifs :
  • --project

    Cette option définit l'emplacement du projet de code de chaîne du générateur d'applications de chaîne de blocs à inclure dans le paquetage. S'il n'est pas précisé, l'emplacement par défaut est le répertoire courant.

  • --out

    Cette option peut être utilisée pour indiquer le chemin de sortie du fichier d'archive généré. S'il n'est pas précisé, le répertoire courant est affiché par défaut.

Exemple :
ochain package -p /Blockchain/DevTools/bp1/CC -o /Blockchain/DevTools/bp1/output

"Your chaincode project has been packaged at /Blockchain/DevTools/bp1/output/CC.zip"