Utilitários do OCI

As instâncias que usam imagens de plataforma Oracle Linux incluem um conjunto de utilitários (oci-utils) que permitem que a instância acesse informações sobre recursos de infraestrutura. Esses utilitários consistem em um componente de serviço e em ferramentas de linha de comando que ajudam a descobrir ou provisionar recursos automaticamente.

Instalando os Utilitários do OCI

As instâncias iniciadas com o Oracle Linux 7 ou mais recente incluem automaticamente o pacote de utilitários do Oracle Cloud Infrastructure (oci-utils) instalado. Os utilitários não estão disponíveis em outras distribuições.

Para usar os utilitários do OCI, você deve atender aos seguintes pré-requisitos:

Certifique-se de que o repositório oci_included esteja ativado. Esse repositório é ativado por padrão nas imagens da plataforma Oracle Linux. Este repositório contém todas as dependências do pacote, incluindo os pacotes SDK e Python do OCI necessários. Todos os pacotes necessários são instalados com o pacote oci-utils.
Certifique-se de que os utilitários do OCI tenham permissões suficientes para acessar o Oracle Cloud Infrastructure fazendo um dos seguintes procedimentos:
- Crie o arquivo de configuração do SDK para o host. Para obter mais informações, consulte Arquivo de Configuração da CLI e de SDKs.
  Observação
  
  Talvez seja necessário instalar a CLI do seu ambiente antes de executar o comando oci setup config para criar o arquivo de configuração do SDK. Para obter mais informações, consulte Instalando a CLI.
- Use controladores de instâncias adicionando a instância a um grupo dinâmico que recebeu acesso aos serviços do Oracle Cloud Infrastructure. Para obter mais informações, consulte Gerenciando Grupos Dinâmicos.
- Configure oci-utils para permitir que a raiz use os arquivos de configuração do Oracle Cloud Infrastructure de um usuário não privilegiado. Para obter mais informações, consulte o arquivo de configuração localizado no diretório /etc/oci-utils.conf.d da instância.
Escolha o método para acessar os utilitários e execute qualquer procedimento de configuração para esse método, conforme necessário:
- CLI do OCI de uma instância ou host remoto - Um terminal da CLI conectado a uma instância ou host remoto no qual você pode executar os utilitários do OCI. Para obter mais informações sobre a CLI e como começar a usá-la, consulte Interface de Linha de Comando (CLI) e Início Rápido da CLI.
- SDK (Software Development Kit, Kit de desenvolvimento de software) da OCI - Um conjunto de ferramentas de desenvolvedor que permite escrever código e gerenciar recursos da OCI. Para obter informações, consulte SDKs (Software Development Kits) e Interface de Linha de Comando.

Para obter um vídeo sobre como instalar e configurar os utilitários do OCI, consulte Enabling OCI Utilities in Oracle Linux on Oracle Cloud Infrastructure Instance na Oracle Linux Training Station.

Atualizando os Utilitários do OCI

Para atualizar para a versão mais recente do oci-utils:

sudo yum update oci-utils

Usando o Daemon ocid

O daemon ocid é o componente de serviço do oci-utils. Ele monitora alterações na configuração de VNICs e iSCSI da instância e tenta anexar ou desanexar dispositivos automaticamente conforme eles aparecem ou desaparecem - por exemplo, quando eles são criados ou excluídos usando a Console, a CLI ou a API do Oracle Cloud Infrastructure.

Para iniciar o daemon ocid usando systemd e definir o serviço ocid para iniciar automaticamente durante a inicialização do sistema:

sudo systemctl enable --now ocid.service

Para confirmar se o serviço está ativo (em execução):

sudo service ocid status

Por exemplo:

$ sudo service ocid status
Redirecting to /bin/systemctl status ocid.service
  ocid.service - Oracle Cloud Infrastructure utilities daemon
   Loaded: loaded (/etc/systemd/system/ocid.service; enabled; vendor preset: enabled)
   Active: active (running) since Thu 2021-02-04 18:01:25 GMT; 1min 42s ago
 Main PID: 16630 (python3)
   CGroup: /system.slice/ocid.service
           └─16630 /usr/bin/python3 /usr/lib/python3.6/site-packages/oci_util...

Feb 04 18:01:23 mor-demoinst-10 systemd[1]: Starting Oracle Cloud Infrastruc....
Feb 04 18:01:24 mor-demoinst-10 sudo[16705]:     root : TTY=unknown ; PWD=/ ...w
Feb 04 18:01:25 mor-demoinst-10 systemd[1]: Started Oracle Cloud Infrastruct....
Hint: Some lines were ellipsized, use -l to show in full.

Referência de Utilitários do OCI

Saiba mais detalhes sobre cada utilitário, incluindo uma descrição, exemplos de uso e opções.

Gerenciando Volumes

Gerenciando a Rede

Exibindo Informações de Configuração

Configurando Notificações

oci-notificar

Convertendo a Imagem Mínima do Oracle Linux

oci-expandir imagem

Você também pode exibir a opção do utilitário OCI e informações detalhadas acessando as páginas man do utilitário OCI. Para obter informações sobre como acessar as páginas man do utilitário do OCI, consulte Opções Comuns do Utilitário do OCI.

oci-compartmentid

Use o utilitário oci-compartmentid para exibir o OCID (Oracle Cloud Identifier) do compartimento no qual a instância está em execução.

Uso

oci-compartmentid [-h | --help]

Para exibir o OCID do compartimento da instância:

sudo oci-compartmentid

Por exemplo:

$ sudo oci-compartmentid
ocid1.compartment1.oc1..OCID

Para obter informações sobre a opção do utilitário oci-compartmentid, consulte Opções Comuns do Utilitário OCI.

oci-growfs

Se você expandir o volume de inicialização de uma instância baseada no Linux do OCI (Oracle Cloud Infrastructure), poderá usar o utilitário oci-growfs para expandir a partição raiz da instância. Isso permite que você use totalmente o volume de inicialização recém-expandido.

Observação

Somente sistemas de arquivos XFS e ext4 são suportados.

Por padrão, uma instância baseada no Linux não usará automaticamente todo o volume de inicialização se o volume de inicialização for maior ou igual a 50 GB. Se o volume de inicialização anexado à instância for inferior a 50 GB, nenhuma alteração será feita no sistema ao usar o utilitário oci-growfs.

Uso

/usr/libexec/oci-growfs [-y] [-n] [-h | --help]

Expandindo a Partição Raiz de uma Instância

Para expandir a partição raiz da instância:

Use o comando lsblk para confirmar se o sistema operacional identificou o novo tamanho do volume de inicialização.

Por exemplo:

lsblk
NAME               MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
sda                  8:0    0  100G  0 disk
├─sda1               8:1    0  100M  0 part /boot/efi
├─sda2               8:2    0    1G  0 part /boot
└─sda3               8:3    0 98.9G  0 part
  ├─ocivolume-root 252:0    0 88.9G  0 lvm  /
  └─ocivolume-oled 252:1    0   10G  0 lvm  /var/oled
sdb                  8:16   0   70G  0 disk

Se o volume de disco não for o tamanho esperado, execute os comandos para verificar novamente o volume de inicialização. Consulte Rescanning the Disk for Volumes Anexados a Instâncias Baseadas no Linux.

Execute o utilitário oci-growfs com a opção y para responder "sim" a todos os prompts.

sudo /usr/libexec/oci-growfs -y

Por exemplo:

$ sudo /usr/libexec/oci-growfs -y
Volume Group: ocivolume 
Mountpoint Data

---------------

mountpoint: /

source: /dev/mapper/ocivolume-root

filesystem type: xfs

source size: 58.9G

type: lvm

size: 58.9G

physical devices: ['/dev/sda3']

physical volumes: ['/dev/sda', '/dev/sda']

partition number: ['3']

volume group name: ocivolume

volume group path: /dev/ocivolume/root

Partition dry run expansion "/dev/sda3" succeeded.

CHANGE: partition=3 start=2304000 old: size=144496607 end=146800606 new: size=207411167 end=209715166 

Partition expand expansion "/dev/sda3" succeeded.
update-partition set to true
FLOCK: try exec open fd 9, on failure exec exits this program
FLOCK: /dev/sda: obtained exclusive lock
resizing 3 on /dev/sda using resize_sfdisk_gpt
209715200 sectors of 512. total size=107374182400 bytes
## sfdisk --unit=S --dump /dev/sda
label: gpt
label-id: DEC7F1D7-BEBD-4622-9B47-8ADF594E82FD
device: /dev/sda
unit: sectors
first-lba: 34
last-lba: 209715166

/dev/sda1 : start=        2048, size=      204800, type=C12A7328-F81F-11D2-BA4B-00A0C93EC93B, uuid=CEB6C9AA-4543-4CBF-A44E-D75D7BDDC644, name="EFI System Partition"
/dev/sda2 : start=      206848, size=     2097152, type=0FC63DAF-8483-4772-8E79-3D69D8477DE4, uuid=340A48CC-18ED-4C1A-AAD7-90CDB8E0B600
/dev/sda3 : start=     2304000, size=   144496607, type=E6D6D379-F507-44C2-A23C-238F2A3DF928, uuid=8BB84AB7-F5DF-47F1-B630-21442C9102C1
padding 33 sectors for gpt secondary header
max_end=209715166 tot=209715200 pt_end=146800606 pt_start=2304000 pt_size=144496607
resize of /dev/sda returned 0.
FLOCK: /dev/sda: releasing exclusive lock

