Instalación y configuración de la CLI de Blockchain App Builder

Requisitos

Antes de instalar Blockchain App Builder CLI en su sistema local, debe instalar los requisitos previos.

Note:

El creador de aplicaciones de blockchain se coordina con Oracle Blockchain Platform y sus compiladores. Si utiliza cualquier versión de los requisitos que no sean los mencionados en la siguiente sección, es posible que falle el despliegue del código de cadena en una red remota de Oracle Blockchain Platform.

Al instalar Blockchain App Builder, primero se ejecuta una comprobación de requisitos. Si la comprobación de requisitos falla, el proceso de instalación se detiene.

Requisitos

Rancher Desktop (probado con 1.19.3). Blockchain App Builder también puede funcionar con Docker, pero se ha probado y verificado con Rancher Desktop. Si planea usar Rancher Desktop, desinstale Docker completamente antes de instalar Rancher Desktop. Después de instalar Rancher Desktop, asegúrese de que el tiempo de ejecución del contenedor esté definido en dockerd (moby). Para verificar el tiempo de ejecución del contenedor en Rancher Desktop 1.19.3, haga clic en Configuración de Kubernetes > Tiempo de ejecución del contenedor.
La última versión de Node.js versión 18 (probada con 18.15.0 y 18.16.0). No utilice versiones de Node.js anteriores o posteriores a la versión 18.
npm v8.x o v9.x (probado con 9.5.0 y 9.5.1)
Vaya a la versión 1.23.2 o posterior, pero no a la versión 1.24 o posterior. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos Go Chaincode.
Si desea utilizar la función de sincronización de Blockchain App Builder, instale Git y, a continuación, configure su nombre de usuario y correo electrónico como se muestra en los siguientes comandos. Especifique el nombre de usuario y la dirección de correo electrónico en lugar de <your_name> y <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Instalación de Node.js y npm mediante nvm

El uso de nvm para instalar Node.js y npm le permite ejecutar más comandos sin sudo.

Introduzca el siguiente comando para instalar nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

Agregue el siguiente fragmento de código al archivo aplicable: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.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

Cierre la sesión y, a continuación, vuelva a iniciarla en el sistema operativo.
Introduzca el siguiente comando para verificar la instalación de nvm:
```
nvm version
```
Introduzca el siguiente comando para instalar Node.js y npm:
```
nvm install 18.16.0
```
Introduzca el siguiente comando para establecer Node.js 18.16.0 como valor predeterminado en nvm:
```
nvm alias default 18.16.0
```

Requisitos

Docker v20.10.0 o posterior
Docker Compose v1.23.0 o posterior
La última versión de Node.js versión 18 (probada con 18.15.0 y 18.16.0). No utilice versiones de Node.js anteriores o posteriores a la versión 18.
npm v8.x o v9.x (probado con 9.5.0 y 9.5.1)
Vaya a la versión 1.23.2 o posterior, pero no a la versión 1.24 o posterior. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos Go Chaincode.
Si desea utilizar la función de sincronización de Blockchain App Builder, instale Git y, a continuación, configure su nombre de usuario y correo electrónico como se muestra en los siguientes comandos. Especifique el nombre de usuario y la dirección de correo electrónico en lugar de <your_name> y <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Instalación de Node.js y npm mediante nvm

El uso de nvm para instalar Node.js y npm le permite ejecutar más comandos sin sudo.

Introduzca el siguiente comando para instalar nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

Agregue el siguiente fragmento de código al archivo aplicable: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.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

Cierre la sesión y, a continuación, vuelva a iniciarla en el sistema operativo.
Introduzca el siguiente comando para verificar la instalación de nvm:
```
nvm version
```
Introduzca el siguiente comando para instalar Node.js y npm:
```
nvm install 18.16.0
```
Introduzca el siguiente comando para establecer Node.js 18.16.0 como valor predeterminado en nvm:
```
nvm alias default 18.16.0
```

Instalación de Docker

Asegúrese de que dnf esté actualizado y apunte al repositorio actual según el núcleo.

Introduzca el siguiente comando para agregar Docker a la lista de repositorios:

sudo dnf config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo

Introduzca el siguiente comando para instalar Docker:
```
dnf install docker-ce -y --allowerasing
```
Introduzca el siguiente comando para iniciar Docker como servicio:
```
sudo systemctl enable --now docker
```
Introduzca los siguientes comandos para asegurarse de que el usuario actual tiene acceso a Docker:
```
sudo groupadd docker
sudo usermod -aG docker $USER
```
Introduzca el siguiente comando para reiniciar el sistema:
```
sudo reboot
```

Instalación de Docker Compose

Introduzca el siguiente comando curl para obtener Docker Compose:

sudo curl -L https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compos

