Distribuisci Oracle Blockchain Platform Enterprise Edition su minikube

minikube può essere utilizzato per scopi di test e sviluppo interno. Non è raccomandato per gli ambienti di produzione.

Prerequisiti:
  • CPU: 8 o superiore
  • Memoria: 16GB
  • Spazio libero su disco: 50 GB o superiore
  • Utente non root con privilegi di utente privilegiato
  • Assicurarsi che il nodo minikube disponga dell'accesso a Internet, necessario per l'installazione dei codici concatenati nelle istanze di Oracle Blockchain Platform.
  • minikube v1.33.1 o versione successiva

Installa minikube

Questa sezione fornisce un esempio di procedura dettagliata per l'installazione della versione testata del minikube. Per ulteriori informazioni, vedere Strumenti di installazione di 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

Completare l'installazione Istio

Oracle Blockchain Platform Enterprise Edition supporta la versione 1.20.2 e successive. È necessario aver completato la procedura descritta in Installa Istio prima di completare quanto segue.


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

Installare Oracle Blockchain Platform Enterprise Edition

Per scaricare e installare Oracle Blockchain Platform Enterprise Edition sull'istanza di minikube:

  1. Nella pagina Oracle Blockchain Platform Enterprise Edition, fare clic su Scarica e seguire i passi per scaricare il pacchetto Oracle Blockchain Platform Enterprise Edition. Decomprimere il pacchetto, quindi estrarlo dal file di archivio scaricato.
    tar -xzf <distribution-package-file>
    # example tar -xzf obpee_package_24.1.3-20240723083137.tgz
  2. Aggiornare runme-input.yaml con i valori richiesti. Questo è un esempio di runme-input.yaml che può essere utilizzato come riferimento:
    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
    dove:
    • imageRegistryConfiguration.registry: server del registro contenitore da utilizzare. Esempio: iad.ocir.io
    • imageRegistryConfiguration.imageTagPrefix: percorso del repository di base contenitore con il registro, in cui le immagini devono essere sottoposte a push (pulled) in (from). Esempio: iad.ocir.io/obpee/bcs
    • imageRegistryConfiguration.username: nome utente di login registro contenitore
    • imageReleaseVersion - Versione della release Oracle Blockchain Platform Enterprise Edition
    • controlPlaneStorage.storageClassName: classe di storage Kubernetes da utilizzare per il PVC (PersistentVolumeClaim). Se vuoto, viene utilizzato il valore predefinito storageClass
    • controlPlaneStorage.size: dimensioni del PVC per i servizi Blockchain Platform Manager (piano di controllo)
    • parentDomainName: nome di dominio da utilizzare per i servizi Blockchain Platform Manager. Esempio: example.com
    • imagePullTimeout: timeout di attesa pull delle immagini in secondi durante l'installazione di Oracle Blockchain Platform Enterprise Edition. L'impostazione predefinita è 1800 secondi.
  3. Assicurarsi che minikube sia in esecuzione.
  4. Aprire una nuova finestra di terminale e andare alla directory dei pacchetti di distribuzione. Eseguire runme_minikube.sh e seguire i passi come richiesto dall'output dello script:
    ./runme_minikube.sh [--publish-image]

    Nota

    Il comando --publish-image facoltativo carica i container in un registro di immagini del container, ad esempio Oracle Cloud Infrastructure Registry.
    • Immettere la password predefinita dell'amministratore LDAP (la password non verrà visualizzata): viene utilizzata per impostare la password dell'utente amministratore per il server di autenticazione LDAP incorporato.
    • Immettere la password utente amministratore del piano di controllo predefinito (la password non verrà visualizzata): viene utilizzata per impostare la password dell'utente amministratore di Blockchain Platform Manager.
    • Se StorageClass non è stato fornito in runme-input.yaml, il sistema controllerà se la classe di memorizzazione predefinita è impostata e chiederà se si desidera utilizzarla.
    • Confermare la porta https del servizio gateway in entrata Istio: l'impostazione predefinita è 443 per il tipo di servizio LoadBalancer.
    • Immettere la password <registry name> del registro: viene utilizzata per connettersi al registro delle immagini del contenitore (come specificato in runme-input.yaml) per scaricare le immagini.
  5. In un'altra finestra di terminale, eseguire il comando seguente:
    export KUBECONFIG=/<path_to>/.kube/minikube
  6. Assicurarsi che il tunnel minikube sia attivo per accedere a Blockchain Platform Manager e alle istanze:
    minikube tunnel --bind-address 0.0.0.0
  7. Lo script dovrebbe continuare a installare i servizi riportati di seguito nello spazio di nomi obp-cp:
    • control-plane
    • openldap
    • obp-auth-server
    • obp-operator
    • hlf-operator
  8. Lo script restituirà l'URL di Blockchain Platform Manager, dal quale è accessibile l'interfaccia utente del piano di controllo.

Accedi a Blockchain Platform Manager

Dopo l'installazione, configurare la risoluzione del nome host per i nomi host di Blockchain Platform Manager generati.
  1. Eseguire questo comando per ottenere la lista dei nomi host configurati:
    kubectl get virtualservice -n obp-cp -o json | jq -r .items[].spec.hosts[0]
  2. Utilizzare l'indirizzo IPv4 dell'host minikube come indirizzo IP di mapping per i nomi host generati.
  3. Assicurarsi che il tunnel minikube sia attivo per accedere alle istanze di Blockchain Platform Manager e Oracle Blockchain Platform.