1. Amministrazione di Oracle Blockchain Platform
  2. Installare l'istanza di Oracle Blockchain Platform
  3. Distribuisci Oracle Blockchain Platform Enterprise Edition su minikube

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.