Referência de Utilitários do OCI

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

Volumes

Rede

Informações sobre a Configuração

Notificações

oci-notificar

Expandindo a imagem mínima

oci-imagem-expanda

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 OCI, consulte Opções Comuns do Utilitário OCI.

Utilitários

oci-compartimentoid

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

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 menor que 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 Verificando novamente o Disco para Volumes Anexados a Instâncias Baseadas em 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-imagem-expanda

Use o utilitário oci-image-expand para converter a instância Mínima do Oracle Linux e 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 de 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 raiz.

Pré-requisito

Instale os Utilitários do OCI na instância mínima. Para obter mais informações, consulte Instalando os Utilitários 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 da nuvem e configura e ativa a 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 da plataforma Oracle Linux padrão, 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 nova geração do kdump initramfs.
- Ativar Ksplice - Instala o Ksplice e ativa o serviço Ksplice. Para obter informações, consulte Oracle Ksplice 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 uma reinicialização para entrar 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 assim 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 do mínimo.

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 da 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 seleções.

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 imagem de plataforma necessária para reinicialização

Para restaurar a funcionalidade de imagem da plataforma Oracle Linux que requer a reinicialização de uma instância para ter efeito:

Execute o utilitário oci-image-expand.
```
/usr/libexec/oci-image-expand
```
No prompt, execute um dos seguintes procedimentos 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á pressionou 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 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 opções de linha, o oci-iscsi-config lista dispositivos que precisam de atenção.

Cuidado

Evite inserir informações confidenciais ao atribuir descrições, tags ou nomes amigáveis aos seus recursos do cloud por meio da Console, API ou 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 os Utilitários OCI para Gerenciar Armazenamento iSCSI para Instâncias da Oracle Cloud Infrastructure na Estação de Treinamento do Oracle Linux.

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 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 em execução, o subcomando exigirá 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 encurtadas 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 desse utilitário ou subcomando. Para obter informações sobre as opções comuns usadas nos utilitários do OCI, consulte Opções Comuns do OCI Utility.

oci-iscsi-config mostrar Detalhes da Opção
Opção	Descrição
`-A \| --all`	Exibe todos os dispositivos iSCSI. Por padrão, somente dispositivos que não estão anexados a uma instância são listados.
`-C \| --compartments name`	Exibe dispositivos iSCSI no compartimento fornecido ou 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 mais informações sobre o OCI SDK, consulte SDKs (Software Development Kits) e Interface de Linha de Comando.

Esse subcomando requer privilégios root.

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 do 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

oci-iscsi-config criar Detalhes da Opção
Opção	Descrição
`-v \| --volume-name name`	Define o nome de 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 disponibilizar o volume para o sistema. O OCI SDK para Python é necessário para selecionar volumes usando seu OCID. Para obter mais informações sobre o OCI SDK, consulte SDKs (Software Development Kits) e Interface de Linha de Comando.

Esse subcomando requer privilégios root.

Observação

Ao usar um IQN, o volume já deve estar anexado (atribuído) à 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

oci-iscsi-config anexar Detalhes da Opção
Opção	Descrição
`-I \| --iqns IQN`	Uma lista separada por vírgulas dos iqns (nomes qualificados) iSCSI do dispositivo iSCSI para anexar à 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 tenta desmontá-lo primeiro.

Esse subcomando requer privilégios root.