CHANGED: partition=3 start=2304000 old: size=144496607 end=146800606 new: size=207411167 end=209715166

Extending /dev/sda3 succeeded.
Device /dev/sda3 extended successfully.
Logical volume /dev/ocivolume/root extended successfully.

Para obter informações sobre as opções do utilitário oci-growfs, consulte Opções Comuns do Utilitário OCI.

oci-expandir imagem

Use o utilitário oci-image-expand para converter a instância Mínima do Oracle Linux para adicionar serviços e pacotes de uma imagem de plataforma padrão do Oracle Linux. Com esse utilitário, a instância mínima pode restaurar quase a mesma funcionalidade que uma imagem de plataforma padrão do Oracle Linux.

Para obter informações sobre a imagem mínima mais recente do Oracle Linux, consulte Imagens do Oracle Linux 9.x.

O utilitário oci-image-expand requer privilégios root.

Pré-requisitos

Instale os Utilitários do OCI na instância mínima. Para obter mais informações, consulte Instalando os Utilitários do OCI.

Tipos de Conversão

O utilitário oci-image-expand fornece dois tipos de conversões de instância Mínima do Oracle Linux:

Padrão: Restaura serviços padrão da plataforma systemd do Oracle Linux, pacotes de diagnóstico, definições de configuração de nuvem e configura e permite permuta na instância. A restauração da funcionalidade da plataforma padrão não aumenta o tempo de inicialização da instância. Esse tipo de conversão é sempre aplicado pelo utilitário oci-image-expand.
Reinicialização Obrigatória: Restaura a funcionalidade padrão da plataforma Oracle Linux, conforme descrito no tipo de conversão Padrão, e restaura um ou mais dos seguintes recursos selecionáveis pelo usuário:
- Ativar SELinux - Restaura o modo de imposição SELinux.
- Ativar Kdump - Adiciona o recurso kdump e a regeneração de kdump initramfs.
- Ativar Ksplice - Instala o Ksplice e ativa o serviço Ksplice. Para obter informações sobre como usar o Ksplice, consulte Oracle Ksplice for Zero-Downtime Updates e Oracle Linux Ksplice User's Guide.
A escolha de qualquer um desses recursos selecionáveis aumenta o tempo de inicialização da instância e requer que uma reinicialização entre em vigor.

Observação

A execução do utilitário oci-instance-expand afeta as definições configuradas pelo usuário na instância. Por exemplo, o utilitário restaura cloud-init config para definições de imagem da plataforma Oracle Linux padrão, substituindo qualquer alteração cloud-config configurada pelo usuário. Além disso, se você optar por restaurar o Ksplice, o utilitário reinstalará o pacote oci-linux-config para que a nova chave de acesso seja armazenada no arquivo de configuração adequado. Não execute o utilitário em instâncias diferentes de instâncias mínimas.

Os arquivos de log do utilitário oci-image-expand estão localizados em: /var/log/oci-image-expand.log

Uso

oci-image-expand [-h | --help]

Restaurando a Funcionalidade de Imagem de Plataforma Padrão

Para restaurar a funcionalidade de imagem da plataforma Oracle Linux padrão para a instância Mínima do Oracle Linux:

Execute o utilitário oci-image-expand e pressione Enter no prompt, sem fazer nenhuma seleção.

Por exemplo:

$ /usr/libexec/oci-image-expand
Please select the set of reboot required functions, if any
Selecting a function transitions from not selected [ ] to selected [+] or vice versa
 
[ ] 0) All reboot options

[ ] 1) Enable SELinux

[ ] 2) Enable Kdump

[ ] 3) Enable Ksplice
  
Select the desired options using their number (again to uncheck, ENTER when done):
ENTER

Restaurando a funcionalidade de reinicialização necessária da imagem da plataforma

Para restaurar a funcionalidade de imagem da plataforma Oracle Linux que requer que uma reinicialização de instância entre em vigor:

Execute o utilitário oci-image-expand.
```
/usr/libexec/oci-image-expand
```
No prompt, execute um dos procedimentos a seguir e pressione Enter:
- Digite zero para restaurar todos os recursos da lista (SELinux, Kdump e Ksplice).
- Insira um único número, entre um e três, para restaurar um dos recursos da lista.
- Insira dois números, entre um e três, para restaurar dois dos recursos da lista.
Por exemplo, para restaurar a funcionalidade SELinux e Ksplice na instância Mínima do Oracle Linux:
```
$ /usr/libexec/oci-image-expand
Please select the set of reboot required functions, if any
Selecting a function transitions from not selected [ ] to selected [+] or vice versa
 
[ ] 0) All reboot options

[+] 1) Enable SELinux

[ ] 2) Enable Kdump

[+] 3) Enable Ksplice
  
Select the desired options using their number (again to uncheck, ENTER when done):
 1 3
The following options were selected:
    Enable SELinux
    Enable Ksplice
The chosen options will now be applied. Press any key to continue (within 10 seconds)
```
Observação

Se você mudar de ideia sobre um recurso selecionado, digite o número novamente antes de pressionar Enter para desmarcar o recurso. Se você já tiver pressionado Enter, pressione Ctrl+C para cancelar a operação.

No prompt, digite y para reinicializar a instância.

A reboot is required to enable and activate all restored services. 
Do you wish to reboot now? (y/n)y

Para obter informações sobre a opção do utilitário oci-image-expand, consulte Opções Comuns do Utilitário do OCI.

oci-instanceid

Use o utilitário oci-instanceid para exibir o OCID (Oracle Cloud Identifier) da instância.

Uso

oci-instanceid [-h | --help]

Para exibir o OCID da instância de computação:

sudo oci-instanceid

Por exemplo:

$ sudo oci-instanceid
ocid1.instance1.oc1.iad1.OCID

Para obter informações sobre a opção do utilitário oci-instanceid, consulte Opções Comuns do Utilitário OCI.

oci-iscsi-config

Use o utilitário oci-iscsi-config para listar e configurar dispositivos iSCSI anexados a uma instância baseada no Linux do OCI (Oracle Cloud Infrastructure). Quando executado sem nenhuma opção de linha de comando, o oci-iscsi-config lista dispositivos que precisam de atenção.

Cuidado

Evite digitar informações confidenciais ao designar descrições, tags ou nomes simples aos recursos na nuvem usando a Console, a API ou a CLI.

Uso

oci-iscsi-config [subcommand] [-h | --help]

Subcomandos

O utilitário oci-iscsi-config tem os subcomandos a seguir.

Subcomandos do Utilitário oci-iscsi-config
Subcomando	Para obter mais informações, consulte...
`show`	Exibindo Configurações de iSCSI
`sync`	Sincronizando um Volume
`create`	Criando e Anexando um Novo Volume
`attach`	Anexando um volume existente
`detach`	Desanexando um Volume
`destroy`	Excluindo um Volume

Para obter um vídeo de treinamento que mostra como usar o utilitário oci-iscsi-config, consulte Usando Utilitários do OCI para Gerenciar o Armazenamento iSCSI para Instâncias do Oracle Cloud Infrastructure na Oracle Linux Training Station.

Para obter informações sobre a opção do utilitário oci-iscsi-config, consulte Opções Comuns do Utilitário OCI.

Exibindo Configurações de iSCSI

O subcomando oci-iscsi-config show lista os dispositivos iSCSI e as informações de iSCSI da instância. Esse subcomando funciona com o daemon ocid para monitorar a criação e a exclusão do dispositivo por meio da Console, da CLI ou da API e descobre automaticamente essas alterações.

Se o daemon ocid não estiver sendo executado, o subcomando precisará de privilégios raiz.

Uso

oci-iscsi-config show [-C | --compartments name] [-A | --all] [--output-mode mode] [--details] [--no-truncate] [-h | --help]

Para exibir uma lista de todos os dispositivos anexados à instância:

Execute o subcomando oci-iscsi-config show.

sudo oci-iscsi-config show

Por exemplo:

$ sudo oci-iscsi-config show
Currently attached iSCSI devices:
          Volume name           |Attached device| Size |
--------------------------------------------------------
         mor-demo-bv20          |      sdb      | 50G  |
Block volumes information:
              Name              | Size |          Attached to           |              OCID              |
----------------------------------------------------------------------------------------------------------
         mor-demo-bv30          | 50GB |               -                |ocid1.volume.oc1.OCID|

Opcionalmente, use as opções --details e --no-truncate com o subcomando oci-iscsi-config show para exibir informações mais detalhadas que não são reduzidas na saída:

sudo oci-iscsi-config show --details --no-truncate

Por exemplo:

