Blockchain App Builder-CLI installieren und konfigurieren
- macOS
- Oracle Linux 8.0 oder 9.0
- Microsoft Windows 10 oder 11
- Installation prüfen.
- Wenn Sie Go Chaincode-Projekte verwenden, führen Sie die zusätzlichen Konfigurationsschritte aus.
Voraussetzungen
Bevor Sie die Blockchain App Builder-CLI auf Ihrem lokalen System installieren, müssen Sie die Voraussetzungen installieren.
Hinweis:
Blockchain App Builder koordiniert mit Oracle Blockchain Platform und seinen Compilern. Wenn Sie andere Versionen der Voraussetzungen als die im folgenden Abschnitt genannten verwenden, verläuft das Deployment Ihres Chaincodes in einem Remote-Oracle Blockchain Platform-Netzwerk möglicherweise nicht erfolgreich.Wenn Sie Blockchain App Builder installieren, wird zuerst eine Voraussetzungsprüfung ausgeführt. Wenn die Prüfung der Voraussetzungen nicht erfolgreich verläuft, wird der Installationsprozess gestoppt.
Voraussetzungen
- Rancher Desktop (getestet mit 1.4.1). Blockchain App Builder kann auch mit Docker funktionieren, wurde jedoch mit Rancher Desktop getestet und verifiziert. Wenn Sie Rancher Desktop verwenden möchten, deinstallieren Sie Docker vollständig, bevor Sie Rancher Desktop installieren. Stellen Sie nach der Installation von Rancher Desktop sicher, dass die Containerlaufzeit auf dockerd (moby) gesetzt ist. Um die Containerlaufzeit in Rancher Desktop 1.4.1 zu prüfen, klicken Sie auf Kubernetes-Einstellungen > Containerlaufzeit.
- Das neueste Release von Node.js Version 18 (getestet mit 18.15.0 und 18.16.0). Verwenden Sie keine Versionen von Node.js vor oder nach Version 18.
- npm v8.x oder v9.x (getestet mit 9.5.0 und 9.5.1)
- Gehen Sie zu v1.23.2 oder höher, aber nicht zu Go v1.24 oder höher. Nach der Installation von Blockchain App Builder finden Sie weitere Informationen unter Zusätzliches Setup für Go Chaincode-Projekte.
- Wenn Sie das Synchronisierungsfeature von Blockchain App Builder verwenden möchten, installieren Sie Git, und konfigurieren Sie dann Ihren Benutzernamen und Ihre E-Mail-Adresse wie in den folgenden Befehlen gezeigt. Geben Sie Ihren Benutzernamen und Ihre E-Mail-Adresse anstelle von
<your_name>
und<email>
an.git config --global user.name "<your_name>"
git config --global user.email "<email>"
Installieren Sie Node.js und npm mit nvm
sudo
ausführen.
- Geben Sie zur Installation von nvm folgenden Befehl ein:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
- Fügen Sie der entsprechenden Datei das folgende Code-Snippet hinzu:
~/.bash_profile
,~/.profile
,~/.bashrc
oder~/.zshrc
.export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion
- Melden Sie sich ab und wieder bei Ihrem Betriebssystem an.
- Geben Sie den folgenden Befehl ein, um die nvm-Installation zu prüfen:
nvm version
- Geben Sie den folgenden Befehl ein, um Node.js und npm zu installieren:
nvm install 18.16.0
- Geben Sie den folgenden Befehl ein, um Node.js 18.16.0 als Standard in nvm festzulegen:
nvm alias default 18.16.0
Voraussetzungen
- Docker v20.10.0 oder höher
- Docker Compose v1.23.0 oder höher
- Das neueste Release von Node.js Version 18 (getestet mit 18.15.0 und 18.16.0). Verwenden Sie keine Versionen von Node.js vor oder nach Version 18.
- npm v8.x oder v9.x (getestet mit 9.5.0 und 9.5.1)
- Gehen Sie zu v1.23.2 oder höher, aber nicht zu Go v1.24 oder höher. Nach der Installation von Blockchain App Builder finden Sie weitere Informationen unter Zusätzliches Setup für Go Chaincode-Projekte.
- Wenn Sie das Synchronisierungsfeature von Blockchain App Builder verwenden möchten, installieren Sie Git, und konfigurieren Sie dann Ihren Benutzernamen und Ihre E-Mail-Adresse wie in den folgenden Befehlen gezeigt. Geben Sie Ihren Benutzernamen und Ihre E-Mail-Adresse anstelle von
<your_name>
und<email>
an.git config --global user.name "<your_name>"
git config --global user.email "<email>"
Installieren Sie Node.js und npm mit nvm
sudo
ausführen.
- Geben Sie zur Installation von nvm folgenden Befehl ein:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
- Fügen Sie der entsprechenden Datei das folgende Code-Snippet hinzu:
~/.bash_profile
,~/.profile
,~/.bashrc
oder~/.zshrc
.export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion
- Melden Sie sich ab und wieder bei Ihrem Betriebssystem an.
- Geben Sie den folgenden Befehl ein, um die nvm-Installation zu prüfen:
nvm version
- Geben Sie den folgenden Befehl ein, um Node.js und npm zu installieren:
nvm install 18.16.0
- Geben Sie den folgenden Befehl ein, um Node.js 18.16.0 als Standard in nvm festzulegen:
nvm alias default 18.16.0
Docker installieren
dnf
aktualisiert wird und basierend auf Ihrem Kernel auf das aktuelle Repository verweist.
- Geben Sie den folgenden Befehl ein, um Docker zur Repository-Liste hinzuzufügen:
sudo dnf config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo
- Geben Sie den folgenden Befehl ein, um Docker zu installieren:
dnf install docker-ce -y --allowerasing
- Geben Sie den folgenden Befehl ein, um Docker as a Service zu starten:
sudo systemctl enable --now docker
- Geben Sie die folgenden Befehle ein, um sicherzustellen, dass der aktuelle Benutzer Zugriff auf Docker hat:
sudo groupadd docker sudo usermod -aG docker $USER
- Geben Sie den folgenden Befehl ein, um das System neu zu starten:
sudo reboot
Docker Compose installieren
- Geben Sie den folgenden
curl
-Befehl ein, um Docker Compose abzurufen:sudo curl -L https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compos
- Geben Sie den folgenden Befehl ein, um ausführbare Berechtigungen zu Docker Compose hinzuzufügen:
sudo chmod +x /usr/local/bin/docker-compose
Voraussetzungen
- Rancher Desktop (getestet mit 1.4.1). Blockchain App Builder kann auch mit Docker funktionieren, wurde jedoch mit Rancher Desktop getestet und verifiziert.
- Das neueste Release von Node.js Version 18 (getestet mit 18.15.0 und 18.16.0). Verwenden Sie keine Versionen von Node.js vor oder nach Version 18.
- npm v8.x oder v9.x (getestet mit 9.5.0 und 9.5.1)
- Gehen Sie zu v1.23.2 oder höher, aber nicht zu Go v1.24 oder höher. Nach der Installation von Blockchain App Builder finden Sie weitere Informationen unter Zusätzliches Setup für Go Chaincode-Projekte.
- Wenn Sie die Synchronisierungsfunktion von Blockchain App Builder verwenden möchten, installieren Sie Git, und konfigurieren Sie Ihren Benutzernamen und Ihre E-Mail-Adresse wie in den folgenden Befehlen gezeigt. Geben Sie Ihren Benutzernamen und Ihre E-Mail-Adresse anstelle von
<your_name>
und<email>
an.git config --global user.name "<your_name>"
git config --global user.email "<email>"
Rancher Desktop installieren
- Wenn Docker auf Ihrem lokalen Computer installiert ist, deinstallieren Sie es vollständig.
- Laden Sie Rancher Desktop herunter und installieren Sie es.
- Nachdem der Installationsassistent abgeschlossen ist, führen Sie vor dem Öffnen von Rancher Desktop die folgenden Befehle aus:
wsl --install wsl --set-default-version 2 wsl --setdefault rancher-desktop
- Öffnen Sie Rancher Desktop, um den Einrichtungsvorgang abzuschließen.
- Stellen Sie nach der Installation von Rancher Desktop sicher, dass die Containerlaufzeit auf dockerd (moby) gesetzt ist. Um die Containerlaufzeit in Rancher Desktop 1.4.1 zu prüfen, klicken Sie auf Kubernetes-Einstellungen > Containerlaufzeit.
Blockchain App Builder installieren
Laden Sie das CLI-Package "Blockchain App Builder" (oracle-ochain-cli-x.x.x.tgz
) auf der Registerkarte Entwicklungstools im Bereich Blockchain App Builder in der Oracle Blockchain Platform-Konsole herunter.
- Geben Sie den folgenden Befehl ein, um Xcode oder die Befehlszeilentools XCode zu installieren (xcode-select).
sudo xcode-select –install
- Geben Sie den folgenden Befehl ein, um Blockchain App Builder zu installieren (passen Sie den Namen der Datei
.tgz
für die zu installierende Version an):npm install -g oracle-ochain-cli-x.x.x.tgz
xcode-select –-reset
- Geben Sie den folgenden Befehl ein, um Blockchain App Builder zu installieren (passen Sie den Namen der Datei
.tgz
für die zu installierende Version an):npm install -g oracle-ochain-cli-x.x.x.tgz
- Melden Sie sich als aktueller Benutzer ab, und melden Sie sich dann erneut an, damit die Gruppenmitgliedschaft wirksam wird.
.tgz
für die zu installierende Version an):npm install -g oracle-ochain-cli-x.x.x.tgz
Prüfen Sie die Installation
Geben Sie im Terminal ochain -v
ein. Die Ausgabe zeigt die Verwendung, Optionen und Befehle der Blockchain App Builder-CLI.
Zusätzliches Setup für Go Chaincode-Projekte
Um ein Go-Projekt zu entwickeln, müssen Sie die Umgebungsvariable GOPATH
festlegen. Dies ermöglicht Go, Ihren Arbeitsbereich zu finden und Ihren Code auszuführen.
GOPATH
festlegen, stellen Sie sicher, dass im Verzeichnis $HOME
ein Ordner go/
vorhanden ist. Andernfalls geben Sie den folgenden Befehl ein, um ein go/
-Verzeichnis in Ihrem Home-Verzeichnis zu erstellen:mkdir $HOME/go
GOPATH
fest, indem Sie der entsprechenden Datei die folgenden Variablen hinzufügen: ~/.bash_profile
, ~/.profile
, ~/.bashrc
oder ~/.zshrc
.export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
source ~/.bash_profile
Alternativ können Sie die Änderung systemweit anwenden, indem Sie die vorherigen Variablen zur Datei /etc/bashrc
hinzufügen.
GOPATH
festlegen, stellen Sie sicher, dass im Verzeichnis $HOME
ein Ordner go/
vorhanden ist. Andernfalls geben Sie den folgenden Befehl ein, um ein go/
-Verzeichnis in Ihrem Home-Verzeichnis zu erstellen:mkdir $HOME/go
GOPATH
fest, indem Sie der entsprechenden Datei die folgenden Variablen hinzufügen: ~/.bash_profile
, ~/.profile
, ~/.bashrc
oder ~/.zshrc
.export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
source ~/.bash_profile
Alternativ können Sie die Änderung systemweit anwenden, indem Sie die vorherigen Variablen zur Datei /etc/bashrc
hinzufügen.
Erstellen Sie ein go/
-Verzeichnis im Home-Verzeichnis: C:\Users\<username>\go
.