Instalaciones manuales y fuera de línea

En esta sección se describe cómo realizar instalaciones manuales y fuera de línea de la interfaz de línea de comandos (CLI) de OCI:

Instalación manual

En lugar de utilizar los métodos de instalación que se describen en Inicio rápido o con la imagen de contenedor de la CLI de OCI, puede instalar manualmente la CLI y sus dependencias mediante pip. Antes de continuar, asegúrese de cumplir los requisitos.

Antes de instalar la CLI de forma manual:

  • Asegúrese de que la ruta de Python está definida correctamente
  • Ejecute "python --version" o "python3 --version" y asegúrese de que tiene la versión necesaria
  • Si realiza la instalación en Oracle Linux o en CentOS, debe instalar lo siguiente:
    • gcc
    • zlib-devel
    • python3-devel
    • la versión más reciente de OpenSSL 1.1.1
Nota

También puede descargar los archivos de instalación de la CLI y realizar una instalación fuera de línea.

Paso 1: Instalación de Python

Las instrucciones de instalación de Python varían para cada sistema operativo que soporta la CLI.

Nota

La CLI solo soporta las versiones de Python que se muestran en Requisitos de la CLI.
Windows

Instale una versión soportada de Python desde la página de descargas de Python para Windows. Durante la instalación, elija agregar Python a la RUTA DE ACCESO y/o las variables de entorno (según la petición de datos).

Oracle Linux

Algunas versiones de Oracle Linux se proporcionan versiones incompatibles de Python y pueden necesitar componentes adicionales para instalar la CLI. Antes de instalar la CLI, ejecute los siguientes comandos en una nueva imagen de Oracle Linux.

Consejo

La CLI está preinstalada en Oracle Linux 9, las versiones 7 y 8 de Oracle Autonomous Linux y Oracle Linux Cloud Developer 8.
Oracle Linux 8
sudo dnf -y update
sudo dnf -y groupinstall "Development Tools"
sudo dnf -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo dnf -y module enable python36  # for Oracle Linux 8
sudo dnf -y install python36  # for Oracle Linux 8

Python está disponible como módulos de flujo de aplicaciones específicos de la versión en Oracle Linux 8 y CentOS 8.

Utilice la lista de módulos dnf para ver los módulos de Python disponibles actualmente. Por ejemplo:
$ sudo dnf module list | grep python
python36 3.6 [d] build, common [d] Python programming language, version 3.6
python38 3.8 [d] build, common [d] Python programming language, version 3.8
python39 3.9 [d] build, common [d] Python programming language, version 3.9
A continuación, habilite e instale un módulo de Python. En el siguiente ejemplo, se habilitará e instalará Python 3.9:
sudo dnf -y module enable python39
sudo dnf -y install python39
python3.9

Sustituya python39 y python3.9 por python36 y python3.6 o python38 y python3.8 para instalar y utilizar esas versiones.

Oracle Linux 7
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo yum install -y python3   # for Oracle Linux 7
Nota

Para Oracle Linux 7, tenga en cuenta que python3-devel está en el repositorio ol7_optional_latest, que puede no estar habilitado por defecto. Para instalar python3-devel, ejecute lo siguiente desde un indicador de shell:
sudo yum install -y --enablerepo ol7_optional_latest python3-devel

Puede encontrar información detallada sobre cómo instalar y utilizar las versiones más recientes de Python disponibles para Oracle Linux 7 en la documentación de la biblioteca de recopilaciones de software de Oracle Linux.

Oracle Linux 6
Nota

Ya no se recomienda Oracle Linux 6. Considere utilizar Oracle Linux 8 en su lugar.
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
wget https://www.python.org/ftp/python/3.6.3/Python-3.6.3.tgz
tar xvf Python-3.6.3.tgz
cd Python-3.6*/
./configure --enable-optimizations
sudo make altinstall
CentOS

Antes de instalar CLI, ejecute los siguientes comandos en una nueva imagen de CentOS.

CentOS Linux 8
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo dnf -y module enable python36  
sudo dnf -y install python36  

Python está disponible como módulos de flujo de aplicaciones específicos de la versión en CentOS 8.

Utilice la lista de módulos dnf para ver los módulos de Python disponibles actualmente.

Por ejemplo:
sudo dnf module list | grep python
Esto produce una salida similar a la siguiente:
python36 3.6 [d] build, common [d] Python programming language, version 3.6
python38 3.8 [d] build, common [d] Python programming language, version 3.8
python39 3.9 [d] build, common [d] Python programming language, version 3.9
A continuación, habilite e instale un módulo de Python. En el siguiente ejemplo, se habilitará e instalará Python 3.9:
sudo dnf -y module enable python39
sudo dnf -y install python39
python3.9

Sustituya python39 y python3.9 por python36 y python3.6 o python38 y python3.8 para instalar y utilizar esas versiones.

CentOS Linux 7
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo yum install -y python3 # for CentOS Linux 7

Puede encontrar información detallada sobre cómo instalar y utilizar las versiones más recientes de Python disponibles para CentOS 7 en la documentación de recopilaciones de software.

Ubuntu

Antes de instalar la CLI, ejecute los siguientes comandos en una nueva imagen de Ubuntu.

