Prerequisiti

Questo argomento contiene i prerequisiti hardware e software per l'installazione di Oracle Blockchain Platform Enterprise Edition.

Piattaforme Kubernetes

Sono supportate le seguenti piattaforme:

Oracle Cloud Infrastructure Container Engine for Kubernetes (OKE) v1.29.1 o versione successiva
Red Hat OpenShift Local - Embedded OpenShift versione 4.15.3 o versioni successive compatibili, Code Ready Container versione 2.34.1 o versioni successive compatibili
Red Hat OpenShift su Microsoft Azure v4.17.27 o versioni successive compatibili
Red Hat OpenShift cluster on-premise v4.17 o versioni compatibili successive
minikube v1.33.1 o versione successiva - solo ambiente di test, non per la produzione

È necessario disporre di un nome di dominio valido che possa essere risolto da un server DNS. Solo per ambienti di test o non di produzione, è possibile configurare la risoluzione dei nomi locali aggiungendo voci nel file /etc/hosts. I nomi host e gli indirizzi IP specifici da utilizzare nel file /etc/hosts vengono generati dopo la distribuzione. Per ulteriori informazioni, vedere la sezione Accedi a Blockchain Platform Manager dell'argomento di installazione per la versione di Kubernetes in uso.

Altro software dei prerequisiti

Inoltre, avrai bisogno dei seguenti strumenti per gestire la tua piattaforma Kubernetes e installare il tuo contenitore Oracle Blockchain Platform:

kubectl versione 1.29.3 o successiva - Strumento della riga di comando di Kubernetes
Helm versione 3.12.3 o successiva - un gestore di pacchetti Kubernetes
Strumenti per gestire i tuoi contenitori e pod - scegli uno dei seguenti:
- Podman versione 4.9.4-rhel o successiva
- Docker versione 24.0.6 o successiva
yq versione 4.42.1 - un processore YAML della riga di comando
jq v1.7.1 o versioni successive - un processore JSON della riga di comando
Istio - strumento di sicurezza e gestione del traffico per le distribuzioni
- v1.20.2 o versioni successive per OKE o minikube su cui è in esecuzione la patch 4 o versioni precedenti di Oracle Blockchain Platform Enterprise Edition
- v1.22.1 o versione successiva per OKE o minikube su cui è in esecuzione la patch 5 o versione successiva di Oracle Blockchain Platform Enterprise Edition
- v1.22.1 per Red Hat OpenShift Locale
- v1.26.0 per Red Hat OpenShift su Microsoft Azure
- v1.26.0 per Red Hat OpenShift On-premise
istioctl - lo strumento della riga di comando per Istio

Browser Web

È possibile accedere a tutti gli strumenti amministrativi inclusi in Oracle Blockchain Platform utilizzando i browser riportati di seguito.

Mozilla Firefox
Microsoft Edge
Google Chrome
Apple Safari

Installa software dei prerequisiti

Questa sezione fornisce un esempio di procedura dettagliata per installare le versioni testate dei prerequisiti. Per ulteriori informazioni ed eventuali modifiche necessarie alle istruzioni di installazione, consultare la documentazione di ciascun prodotto.

Oracle Linux
macOS

Installa kubectl

La versione di kubectl deve essere sempre compresa in una differenza di versione minore del cluster. Ad esempio, se la versione del cluster Kubernetes è v1.29.1, è possibile utilizzare kubectl v1.29.3. Per ulteriori informazioni, vedere Strumenti di installazione di Kubernetes.

# Download:
    curl -LO https://dl.k8s.io/release/v1.29.3/bin/linux/amd64/kubectl
 
# Setup:
    # Make binary file executable:
    chmod +x ./kubectl
    # Move the downloaded binary to /usr/local/bin or /usr/bin and make "root" as the owner of this binary
    sudo mv ./kubectl /usr/bin/kubectl
    sudo chown root: /usr/bin/kubectl
 
# Verify:
    $ kubectl version --client --output=yaml
    clientVersion:
        buildDate: "2024-03-15T00:08:19Z"
        compiler: gc
        gitCommit: 6813625b7cd706db5bc7388921be03071e1a492d
        gitTreeState: clean
        gitVersion: v1.29.3
        goVersion: go1.21.8
        major: "1"
        minor: "29"
        platform: linux/amd64
    kustomizeVersion: v5.0.4-0.20230601165947-6ce0bf390ce3

