Instalación de la CLI de OCI

Antes de empezar

Para instalar y usar la CLI de OCI, debe tener lo siguiente:

• Cuenta de usuario para la interfaz de usuario web de Compute.

• Par de claves de firma de API, necesario para firmar solicitudes de API. Si aún no tiene un par de claves públicas/privadas RSA en formato PEM, puede crear uno en los pasos de configuración de la CLI de OCI. Para agregar la clave pública a su cuenta de usuario, consulte Adición de una clave pública de API a un perfil de usuario.

• Certificado autofirmado de Private Cloud Appliance.

  Este requisito se cumple durante los pasos de configuración.

Puede instalar la CLI de OCI en macOS, Microsoft Windows o cualquier sistema operativo Linux/UNIX soportado:

• Oracle Linux 7 y Oracle Linux 8

• CentOS 7.0 y CentOS 8.x

• Ubuntu 16.04, Ubuntu 18.04 y de Ubuntu 20.04

Instalación de la CLI de OCI

Puede instalar la CLI de OCI en los sistemas operativos Oracle Linux o macOS mediante un gestor de paquetes. Para realizar la instalación en Microsoft Windows o en otro sistema operativo, utilice el script de instalación.

Para instalar la CLI de OCI, sus dependencias y Python, siga los pasos de su sistema operativo. Durante la instalación, responda a las peticiones de datos de información como se describe en Responding to the Install Script Prompts.

Oracle Linux 8

Ejecute los siguientes comandos para instalar la CLI de OCI:

$ sudo dnf -y install oraclelinux-developer-release-el8
$ sudo dnf install python36-oci-cli

Para desinstalar la CLI de OCI, ejecute:

$ sudo dnf remove python36-oci-cli

Oracle Linux 7

Ejecute el siguiente comando para instalar la CLI de OCI:

$ sudo yum install python36-oci-cli

Para desinstalar la CLI de OCI, ejecute:

$ sudo yum remove python36-oci-cli

macOS

Puede utilizar Homebrew para instalar, actualizar y desinstalar la CLI de OCI en macOS.

• Para instalar la CLI de OCI, ejecute:

  $ brew update && brew install oci-cli

• Para actualizar la CLI de OCI, ejecute:

  $ brew update && brew upgrade oci-cli

• Para desinstalar la CLI de OCI, ejecute:

  $ brew uninstall oci-cli

Microsoft Windows

Puede utilizar Microsoft Windows PowerShell para instalar la CLI de OCI.

1. Abra la consola de PowerShell con la opción Ejecutar como administrador.

2. Defina las variables de entorno http_proxy y https_proxy.

   Importante
   
   

   El valor de https_proxy es el nombre de host o la dirección IP del servidor proxy HTTP.

   $Env:http_proxy="http://www-proxy.example.com:80"
   $Env:https_proxy="http://www-proxy.example.com:80"

   Si el servidor proxy necesita un nombre de usuario y una contraseña, o utiliza un número de puerto distinto de 80, incluya esa información, como se muestra en el siguiente ejemplo:

   $Env:https_proxy=http://username:password@proxy.example.com:port

   Compruebe que las variables de proxy estén definidas correctamente. Asegúrese de que puede conectarse a las ubicaciones de Internet.

   $Env:http_proxy
   $Env:https_proxy
   ping https://raw.githubusercontent.com

3. El instalador permite la terminación automática al instalar y ejecutar un script. Para permitir la ejecución de este script, debe activar la política de ejecución RemoteSigned.

   Para configurar la directiva de ejecución remota para PowerShell, ejecute el siguiente comando:

   $ Set-ExecutionPolicy RemoteSigned

4. Fuerce que PowerShell utilice TLS 1.2 para Microsoft Windows 2012 y Microsoft Windows 2016:

   $ [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 

5. Descargue el script de instalación:

   $ Invoke-WebRequest ^
   https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.ps1 ^
   -OutFile install.ps1

6. Ejecute el script de instalación con o sin peticiones de datos.

   Ejecute el script install.ps1 que descargó en el paso anterior.

   Para evitar peticiones de datos y aceptar los valores por defecto, ejecute el script con la siguiente opción:

   $ install.ps1 -AcceptAllDefaults

7. Anule la definición de las variables del entorno del proxy.

   $Env:http_proxy=""
   $Env:https_proxy=""

Uso de la secuencia de comandos de instalación para otros sistemas operativos

Para cualquier otro sistema operativo, ejecute el siguiente script de instalación para instalar la CLI de OCI, sus dependencias y Python.

$ bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"

Para evitar peticiones de datos y aceptar los valores por defecto, agregue la opción --accept-all-defaults.

Respuesta a las peticiones de datos del script de instalación

• Si no tiene una versión compatible de Python instalada en Linux o Microsoft Windows, se le solicitará que proporcione una ubicación para instalar los binarios y ejecutables. El script instala Python.

• Si no tiene una versión compatible de Python instalada en macOS, se le notificará que su versión de Python es incompatible. Debe actualizar para continuar con la instalación. El script no instala Python.

• Cuando se le solicite que actualice la CLI de OCI a la versión más nueva, responda Y para sobrescribir una instalación existente.

• Cuando se le solicite que actualice la RUTA DE ACCESO, responda Y para poder llamar al comando oci sin proporcionar la ruta completa al ejecutable.