Oracle Blockchain Platform Enterprise Edition auf Minikube bereitstellen

minikube kann für Test- und interne Entwicklungszwecke verwendet werden. Dies wird für Production-Umgebungen nicht empfohlen.

Voraussetzungen:
  • CPUs: 8 oder höher
  • Speicher: 16GB
  • 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. Bevor Sie die folgenden Schritte ausführen können, müssen Sie die Schritte unter Istio installieren ausgeführt haben.


# 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

So laden Sie Oracle Blockchain Platform Enterprise Edition herunter und installieren es auf Ihrer Minikube-Instanz:

  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. Entpacken Sie das Paket, und extrahieren Sie es aus der heruntergeladenen Archivdatei.
    tar -xzf <distribution-package-file>
    # example tar -xzf obpee_package_24.1.3-20240723083137.tgz
  2. Aktualisieren Sie runme-input.yaml mit den erforderlichen Werten. Dies ist ein Beispiel für runme-input.yaml, das als Referenz verwendet werden kann:
    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
    Hierbei gilt:
    • imageRegistryConfiguration.registry: Zu verwendender Container-Registry-Server. Beispiel: iad.ocir.io
    • imageRegistryConfiguration.imageTagPrefix: Containerbasis-Repository-Pfad mit der Registry, in den die Images übertragen (abgezogen) werden sollen (von). Beispiel: iad.ocir.io/obpee/bcs
    • imageRegistryConfiguration.username: Anmeldename der Containerregistrierung
    • 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 gehen Sie zum Verzeichnis für das Distributionspaket. Führen Sie runme_minikube.sh aus, und führen Sie die Schritte gemäß der Skriptausgabe aus:
    ./runme_minikube.sh [--publish-image]

    Hinweis:

    Der optionale Befehl --publish-image 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): Damit wird das Kennwort des Admin-Benutzers für den integrierten LDAP-Authentifizierungsserver festgelegt.
    • Geben Sie das Standard-Admin-Benutzerkennwort für Control Plane ein (das Kennwort wird nicht angezeigt): Damit wird das Kennwort des Admin-Benutzers für den Blockchain Platform Manager festgelegt.
    • Wenn StorageClass nicht in 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 ist 443 für den Servicetyp LoadBalancer.
    • Geben Sie das Registrierungskennwort <registry name> ein: Damit wird eine Verbindung zur Containerimage-Registry (wie in runme-input.yaml angegeben) zum Herunterladen von Images hergestellt.
  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 den Blockchain Platform Manager und die Instanzen aktiv ist:
    minikube tunnel --bind-address 0.0.0.0
  7. Das Skript muss die folgenden Services unter dem Namespace obp-cp weiterhin installieren:
    • control-plane
    • openldap
    • obp-auth-server
    • obp-operator
    • hlf-operator
  8. Das Skript gibt die Blockchain Platform Manager-URL aus, über die auf die Control-Plane-UI zugegriffen werden kann.

Zugriff auf Blockchain Platform Manager

Konfigurieren Sie nach der Installation die Hostnamenauflösung für die generierten Blockchain Platform Manager-Hostnamen.
  1. Führen Sie diesen 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 Adresse IPv4 des Minikube-Hosts als Zuordnungs-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.