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.
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
Tenancy OCID: Navegue até Administration>Compartment>Tenancy Details
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
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.
Windows
Abra a Public Key com notepad e copie todo o conteúdo.
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.
Após adicionada a API Key é gerada um Fingerprint.
Visualize o arquivo de configuração.
MacOS/Linux
$ cd /home/ubuntu/.oci/
$ cat config
Windows
Navegue até o diretório do arquivo config e abra com notepad.
Certifique-se que a configuração foi bem sucedida listando os compartments do Tenancy.
$ oci iam compartment list
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.
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.
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
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
Agora você é capaz de acessar o OCI-CLI e criar Instances VMs na Oracle Cloud Infrastructure.