Scénario : exécution du code chaîne en tant que service

L'exemple suivant illustre l'exécution du code chaîne FabCar en tant que service externe (un pod dans le cluster Kubernetes) que vous pouvez ensuite déployer vers Oracle Blockchain Platform.

Avant d'effectuer les étapes suivantes, déployez le code chaîne en tant que package externe dans Oracle Blockchain Platform.

1. Clonez le répertoire GitHub dans le référentiel hyperledger/fabric-samples qui contient fabcar/external. Le répertoire contient la version externe du code chaîne FabCar dans Go, fabcar.go et un fichier Dockerfile. Ignorez les fichiers metadata.json et chaincode.env.example.
2. Modifiez le fichier Dockerfile comme indiqué dans l'exemple suivant :

   # Use the Go image from Docker Hub with specified versions for Go and Alpine Linux
   FROM golang:1.13.8-alpine3.10
   
   # Create a directory named "chaincode" in the image
   RUN mkdir /chaincode
   
   # Set "/chaincode" as the working directory within the image
   WORKDIR /chaincode
   
   # Copy the contents of the local directory into "/chaincode" in the image
   COPY . .
   
   # Fetch and install Go dependencies for the project
   RUN go get -d -v ./...
   
   # Install Go dependencies
   RUN go install -v ./...
   
   # Compile the Go code in the current directory, creating an executable binary named "fabcar"
   RUN go build -o fabcar .
   
   # Expose port 9999, indicating that the application within the container will listen on this port
   EXPOSE 9999
   
   # Set the default command to run the "fabcar" executable when the container starts
   CMD ["/chaincode/fabcar"]

   Cette séquence de commandes définit l'image de base pour la création de la nouvelle image sur l'image Go avec des versions spécifiques pour Go et Alpine Linux, crée un répertoire, définit ce répertoire comme répertoire de travail, copie le contenu local dans l'image, extrait et installe les dépendances Go, compile le code Go, configure le conteneur à écouter sur le port 9999 et définit la commande par défaut pour exécuter l'exécutable fabcar.

3. Exécutez la commande suivante pour créer l'image Docker, qui crée une image Docker nommée fabcar-sample, qui peut ensuite être propagée vers un référentiel.

   docker build -t fabcar-sample .

4. Créez un fichier YAML de déploiement Kubernetes pour exécuter l'image Docker contenant le code chaîne. L'exemple suivant montre un fichier deployment.yaml. Le référentiel à partir duquel l'image Docker est extraite est repository.example.org. Le nom de clé secrète Kubernetes utilisé pour extraire les images est ocirsecret. La valeur CHAINCODE_SERVER_ADDRESS est 0.0.0.0 :9999, ce qui indique que le serveur est configuré pour accepter les connexions entrantes sur le port 9999 à partir de n'importe quelle adresse IP associée à l'ordinateur. Obtenez la valeur CHAINCODE_ID à partir de l'ID de package de code chaîne affiché lorsque vous effectuez un déploiement sur le noeud homologue dans Oracle Blockchain Platform en sélectionnant le type de code chaîne externe et en téléchargeant un fichier .zip. Dans l'interface utilisateur Oracle Blockchain Platform, l'ID de code chaîne est affiché sous la forme chaincode_name :package_ID. Pour le code chaîne Java, la variable d'ID de code chaîne est appelée CORE_CHAINCODE_ID_NAME.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
   name: external-fabcar-node
   namespace: chaincode
   labels:
   chaincode-type: external
   chaincode-name: external-fabcar-node
   spec:
   replicas: 1
   selector:
   matchLabels:
   chaincode-type: external
   chaincode-name: external-fabcar-node
   template:
   metadata:
   labels:
   chaincode-type: external
   chaincode-name: external-fabcar-node
   spec:
   imagePullSecrets:
   - name: ocirsecret
   containers:
   - env:
   - name: CHAINCODE_SERVER_ADDRESS
   value: "0.0.0.0:9999"
   - name: CHAINCODE_ID
   value: "ext-fabcar-node:7f953544f26124914c29467d5079f601ddefa53375fffec830ecd70c13547877"
   image: repository.example.org/blockchain/fabcar-sample:latest
   imagePullPolicy: Always
   name: assettransfer
   ports:
   - containerPort: 9999
   name: grpc
   protocol: TCP
   
   
   
   ---
   
   apiVersion: v1
   kind: Service
   metadata:
   labels:
   chaincode-name: external-fabcar-node
   chaincode-type: external
   name: external-fabcar-node
   namespace: chaincode
   spec:
   ports:
   - name: grpc
   port: 9999
   protocol: TCP
   targetPort: 9999
   selector:
   chaincode-name: external-fabcar-node
   chaincode-type: external
   type: ClusterIP

5. Exécutez la commande suivante pour générer une clé secrète Kubernetes dans l'espace de noms chaincode. Pour name_of_secret, indiquez la clé secrète à partir du fichier deployment.yaml. Dans cet exemple, le nom de la clé secrète est ocirsecret.

   kubectl create secret docker-registry name_of_secret -n chaincode --docker-server='repository.example.org/blockchain' --docker-username='your_username' --docker-password='auth_token'

6. Exécutez la commande suivante pour déployer le pod et le service Kubernetes.

   kubectl apply -f deployment.yaml

Vous pouvez désormais exécuter des transactions qui utilisent le code chaîne externe à partir d'Oracle Blockchain Platform.