$ sudo oci-iscsi-config show --details --no-truncate
Currently attached iSCSI devices:
             Target                       |          Volume name           |          Volume OCID                       | Persistent portal  |   Current portal   |Session State|Attached device| Size |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
iqn.2015-12.com.oracleiaas:exampleuniqueID|         mor-demo-bv20          |ocid1.volume.oc1.iad.OCID  |  172.16.10.4:3260  |  172.16.10.4:3260  |  LOGGED_IN  |      sdb      | 50G  |

Block volumes information:
              Name              | Size |          Attached to           |              OCID                        |     IQN      | Compartment |Availability domain|
------------------------------------------------------------------------------------------------------------------------------------------------------------
         mor-demo-bv30          | 50GB |               -                |ocid1.volume.oc1.iad.OCID|      -       | virtdoc.dev  |DSdu:US-ASHBURN-AD-3|

Opcionalmente, altere a apresentação de saída para ser mais legível usando a opção --output-mode com o subcomando oci-iscsi-config show:

sudo oci-iscsi-config show --output-mode mode

Por exemplo, para exibir a apresentação de saída no modo de texto:

$ sudo oci-iscsi-config show --output-mode text
Currently attached iSCSI devices
Volume name: mor-demo-bv20
Attached device: sdb
Size: 50G

Block volumes information
Name: mor-demo-bv30
Size: 50GB
Attached to: -
OCID: ocid1.volume.oc1.iad..OCID

Detalhes da Opção

A tabela a seguir fornece informações detalhadas sobre opções específicas para este utilitário ou subcomando. Para obter informações sobre as opções comuns usadas nos utilitários do OCI, consulte Opções Comuns do Utilitário do OCI.

oci-iscsi-config mostrar Detalhes da Opção
Opção	Descrição
`-A \| --all`	Exibe todos os dispositivos iSCSI. Por padrão, somente os dispositivos que não estiverem anexados a uma instância serão listados.
`-C \| --compartments name`	Exibe dispositivos iSCSI no compartimento fornecido ou em todos os compartimentos (se `all` for especificado para `name`).

Criando e Anexando um Novo Volume

Use o subcomando oci-iscsi-config create para criar e anexar um volume em blocos a uma instância. Este subcomando requer que o OCI SDK para Python seja instalado e configurado. Para obter informações sobre o OCI SDK, consulte Software Development Kits e Interface de Linha de Comando.

Este subcomando requer privilégios raiz.

Uso

oci-iscsi-config create [-S | --size size] [-v | --volume-name name] [--attach-volume] [-c | --chap] [-h | --help]

Para criar e anexar um volume, use o utilitário oci-iscsi-config create com as opções -S, --volume-name e --attach-volume:

sudo oci-iscsi-config create -S size --volume-name=name --attach-volume

Por exemplo, para criar e anexar um volume com 70 GB de tamanho à instância, com o nome de volume mor-demo-by70:

$ sudo oci-iscsi-config create -S 70 --volume-name=mor-demo-by70 --attach-volume
Creating a new 70 GB volume
Volume name=mor-demo-by70 created
Attaching the volume to this instance
Attaching iSCSI device
iscsiadm attach Result: command executed successfully

Detalhes da Opção

Detalhes da Opção de criação oci-iscsi-config
Opção	Descrição
`-v \| --volume-name name`	Define o nome para exibição do volume. Evite digitar informações confidenciais no nome para exibição.
`-c \| --chap`	Anexa o dispositivo com o flag Exigir Credenciais CHAP.

Anexando um volume existente

Use o subcomando oci-iscsi-config attach para anexar um volume em blocos existente à instância e tornar o volume disponível para o sistema. O OCI SDK para Python é necessário para selecionar volumes usando seu OCID. Para obter informações sobre o OCI SDK, consulte Software Development Kits e Interface de Linha de Comando.

Este subcomando requer privilégios raiz.

Observação

Ao usar um IQN, o volume já deve estar anexado (designado) à instância na Console. Esta opção pode ser usada para anexar vários dispositivos ao mesmo tempo, fornecendo uma lista separada por vírgulas de IQNs.

Uso

Para anexar um volume em blocos específico à instância:

$ sudo oci-iscsi-config attach --iqns iqn.2015-12.com.oracleiaas:IQN

Detalhes da Opção

Detalhes da Opção de anexação oci-iscsi-config
Opção	Descrição
`-I \| --iqns IQN`	Uma lista separada por vírgulas dos nomes qualificados de iqns (iSCSI) do dispositivo ou dispositivos iSCSI a serem anexados à instância.
`-O \| --ocids` `OCID`	Uma lista separada por vírgulas dos OCIDs do dispositivo iSCSI, ou dispositivos, a serem anexados à instância.
`-u \| --username name`	Usa o nome de usuário especificado como nome de usuário CHAP quando for necessária a autenticação para anexar um dispositivo. Essa opção não é necessária quando o OCI SDK para Python está disponível.
`-p \| --password password`	Usa a senha fornecida como a senha CHAP quando a autenticação for necessária para anexar um dispositivo. Esse argumento não é necessário quando o OCI SDK para Python está disponível.
`-c \| --chap`	Anexa o dispositivo com o flag Exigir Credenciais CHAP.

Sincronizando um Volume

Use o subcomando oci-iscsi-config sync para anexar dispositivos de bloco disponíveis à instância e executar operações de sincronização. O subcomando requer privilégios root.

Uso

oci-iscsi-config sync [-a | --apply] [-y | --yes] [-h | --help]

Para anexar dispositivos de bloco disponíveis à instância e sincronizar as alterações com o OCI, use o subcomando oci-iscsi-config sync com a opção --apply:

sudo oci-iscsi-config sync --apply

Por exemplo:

$ sudo oci-iscsi-config sync --apply
Attaching the volume to this instance
Attaching iSCSI device
iscsiadm attach Result: command executed successfully

Detalhes da Opção

Detalhes da Opção de sincronização oci-iscsi-config
Opção	Descrição
`-a \| --apply`	Executa operações de sincronização.

Desanexando um Volume

Use o subcomando oci-iscsi-config detach para desanexar um dispositivo com o IQN fornecido (um ID exclusivo designado a um dispositivo). Se o volume (ou qualquer partição do volume) estiver montado, esta opção tentará desmontá-lo primeiro.

Este subcomando requer privilégios raiz.

Observação

Você pode desanexar vários dispositivos ao mesmo tempo fornecendo uma lista separada por vírgulas de IQNs.

Uso

oci-iscsi-config detach [-I | --iqns IQN] [-f | --force] [-h | --help]

Para desanexar um dispositivo específico da instância, use o subcomando oci-iscsi-config detach com a opção -I:

sudo oci-iscsi-config detach -I IQN

Por exemplo:

$ sudo oci-iscsi-config detach -I  iqn.2015-12.com.oracleiaas:IQN
Detaching volume mor-demo-bv70 (iqn.2015-12.com.oracleiaas:IQN)
Volume [iqn.2015-12.com.oracleiaas:oracleiaas:IQN] is detached
Updating detached volume cache file: ['iqn.2015-12.com.oracleiaas:oracleiaas:IQN']

Para exibir o IQN ou o OCID do volume que você deseja desanexar, use o subcomando oci-iscsi-config show. Para obter informações, consulte Exibindo Configurações de iSCSI.

Detalhes da Opção

Detalhes da Opção de desanexação oci-iscsi-config
Opção	Descrição
`-f \| --force`	Continua a desinstalação mesmo que não seja possível desmontar o dispositivo.
`-I \| --iqns IQN`	Uma lista separada por vírgulas dos nomes qualificados de iqns (iSCSI) do dispositivo ou dispositivos iSCSI para desanexar da instância.

Excluindo um Volume

Para excluir um volume de armazenamento em blocos com o OCID fornecido, use o subcomando oci-iscsi-config destroy.

Observação

Você pode excluir vários dispositivos ao mesmo tempo fornecendo uma lista de OCIDs separados por vírgulas.

Uso

oci-iscsi-config destroy [-O | --ocids OCID] [-y | --yes] [-h | --help]

Para excluir um volume em blocos específico da instância, use o subcomando oci-iscsi-config-destroy com a opção -O:

sudo oci-iscsi-config destroy -O OCID

Por exemplo:

$ sudo oci-iscsi-config destroy -O ocid1.volume.oc1.OCID
WARNING: the volume(s) will be destroyed.  This is irreversible.  Continue?
y
Volume [ocid1.volume.oc1.iad.OCID] is destroyed

Você pode exibir o OCID do volume usando o subcomando do utilitário oci-iscsi-config show. Para obter informações, consulte Exibindo Configurações de iSCSI.

Detalhes da Opção

Detalhes da Opção de destruição oci-iscsi-config
Opção	Descrição
`-O \| --ocids OCID`	Uma lista separada por vírgulas dos OCIDs de volume em blocos a serem excluídos.

oci-metadata

Use o utilitário oci-metadata para exibir ou definir metadados para uma instância de computação baseada no Oracle Linux. Quando executado sem opções de linha de comando, o oci-metadata lista todos os metadados disponíveis.

Para obter mais informações sobre metadados da instância, consulte Obtendo Metadados da Instância.