Observação

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

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`	Continue desanexando mesmo que o dispositivo não possa ser desmontado.
`-I \| --iqns IQN`	Uma lista separada por vírgulas dos iqns (nome qualificado para iSCSI) do dispositivo iSCSI, ou dispositivos, 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

oci-iscsi-config destroy Detalhes da Opção
Opção	Descrição
`-O \| --ocids OCID`	Uma lista separada por vírgulas dos OCIDs do 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 qualquer opção da linha do comando, 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 para a Instância

Para exibir os 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`, reduza o caminho da chave para o último componente a fim de 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`	Atualize o valor da chave (ou chaves) específica. 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 placas de interface virtual (VNICs) atuais provisionadas no Oracle Cloud Infrastructure (OCI) 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 dentro de namespaces de rede distintos. Essa separação é necessária quando VNICs estão em sub-redes (VCNs diferentes) com blocos de endereços sobrepostos e as aplicações de rede não são vinculadas diretamente às interfaces. Namespaces de rede requerem que aplicativos sejam iniciados nos namespaces explicitamente (com o comando ip netns exec ns) para estabelecer associação com a interface. Quando os namespaces não forem usados, o roteamento baseado em política será configurado para fornecer uma rota padrão para o roteador virtual da VNIC secundária (gateway default) quando o endereço da VNIC for 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 da Sub-rede
`configure`	Configurando VNICs
`unconfigure`	Excluindo a Configuração de IPs para VNICs Secundárias Provisionadas
`attach-vnic`	Criando e Anexando uma VNIC
`detach-vnic`	Desanexando uma VNIC
`add-secondary-addr`	Adicionando um Endereço Secundário
`remove-secondary-addr`	Removendo um Endereço IPv6 Secundário

Para obter um vídeo de treinamento que mostra como usar o utilitário oci-network-config, consulte Network Interface Management Using OCI Utilities on Oracle Linux Instances 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 foram configuradas são marcadas com ADD. Portanto, as configurações IP que não têm mais uma VNIC associada serão marcadas, portanto, com DELETE.

A saída deste comando será a ação padrão se o utilitário oci-network-config for informado 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 estão configuradas (rotuladas de 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

Não há suporte para a anexação de uma VNIC com um endereço IPv6 principal.

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 estiver sendo usada, um endereço IP não usado 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 correspondente ao 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 IP a VNICs que não estão configuradas e exclui a configuração IP de VNICs que não estão mais provisionadas. Este comando sincroniza a configuração de IP da instância com o provisionamento do OCI atual.

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 da configuração. Para obter mais informações, consulte Displaying the Current Network Configuration.

Detalhes da Opção

Detalhes da Opção de configuração oci-network-config
Opção	Descrição
`-n \| --namespace format`	Ao configurar, coloque interfaces no namespace identificado pelo formato fornecido. O formato pode incluir variáveis `$nic` e `$vltag`. O nome assume `DEF_NS_FORMAT_BM` como padrão 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 o `-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 do oci-network-config show-vnics-all, consulte Opções Comuns do Utilitário OCI.

Adicionando 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

oci-network-config add-secondary-addr Detalhes da Opção
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 IPs para VNICs Secundárias Provisionadas

Use o subcomando oci-network-config unconfigure para excluir todas as configurações de IP para VNICs secundárias provisionadas (exceto as excluídas explicitamente). Não é possível excluir a VNIC principal.

Uso

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

Para excluir todas as configurações 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 de 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 IPv6 secundário privado 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

oci-network-config remove-secondary-addr Detalhes da Opção
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 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 desanexar 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 oci-network-config detach-vnic
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 de 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 da Sub-rede

O subcomando oci-network-config show-subnets mostra informações da sub-rede no compartimento no qual esta 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-rede-inspector

O utilitário oci-network inspector exibe um relatório de rede detalhado para 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 de 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 para um tópico de serviço de Notificações. 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, API ou 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. Depois de configurado, você pode publicar 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 uma string de texto com o título especificado no tópico configurado.

Observação: Quando a mensagem é publicada, o utilitário oci-notify pré-anexa o nome da instância ao assunto. 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 ao 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

oci-notify-message Detalhes da Opção
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 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 a `message_file` especificada não for reconhecida como um URL ou o caminho do diretório já 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, no formato legível por humanos ou JSON.

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

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

Essa 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 de 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 fornecida, em vez do atual. Exige que o OCI SDK para Python seja instalado e configurado.
`-L \| --list-servers`	Imprime uma lista de servidores e saídas STUN conhecidos.
`-s \| --sourceip source_IP`	Especifica o endereço IP de origem a ser usado.
`-S \| --stun-server STUN_server`	Especifica o servidor STUN a ser usado.

dados do oci-volume

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 de um volume iSCSI específico. Os valores de 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 para oci-volume-data. Para obter informações sobre como acessar as páginas man do utilitário OCI, consulte Opções Comuns do Utilitário 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, o IQN ou o nome para exibição do volume.
`-p \| --par`	Especifica o endereço IP de origem a ser usado.
`-v \| --value-only`	Exiba somente os valores na saída.

Documentação do Oracle Cloud Infrastructure

Referência de Utilitários do OCI

Utilitários

Uso

Uso

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

Pré-requisito

Tipos de Conversão

Uso

Restaurando a Funcionalidade de Imagem da Plataforma Padrão

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

Uso

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

Uso

Obtendo Todos os Metadados da Instância

Obtendo Metadados Específicos para a Instância

Detalhes da Opção

Uso

Subcomandos

Exibindo a Configuração de Rede Atual

Criando e Anexando uma VNIC

Configurando VNICs

Exibindo VNICs Configuradas

Exibindo Todos os VNICS Configurados

Adicionando um Endereço Secundário

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

Removendo um Endereço IPv6 Secundário

Desanexando uma VNIC

Exibindo Informações da VCN

Exibindo Informações da Sub-rede

Uso

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

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

Uso

Subcomandos

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

Publicando uma Mensagem em um Tópico

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

Uso

Exibindo Todos os Dados Sobre um Volume iSCSI Anexado

Exibindo Dados Específicos sobre um Volume iSCSI Anexado

Detalhes da Opção