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

Se admiten las siguientes plataformas:

• macOS
• Oracle Linux 8.0 o 9.0
• 10 o 11 de Microsoft Windows

Una vez finalizado el proceso de instalación:

• Verificar la Instalación.
• Si utiliza proyectos de código de cadenas Go, complete los pasos de configuración adicionales.

Requisitos

Antes de instalar la CLI de Blockchain App Builder en el sistema local, debe instalar los requisitos.

Note:

Blockchain App Builder 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, puede que falle el despliegue del código de cadenas en una red remota de Oracle Blockchain Platform.

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

• macOS
• Linux
• Windows

Requisitos

• Rancher Desktop (probado con 1.4.1). Blockchain App Builder también puede funcionar con Docker, pero se ha probado y verificado con Rancher Desktop. Si tiene previsto utilizar 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é establecido en dockerd (moby). Para verificar el tiempo de ejecución del contenedor en Rancher Desktop 1.4.1, haga clic en Configuración de Kubernetes y, a continuación, en Tiempo de ejecución del contenedor.
• La última versión de Node.js versión 18 (probada con las versiones 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 v1.20.10. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos de 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>"

Instale Node.js y npm mediante nvm

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

1. Introduzca el siguiente comando para instalar nvm:

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

2. 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

3. Cierre sesión y, a continuación, vuelva a iniciar sesión en el sistema operativo.
4. Introduzca el siguiente comando para verificar la instalación de nvm:

   nvm version

5. Introduzca el siguiente comando para instalar Node.js y npm:

   nvm install 18.16.0

6. Introduzca el siguiente comando para definir Node.js 18.16.0 como el valor por defecto 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 las versiones 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 v1.20.10. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos de 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>"

Instale Node.js y npm mediante nvm

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

1. Introduzca el siguiente comando para instalar nvm:

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

2. 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

3. Cierre sesión y, a continuación, vuelva a iniciar sesión en el sistema operativo.
4. Introduzca el siguiente comando para verificar la instalación de nvm:

   nvm version

5. Introduzca el siguiente comando para instalar Node.js y npm:

   nvm install 18.16.0

6. Introduzca el siguiente comando para definir Node.js 18.16.0 como el valor por defecto en nvm:

   nvm alias default 18.16.0

Instalación de Docker

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

1. 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

2. Introduzca el siguiente comando para instalar Docker:

   dnf install docker-ce -y --allowerasing

3. Introduzca el siguiente comando para iniciar Docker como servicio:

   sudo systemctl enable --now docker

4. Introduzca los siguientes comandos para asegurarse de que el usuario actual tiene acceso a Docker:

   sudo groupadd docker
   sudo usermod -aG docker $USER

5. Introduzca el siguiente comando para reiniciar el sistema:

   sudo reboot

Instalación de Docker Compose

1. 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

2. 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.4.1). 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 las versiones 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 v1.20.10. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos de 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>"

Instalación de Rancher Desktop

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

1. Si Docker está instalado en el equipo local, desinstálelo por completo.
2. Descargue e instale Rancher Desktop.
3. 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

4. Abra Rancher Desktop para completar el proceso de configuración.
5. Después de instalar Rancher Desktop, asegúrese de que el tiempo de ejecución del contenedor esté establecido en dockerd (moby). Para verificar el tiempo de ejecución del contenedor en Rancher Desktop 1.4.1, haga clic en Configuración de Kubernetes y, a continuación, en Tiempo de ejecución del contenedor.

Instalar Blockchain App Builder

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

• macOS
• Linux
• Windows

1. Introduzca el siguiente comando para instalar Xcode o las herramientas de la línea de comandos XCode (xcode-select).

   sudo xcode-select –install

2. 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

Tenga en cuenta que 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

1. 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

2. 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 va a instalar):

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

Comprobación de la Instalación

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

Configuración adicional para proyectos de código de cadenas de Go

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

• macOS
• Linux
• Windows

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 surtan efecto 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 surtan efecto 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.