Uso

oci-metadata [-h | --human-readable] [-j | --json] [-g | --get key] [--export] [--trim] [--value-only] [-u key_value] [-i | --instance-id OCID] [--help]

Obtendo Todos os Metadados da Instância

Para exibir todos os metadados da instância, execute o utilitário oci-metadata sem opções:

sudo oci-metadata

Por exemplo:

$ sudo oci-metadata
Instance details:
  Display Name: my-example-instance
  Region: phx - us-phoenix-1 (Phoenix, AZ, USA)
  Canonical Region Name: us-phoenix-1
  Availability Domain: cumS:PHX-AD-1
  Fault domain: FAULT-DOMAIN-3
  OCID: ocid1.instance.oc1.phx.OCID
  Compartment OCID: ocid.compartment.oc1..OCID
  Instance shape: VM.Standard2.1
  Image ID: ocid1.image.oc1.phx.OCID
  Created at: 1569529065596
  state: Running
  agentConfig:
    managementDisabled: False
    monitoringDisabled: False
  Instance Metadata:
    ssh_authorized_keys: example-key
Networking details:
  VNIC OCID: ocid1.vnic.oc1.phx.OCID
  VLAN Tag: 2392
  Private IP address: 10.0.0.16
  MAC address: 02:00:17:03:D8:FE
  Subnet CIDR block: 10.0.0.0/24
  Virtual router IP address: 10.0.0.1

Obtendo Metadados Específicos da Instância

Para exibir metadados da instância de uma chave especificada, use a opção --get com o utilitário oci-metadata:

sudo oci-metadata --get key

Por exemplo, para exibir apenas o estado da instância de computação:

$ sudo oci-metadata --get state
Instance details:
Instance state: Running

Detalhes da Opção

Detalhes da Opção oci-metadata
Opção	Descrição
`-g key \| --get key`	Recupera dados somente para a chave especificada. As chaves de metadados de uma instância podem ser definidas pelo serviço Compute ou você pode criar chaves personalizadas. Para obter mais informações, consulte Chaves de Metadados.
`--export`	Usado com a opção `-g` ou `--get`, exiba um comando shell para exportar a chave como uma variável de ambiente.
`--trim`	Usado com a opção `-g` ou `--get`, reduz o caminho da chave para o último componente para tornar a saída mais concisa. Por exemplo: `instance/metadata/ssh_authorized_keys` a `ssh_authorized_keys`. Se a chave corresponder a várias chaves, somente a primeira chave correspondente será exibida.
`--value-only`	Usado com a opção `-g` ou `--get`, exiba somente os valores correspondentes à chave get.
`-u key_value`	Atualiza o valor da ou das chaves específicas. Para `key_value`, especifique uma string, um valor JSON ou um indicador para um arquivo com conteúdo JSON no seguinte formato: `key=file:/path/to/file`
`-i \| --instance-id OCID`	Obtenha ou atualize os metadados da instância com o OCID específico. Por padrão, o `oci-metadata` trabalha com os metadados da instância na qual você fez log-in.

oci-network-config

O utilitário oci-network-config permite configurar interfaces de rede para a instância. Este utilitário deve ser executado como raiz.

O utilitário oci-network-config mostra as VNICs atuais de interface de rede virtual (VNICs) provisionadas no OCI (Oracle Cloud Infrastructure) e configuradas para essa instância. Quando uma VNIC secundária é provisionada no OCI, ela deve ser explicitamente configurada na instância usando o utilitário oci-network-config.

As interfaces de rede que estão sendo configuradas podem ser colocadas em namespaces de rede separados. Essa separação é necessária quando as VNICs estão em sub-redes (VCNs distintas) com blocos de endereços que se sobrepõem e os aplicativos de rede não estão vinculados diretamente às interfaces. Os namespaces de rede requerem que os aplicativos sejam iniciados nos namespaces explicitamente (com o comando ip netns exec ns) para estabelecer a associação com a interface. Quando namespaces não são usados, o roteamento baseado em política é configurado para fornecer uma rota padrão para o roteador virtual da VNIC secundária (gateway padrão) quando o endereço da VNIC é o endereço de origem.

VNICs secundárias bare metal são configuradas usando VLANs (onde não há interface física correspondente). Essas VNICs aparecem como duas interfaces adicionais ao mostrar links de IP, com nomes em MACVLAN_FORMAT para a VLAN MAC e VLAN_FORMAT para a VLAN de IP.

Uso

oci-network-config [subcommand] [-q | --quiet] [-h | --help]

Subcomandos

O utilitário oci-network-config tem os subcomandos a seguir.

Subcomandos do Utilitário oci-network-config
Subcomando	Para obter mais informações, consulte...
`show`	Exibindo a Configuração de Rede Atual
`show-vnics`	Exibindo VNICs Configuradas
`show-vnics-all`	Exibindo Todos os VNICS Configurados
`show-vcns`	Exibindo Informações da VCN
`show-subnets`	Exibindo Informações de Sub-rede
`configure`	Configurando VNICs
`unconfigure`	Excluindo a Configuração de IP para VNICs Secundárias Provisionadas
`attach-vnic`	Criando e Anexando uma VNIC
`detach-vnic`	Desanexando uma VNIC
`add-secondary-addr`	Adicionar um endereço secundário
`remove-secondary-addr`	Removendo um Endereço IPv6 Secundário

Para ver um vídeo de treinamento que mostra como usar o utilitário oci-network-config, consulte Gerenciamento de Interface de Rede Usando Utilitários do OCI nas Instâncias do Oracle Linux na Oracle Linux Training Station.

Para obter informações sobre as opções do utilitário oci-network-config, consulte Opções Comuns do Utilitário OCI.

Exibindo a Configuração de Rede Atual

O subcomando oci-network-config show mostra informações sobre as VNICs configuradas na instância. Você pode exibir a configuração de rede atual, como as VNICs provisionadas e as configurações de IP atuais da instância. As VNICs que ainda não estão configuradas são marcadas com ADD, e as configurações de IP que não têm mais uma VNIC associada são marcadas com DELETE.

A saída deste comando será a ação padrão se o utilitário oci-network-config for inserido sem nenhuma opção.

Uso

oci-network-config show [--output-mode mode] [-I | --include item] [-X | --exclude item] [--details] [--no-truncate] [-h | --help]

Para exibir a configuração de rede atual:

sudo oci-network-config show

Por exemplo:

$ sudo oci-network-config show 
Network configuration
 State | Link | Status |  IP address |        VNIC        |        MAC        |
------------------------------------------------------------------------------
   -   | ens3 |   UP   | 10.2.20.254 |  hostname_ipv6_01  | 02:00:17:01:30:D5 |
  ADD  | ens4 |   UP   | 10.2.10.121 | vnic20220912090629 | 02:00:17:01:A9:0E |


Operating System level network configuration:
CONFIG      ADDR          SUBNET     BITS   VIRTROUTER      NS    IND      IFACE     VLTAG     VLAN    STATE        MAC                                                VNIC ID                                          
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  -     10.2.20.254     10.2.20.0     24    10.2.20.1       -      2        ens3      3181      -        UP  02:00:17:01:30:D5 ocid1.vnic.oc1.uk-london-1.VNIC_OCID  
 ADD    10.2.10.121     10.2.10.0     24    10.2.10.1       -      3        ens4      1435      -        UP  02:00:17:01:A9:0E ocid1.vnic.oc1.uk-london-1.VNIC_OCID

Para configurar VNICs que ainda não foram configuradas (rotuladas como ADD) e excluir endereços IP que não têm VNICs associadas, use o subcomando oci-network-config config. Para obter mais informações, consulte Configurando VNICs.

Detalhes da Opção

oci-network-config mostrar Detalhes da Opção
Opção	Descrição
`-I \| --include item`	Inclui um endereço IP ou uma interface VLAN que foi excluída anteriormente usando a opção `--exclude` na configuração/desconfiguração automática. Para `item`, você pode especificar um OCID de VNIC, um endereço IP ou um nome de interface VLAN.
`-X \| --exclude item`	Exclui de forma persistente um endereço IP ou interface VLAN da configuração/desconfiguração automática. Para `item`, você pode especificar um OCID de VNIC, um endereço IP ou um nome de interface VLAN. Use a opção `--include` para incluir novamente o endereço IP ou a interface VLAN.

Criando e Anexando uma VNIC

Use o subcomando oci-network-config attach-vnic para criar e anexar uma VNIC a uma instância. Você pode designar um endereço IP público ou privado à nova VNIC com esse subcomando.

Importante

A anexação de uma VNIC com um endereço IPv6 principal não é suportada pelo OCI.

Uso

Para criar uma VNIC e anexar a VNIC a uma instância, use o subcomando oci-network-config attach-vnic com a opção -n:

sudo oci-network-config attach-vnic -n name

Por exemplo, para criar uma VNIC chamada ex-demo-inst-10 e anexar a VNIC à instância:

$ sudo oci-network-config attach-vnic -n ex-demo-inst-10
creating VNIC: 10.102.119.140

Detalhes da Opção

