OCI CLI: Instalación y configuración en Linux

Hola a todos. Hoy vamos a hablaros de la instalación y configuración de OCI CLI en Linux. Esta herramienta de OCI será útil tenerla instalada si en un futuro vas a trabajar con Oracle Cloud Infrastructure.

Es una herramienta muy útil para subir y descargar ficheros entre servidores on-prem y Oracle Cloud Infrastructure (Object Storage).

Herramienta útil, por ejemplo, para migraciones de base de datos Oracle de tamaño pequeño-mediano en donde la migración pueda llevarse a cabo a través de un export/import. Comencemos.

Instalación de OCI CLI

Antes de empezar comprobamos la versión de Linux que tenemos en nuestro servidor:

[root@test /root]$ cat /etc/redhat-release
Red Hat Enterprise Linux Server release 7.9 (Maipo)

Abrimos un terminal con usuario root y ejecutamos lo siguiente:

Nota: Esta instalación de OCI CLI, instala, si no lo tienes previamente, la versión 3 de Python. Puedes de todas formas, ver qué versión se tiene instalada con el siguiente comando:

[root@test /root]$ python3 --version
Python 3.6.8

A continuación, lanzamos la instalación:

[root@test /root]$ bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh"

Una vez finalizada la instalación de OCI CLI en el servidor, comprobamos la versión instalada con el siguiente comando:

[root@test /root]$ oci --version
3.4.4

Configuración

Para lanzar la configuración, el comando es el siguiente:

[root@test /home/oracle]$ oci setup config
    This command provides a walkthrough of creating a valid CLI config file.
    The following links explain where to find the information required by this
    script:
    User API Signing Key, OCID and Tenancy OCID:
        https://docs.cloud.oracle.com/Content/API/Concepts/apisigningkey.htm#Other
    Region:
        https://docs.cloud.oracle.com/Content/General/Concepts/regions.htm
    General config documentation:
        https://docs.cloud.oracle.com/Content/API/Concepts/sdkconfig.htm

Enter a location for your config [/root/.oci/config]:
Enter a user OCID: ocid1.user.oc1..aaaaaaaaujtkvgbd7ern4p6w2pdwk3o6yz4nnd4mu2kdpetydo67v3xak24q
Enter a tenancy OCID: ocid1.tenancy.oc1..aaaaaaaaao6lid7pht4vw7opfij7ydnvrcyqs2nawvfigmllx3z2nve6h4pq
Enter a region by index or name(e.g.
1: af-johannesburg-1, 2: ap-chiyoda-1, 3: ap-chuncheon-1, 4: ap-hyderabad-1, 5: ap-ibaraki-1,
6: ap-melbourne-1, 7: ap-mumbai-1, 8: ap-osaka-1, 9: ap-seoul-1, 10: ap-singapore-1,
11: ap-sydney-1, 12: ap-tokyo-1, 13: ca-montreal-1, 14: ca-toronto-1, 15: eu-amsterdam-1,
16: eu-frankfurt-1, 17: eu-marseille-1, 18: eu-milan-1, 19: eu-stockholm-1, 20: eu-zurich-1,
21: il-jerusalem-1, 22: me-abudhabi-1, 23: me-dcc-muscat-1, 24: me-dubai-1, 25: me-jeddah-1,
26: sa-santiago-1, 27: sa-saopaulo-1, 28: sa-vinhedo-1, 29: uk-cardiff-1, 30: uk-gov-cardiff-1,
31: uk-gov-london-1, 32: uk-london-1, 33: us-ashburn-1, 34: us-gov-ashburn-1, 35: us-gov-chicago-1,
36: us-gov-phoenix-1, 37: us-langley-1, 38: us-luke-1, 39: us-phoenix-1, 40: us-sanjose-1): 32
Do you want to generate a new API Signing RSA key pair? (If you decline you will be asked to supply the path to an existing key.) [Y/n]: Y
Enter a directory for your keys to be created [/root/.oci]:
Enter a name for your key [oci_api_key]:
Public key written to: /root/.oci/oci_api_key_public.pem
Enter a passphrase for your private key (empty for no passphrase):
Private key written to: /root/.oci/oci_api_key.pem
Fingerprint: 93:69:08:d7:23:c7:64:28:76:4f:9a:82:f9:97:5a:7e
Config written to /root/.oci/config

    If you haven't already uploaded your API Signing public key through the
    console, follow the instructions on the page linked below in the section
    'How to upload the public key':
        https://docs.cloud.oracle.com/Content/API/Concepts/apisigningkey.htm#How2

Una vez configurado, vamos a la ruta donde se ha creado el fichero de configuración:

[root@test /root/.oci]$ pwd
/root/.oci
[root@test /root/.oci]$ ls -lart
total 20
dr-xr-x---. 9 root root 4096 Jan 27 13:15 ..
-rw-------. 1 root root  451 Jan 27 13:42 oci_api_key_public.pem
-rw-------. 1 root root 1704 Jan 27 13:42 oci_api_key.pem
-rw-------. 1 root root  295 Jan 27 13:42 config
drwx------. 2 root root 4096 Jan 27 13:42 .

En este punto, queremos comentar que se debe copiar el contenido del fichero oci_api_key_public.pem en el recurso API Keys del usuario que DEBEREMOS tener creado a nivel de OCI para que se establezca la conexión servidor-OCI.

En el pantallazo podréis observar que en el usuario de OCI oscar.gavilan se ha creado una nueva API Key con el contenido del fichero mencionado anteriormente.

Instalación y configuración de OCI CLI

Con esto, ya tendríamos instalado y configurado el OCI CLI y, estaríamos en disposición de utilizar la herramienta OCI CLI para subir/descargar ficheros entre OCI y nuestro servidor on-prem.

Espero que os sea de utilidad. Si no quieres perderte ninguna publicación. Regístrate en nuestra newsletter. Con un email al mes, estarás informado.

¿Aún no conoces Query Performance? Descubre cómo puede ayudarte en tu entorno Oracle. Más información en su página de LinkedIn.

Sígue a GPS en LinkedIn

Comments are closed.