Ubuntu 16, Ubuntu 18 y Ubuntu 20
sudo apt update
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libsqlite3-dev wget libbz2-dev
sudo apt update && sudo apt install python3 python3-pip python3-venv
Mac OS X

Mac OS X incluye Python preinstalado.

Para instalar la última versión de Python en Mac OS X, consulte la documentación oficial de Python.

Paso 2: Creación y configuración de un entorno virtual

El módulo de Python venv es un creador de entornos virtuales que permite crear entornos de Python aislados. Recomendamos instalar la CLI en un entorno virtual.

Instalación y activación del entorno virtual

Después de instalar Python, configure un entorno virtual para el sistema operativo mediante los siguientes pasos.

Windows
  1. Navegue al directorio en el que desea crear el entorno virtual.
  2. Cree el entorno virtual ejecutando el siguiente comando:
    python -m venv oracle-cli
  3. Active el entorno virtual ejecutando el siguiente comando:
    oracle-cli/Scripts/activate
Linux y Mac
  1. Navegue al directorio en el que desea crear el entorno virtual.
  2. Cree el entorno virtual ejecutando uno de los siguientes comandos, según la versión de Python instalada:
    python3.8 -m venv oracle-cli
    python3.6 -m venv oracle-cli
  3. Active el entorno virtual ejecutando el siguiente comando:
    source oracle-cli/bin/activate

Paso 3: Instalación de la Interfaz de línea de comandos

Puede descargar CLI de GitHub o instalar el paquete desde Python Package Index (PyPI).

Para realizar la instalación mediante la descarga de GitHub:

  • Descargue y descomprima oci-cli.zip.
  • De manera opcional, valide el archivo descargado.
  • Ejecute el siguiente comando.

    pip install oci_cli-*-py2.py3-none-any.whl

Para realizar la instalación mediante PyPI, ejecute el siguiente comando:

pip install oci-cli

Para obtener información sobre cómo iniciar una sesión de la CLI, consulte Uso de la CLI.

Instalación fuera de línea

Si tiene instalada una versión de Python soportada, puede realizar una instalación fuera de línea de la CLI de OCI.

Para realizar una instalación fuera de línea:
  1. Vaya a la página de versión de la CLI de OCI en GitHub y seleccione la versión de la CLI que desea instalar.
  2. Desplácese hacia abajo hasta la sección Activos de la página de la versión y haga clic en el archivo zip para descargarlo.
  3. De manera opcional, valide el archivo descargado.
  4. Copie el archivo zip en el sistema de destino.
  5. Descomprima el archivo ZIP.
  6. Ejecute el instalador adecuado para la plataforma:
    1. En Unix y Linux, ejecute bash install.sh --offline-install.
    2. En Windows, ejecute install.ps1 -OfflineInstall
  7. Siga los indicadores de instalación.

Para solucionar problemas relativos a instalaciones fuera de línea, consulte Problemas comunes o cree una incidencia en GitHub.

Instalación sin un entorno virtual

No se recomienda instalar CLI en todo el sistema Python y sugerimos que, en su lugar, instale CLI mediante el instalador o el entorno virtual.

En los casos en los que intente instalar CLI en todo el sistema Python con la versión de pip más reciente, es posible que encuentre conflictos con algunos paquetes instalados con distutils. A continuación se muestra un mensaje de error de ejemplo cuando ocurre esto:

sudo pip install oci-cli
...
...
Cannot uninstall 'requests'. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall.

Otra opción es instalar CLI para el usuario mediante el siguiente comando, aunque este enfoque no está soportado:

pip install --user oci-cli

Validación del total de control de la versión

Después de descargar el paquete de la CLI, puede validar el total de control SHA-256. Según el sistema operativo, utilice las siguientes instrucciones para comparar el valor SHA-256 proporcionado en la versión de Github con el valor que obtiene al completar este procedimiento para el sistema operativo.

Windows
  1. Abra un shell de comandos.
  2. Cambie al directorio donde se encuentra el archivo de descarga.
  3. Ejecute el siguiente comando para generar el valor de total de control, donde filename es el nombre del archivo descargado en la computadora:
    certutil -hashfile filename SHA256
  4. Verifique que el valor de total de control devuelto coincide con el valor SHA-256 proporcionado en la versión de Github. Si los valores no coinciden, vuelva a descargar el archivo y repita este procedimiento.
Mac OS
  1. Abra una ventana de terminal.
  2. Ejecute el siguiente comando, donde fileLocation es la ruta completa del archivo en la computadora:
    shasum -a 256 fileLocation 
    Este comando debe devolver un valor de total de control.
  3. Verifique que el valor de total de control devuelto coincide con el valor SHA-256 proporcionado en la versión de Github. Si los valores no coinciden, vuelva a descargar el archivo y repita este procedimiento.
Linux
  1. Abra una sesión de terminal.
  2. Ejecute el siguiente comando, donde fileLocation es la ruta completa del archivo en la computadora:
    sha256sum fileLocation

    Este comando debe devolver un valor de total de control.

  3. Verifique que el valor de total de control devuelto coincide con el valor SHA-256 proporcionado en la versión de Github. Si los valores no coinciden, vuelva a descargar el archivo y repita este procedimiento.