oci-network-config attach-vnic Detalhes da Opção
Opção	Descrição
`-I \| --ip-address ip_address`	Designa à VNIC o endereço IP privado fornecido. Se essa opção não for usada, um endereço IP não utilizado da sub-rede será designado automaticamente à VNIC.
`-ipv4 \| --ipv4`	Designa um endereço IPv4 à VNIC. Se a opção `--ipv4` for usada, um endereço IPv4 não utilizado da sub-rede será designado à VNIC. Se a opção `--ip-address` for especificada com essa opção, as opções `--ipv4` e `--ipv6` serão ignoradas.
`-ipv6 \| --ipv6`	Designa um endereço IPv6 à VNIC. Se a opção `--ipv6` for usada, um endereço IPv6 não utilizado da sub-rede será designado à VNIC. Se você usar a opção `--ip-address`, as opções `--ipv4` e `--ipv6` serão ignoradas. Importante!: A anexação de uma VNIC com um endereço IPv6 principal não é suportada pelo OCI. A mensagem a seguir é exibida ao executar `oci-network-config attach-vnic` com a opção `--ipv6`. # sudo oci-network-config attach-vnic --ipv6 Attaching a vnic with a primary ipv6 address is not yet supported by OCI.
`-i \| --nic-index index`	Designa a VNIC à placa NIC física especificada. Para `index`, especifique o número do índice designado à placa NIC física. O valor padrão é 0. Esta opção só é usada para instâncias bare metal.
`--subnet subnet`	Conecta a VNIC com a sub-rede fornecida. Para `subnet`, especifique um OCID ou uma expressão regular que tenha correspondência com o nome para exibição de todas as sub-redes disponíveis. Quando `--ip-address` é usado, a sub-rede é inferida do endereço IP ou assume como padrão a sub-rede da VNIC principal.
`-n \| --name name`	Define o nome para exibição da VNIC. Evite digitar informações confidenciais.
`--assign-public-ip`	Designa um endereço IP público à VNIC. Por padrão, somente um endereço IP privado é designado.

Configurando VNICs

O subcomando oci-network-config configure adiciona configuração de IP para VNICs que não estão configuradas e exclui a configuração de IP de VNICs que não estão mais provisionadas. Esse comando sincroniza a configuração de IP da instância com o provisionamento atual do OCI.

Uso

Para configurar todas as VNICs na instância:

sudo oci-network-config configure

Por exemplo:

$ sudo oci-network-config configure
Configured

Para configurar as VNICs na instância, exceto uma VNIC específica, use o subcomando oci-network-config configure com a opção -X:

sudo oci-network-config configure -X VNIC_OCID

Por exemplo:

$ sudo oci-network-config configure -X VNIC_OCID
Configured

Você pode confirmar se as VNICs estão configuradas executando o subcomando oci-network-config show. Após a configuração, nenhum label ADD ou DELETE será exibido na saída, a menos que você opte por excluir uma VNIC de ser configurada. Para obter mais informações, consulte Exibindo a configuração de rede atual.

Detalhes da Opção

Detalhes da Opção de configuração de oci-network-config
Opção	Descrição
`-n \| --namespace format`	Ao configurar, coloque as interfaces no namespace identificado pelo formato fornecido. O formato pode incluir variáveis `$nic` e `$vltag`. O padrão do nome é `DEF_NS_FORMAT_BM` para BMs e `DEF_NS_FORMAT_VM` para VMs. Ao configurar várias VNICs, certifique-se de que os namespaces sejam exclusivos.
`-r \| --start-sshd`	Inicie `sshd` no namespace (se `-n` estiver presente).
`-I \| --include item`	Inclui um endereço IP ou uma interface VLAN que foi excluída anteriormente usando a opção `--exclude` na configuração/desconfiguração automática. Para `item`, você pode especificar um OCID de VNIC, um endereço IP ou um nome de interface VLAN.
`-X \| --exclude item`	Exclui de forma persistente um endereço IP ou interface VLAN da configuração/desconfiguração automática. Para `item`, você pode especificar um OCID de VNIC, um endereço IP ou um nome de interface VLAN. Use a opção `--include` para incluir novamente o endereço IP ou a interface VLAN.

Exibindo VNICs Configuradas

O subcomando oci-network-config show-vnics mostra informações sobre VNICs configuradas na instância.

Uso

oci-network-config show-vnics [--output-mode mode] [--details] [--ocid OCID] [--name name] [--ip-address primary_ip] [--no-truncate] [-h | --help]

Para mostrar informações sobre VNICs configuradas na instância:

sudo oci-network-config show-vnics

Por exemplo:

$ sudo oci-network-config show-vnics
VNICs Information:
              Name              |   Private IP  |                                           OCID                                           |       MAC       |
--------------------------------------------------------------------------------------------------------------------------------------------------------------
        ex-demo-inst-10         |10.102.119.140|     ocid1.vnic.oc1.iad.OCID                                                    |00:00:17:02:CC:CB|
        mor-demoinst-10         |10.102.118.251|     ocid1.vnic.oc1.iad.OCID                                                    |02:00:17:02:C6:B2|

Detalhes da Opção

oci-network-config show-vnics Detalhes da Opção
Opção	Descrição
`--ocid OCID`	Mostra informações sobre a VNIC que corresponde ao OCID (Oracle Cloud Identifier) fornecido.
`--name name`	Mostra informações sobre a VNIC associada ao nome fornecido.
`--ip-address primary_IP`	Mostra informações sobre a VNIC associada ao endereço IP principal fornecido.

Exibindo Todos os VNICS Configurados

Use o subcomando oci-network-config show-vnics-all para exibir informações detalhadas sobre todas as VNICs configuradas nesta instância.

Uso

oci-network-config show-vnics-all [--output-mode mode] [-h | --help]

Para exibir todas as VNICs configuradas na instância:

sudo oci-network-config show-vnics-all

Por exemplo:

# sudo oci-network-config show-vnics-all
Virtual Network Interface Information:
        Name        |  Private IP |        MAC        | Config |                                           OCID                                          | Primary  |      Subnet      | Subnet cidr  |       State        | NIC  |   Public IP    |
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  hostname_ipv6_01  | 10.2.20.254 | 02:00:17:01:30:D5 |   -    | ocid1.vnic.oc1.iad.OCID                                                |   True   | hostname_uk02_02 | 10.2.20.0/24 | AVAILABLE-ATTACHED |  -   | 140.238.76.113 |
      IP address details      
                      Private IP               |                                             OCID                                             |      
      ----------------------------------------------------------------------------------------------------------------------------------------      
                     10.2.20.254               | ocid1.privateip.oc1.iad.OCID |      
      
      
 vnic20220912090629 | 10.2.10.121 | 02:00:17:01:A9:0E |   -    | ocid1.vnic.oc1.iad.OCID                                               |    -     | hostname_uk02_01 | 10.2.10.0/24 | AVAILABLE-ATTACHED |  -   |       -        |
      IP address details      
                      Private IP               |                                             OCID                                             |      
      ----------------------------------------------------------------------------------------------------------------------------------------      
                     10.2.10.121               | ocid1.privateip.oc1.iad.OCID |      
       2603:c020:c003:3a10:b64c:8f35:7f9e:7e87 |   ocid1.ipv6.oc1.iad.OCID    |

Para obter informações sobre as opções oci-network-config show-vnics-all, consulte Opções Comuns do Utilitário OCI.

Adicionar um endereço secundário

Use o utilitário oci-network-config add-secondary-addr para adicionar um endereço IP privado secundário com o endereço IPv4 ou IPv6 especificado a uma VNIC existente.

Uso

Para adicionar um endereço IP secundário privado, nesse caso um endereço IPv6, a uma VNIC existente, use o subcomando oci-network-config add-secondary-addr com as opções --ipv6 e --ocid:

sudo oci-network-config add-secondary-addr --ipv6 --ocid OCID

Por exemplo:

$ sudo oci-network-config add-secondary-addr --ipv6 --ocid ocid1.vnic.oc1.iad.OCID
Provisioning secondary private IPv6: 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87
IP 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87 has been assigned to vnic ocid1.vnic.oc1.iad.OCID

Detalhes da Opção

Detalhes da Opção add-secondary-addr oci-network-config
Opção	Descrição
`-ipv4 \| --ipv4`	Especifica que um endereço secundário privado IPv4 seja adicionado a uma VNIC existente. Essa opção será o padrão se o comando for inserido sem nenhuma opção.
`-ipv6 \| --ipv6`	Especifica que um endereço secundário privado IPv6 seja adicionado a uma VNIC existente.
`-I ip_address \| --ip-address ip_address`	Especifica o endereço IP privado secundário a ser adicionado à VNIC.
`-O \| --ocid OCID`	Designe o endereço secundário à VNIC associada ao OCID específico.

Excluindo a Configuração de IP para VNICs Secundárias Provisionadas

Use o subcomando oci-network-config unconfigure para excluir toda a configuração de IP para VNICs secundárias provisionadas ( exceto as explicitamente excluídas). A VNIC principal não pode ser excluída.

Uso

