Como Instalar a Oracle Cloud Infrastructure CLI no Linux e no Windows

Olá Pessoal, tudo bem?
Hoje vamos instalar a ferramenta CLI da Oracle Cloud Infrastructure no Linux e Windows.
Diferente das ferramentas CLI da AWS ou da Azure, a CLI da OCI não tem com um instalador “oficial” o qual poderia facilitar muito, pelo qye vamos fazer a instalação “manual” seguindo a documentação da CLI de Oracle.
Requisitos
Para poder instalar a CLI da OCI, devemos cumprir com os seguintes requisitos:
- Ter uma conta da Oracle Cloud Infrastructure.
- Criar um usuário nessa conta, em um grupo com uma política que conceder a autorização desejada. Este usuário pode ser vocé mesmo, outra pessoa ou um sistema que faça chamadas à API.
- Um par de chaves que vão ser usadas para assinar as solicitudes na API, com a chave pública carregada no Oracle. Apenas o usuário que chamará à API deve possuir a chave privada.
Fedora 32 - CentOS 7/8
Vamos precisar ter os seguintes pacotes instalados:
- Python 3.5+
- gcc
- libffi-devel
- python-devel
- openssl-devel
|
|
Microsoft Windows 10
Gerando a Chave de Assinatura API
Criamos a pasta .oci, a qual estará na pasta home do usuario:
Linux:
|
|
No Windows abrimos uma terminal de PowerShell e vamos à pasta do usuario:
|
|
Geramos uma chave de assinatura API, colocando a localização onde queremos salvar o arquivo e o formato .pem, especificando a pasta .oci, a qual usaremos para nos autenticar ao serviço da OCI:
|
|
|
|
Verificamos que a chave privada possa ser vista apenas pelo usuário dono da conta:
|
|
E agora geramos a chave pública:
|
|
Carregamos a nossa chave pública, para isto devemos iniciar sessão em nossa conta da OCI, click no canto superior direito (no icone do nosso perfil)
Vamos à opção Usuários, API Keys, e anadimos uma nova.
Colamos só a CHAVE PÚBLICA, e click em Add.
Ali vai se carregar o fingerprint, vamos copiar esse valor e colamos em um Notepad ou em outro editor de textos, já que vamos precisa-lô mais para frente.
Instalando Oracle Cloud Infrastructure CLI
Linux
Descarregamos e instalamos de uma vez a versão mais atualizada do script de instalação:
|
|
O script vai-nos fazer uma série de perguntas:
- Em qual pasta gostaria instalar? Podemos colocar uma rota alternativa, neste caso vou usar /home/usuario/oci-cli
|
|
- Em qual pasta gostaria de instalar o executable oci?
|
|
- Em qual pasta gostaria de instalar os scripts da OCI?
|
|
Vai-nos perguntar se quremos instalar pacotes opcionáis, apertamos ENTER pelo momento:
|
|
Para terminar a configuración, vai-nos peguntar se desejamos modificar o PATH do nosso shell, colocamos Y depois ENTER:
|
|
Indicamos a rota do nosso arquivo .bashrc (no caso de estar usando bash), ou .zshrc (se usaramos zsh):
|
|
Recarregamos a nossa shell:
bash
|
|
zsh
|
|
Verificamos se a instalação foi feita corretamente, vamos consultar a ajuda do programa:
|
|
|
|
Windows 10
- Abrimos uma consola de PowerShell como ADMINISTRADOR
- O instalador permite a execução e término automatico de um script. Para permitir a execução de este, devemos habilitar a política de execução RemoteSigned.
Para configurar a política de execução remota para PowerShell, execute e seguinte comando:
|
|
- Para executar o script do instalador, execute o seguinte comando:
|
|
O script vai-nos fazer uma série de perguntas:
- Em qual pasta gostaria instalar? Podemos colocar uma rota alternativa, em este caso vou usar /home/usuario/oci-cli
|
|
- Em qual pasta gostaria de instalar o executable oci?
|
|
- Em qual pasta gostaria de instalar os scripts da OCI?
|
|
Vai-nos perguntar se quremos instalar pacotes opcionáis, apertamos ENTER pelo momento:
|
|
Para terminar a configuración, vai-nos peguntar se desejamos modificar o PATH do nosso Powershell, colocamos Y depois ENTER:
|
|
Fechamos PowerShell e vamos a abri-lô de novo.
Verificamos se a instalação foi feita corretamente, vamos consultar a ajuda do programa:
|
|
|
|
Configurando oci-cli
Interactivo
Executamos o comando:
|
|
Vai-nos fazer umas perguntas, primeiro a localização do arquivo config, vamos permitir que crie o arquivo na rota padrão:
|
|
O seguinte que nos vai pedir, é o usuário OCID:
|
|
Pelo que devemos iniciar sessão na nossa conta OCI, vamos ao icone de Perfil e click no nosso usuário cadastrado.
Copiamos a nossa OCID de usuário e a colocamos no parámetro user.
Logo colocamos a OCID da conta (tenancy):
|
|
Opção Tenancy:
Copiamos a nossa OCID da cuenta e a colocamos no parámetro tenancy:
Depois nos vai pedir a região principal, no meu caso será us-ashburn-1:
|
|
Vai-nos perguntar se desejamos gerar uma nova chave o se queremos carregar uma existente, como já tihamos criado ao começo do artigo, presionamos “n”:
|
|
E vamos indicar rota onde se encontra localizada a chave privada:
|
|
Manual
A maneira manual, é criar o arquivo de configuração em /home/usuario/.oci/config, com o seu editor de textos favorito:
Fedora 32:
|
|
Em Windows 10 Pro, abrimos um Notepad e vamos escrever os seguintes parámetros:
|
|
Onde:
- user é o dentificador OCID do usuario na OCI
- fingerprint é a impressão digital da chave ssh
- key_file é a tota onde se encontra armazenada a chave privada ssh (a guardamos em /home/usuario/.oci/oci_api_key.pem) No Windows substituimos pela rota do usuario (normalmente C:\Users\usuario.oci\oci_api_key.pem)
- tenancy é o identificador OCID da tua conta
- region é a região padrão onde vais deployar a infraestrctura
Y pronto, deste maneira teremos instalado e configurado o cliente CLI da OCI em nosso sistema.
Espero que tinham gostado deste tutorial, até a próxima!