Oracle Blockchain Platform Enterprise Edition auf Minikube bereitstellen

Sie können minikube für Test- und interne Entwicklungszwecke verwenden. Verwenden Sie minikube nicht für Produktionsumgebungen.

Voraussetzungen:
  • CPUs: 8 oder höher
  • Arbeitsspeicher: 16 GB
  • Freier Speicherplatz: 50 GB oder höher
  • Ein Nicht-Root-Benutzer mit Superuser-Berechtigungen
  • Stellen Sie sicher, dass der Minikube-Knoten Zugriff auf das Internet hat, das für die Installation von Chaincodes auf Ihren Oracle Blockchain Platform-Instanzen erforderlich ist.
  • minikube v1.33.1 oder höher

Minikube installieren

Dieser Abschnitt enthält ein Beispiel für die Installation der getesteten Version des Minikubes. Zusätzliche Informationen finden Sie unter Kubernetes-Installationstools. 

#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

Istio-Installation abschließen

Oracle Blockchain Platform Enterprise Edition unterstützt Version 1.20.2 und höher. Sie müssen die Schritte unter Istio installieren ausführen, bevor Sie die folgenden Befehle ausführen. 


# 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)

Oracle Blockchain Platform Enterprise Edition installieren

Laden Sie die Oracle Blockchain Platform Enterprise Edition auf Ihrer minikube-Instanz herunter, und installieren Sie sie:

  1. Klicken Sie auf der Seite Oracle Blockchain Platform Enterprise Edition auf Herunterladen, und befolgen Sie die Schritte zum Herunterladen des Oracle Blockchain Platform Enterprise Edition-Packages. Extrahieren Sie das Package aus der Datei .zip, und extrahieren Sie es dann aus der heruntergeladenen Archivdatei.
    tar -xzf <distribution-package-file>
# example tar -xzf obpee_package_24.1.3-20240723083137.tgz
  2. Aktualisieren Sie die Datei runme-input.yaml mit den erforderlichen Werten. Die folgende Beispieldatei runme-input.yaml kann als Referenz verwendet werden:
    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
    Im vorherigen Beispiel werden die Variablen wie in der folgenden Liste dargestellt definiert:
    • imageRegistryConfiguration.registry: Zu verwendender Container-Registry-Server. Beispiel: iad.ocir.io
    • imageRegistryConfiguration.imageTagPrefix: Container-Basis-Repository-Pfad mit der Registry, in die Images übertragen und daraus abgerufen werden. Beispiel: iad.ocir.io/obpee/bcs
    • imageRegistryConfiguration.username: Benutzername der Container-Registry-Anmeldung
    • imageReleaseVersion: Oracle Blockchain Platform Enterprise Edition-Releaseversion
    • controlPlaneStorage.storageClassName: Kubernetes-Speicherklasse für PVC (PersistentVolumeClaim). Wenn leer, wird der Standardwert storageClass verwendet
    • controlPlaneStorage.size: PVC-Größe für Blockchain Platform Manager-(Control Plane-)Services
    • parentDomainName: Domainname für Blockchain Platform Manager-Services. Beispiel: example.com
    • imagePullTimeout: Timeout für Image-Pull-Wartezeit in Sekunden während der Installation von Oracle Blockchain Platform Enterprise Edition. Der Standardwert ist "1800 Sekunden".
  3. Stellen Sie sicher, dass minikube ausgeführt wird.
  4. Öffnen Sie ein neues Terminalfenster, und wechseln Sie zum Verteilungspaketverzeichnis. Führen Sie das Skript runme_minikube.sh aus, und befolgen Sie die Schritte, wie in der Skriptausgabe gefordert:
    ./runme_minikube.sh [--publish-images]

    Hinweis:

    Der optionale Befehl --publish-images lädt die Container in eine Containerimage-Registry wie Oracle Cloud Infrastructure Registry hoch.
    • Geben Sie das Standard-LDAP-Admin-Kennwort ein (das Kennwort wird nicht angezeigt): Legt das Administratorkennwort für den integrierten LDAP-Authentifizierungsserver fest.
    • Geben Sie das Standardkennwort für den Control-Plane-Admin-Benutzer ein (das Kennwort wird nicht angezeigt): Legt das Kennwort des Blockchain Platform Manager-Administrators fest.
    • Wenn StorageClass nicht in der Datei runme-input.yaml angegeben wurde, prüft das System, ob die Standardspeicherklasse festgelegt ist, und fragt, ob Sie sie verwenden möchten.
    • Bestätigen Sie den HTTPS-Port des Istio-Ingress-Gatewayservice: Der Standardwert für den Servicetyp LoadBalancer ist 443.
    • Geben Sie das Registrierungskennwort <Registry-Name> ein: Dieses Kennwort wird verwendet, um eine Verbindung zu Ihrer Containerimage-Registry (wie in der Datei runme-input.yaml angegeben) zum Herunterladen von Images herzustellen.
  5. Führen Sie den folgenden Befehl in einem anderen Terminalfenster aus:
    export KUBECONFIG=/<path_to>/.kube/minikube
  6. Stellen Sie sicher, dass der Minikube-Tunnel für den Zugriff auf Blockchain Platform Manager und Instanzen aktiv ist:
    minikube tunnel --bind-address 0.0.0.0
  7. Das Skript installiert die folgenden Services unter dem Namespace obp-cp:
    • control-plane
    • openldap
    • obp-auth-server
    • obp-operator
    • hlf-operator
  8. Das Skript zeigt die Blockchain Platform Manager-URL an, mit der Sie auf die Control Plane-UI zugreifen können.

Zugriff auf Blockchain Platform Manager

Konfigurieren Sie nach der Installation die Hostnamensauflösung für die generierten Blockchain Platform Manager-Hostnamen.
  1. Führen Sie den folgenden Befehl aus, um die Liste der konfigurierten Hostnamen abzurufen:
    kubectl get virtualservice -n obp-cp -o json | jq -r '.items[].spec.hosts[0]'
  2. Verwenden Sie die IPv4-Adresse des Minikube-Hosts als Mapping-IP-Adresse für die generierten Hostnamen.
  3. Stellen Sie sicher, dass der Minikube-Tunnel für den Zugriff auf Blockchain Platform Manager- und Oracle Blockchain Platform-Instanzen aktiv ist.