oci-network-config unconfigure [-I | --include item] [-X | --exclude item] [-h | --help]

Para excluir toda a configuração de IP para VNICs secundárias provisionadas, use o subcomando oci-network-config unconfigure:

sudo oci-network-config unconfigure

Por exemplo:

$ sudo oci-network-config unconfigure
Unconfigured

Detalhes da Opção

Detalhes da Opção de desconfiguração oci-network-config
Opção	Descrição
`-I \| --include item`	Inclui um endereço IP ou uma interface VLAN que foi excluída anteriormente usando a opção `--exclude` na configuração/desconfiguração automática. Para `item`, você pode especificar um OCID de VNIC, um endereço IP ou um nome de interface VLAN.
`-X \| --exclude item`	Exclui de forma persistente um item (Endereço IP ou interface VLAN) da configuração/desconfiguração automática. Para `item`, você pode especificar um OCID de VNIC, um endereço IP ou um nome de interface VLAN. Use a opção `--include` para incluir novamente o endereço IP ou a interface VLAN.

Removendo um Endereço IPv6 Secundário

Use o subcomando oci-network-config remove-secondary-addr para remover um endereço IP privado secundário com o endereço IPv4 ou IPv6 especificado de uma VNIC existente.

Uso

oci-network-config remove-secondary-addr [-I | --ip-address ip_address] [-h | --help]

Para remover um endereço secundário privado IPv6 de uma VNIC existente, use o subcomando oci-network-config remove-secondary-addr com a opção -I:

sudo oci-network-config remove-secondary-addr -I ip_address

Por exemplo, para remover o endereço IPv6 secundário, 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87, de uma VNIC existente:

$ sudo oci-network-config remove-secondary-addr -I 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87
Deconfigure secondary private IP 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87

Detalhes da Opção

Detalhes da Opção remove-secondary-addr oci-network-config
Opção	Descrição
`-I \| --ip-address ip_address`	Especifica o endereço IP privado secundário a ser removido da VNIC.

Desanexando uma VNIC

Use o subcomando oci-network-config detach-vnic para desanexar e excluir a VNIC com o OCID ou o endereço IP específico da instância. Esse subcomando pode ser usado para remover o endereço IP designado de uma VNIC existente. No entanto, a VNIC principal não pode ser desanexada. Todos os endereços IP privados secundários associados à VNIC também são excluídos.

Uso

oci-network-config detach-vnic [-I | --ip-address ip_address] [-O | --ocid OCID] [-h | --help]

Para desassociar uma VNIC da instância, use o subcomando oci-network-config detach-vnic com a opção --ocid:

sudo oci-network-config detach-vnic --ocid OCID

Por exemplo, para desanexar uma VNIC com um OCID de VNIC específico da instância:

$ sudo oci-network-config detach-vnic --ocid ocid1.vnic.oc1.iad.OCID
Detaching VNIC 10.2.10.121 [ocid1.vnic.oc1.iad.OCID]
VNIC [ocid1.vnic.oc1.iad.OCID] is detached.

Detalhes da Opção

Detalhes da Opção detach-vnic oci-network-config
Opção	Descrição
`-I \| --ip-address ip_address`	Desanexa a VNIC com o endereço IP fornecido.
`--ocid OCID`	Desanexa a VNIC com o OCID fornecido.

Exibindo Informações da VCN

O subcomando oci-network-config show-vcns exibe informações da rede virtual na nuvem (VCN) no compartimento no qual a instância reside.

Uso

oci-network-config show-vcns [--output-mode mode] [--details] [--ocid OCID] [--name name] [--no-truncate] [-h | --help]

Para exibir informações detalhadas da VCN no formato de saída de texto, use o subcomando oci-network-config show-vcns com as opções --details e --output-mode text:

sudo oci-network-config show-vcns --details --output-mode text

Por exemplo:

$ sudo oci-network-config show-vcns --details --output-mode text
Virtual Cloud Network Information:

Name: hostname_uk_01
IPv4 cidr block: 10.0.0.0/16
IPv6 cidr block: 2603:c020:c003:6c00::/56
OCID: ocid1.vcn.oc1..example_OCID
IPv4 cidr blocks: 10.0.0.0/16
DNS label: gtijskenuk01
State: AVAILABLE
Lifecycle state: AVAILABLE

Name: hostname_uk_02
IPv4 cidr block: 10.2.0.0/16
IPv6 cidr block: 2603:c020:c003:3a00::/56
OCID: ocid1.vcn.oc1..example_OCID
IPv4 cidr blocks: 10.2.0.0/16
DNS label: gtijskenuk02
State: AVAILABLE
Lifecycle state: AVAILABLE

Name: hostname_uk_ref
IPv4 cidr block: 10.253.0.0/16
IPv6 cidr block: 2603:c020:c007:9f00::/56
OCID: ocid1.vcn.oc1..example_OCID
IPv4 cidr blocks: 10.253.0.0/16
DNS label: gtijskenukref
State: AVAILABLE
Lifecycle state: AVAILABLE

Detalhes da Opção

Detalhes da Opção oci-network-config show-vcns
Opção	Descrição
`--ocid OCID`	Exiba a VCN com o OCID fornecido.
`--name name`	Exiba a VCN com o nome fornecido.

Exibindo Informações de Sub-rede

O subcomando oci-network-config show-subnets mostra informações da sub-rede no compartimento no qual essa instância reside.

Uso

oci-network-config show-subnets [--output-mode mode] [--details] [--ocid OCID] [--name name] [--no-truncate] [-h | --help]

Para exibir informações detalhadas da sub-rede no formato de saída JSON, use o subcomando oci-network-config show-subnets com as opções --details e --output-mode json:

sudo oci-network-config show-subnets --details --output-mode json

Por exemplo:

$ sudo oci-network-config show-subnets --details --output-mode json
[
  {
    "Name": "Public Subnet-hostname_uk_01",
    "ipv4 cidr block": "10.0.0.0/24",
    "ipv6 cidr block": "2603:c020:c003:6c00::/64",
    "OCID": "ocid1.subnet.oc1..OCID",
    "VCN name": "hostname_uk_01",
    "VCN ocid": "ocid1.vcn.oc1..OCID",
    "Public": true,
    "Public ingress": true,
    "DNS label": "sub06230933270",
    "Domain name": "sub06230933270.gtijskenuk01.oraclevcn.com",
    "Lifecycle state": "AVAILABLE"
  },
  {
    "Name": "hostname_uk_ref_02",
    "ipv4 cidr block": "10.253.20.0/24",
    "ipv6 cidr block": "2603:c020:c007:9f20::/64",
    "OCID": "ocid1.subnet.oc1..OCID",
    "VCN name": "hostname_uk_ref",
    "VCN ocid": "ocid1.vcn.oc1..OCID",
    "Public": true,
    "Public ingress": true,
    "DNS label": "gtijskenukref02",
    "Domain name": "gtijskenukref02.gtijskenukref.oraclevcn.com",
    "Lifecycle state": "AVAILABLE"
  },
  {
    "Name": "hostname_uk_ref_01",
    "ipv4 cidr block": "10.253.10.0/24",
    "ipv6 cidr block": "2603:c020:c007:9f10::/64",
    "OCID": "ocid1.subnet.oc1..OCID",
    "VCN name": "hostname_uk_ref",
    "VCN ocid": "ocid1.vcn.oc1..OCID",
    "Public": true,
    "Public ingress": true,
    "DNS label": "gtijskenukref01",
    "Domain name": "gtijskenukref01.gtijskenukref.oraclevcn.com",
    "Lifecycle state": "AVAILABLE"
  },
]

Detalhes da Opção

oci-network-config show-subnets Detalhes da Opção
Opção	Descrição
`--ocid OCID`	Mostra informações sobre a sub-rede que corresponde ao OCID (Oracle Cloud Identifier) fornecido.
`--name name`	Mostra informações sobre a sub-rede associada ao nome fornecido.

oci-network-inspector

O utilitário oci-network inspector exibe um relatório de rede detalhado de um compartimento ou uma rede específica configurada para a instância.

Uso

oci-network-inspector [-C | --compartment OCID] [-N | --vcn OCID] [-h | --help]

Exibindo um Relatório Detalhado de uma VCN Específica

Para exibir um relatório detalhado de uma VCN específica, execute o utilitário oci-network-inspector e use a opção -N para especificar o OCID da VCN:

sudo oci-network-inspector -N OCID

Por exemplo:

$ sudo oci-network-inspector -N ocid1.compartment.oc1..OCID