Installa Helm

Oracle Blockchain Platform Enterprise Edition è stato testato con Helm v3.12.3. Per ulteriori informazioni, vedere Installazione di Helm.

#Download install script:
    curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3
 
# Provide execute permission and execute:
    chmod +x get_helm.sh
    ./get_helm.sh
 
# Verify:"
    $ helm version
    version.BuildInfo{Version:"v3.12.3", GitCommit:"3a31588ad33fe3b89af5a2a54ee1d25bfe6eaa5e", GitTreeState:"clean", GoVersion:"go1.20.7"}

Installa Podman

Oracle Blockchain Platform Enterprise Edition è stato testato con Podman v4.9.4-rhel. Per ulteriori informazioni, vedere Istruzioni di installazione di Podman.

# Update the package list:
    sudo yum update
 
# Install podman:
    sudo yum install podman -y
 
# create docker alias to run podman commands
    sudo yum install -y podman-docker
 
#Verify:
    $ podman --version
        podman version 4.9.4-rhel
    $ docker --version
        podman version 4.9.4-rhel

Installa yq

Oracle Blockchain Platform Enterprise Edition è stato testato con yq v4.42.1. Per maggiori informazioni, vedere README YQ.

# Download:
    wget https://github.com/mikefarah/yq/releases/download/v4.42.1/yq_linux_amd64.tar.gz -O - | tar xz
 
# Setup:
    sudo mv yq_linux_amd64 /usr/bin/yq
    sudo chmod +x /usr/bin/yq
 
# Verify:
yq --version

Installa jq

Oracle Blockchain Platform Enterprise Edition è stato testato con jq v1.7.1. Per ulteriori informazioni, vedere Scarica jq.

# Install:
    sudo dnf install jq

# Verify:
   jq --version
   jq-1.7.1

Installa kubectl

La versione di kubectl deve essere sempre compresa in una differenza di versione minore del cluster. Ad esempio, se la versione del cluster di Oracle Kubernetes Engine è v1.29.1, puoi utilizzare kubectl v1.29.3. Per ulteriori informazioni, vedere Strumenti di installazione di Kubernetes.

curl -LO https://dl.k8s.io/release/v1.29.3/bin/darwin/amd64/kubectl

# Setup:
    # Make binary file executable:
    chmod +x ./kubectl
    # Move the downloaded binary to /usr/local/bin and make "root" as the owner of this binary
    sudo mv ./kubectl /usr/local/bin/kubectl
    sudo chown root: /usr/local/bin/kubectl
 
# Verify:
    $ kubectl version --client --output=yaml

    clientVersion:
        buildDate: "2024-03-15T00:08:19Z"
        compiler: gc
        gitCommit: 6813625b7cd706db5bc7388921be03071e1a492d
        gitTreeState: clean
        gitVersion: v1.29.3
        goVersion: go1.21.8
        major: "1"
        minor: "29"
        platform: darwin/amd64
    kustomizeVersion: v5.0.4-0.20230601165947-6ce0bf390ce3

Installa Helm

Oracle Blockchain Platform Enterprise Edition è stato testato con Helm v3.12.3. Per ulteriori informazioni, vedere Installazione di Helm.

#Download install script:
    curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3
 
# Provide execute permission and execute:
    chmod +x get_helm.sh
    ./get_helm.sh
 
# Verify:"
    $ helm version
    version.BuildInfo{Version:"v3.12.3", GitCommit:"3a31588ad33fe3b89af5a2a54ee1d25bfe6eaa5e", GitTreeState:"clean", GoVersion:"go1.20.7"}

Installa Podman

Oracle Blockchain Platform Enterprise Edition è stato testato con Podman v4.9.4-rhel. Per ulteriori informazioni, vedere Istruzioni di installazione di Podman.

# Install:
     brew install podman

# After installing, you need to create and start your first Podman machine:

     podman machine init
     podman machine start

# Verify:
     podman info
     host: arch: amd64 buildahVersion: 1.36.0 cgroupControllers: - cpu - io - memory - pids cgroupManager: systemd

# Make docker commands available via podman by creating a symlink:
     sudo ln -s /usr/local/bin/podman /usr/local/bin/docker

Installa yq

