Déployez Oracle Blockchain Platform Enterprise Edition sur minikube

minikube peut être utilisé à des fins de test et de développement interne. Il n'est pas recommandé pour les environnements de production.

Prérequis :
  • CPU : 8 ou plus
  • Mémoire : 16 Go
  • Espace disque libre : 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 l'installation 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 avoir effectué les étapes de la section Install Istio avant d'effectuer les opérations 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

Pour télécharger et installer Oracle Blockchain Platform Enterprise Edition sur votre instance minikube, procédez comme suit :

  1. Sur la page Oracle Blockchain Platform Enterprise Edition, cliquez sur Télécharger et suivez les étapes permettant de télécharger le package Oracle Blockchain Platform Enterprise Edition. Décompressez le package, puis extrayez-le 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 runme-input.yaml avec les valeurs requises. Voici un exemple runme-input.yaml qui 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
    où :
    • 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, où les images doivent être propagées (extraites) vers (depuis). Exemple : iad.ocir.io/obpee/bcs
    • imageRegistryConfiguration.username : nom utilisateur de connexion au registre de conteneurs
    • imageReleaseVersion - Version d'Oracle Blockchain Platform Enterprise Edition
    • controlPlaneStorage.storageClassName : classe de stockage Kubernetes à utiliser pour la demande de volume persistant (PersistentVolumeClaim). Si vide, la valeur par défaut storageClass est utilisée
    • 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. Vérifiez que minikube est en cours d'exécution.
  4. Ouvrez une nouvelle fenêtre de terminal et accédez au répertoire du package de distribution. Exécutez runme_minikube.sh et suivez les étapes indiquées dans la sortie du script :
    ./runme_minikube.sh [--publish-image]

    Remarques :

    La commande facultative --publish-image télécharge les conteneurs vers un registre d'images de conteneur, tel qu'Oracle Cloud Infrastructure Registry.
    • Entrez le mot de passe de l'administrateur LDAP par défaut (le mot de passe ne sera pas affiché) : il est utilisé pour définir le mot de passe de l'administrateur pour le serveur d'authentification LDAP intégré.
    • Entrez le mot de passe de l'administrateur du plan de contrôle par défaut (le mot de passe ne sera pas affiché) : il est utilisé pour définir le mot de passe de l'administrateur Blockchain Platform Manager.
    • Si StorageClass n'a pas été fourni dans runme-input.yaml, le système vérifie si la classe de stockage par défaut est définie et vous demande si vous souhaitez l'utiliser.
    • Vérifiez 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 <registry name> : il permet de se connecter au registre d'images de conteneur (tel qu'indiqué dans 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 au gestionnaire de plate-forme de chaîne de blocs et aux instances :
    minikube tunnel --bind-address 0.0.0.0
  7. Le script doit continuer à installer les services ci-dessous sous l'espace de noms obp-cp :
    • control-plane
    • openldap
    • obp-auth-server
    • obp-operator
    • hlf-operator
  8. Le script génère l'URL Blockchain Platform Manager, à partir de laquelle l'interface utilisateur du plan de contrôle est accessible.

Accéder à Blockchain Platform Manager

Après l'installation, configurez la résolution de nom d'hôte pour les noms d'hôte Blockchain Platform Manager générés.
  1. Exécutez cette commande 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.