Compartment: KVM_workspace (ocid1.compartment.oc1..OCID)

  vcn  : uk_02 (ocid1.vcn.oc1..OCID)
    Security List: Default Security List for uk_02
      Ingress: tcp              0.0.0.0/0:-                       ---:22
      Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
      Ingress: icmp           10.2.0.0/16:-                 code-None:type-3
      Ingress: tcp                   ::/0:-                       ---:22
      Ingress: 58                    ::/0:-                       ---:-
      Egress : all                    ---:-                 0.0.0.0/0:-
      Egress : all                    ---:-                      ::/0:-

    Subnet  : uk02_02 (ocid1.subnet.oc1..OCID)
      ipv4 cidr block : 10.2.20.0/24
      ipv6 cidr block : 2603:c020:c003:3a20::/64
      DNS domain name : gtijskenuk0202.gtijskenuk02.oraclevcn.com
       Security List: Default Security List for uk_02
         Ingress: tcp              0.0.0.0/0:-                       ---:22
         Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
         Ingress: icmp           10.2.0.0/16:-                 code-None:type-3
         Ingress: tcp                   ::/0:-                       ---:22
         Ingress: 58                    ::/0:-                       ---:-
         Egress : all                    ---:-                 0.0.0.0/0:-
         Egress : all                    ---:-                      ::/0:-

      Private IP      : 10.2.20.42(primary)  Host: gtijsken-amd-kvm-lon-flex3-vnicb752
        Vnic            : ocid1.vnic.oc1..OCID (AVAILABLE-ATTACHED)
        Vnic PublicIP   : None
        Instance        : amd_kvm_lon_flex3
          Instance State  : RUNNING
          Instance ocid   : ocid1.instance.oc1..OCID

      ...

Exibindo um Relatório Detalhado de um Compartimento Específico

Para exibir um relatório de rede detalhado para um compartimento específico, execute o utilitário oci-network-inspector e use a opção -C para especificar um OCID de compartimento:

sudo oci-network-inspector -C OCID

Por exemplo:

$ sudo oci-network-inspector -C ocid1.compartment.oc1..OCID

Compartment: scottb_sandbox (ocid1.compartment.oc1..OCID)

  vcn: scottb_vcn
    Security List: Default Security List for scottb_vcn
      Ingress: tcp              0.0.0.0/0:-                       ---:22
      Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
      Ingress: icmp           10.0.0.0/16:-                 code-None:type-3
      Ingress: tcp              0.0.0.0/0:80                      ---:80
      Ingress: tcp              0.0.0.0/0:43                      ---:43
      Ingress: tcp              0.0.0.0/0:-                       ---:-
      Egress : all                    ---:-                 0.0.0.0/0:-

     Subnet: Public Subnet cumS:PHX-AD-3 Avalibility domain: cumS:PHX-AD-3
         Cidr_block: 10.0.2.0/24 Domain name: sub99999999999.scottbvcn.oraclevcn.com
       Security List: Default Security List for scottb_vcn
         Ingress: tcp              0.0.0.0/0:-                       ---:22
         Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
         Ingress: icmp           10.0.0.0/16:-                 code-None:type-3
         Ingress: tcp              0.0.0.0/0:80                      ---:80
         Ingress: tcp              0.0.0.0/0:43                      ---:43
         Ingress: tcp              0.0.0.0/0:-                       ---:-
         Egress : all                    ---:-                 0.0.0.0/0:-

     ...

Para obter informações sobre a opção do utilitário oci-network-inspector, consulte Opções Comuns do Utilitário OCI.

oci-notificar

O utilitário oci-notify envia uma mensagem a um tópico do serviço Notifications. Este utilitário deve ser executado como raiz.

Uma mensagem é composta por um cabeçalho (título) e um arquivo. A configuração do serviço Notifications para o tópico determina onde e como as mensagens são entregues. Os tópicos são configurados usando a Console, a API ou a CLI do Oracle Cloud Infrastructure (OCI).

Para obter mais informações sobre o serviço Notifications, consulte Visão Geral do Serviço Notifications.

Uso

oci-notify [subcommand] [-h | --help]

Subcomandos

O utilitário oci-notify tem os subcomandos a seguir.

Subcomandos do Utilitário oci-notify
Subcomando	Para obter mais informações, consulte...
`config`	Configurando um Tópico do Serviço Notifications em uma Instância
`message`	Publicando uma Mensagem em um Tópico

Para obter informações sobre a opção do utilitário oci-notify, consulte Opções Comuns do Utilitário OCI.

Configurando um Tópico do Serviço Notifications em uma Instância

Use o subcomando oci-notify config para gravar o OCID do tópico do serviço Notifications no arquivo oci.conf. Após a configuração, você poderá publicar as mensagens neste tópico configurado.

Por padrão, o caminho para o arquivo de configuração é /etc/oci-utils/oci.conf. Você pode substituir o caminho do arquivo de configuração usando a variável de ambiente OCI_CONFIG_DIR.

Uso

oci-notify config notifications_topic_OCID [-h | --help]

Para gravar o OCID de um tópico do serviço Notifications configurado no arquivo oci.conf, use o subcomando oci-notify config e especifique o OCID do tópico do serviço Notifications.

Por exemplo:

$ sudo oci-notify config ocid1.onstopic.oc1..OCID

Para obter informações sobre a opção do utilitário oci-notify-config, consulte Opções Comuns do Utilitário OCI.

Publicando uma Mensagem em um Tópico

Com o subcomando oci-notify message, você pode publicar o conteúdo de um arquivo ou de uma string de texto com o título especificado no tópico configurado.

Observação: Quando a mensagem é publicada, o utilitário oci-notify prefixa o nome da instância ao assunto da mensagem. Por exemplo: instance_name:log messages

Uso

oci-notify message [-t | --title 'message_title'] [-f | --file message_file] [-h | --help]

Para enviar o conteúdo do arquivo /var/log/messages com o título 'logging messages' para o tópico configurado, use as opções --title e --file com o subcomando oci-notify-message.

Por exemplo:

$ sudo oci-notify message --title 'logging messages' --file /var/log/messages

Para enviar uma string de texto para o tópico configurado, informe uma linha de texto entre aspas simples para o valor da opção --file.

Por exemplo:

$ sudo oci-notify message --title 'sending a text' --file 'Today is a beautiful day'

Detalhes da Opção

Detalhes da Opção oci-notify-message
Opção	Descrição
`-t \| --title message_title`	Especifique o título a ser usado no cabeçalho da mensagem (por exemplo, `'log messages'` se você estiver enviando arquivos de log). O `message_title` deve estar entre aspas simples ou duplas. Os cabeçalhos das mensagens são truncados para 128 caracteres.
`-f \| --file message_file`	Especifica o caminho completo ou relativo do diretório, HTTP ou URL FTP do arquivo de mensagem ou a string de texto a ser enviada. Os arquivos maiores são divididos em chunks de 64 KB e são enviados como mensagens separadas. O número de chunks é limitado a 10. Se o `message_file` especificado não for reconhecido como um URL ou o caminho do diretório não existir, o texto informado para `message_file` será enviado como uma string de texto. As strings de texto são limitadas a 128 caracteres.

oci-public-ip

Use o utilitário oci-public-ip para exibir o endereço IP público da instância de computação atual, em formato legível por seres humanos ou JSON.

O utilitário oci-public-ip usa o SDK do OCI (Oracle Cloud Infrastructure) para descobrir o endereço IP (consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando). Se o endereço IP não puder ser obtido por este método, o utilitário oci-public-ip tentará o protocolo STUN ( Session Traversal Utilities for NAT) como um último recurso para descobrir o endereço IP. Para obter mais informações sobre o STUN, consulte o artigo da Wikepedia.

Uso

oci-public-ip [-h | --human-readable] [-j | --json] [-g | --get] [-a | --all] [-s | --sourceip source_IP] [-S | --stun-server STUN_server] [-L | --list-servers] [--instance-id OCID] [--help]

Exibindo o Endereço IP da Instância Atual

Execute o comando oci-public-ip sem opções para retornar o endereço IP da instância atual:

sudo oci-public-ip

Por exemplo:

$ sudo oci-public-ip
Public IP address: 203.0.113.2

Exibindo o Endereço IP de Outra Instância

Para exibir o endereço IP público de outra instância diferente da instância atual, use o utilitário oci-public-ip com a opção --instance-id.

Observação

Esta opção requer que o OCI SDK para Python seja instalado e configurado. Para obter informações, consulte SDKs (Software Development Kits) e Interface de Linha de Comando.

sudo oci-public-ip --instance-id OCID

Por exemplo:

$ sudo oci-public-ip --instance-id ocid1.instance.oc1.phx.OCID
Public IP address: 203.0.113.2

Exibindo uma Lista de Servidores STUN

Para exibir uma lista de servidores STUN, use o utilitário oci-public-ip com a opção --list-servers:

sudo oci-public-ip --list-servers

Por exemplo:

$ sudo oci-public-ip --list-servers
stun.stunprotocol.org
stun.counterpath.net
stun.voxgratia.org
stun.callwithus.com
stun.ekiga.net
stun.ideasip.com
stun.voipbuster.com
stun.voiparound.com
stun.voipstunt.com

Detalhes da Opção

Opções do Utilitário oci-public-ip
Opção	Descrição
`-g \| get`	Imprime somente o endereço IP.
`--instance-id OCID`	Exibe o endereço IP público da instância determinada em vez da atual. Requer que o OCI SDK para Python seja instalado e configurado.
`-L \| --list-servers`	Imprime uma lista de servidores STUN conhecidos e sai.
`-s \| --sourceip source_IP`	Especifica o endereço IP de origem a ser usado.
`-S \| --stun-server STUN_server`	Especifica o servidor STUN a usar.

