Requisitos

Uma conta Oracle Cloud Obrigatório
Python v2.7 ou superior Obrigatório
Tenancy OCID Obrigatório
Compartment OCID Obrigatório
User OCID Obrigatório

Baixando e instalando o Oracle Cloud Infrastructure CLI

Aceite as configurações default ou personalize conforme a necessidade.

MacOS/Linux

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

Windows: Execute o comando abaixo com permissão de administrador. Aceite a instalação do PythonCore caso seja solicitado, reabra o CMD após a instalação.

powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.ps1'))"

Certifique-se que a instalação foi bem sucedida.

oci --help

Caso a instalação tenha sido bem sucedida receberá um output como esse.

cli-01

Configurando Oracle Cloud Infrastructure CLI

Com o CLI instalado, agora é preciso configura-lo. Nesta etapa será necessário user OCID e tenancy OCID.

Obtendo User OCID e Tenancy OCID

User OCID: Navegue até Identity>Users>Seu User

cli-02

Tenancy OCID: Navegue até Administration>Compartment>Tenancy Details

cli-03

Para iniciar o processo de configuração execute o comando abaixo, aceite as configurações default ou personalize conforme a necessidade. Salve o diretório de armazenamento do arquivo config e SSH Key.

oci setup config

cli-04

Nesta etapa será criada uma API Keys e será utilizado a public key recém criada nesse processo.

MacOS/Linux

Preencha com as suas informações (caminho/nome da public key) apontadas no momento da configuração.

$ cd /home/ubuntu/.oci/
$ vim oci_api_key_public.pem 

Copie o conteúdo completo da Public Key.

cli-05

Windows

Abra a Public Key com notepad e copie todo o conteúdo.

cli-05

Acesse a console Oracle Cloud e vá até o caminho Identity>Users>Seu User>API Keys>Add API Key.

Selecione “Paste Public Key”, cole o conteúdo da Public Key e clique em Add.

cli-06

Após adicionada a API Key é gerada um Fingerprint.

cli-07

Visualize o arquivo de configuração.

MacOS/Linux

$ cd /home/ubuntu/.oci/
$ cat config

cli-08

Windows

Navegue até o diretório do arquivo config e abra com notepad.

cli-09

Certifique-se que a configuração foi bem sucedida listando os compartments do Tenancy.

$ oci iam compartment list

cli-10

Deploy de uma Instance VM com OCI-CLI

Após instalar, configurar e certificar-se que tudo funciona bem com OCI-CLI, siga os passos abaixo para criar uma Instance VM via CLI.

Para essa task será necessario os seguintes recursos:

Recurso Onde Conseguir
Availability Domain CLI-OCI
Compartment OCID CLI-OCI
Subnet OCID CLI-OCId
Image OCID CLI-OCI
Name Shape Site Oracle Cloud
Display Name Defina um Nome
SSH Key Gerar durante Deploy

Availability Domain: Salve o OCID do availability domain.

$ oci iam availability-domain list --query "data [*].{\"Name\":\"name\"}" --output table

Compartimet OCID: Salve o OCID do compartment que deseja criar a Instance VM.

$ oci iam compartment list --lifecycle-state active --query "data [*].{\"Name\":\"name\",\"id\":\"id\"}" --output table

Subnet OCID: Substitua o valor do –compartment-id pela OCID do compartiment listado acima onde sua subnet está alocada. Salve o OCID da subnet.

$ oci network subnet list --compartment-id ocid1.compartment.oc1..aaaaaaaa2tjqxvk2oxw45php23trjixcrzwb3bhzhcw4qqjpjcpvozny6mza --query "data [*].{\"Name\":\"display-name\",\"id\":\"id\"}" --output table

Imagem OCID: Substitua o valor do –compartment-id pela OCID do compartiment listado acima onde será realizado o deploy da Instance VM. Salve o OCID da imagem desejada, nesta task será utilizada a Oracle-Linux-7.9-2020.11.10-1, mas é possível escolher qualquer imagem disponível na Oracle Cloud Infrastructure.

$ oci compute image list --compartment-id ocid1.compartment.oc1..aaaaaaaayu2eqzztrf7nrvi2dc5h2vl2rw2xoqphiucblfg7ossq7rzc5wsq --query "data [?contains(\"display-name\",'Oracle-Linux-7.9')].{\"IMAGE\":\"display-name\",\"ID\":\"id\"}" --output table

Shape: Utilize o shape VM.Standard.E2.1.Micro que faz parte dos recursos Always Free , consulte todos os shapes disponíveis no site oficial Oracle Cloud Infrastructure.

cli-11

Iniciando Deploy da Instance VM

Inicie criando um diretório para armazenar a SSH Key.

$ mkdir keys

Gerando uma nova SSH Key. Substitua pelo caminho que deseja salvar a SSH Key, exemplo C:\Keys no Windows.

$ ssh-keygen -t rsa -N "" -b 2048 -C "CiCd-Compute-Instance" -f /home/ubuntu/keys/key-test

Faça o deploy da Instance VM utilizando as informações salvas anteriormente availability-domain, compartment-id, shape, subnet-id, image-id, display-name, ssh-authorized-keys-file e adicione o parâmetro assign-public-ip como true para que seja atribuído um IP público na Instance VM.

$ oci compute instance launch --availability-domain syxp:SA-SAOPAULO-1-AD-1 --compartment-id ocid1.compartment.oc1..aaaaaaaa2tjqxvk2oxw45php23trjixcrzwb3bhzhcw4qqjpjcpvozny6mza --shape VM.Standard.E2.1.Micro --subnet-id ocid1.subnet.oc1.sa-saopaulo-1.aaaaaaaa2j4d7too2lkyjtlzujdegwl3m37tpoqxilnsyunykc2nh3fy65kq --image-id ocid1.image.oc1.sa-saopaulo-1.aaaaaaaa7inha53kcyutiqdbz3w4gvms2ab5z3bc624loheugh7fbvg4wada --assign-public-ip true --display-name instance-vm-teste --ssh-authorized-keys-file /home/ubuntu/keys/key-test.pub

Aguarde até que o estado da Intance VM seja Running.

cli-12

Acesse a Instance VM recém criada.

MacOS/Linux

$ chmod 400 /home/ubuntu/keys/key-test
$ ssh -i /home/ubuntu/keys/key-test opc@152.67.40.241

cli-13

Windows

Instale o MobaXterm, abra uma nova sessão e acesse a Instance VM.

$ chmod 400 'C:\keys\key-test'
$ ssh -i 'C:\keys\key-test' opc@152.67.40.241

cli-14

Agora você é capaz de acessar o OCI-CLI e criar Instances VMs na Oracle Cloud Infrastructure.