Oracle Blockchain Platform Enterprise Edition è stato testato con yq v4.44.1. Per maggiori informazioni, vedere il README YQ.

# Install:
    brew install yq

# Verify:
   yq--version
   yq (https://github.com/mikefarah/yq/) version v4.44.1

Installa jq

Oracle Blockchain Platform Enterprise Edition è stato testato con jq v1.7.1. Per ulteriori informazioni, vedere Scarica jq.

# Install:
    brew install jq

# Verify:
   jq --version
   jq-1.7.1

Installa istio

Istio estende Kubernetes per fornire la gestione e la sicurezza del traffico a implementazioni complesse. Oracle Blockchain Platform Enterprise Edition utilizza Istio come servizio gateway in entrata per accettare il traffico in entrata in vari servizi.

Oracle Linux
macOS

Si consiglia di installare Istio e istioctl (utilità della riga di comando di configurazione Istio).

Per scaricare Istio:

# Download istioctl tool
   curl -L https://istio.io/downloadIstio | sh -

# (optional) You can move the downloaded "istio-1.22.1" directory     
   mv ./istio-1.22.1 $HOME/istioctl

# Add the istioctl client to your path     
export PATH=$HOME/istioctl/bin:$PATH

Si consiglia di installare Istio e istioctl (utilità della riga di comando di configurazione Istio).

Per scaricare Istio:

# Download istioctl tool
   curl -L https://istio.io/downloadIstio | sh -

# (optional) You can move the downloaded "istio-1.22.1" directory     
   mv ./istio-1.22.1 $HOME/istioctl

# Add the istioctl client to your path     
export PATH=$HOME/istioctl/bin:$PATH

Nota

L'installazione Istio verrà completata dopo la creazione del cluster Kubernetes. Ha una dipendenza dal file .kube/config.

Il servizio ingressgateway di Istio può essere configurato in Kubernetes per essere eseguito con i tipi di servizio LoadBalancer o NodePort. Per informazioni dettagliate, consultare la documentazione di Istio: Istio Ingress Gateway

Load balancer: Se il cluster Kubernetes supporta un load balancer esterno, si consiglia di configurare il servizio gateway di entrata Istio come load balancer utilizzando lo script runme di Oracle Blockchain Platform Enterprise Edition che verrà utilizzato durante la distribuzione. Oracle Blockchain Platform Enterprise Edition utilizzerà la porta https (443) del gateway di entrata Istio come porta pubblica per accettare il traffico in entrata. Se lo si desidera, è possibile personalizzare questo valore della porta durante l'installazione di Oracle Blockchain Platform Enterprise Edition utilizzando lo script runme.
Porta nodo: Nei casi in cui non è possibile utilizzare il tipo di servizio load balancer, il servizio gateway in entrata Istio può essere configurato con il tipo di servizio porta nodo. Oracle Blockchain Platform Enterprise Edition utilizzerà il valore nodePort della porta https nel gateway di entrata Istio per instradare il traffico esterno a Oracle Blockchain Platform Enterprise Edition all'interno del cluster Kubernetes. Il valore di nodePort per la porta https può essere personalizzato facoltativamente (in base all'intervallo nodePort consentito) durante l'installazione di Oracle Blockchain Platform Enterprise Edition utilizzando lo script runme. Per impostazione predefinita, l'intervallo nodePort consentito nel cluster Kubernetes è 30000-32767.

Nota
Non aggiornare il valore dell'https port o nodePort dopo l'installazione di Oracle Blockchain Platform Enterprise Edition in quanto influirà sulla sua funzione.

Risoluzione del nome host per i servizi di Oracle Blockchain Platform Enterprise Edition

I servizi Oracle Blockchain Platform Enterprise Edition utilizzano nomi host generati in modo univoco configurati nei gateway/virtualservices Istio. Per comunicare con i servizi Oracle Blockchain Platform Enterprise Edition all'interno del cluster Kubernetes, è necessario utilizzare questi nomi host univoci dai browser o dalle applicazioni. In base al tipo di servizio scelto per istio-ingressgateway, questi nomi host devono essere risolti in un indirizzo IPv4 nel modo seguente:

Se LoadBalancer, vengono risolti nell'indirizzo IP esterno generato per il servizio istio-ingressgateway
Se NodePort, vengono risolti negli indirizzi IP dei nodi di lavoro