Introduzca el siguiente comando para agregar permisos ejecutables a Docker Compose:
```
sudo chmod +x /usr/local/bin/docker-compose
```

Requisitos

Rancher Desktop (probado con 1.19.3). Blockchain App Builder también puede funcionar con Docker, pero se ha probado y verificado con Rancher Desktop.
La última versión de Node.js versión 18 (probada con 18.15.0 y 18.16.0). No utilice versiones de Node.js anteriores o posteriores a la versión 18.
npm v8.x o v9.x (probado con 9.5.0 y 9.5.1)
Vaya a la versión 1.23.2 o posterior, pero no a la versión 1.24 o posterior. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos Go Chaincode.
Si desea utilizar la función de sincronización de Blockchain App Builder, instale Git y configure su nombre de usuario y correo electrónico como se muestra en los siguientes comandos. Especifique el nombre de usuario y la dirección de correo electrónico en lugar de <your_name> y <email>.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Instalar escritorio de rancher

Complete los siguientes pasos para instalar Rancher Desktop en Microsoft Windows.

Si Docker está instalado en el equipo local, desinstálelo por completo.
Descargue e instale Rancher Desktop.
Una vez finalizado el asistente de instalación, antes de abrir Rancher Desktop, ejecute los siguientes comandos:
```
wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
```
Abra Rancher Desktop para completar el proceso de configuración.
Después de instalar Rancher Desktop, asegúrese de que el tiempo de ejecución del contenedor esté definido en dockerd (moby). Para verificar el tiempo de ejecución del contenedor en Rancher Desktop 1.19.3, haga clic en Configuración de Kubernetes > Tiempo de ejecución del contenedor.

Instalar Creador de aplicaciones de blockchain

Descargue el paquete de la CLI del creador de aplicaciones de blockchain (oracle-ochain-cli-x.x.x.tgz) del separador Herramientas para desarrolladores del panel Creador de aplicaciones de blockchain de la consola de Oracle Blockchain Platform.

Introduzca el siguiente comando para instalar Xcode o las herramientas de línea de comandos XCode (xcode-select).
```
sudo xcode-select –install
```
Introduzca el siguiente comando para instalar Blockchain App Builder (ajuste el nombre del archivo .tgz para la versión que está instalando):
```
npm install -g oracle-ochain-cli-x.x.x.tgz
```

Mac OS Catalina puede tener problemas con xcode-select. Si encuentra estos problemas, utilice el siguiente comando para restablecer y reiniciar xcode-select:

xcode-select –-reset

Introduzca el siguiente comando para instalar Blockchain App Builder (ajuste el nombre del archivo .tgz para la versión que está instalando):
```
npm install -g oracle-ochain-cli-x.x.x.tgz
```
Desconéctese como usuario actual y, a continuación, vuelva a conectarse para que se aplique la pertenencia al grupo.

Después de instalar todo el software necesario, introduzca el siguiente comando para instalar Blockchain App Builder (ajuste el nombre del archivo .tgz para la versión que está instalando):

npm install -g oracle-ochain-cli-x.x.x.tgz

Comprobación de la Instalación

En su terminal, escriba ochain -v. La salida muestra el uso de la CLI de Blockchain App Builder, las opciones y los comandos.

Configuración adicional para proyectos de código de cadena de gobierno

Para desarrollar un proyecto Go, debe definir la variable de entorno GOPATH. Esto permite a Go localizar el espacio de trabajo y ejecutar el código.

Antes de definir la variable de entorno GOPATH, asegúrese de que existe una carpeta go/ en el directorio $HOME. Si no es así, introduzca el siguiente comando para crear un directorio go/ en el directorio raíz:

mkdir $HOME/go

Defina la variable de entorno GOPATH agregando las siguientes variables al archivo aplicable: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.zshrc.

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

Después de editar el archivo, ejecute el siguiente comando para que los cambios se apliquen inmediatamente:

source ~/.bash_profile

Como alternativa, puede aplicar el cambio en todo el sistema agregando las variables anteriores al archivo /etc/bashrc.

Antes de definir la variable de entorno GOPATH, asegúrese de que existe una carpeta go/ en el directorio $HOME. Si no es así, introduzca el siguiente comando para crear un directorio go/ en el directorio raíz:

mkdir $HOME/go

Defina la variable de entorno GOPATH agregando las siguientes variables al archivo aplicable: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.zshrc.

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

Después de editar el archivo, ejecute el siguiente comando para que los cambios se apliquen inmediatamente:

source ~/.bash_profile

Como alternativa, puede aplicar el cambio en todo el sistema agregando las variables anteriores al archivo /etc/bashrc.

Cree un directorio go/ en el directorio raíz: C:\Users\<username>\go.