Distribuisci Oracle Blockchain Platform Enterprise Edition su minikube

È possibile utilizzare minikube per scopi di test e sviluppo interno. Non utilizzare minikube per gli ambienti di produzione.

Prerequisiti:
  • CPU: 8 o superiore
  • Memoria: 16 GB
  • 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 installare i 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. Prima di eseguire i seguenti comandi, è necessario eseguire la procedura descritta in Installa istio. 


# 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

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 la procedura per scaricare il package Oracle Blockchain Platform Enterprise Edition. Estrarre il pacchetto dal file .zip, quindi estrarre il pacchetto dal file di archivio scaricato.
    tar -xzf <distribution-package-file>
# example tar -xzf obpee_package_24.1.3-20240723083137.tgz
  2. Aggiornare il file runme-input.yaml con i valori richiesti. Il seguente esempio di file runme-input.yaml 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
    Nell'esempio precedente, le variabili sono definite come illustrato nell'elenco seguente:
    • imageRegistryConfiguration.registry: server del registro contenitore da utilizzare. Esempio: iad.ocir.io
    • imageRegistryConfiguration.imageTagPrefix: percorso del repository di base del contenitore con il registro, in cui verrà eseguito il push e il pull delle immagini. Esempio: iad.ocir.io/obpee/bcs
    • imageRegistryConfiguration.username: nome utente di login al registro contenitore
    • imageReleaseVersion: versione della release di 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 del pacchetto di distribuzione. Eseguire lo script runme_minikube.sh e attenersi alla procedura richiesta dall'output dello script:
    ./runme_minikube.sh [--publish-images]

    Nota

    Il comando --publish-images facoltativo carica i contenitori in un registro delle immagini del contenitore, ad esempio Oracle Cloud Infrastructure Registry.
    • Immettere la password predefinita dell'amministratore LDAP (la password non verrà visualizzata): imposta la password dell'amministratore per il server di autenticazione LDAP incorporato.
    • Immettere la password utente amministratore del piano di controllo predefinito (la password non verrà visualizzata): imposta la password dell'amministratore di Blockchain Platform Manager.
    • Se StorageClass non è stato fornito nel file runme-input.yaml, il sistema controlla se la classe di memorizzazione predefinita è impostata e chiede se si desidera utilizzarla.
    • Confermare la porta https del servizio gateway in entrata Istio: il valore predefinito è 443 per il tipo di servizio LoadBalancer.
    • Immettere la password del registro <nome registro>: questa password viene utilizzata per connettersi al registro delle immagini del contenitore (come specificato nel file 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 installa i seguenti servizi nello spazio di nomi obp-cp:
    • control-plane
    • openldap
    • obp-auth-server
    • obp-operator
    • hlf-operator
  8. Lo script visualizza l'URL di Blockchain Platform Manager, che è possibile utilizzare per accedere all'interfaccia utente del piano di controllo.

Accedi a Blockchain Platform Manager

Dopo l'installazione, configurare la risoluzione dei nomi host per i nomi host Blockchain Platform Manager generati.
  1. Eseguire il comando seguente per ottenere l'elenco 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.