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:

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

Convertendo a Imagem Mínima do Oracle Linux

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:

  1. 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.

  2. 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: 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:

  1. Execute o utilitário oci-image-expand.

    /usr/libexec/oci-image-expand
  2. 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.

  3. 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:

  1. 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|
    
  2. 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|
    
  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

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.

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

oci-iscsi-config attach [-I | --iqns IQN] [-O | --ocids OCID] [-u | --username name] [-p | --password password] [-c | --chap] [-h | --help]

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

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.

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

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.

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

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.

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

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.

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

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.

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

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

oci-network-config attach-vnic [-I | --ip-address ip_address] [-ipv4 | --ipv4] [-ipv6 | --ipv6] [-i | --nic-index index] [--subnet subnet] [-n | --name name] [--assign-public-ip] [-h | --help]

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

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

oci-network-config configure [-n | --namespace format] [-r | --start-sshd] [-I | --include item] [-X | --exclude item] [-h | --help]

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

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.

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

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

oci-network-config add-secondary-addr [-ipv4 | --ipv4] [-ipv6 | --ipv6] [-I | --ip-address ip_address] [-O | --ocid OCID] [-h | --help]

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

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.

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

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.

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

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.

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

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.

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

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.

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

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

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.

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

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.

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

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.

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