oci-volume-dados

Use o utilitário oci-volume-data para exibir dados sobre um volume iSCSI específico anexado a uma instância de computação baseada no Oracle Linux.

O utilitário oci-volume-data requer a opção -k (chave) para exibir dados para um volume iSCSI específico. Os valores da opção de chave podem ser o nome para exibição, o OCID ou o iqn (Nome Qualificado para iSCSI) do volume.

Uso

oci-volume-data [-h | --help] [-k KEY | --key KEY] [-p | --par {name, iqn, ocid, portal, chap, attachestate, avdomain, compartment, attached, size, state}] [-v | --value-only]

Exibindo Todos os Dados Sobre um Volume iSCSI Anexado

Para exibir todos os dados sobre um volume iSCSI anexado à instância de computação:

sudo oci-volume-data -k OCID

Por exemplo:

$ sudo oci-volume-data -k OCID
             display name: name=oci1-iscsi-volume-1
                     ocid: ocid1.volume.oc1.OCID
                      iqn: iqn.2122-45.com.oracleiaas:IQN
                portal ip: 123.245.6.7
              portal port: 1234
                chap user: None
            chap password: None
      availability domain: DSdu:US-EAST-DOMAIN
              compartment: comparment1
           compartment id: ocid1.compartment.OCID
              attached to: oci-utils-instance
         attachment state: --
                     size: 70GB
                    state: AVAILABLE

Exibindo Dados Específicos Sobre um Volume iSCSI Anexado

Opcionalmente, use as opções -k, -p e -v (somente valor) com o utilitário oci-volume-data para restringir o que você deseja exibir para o volume iSCSI:

oci-volume-data -k OCID -p size -v

Por exemplo, para exibir apenas o tamanho de um volume iSCSI, nesse caso, 70 GB:

$ oci-volume-data -k ocid1.volume.OCID -p size -v
70GB

Para obter mais informações sobre os valores de opção suportados (como tamanho, estado, compartimento etc.), consulte a página man referente a oci-volume-data. Para obter informações sobre como acessar as páginas man do utilitário do OCI, consulte Opções Comuns do Utilitário do OCI.

Detalhes da Opção

Opções do Utilitário oci-volume-data
Opção	Descrição
`-k KEY \| --key KEY`	Obrigatório. A chave para identificar o volume. O valor `KEY` pode ser o OCID, IQN ou o nome para exibição do volume.
`-p \| --par`	Especifica o endereço IP de origem a ser usado.
`-v \| --value-only`	Mostre apenas os valores na saída.

Resumo de Utilitários do OCI

Um resumo dos componentes de utilitários do OCI.


Nome	Descrição
`ocid`	O componente de serviço do `oci-utils`, que é executado como daemon iniciado por `systemd`. Esse serviço procura alterações nas configurações de dispositivos iSCSI e VNIC e armazena em cache os metadados e o endereço IP público da instância.
`oci-compartmentid`	Exibe o OCID (Oracle Cloud Identifier) do compartimento no qual a instância está em execução.
`oci-growfs`	Expande o sistema de arquivos raiz da instância para seu tamanho configurado.
`oci-image-expand`	Converte a instância Mínima do Oracle Linux para adicionar serviços e pacotes de uma imagem de plataforma padrão do Oracle Linux.
`oci-instanceid`	Exibe o OCID da instância.
`oci-iscsi-config`	Lista ou configura dispositivos iSCSI anexados a uma instância de computação. Se nenhuma opção de linha de comando for especificada, listará os dispositivos que precisam de atenção.
`oci-metadata`	Exibe metadados para a instância de computação. Se nenhuma opção de linha de comando for especificada, listará todos os metadados disponíveis. Os metadados incluem o OCID da instância, o nome para exibição, o compartimento, a forma, a região, o domínio de disponibilidade, a data de criação, o estado, a imagem e quaisquer metadados personalizados que você fornecer, como uma chave pública SSH.
`oci-network-config`	Lista ou configura VNICs (placas de interface de rede virtual) anexadas à instância de computação. Quando uma VNIC secundária é provisionada na nuvem, ela deve ser configurada explicitamente na instância usando esse script ou comandos semelhantes.
`oci-network-inspector`	Exibe um relatório detalhado de um determinado compartimento ou rede.
`oci-notify`	Envia uma mensagem para um tópico do serviço Notifications.
`oci-public-ip`	Exibe o endereço IP público do sistema atual em formato JSON ou legível.
`oci-volume-data`	Exibe dados sobre um volume iSCSI específico anexado à instância.

Opções Comuns do Utilitário OCI

Muitos dos utilitários do OCI (Oracle Cloud Infrastructure) têm as mesmas opções ou argumentos disponíveis quando os utilitários são executados na linha de comando. Essas opções e argumentos ajudam a definir melhor que tipo de informação é produzida pelo utilitário ou como uma tarefa do utilitário é executada.

A tabela a seguir lista as opções e seus valores suportados que são comuns nos utilitários do OCI.


Opção	Descrição
`--help`	Exibe informações de ajuda sobre o utilitário, como o uso do utilitário, as opções disponíveis e os valores suportados para cada opção. Por exemplo, para exibir a ajuda do utilitário `oci-metadata`: `$ sudo oci-metadata --help usage: oci-metadata [-h] [-j] [-g KEY] [--value-only] [--export] [--trim] [-u KEY=VALUE [KEY=VALUE ...]] [-i OCID] [--help] Utility for displaying metadata for an instance running in the Oracle Cloud Infrastructure. optional arguments: -h, --human-readable Display human readable output (default) -j, --json Display json output ... --help Display this help`
`--all`	Mostra todos os itens ou valores na saída.
`--details`	Mostra informações detalhadas na saída.
`--output-mode`	Permite definir como a saída do utilitário é exibida. Veja a seguir os modos de utilitário do OCI disponíveis: `json`: Exibe a saída no formato JSON. `human-readable`: Exibe a saída no formato legível por humanos. `parsable`: Exibe a saída no formato analisável. `table`: Exibe a saída em uma tabela. `text`: Exibe a saída textual.
`--no-truncate`	Não encurta os valores na saída exibida.
`--truncate`	Encurta os valores na saída exibida.
`-y\| --yes`	Responde "yes" em todos os prompts.
`-n \| --no`	Responde "não" em todos os prompts.
`-q \| --quiet`	Suprime mensagens de informações.

Observação

Você também pode exibir páginas man de cada utilitário do OCI digitando man oci-utility na linha de comando. Por exemplo, para exibir as páginas manuais incorporadas para o utilitário oci-metadata:

man oci-metadata

Documentação do Oracle Cloud Infrastructure

Utilitários do OCI

Instalando os Utilitários do OCI

Atualizando os Utilitários do OCI

Usando o Daemon ocid

Referência de Utilitários do OCI

Gerenciando Volumes

Gerenciando a Rede

Exibindo Informações de Configuração

Configurando Notificações

Convertendo a Imagem Mínima do Oracle Linux

oci-compartmentid

Uso

oci-growfs

Uso

Expandindo a Partição Raiz de uma Instância

oci-expandir imagem

Pré-requisitos

Tipos de Conversão

Uso

Restaurando a Funcionalidade de Imagem de Plataforma Padrão

Restaurando a funcionalidade de reinicialização necessária da imagem da plataforma

oci-instanceid

Uso

oci-iscsi-config

Uso

Subcomandos

Exibindo Configurações de iSCSI

Criando e Anexando um Novo Volume

Anexando um volume existente

Sincronizando um Volume

Desanexando um Volume

Excluindo um Volume

oci-metadata

Uso

Obtendo Todos os Metadados da Instância

Obtendo Metadados Específicos da Instância

Detalhes da Opção

oci-network-config

Uso

Subcomandos

Exibindo a Configuração de Rede Atual

Criando e Anexando uma VNIC

Configurando VNICs

Exibindo VNICs Configuradas

Exibindo Todos os VNICS Configurados

Adicionar um endereço secundário

Excluindo a Configuração de IP para VNICs Secundárias Provisionadas

Removendo um Endereço IPv6 Secundário

Desanexando uma VNIC

Exibindo Informações da VCN

Exibindo Informações de Sub-rede

oci-network-inspector

Uso

Exibindo um Relatório Detalhado de uma VCN Específica

Exibindo um Relatório Detalhado de um Compartimento Específico

oci-notificar

Uso

Subcomandos

Configurando um Tópico do Serviço Notifications em uma Instância

Publicando uma Mensagem em um Tópico

oci-public-ip

Uso

Exibindo o Endereço IP da Instância Atual

Exibindo o Endereço IP de Outra Instância

Exibindo uma Lista de Servidores STUN

Detalhes da Opção

oci-volume-dados

Uso

Exibindo Todos os Dados Sobre um Volume iSCSI Anexado

Exibindo Dados Específicos Sobre um Volume iSCSI Anexado

Detalhes da Opção

Resumo de Utilitários do OCI

Opções Comuns do Utilitário OCI