Déployez Oracle Blockchain Platform Enterprise Edition sur minikube

Vous pouvez utiliser minikube à des fins de test et de développement interne. N'utilisez pas minikube pour les environnements de production.

Prérequis :
  • CPU : 8 ou plus
  • Mémoire : 16 Go
  • Espace disque disponible : 50 Go ou plus
  • Utilisateur non root disposant de privilèges de superutilisateur
  • Assurez-vous que le noeud minikube a accès à Internet, ce qui est requis pour installer des codes chaîne sur vos instances Oracle Blockchain Platform.
  • minikube version 1.33.1 ou ultérieure

Installer minikube

Cette section fournit un exemple de procédure pas à pas d'installation de la version testée du minikube. Pour plus d'informations, reportez-vous à Outils d'installation de Kubernetes. 

#Download the latest minikube binary
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64

#Install
sudo install minikube-linux-amd64 /usr/local/bin/minikube

#Verify Installation
minikube version

#Start Minikube
minikube start

#Verify Minikube Installation
minikube status

#Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

#Install minikube using Homebrew
brew install minikube

#Start minikube
minikube start

#Verify minikube Installation
minikube status

Terminer l'installation Istio

Oracle Blockchain Platform Enterprise Edition prend en charge les versions 1.20.2 et ultérieures. Vous devez effectuer les étapes de l'installation d'Istio avant d'exécuter les commandes suivantes. 


# Install
    istioctl install --set profile=default --set values.pilot.env.ENABLE_TLS_ON_SIDECAR_INGRESS=true --set components.cni.enabled=true --set values.cni.repair.deletePods="true"
    ## Enter "y" when prompted for "Proceed? (y/N)"
 
# Verify:
    $ istioctl version
    client version: 1.22.1
    control plane version: 1.22.1
    data plane version: 1.22.1 (1 proxies)

Installation d'Oracle Blockchain Platform Enterprise Edition

Téléchargez et installez Oracle Blockchain Platform Enterprise Edition sur votre instance minikube :

  1. Sur la page Oracle Blockchain Platform Enterprise Edition, cliquez sur Télécharger et suivez les étapes de téléchargement du package Oracle Blockchain Platform Enterprise Edition. Extrayez le package à partir du fichier .zip, puis extrayez le package à partir du fichier d'archive téléchargé.
    tar -xzf <distribution-package-file>
# example tar -xzf obpee_package_24.1.3-20240723083137.tgz
  2. Mettez à jour le fichier runme-input.yaml avec les valeurs requises. L'exemple de fichier runme-input.yaml suivant peut être utilisé comme référence :
    imageRegistryConfiguration:
  registry: <container_registry_name>
  imageTagPrefix: <container-image-repository-prefix>
  username: <container-registry-username>
 
imageReleaseVersion: 24.1.3-20240723083137
 
# storageClassName should be set to create a dynamic persistent volume. If empty, default storageClass is used.
 
controlPlaneStorage:
  storageClassName: 
  # Example 500Mi, 5Gi
  size: 4Gi
  
parentDomainName: example.com
#imagePullTimeout: Use this field to customize the wait time (in seconds) for pulling the required container images from the repository. Default is 1800 seconds.
    imagePullTimeout: 1800
    Dans l'exemple précédent, les variables sont définies comme indiqué dans la liste suivante :
    • imageRegistryConfiguration.registry : serveur de registre de conteneur à utiliser. Exemple : iad.ocir.io
    • imageRegistryConfiguration.imageTagPrefix : chemin du référentiel de base de conteneur avec le registre, à partir duquel les images seront propagées et extraites. Exemple : iad.ocir.io/obpee/bcs
    • imageRegistryConfiguration.username : nom utilisateur de connexion au registre de conteneur
    • imageReleaseVersion : version d'Oracle Blockchain Platform Enterprise Edition
    • controlPlaneStorage.storageClassName : classe de stockage Kubernetes à utiliser pour la demande de volume persistant (PersistentVolumeClaim). Si vide, storageClass par défaut est utilisé
    • controlPlaneStorage.size : taille de PVC pour les services Blockchain Platform Manager (plan de contrôle)
    • parentDomainName : nom de domaine à utiliser pour les services Blockchain Platform Manager. Exemple : example.com
    • imagePullTimeout : délai d'attente d'extraction d'image en secondes lors de l'installation d'Oracle Blockchain Platform Enterprise Edition. La valeur par défaut est 1800 seconde.
  3. Assurez-vous que minikube fonctionne.
  4. Ouvrez une nouvelle fenêtre de terminal et accédez au répertoire du package de distribution. Exécutez le script runme_minikube.sh et suivez les étapes indiquées dans la sortie du script :
    ./runme_minikube.sh [--publish-images]

    Remarques :

    La commande --publish-images facultative télécharge les conteneurs vers un registre d'images de conteneur tel qu'Oracle Cloud Infrastructure Registry.
    • Entrez le mot de passe administrateur LDAP par défaut (le mot de passe ne s'affichera pas) : définit le mot de passe de l'administrateur pour le serveur d'authentification LDAP intégré.
    • Entrez le mot de passe par défaut de l'administrateur du plan de contrôle (le mot de passe ne sera pas affiché) : définit le mot de passe de l'administrateur Blockchain Platform Manager.
    • Si StorageClass n'a pas été fourni dans le fichier runme-input.yaml, le système vérifie si la classe de stockage par défaut est définie et vous demande si vous voulez l'utiliser.
    • Confirmez le port HTTPS du service de passerelle entrante Istio : la valeur par défaut est 443 pour le type de service LoadBalancer.
    • Entrez le mot de passe du registre <nom du registre> : ce mot de passe permet de se connecter au registre d'images de conteneur (tel qu'indiqué dans le fichier runme-input.yaml) pour télécharger des images.
  5. Dans une autre fenêtre du terminal, exécutez la commande suivante :
    export KUBECONFIG=/<path_to>/.kube/minikube
  6. Assurez-vous que le tunnel minikube est actif pour accéder à Blockchain Platform Manager et aux instances :
    minikube tunnel --bind-address 0.0.0.0
  7. Le script installe les services suivants sous l'espace de noms obp-cp :
    • control-plane
    • openldap
    • obp-auth-server
    • obp-operator
    • hlf-operator
  8. Le script affiche l'URL du gestionnaire de plate-forme Blockchain, que vous pouvez utiliser pour accéder à l'interface utilisateur du plan de contrôle.

Accéder à Blockchain Platform Manager

Après l'installation, configurez la résolution des noms d'hôte pour les noms d'hôte Blockchain Platform Manager générés.
  1. Exécutez la commande suivante pour obtenir la liste des noms d'hôte configurés :
    kubectl get virtualservice -n obp-cp -o json | jq -r '.items[].spec.hosts[0]'
  2. Utilisez l'adresse IPv4 de l'hôte minikube comme adresse IP de mappage pour les noms d'hôte générés.
  3. Assurez-vous que le tunnel minikube est actif pour accéder aux instances Blockchain Platform Manager et Oracle Blockchain Platform.