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 pacoteoci-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 comandooci 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.
- 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.
- Escolha o método para acessar os utilitários e execute qualquer procedimento de configuração para esse método, conforme necessário:
- CLI do OCI de uma instância ou host remoto - Um terminal da CLI conectado a uma instância ou host remoto no qual você pode executar os utilitários do OCI. Para obter mais informações sobre a CLI e como começar a usá-la, consulte Interface de Linha de Comando (CLI) e Início Rápido da CLI.
- SDK (Software Development Kit, Kit de desenvolvimento de software) da OCI - Um conjunto de ferramentas de desenvolvedor que permite escrever código e gerenciar recursos da OCI. Para obter informações, consulte SDKs (Software Development Kits) e Interface de Linha de Comando.
Para obter um vídeo sobre como instalar e configurar os utilitários do OCI, consulte Enabling OCI Utilities in Oracle Linux on Oracle Cloud Infrastructure Instance na Oracle Linux Training Station.
Atualizando os Utilitários do OCI
Para atualizar para a versão mais recente do oci-utils
:
sudo yum update oci-utils
Usando o Daemon ocid
O daemon ocid
é o componente de serviço do oci-utils
. Ele monitora alterações na configuração de VNICs e iSCSI da instância e tenta anexar ou desanexar dispositivos automaticamente conforme eles aparecem ou desaparecem - por exemplo, quando eles são criados ou excluídos usando a Console, a CLI ou a API do Oracle Cloud Infrastructure.
Para iniciar o daemon ocid
usando systemd
e definir o serviço ocid
para iniciar automaticamente durante a inicialização do sistema:
sudo systemctl enable --now ocid.service
Para confirmar se o serviço está ativo (em execução):
sudo service ocid status
Por exemplo:
$ sudo service ocid status
Redirecting to /bin/systemctl status ocid.service
ocid.service - Oracle Cloud Infrastructure utilities daemon
Loaded: loaded (/etc/systemd/system/ocid.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2021-02-04 18:01:25 GMT; 1min 42s ago
Main PID: 16630 (python3)
CGroup: /system.slice/ocid.service
└─16630 /usr/bin/python3 /usr/lib/python3.6/site-packages/oci_util...
Feb 04 18:01:23 mor-demoinst-10 systemd[1]: Starting Oracle Cloud Infrastruc....
Feb 04 18:01:24 mor-demoinst-10 sudo[16705]: root : TTY=unknown ; PWD=/ ...w
Feb 04 18:01:25 mor-demoinst-10 systemd[1]: Started Oracle Cloud Infrastruct....
Hint: Some lines were ellipsized, use -l to show in full.
Referência de Utilitários do OCI
Saiba mais detalhes sobre cada utilitário, incluindo uma descrição, exemplos de uso e opções.
Gerenciando Volumes
Gerenciando a Rede
Exibindo Informações de Configuração
Configurando Notificações
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.
Somente sistemas de arquivos XFS e ext4 são suportados.
Por padrão, uma instância baseada no Linux não usará automaticamente todo o volume de inicialização se o volume de inicialização for maior ou igual a 50 GB. Se o volume de inicialização anexado à instância for inferior a 50 GB, nenhuma alteração será feita no sistema ao usar o utilitário oci-growfs
.
Uso
/usr/libexec/oci-growfs [-y] [-n] [-h | --help]
Expandindo a Partição Raiz de uma Instância
Para expandir a partição raiz da instância:
-
Use o comando
lsblk
para confirmar se o sistema operacional identificou o novo tamanho do volume de inicialização.Por exemplo:
lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT sda 8:0 0 100G 0 disk ├─sda1 8:1 0 100M 0 part /boot/efi ├─sda2 8:2 0 1G 0 part /boot └─sda3 8:3 0 98.9G 0 part ├─ocivolume-root 252:0 0 88.9G 0 lvm / └─ocivolume-oled 252:1 0 10G 0 lvm /var/oled sdb 8:16 0 70G 0 disk
Se o volume de disco não for o tamanho esperado, execute os comandos para verificar novamente o volume de inicialização. Consulte Rescanning the Disk for Volumes Anexados a Instâncias Baseadas no Linux.
-
Execute o utilitário
oci-growfs
com a opçãoy
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áriooci-image-expand
. -
Reinicialização Obrigatória: Restaura a funcionalidade padrão da plataforma Oracle Linux, conforme descrito no tipo de conversão Padrão, e restaura um ou mais dos seguintes recursos selecionáveis pelo usuário:
- Ativar SELinux - Restaura o modo de imposição SELinux.
- Ativar Kdump - Adiciona o recurso
kdump
e a regeneração dekdump
initramfs
. - Ativar Ksplice - Instala o Ksplice e ativa o serviço Ksplice. Para obter informações sobre como usar o Ksplice, consulte Oracle Ksplice for Zero-Downtime Updates e Oracle Linux Ksplice User's Guide.
A execução do utilitário oci-instance-expand
afeta as definições configuradas pelo usuário na instância. Por exemplo, o utilitário restaura cloud-init config
para definições de imagem da plataforma Oracle Linux padrão, substituindo qualquer alteração cloud-config
configurada pelo usuário. Além disso, se você optar por restaurar o Ksplice, o utilitário reinstalará o pacote oci-linux-config
para que a nova chave de acesso seja armazenada no arquivo de configuração adequado. Não execute o utilitário em instâncias diferentes de instâncias mínimas.
Os arquivos de log do utilitário oci-image-expand
estão localizados em: /var/log/oci-image-expand.log
Uso
oci-image-expand [-h | --help]
Restaurando a Funcionalidade de Imagem de Plataforma Padrão
Para restaurar a funcionalidade de imagem da plataforma Oracle Linux padrão para a instância Mínima do Oracle Linux:
Execute o utilitário oci-image-expand
e pressione Enter no prompt, sem fazer nenhuma seleção.
Por exemplo:
$ /usr/libexec/oci-image-expand
Please select the set of reboot required functions, if any
Selecting a function transitions from not selected [ ] to selected [+] or vice versa
[ ] 0) All reboot options
[ ] 1) Enable SELinux
[ ] 2) Enable Kdump
[ ] 3) Enable Ksplice
Select the desired options using their number (again to uncheck, ENTER when done):
ENTER
Restaurando a funcionalidade de reinicialização necessária da imagem da plataforma
Para restaurar a funcionalidade de imagem da plataforma Oracle Linux que requer que uma reinicialização de instância entre em vigor:
-
Execute o utilitário
oci-image-expand
./usr/libexec/oci-image-expand
-
No prompt, execute um dos procedimentos a seguir e pressione Enter:
- Digite zero para restaurar todos os recursos da lista (SELinux, Kdump e Ksplice).
- Insira um único número, entre um e três, para restaurar um dos recursos da lista.
- Insira dois números, entre um e três, para restaurar dois dos recursos da lista.
Por exemplo, para restaurar a funcionalidade SELinux e Ksplice na instância Mínima do Oracle Linux:
$ /usr/libexec/oci-image-expand Please select the set of reboot required functions, if any Selecting a function transitions from not selected [ ] to selected [+] or vice versa [ ] 0) All reboot options [+] 1) Enable SELinux [ ] 2) Enable Kdump [+] 3) Enable Ksplice Select the desired options using their number (again to uncheck, ENTER when done): 1 3 The following options were selected: Enable SELinux Enable Ksplice The chosen options will now be applied. Press any key to continue (within 10 seconds)
Observação
Se você mudar de ideia sobre um recurso selecionado, digite o número novamente antes de pressionar Enter para desmarcar o recurso. Se você já tiver pressionado Enter, pressione Ctrl+C para cancelar a operação.
- No prompt, digite y para reinicializar a instância.
A reboot is required to enable and activate all restored services. Do you wish to reboot now? (y/n)y
Para obter informações sobre a opção do utilitário oci-image-expand
, consulte Opções Comuns do Utilitário do OCI.
oci-instanceid
Use o utilitário oci-instanceid
para exibir o OCID (Oracle Cloud Identifier) da instância.
Uso
oci-instanceid [-h | --help]
Para exibir o OCID da instância de computação:
sudo oci-instanceid
Por exemplo:
$ sudo oci-instanceid
ocid1.instance1.oc1.iad1.OCID
Para obter informações sobre a opção do utilitário oci-instanceid
, consulte Opções Comuns do Utilitário OCI.
oci-iscsi-config
Use o utilitário oci-iscsi-config
para listar e configurar dispositivos iSCSI anexados a uma instância baseada no Linux do OCI (Oracle Cloud Infrastructure). Quando executado sem nenhuma opção de linha de comando, o oci-iscsi-config
lista dispositivos que precisam de atenção.
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.
Subcomando |
Para obter mais informações, consulte... |
---|---|
|
|
|
|
|
|
|
|
|
|
|
Para obter um vídeo de treinamento que mostra como usar o utilitário oci-iscsi-config
, consulte Usando Utilitários do OCI para Gerenciar o Armazenamento iSCSI para Instâncias do Oracle Cloud Infrastructure na Oracle Linux Training Station.
Para obter informações sobre a opção do utilitário oci-iscsi-config
, consulte Opções Comuns do Utilitário OCI.
Exibindo Configurações de iSCSI
O subcomando oci-iscsi-config show
lista os dispositivos iSCSI e as informações de iSCSI da instância. Esse subcomando funciona com o daemon ocid
para monitorar a criação e a exclusão do dispositivo por meio da Console, da CLI ou da API e descobre automaticamente essas alterações.
Se o daemon ocid
não estiver sendo executado, o subcomando precisará de privilégios raiz.
Uso
oci-iscsi-config show [-C | --compartments name] [-A | --all] [--output-mode mode] [--details] [--no-truncate] [-h | --help]
Para exibir uma lista de todos os dispositivos anexados à instância:
-
Execute o subcomando
oci-iscsi-config show
.sudo oci-iscsi-config show
Por exemplo:
$ sudo oci-iscsi-config show Currently attached iSCSI devices: Volume name |Attached device| Size | -------------------------------------------------------- mor-demo-bv20 | sdb | 50G | Block volumes information: Name | Size | Attached to | OCID | ---------------------------------------------------------------------------------------------------------- mor-demo-bv30 | 50GB | - |ocid1.volume.oc1.OCID|
-
Opcionalmente, use as opções
--details
e--no-truncate
com o subcomandooci-iscsi-config show
para exibir informações mais detalhadas que não são reduzidas na saída:sudo oci-iscsi-config show --details --no-truncate
Por exemplo:
$ sudo oci-iscsi-config show --details --no-truncate Currently attached iSCSI devices: Target | Volume name | Volume OCID | Persistent portal | Current portal |Session State|Attached device| Size | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- iqn.2015-12.com.oracleiaas:exampleuniqueID| mor-demo-bv20 |ocid1.volume.oc1.iad.OCID | 172.16.10.4:3260 | 172.16.10.4:3260 | LOGGED_IN | sdb | 50G | Block volumes information: Name | Size | Attached to | OCID | IQN | Compartment |Availability domain| ------------------------------------------------------------------------------------------------------------------------------------------------------------ mor-demo-bv30 | 50GB | - |ocid1.volume.oc1.iad.OCID| - | virtdoc.dev |DSdu:US-ASHBURN-AD-3|
-
Opcionalmente, altere a apresentação de saída para ser mais legível usando a opção
--output-mode
com o subcomandooci-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.
Opção |
Descrição |
---|---|
|
Exibe todos os dispositivos iSCSI. Por padrão, somente os dispositivos que não estiverem anexados a uma instância serão listados. |
|
Exibe dispositivos iSCSI no compartimento fornecido ou em todos os compartimentos (se |
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.
Opção |
Descrição |
---|---|
|
Define o nome para exibição do volume. Evite digitar informações confidenciais no nome para exibição. |
|
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.
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.
Opção |
Descrição |
---|---|
|
Uma lista separada por vírgulas dos nomes qualificados de iqns (iSCSI) do dispositivo ou dispositivos iSCSI a serem anexados à instância. |
|
Uma lista separada por vírgulas dos OCIDs do dispositivo iSCSI, ou dispositivos, a serem anexados à instância. |
|
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. |
|
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. |
|
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.
Opção |
Descrição |
---|---|
|
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.
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.
Opção |
Descrição |
---|---|
|
Continua a desinstalação mesmo que não seja possível desmontar o dispositivo. |
|
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
.
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.
Opção |
Descrição |
---|---|
|
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.
Opção |
Descrição |
---|---|
|
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. |
|
Usado com a opção |
|
Usado com a opção |
|
Usado com a opção |
|
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: |
|
Obtenha ou atualize os metadados da instância com o OCID específico. Por padrão, o |
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.
Subcomando |
Para obter mais informações, consulte... |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
Excluindo a Configuração de IP para VNICs Secundárias Provisionadas |
|
|
|
|
|
|
|
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.
Opção |
Descrição |
---|---|
|
Inclui um endereço IP ou uma interface VLAN que foi excluída anteriormente usando a opção |
|
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 |
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.
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.
Opção |
Descrição |
---|---|
|
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. |
|
Designa um endereço IPv4 à VNIC. Se a opção |
|
Designa um endereço IPv6 à VNIC. Se a opção 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 # sudo oci-network-config attach-vnic --ipv6 Attaching a vnic with a primary ipv6 address is not yet supported by OCI. |
|
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. |
|
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 |
|
Define o nome para exibição da VNIC. Evite digitar informações confidenciais. |
|
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.
Opção |
Descrição |
---|---|
|
Ao configurar, coloque as interfaces no namespace identificado pelo formato fornecido. O formato pode incluir variáveis |
|
Inicie |
|
Inclui um endereço IP ou uma interface VLAN que foi excluída anteriormente usando a opção |
|
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 |
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.
Opção |
Descrição |
---|---|
|
Mostra informações sobre a VNIC que corresponde ao OCID (Oracle Cloud Identifier) fornecido. |
|
Mostra informações sobre a VNIC associada ao nome fornecido. |
|
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.
Opção |
Descrição |
---|---|
|
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. |
|
Especifica que um endereço secundário privado IPv6 seja adicionado a uma VNIC existente. |
|
Especifica o endereço IP privado secundário a ser adicionado à VNIC. |
|
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.
Opção |
Descrição |
---|---|
|
Inclui um endereço IP ou uma interface VLAN que foi excluída anteriormente usando a opção |
|
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 |
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.
Opção |
Descrição |
---|---|
|
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.
Opção |
Descrição |
---|---|
|
Desanexa a VNIC com o endereço IP fornecido. |
|
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.
Opção |
Descrição |
---|---|
|
Exiba a VCN com o OCID fornecido. |
|
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.
Opção |
Descrição |
---|---|
|
Mostra informações sobre a sub-rede que corresponde ao OCID (Oracle Cloud Identifier) fornecido. |
|
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.
Subcomando |
Para obter mais informações, consulte... |
---|---|
|
Configurando um Tópico do Serviço Notifications em uma Instância |
|
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.
Opção |
Descrição |
---|---|
|
Especifique o título a ser usado no cabeçalho da mensagem (por exemplo, |
|
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
.
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ção |
Descrição |
---|---|
|
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. |
|
Especifica o endereço IP de origem a ser usado. |
|
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ção |
Descrição |
---|---|
|
Obrigatório. A chave para identificar o volume. O valor KEY pode ser o OCID, IQN ou o nome para exibição do volume. |
|
Especifica o endereço IP de origem a ser usado. |
|
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 :
|
|
Mostra todos os itens ou valores na saída. |
|
Mostra informações detalhadas na saída. |
|
Permite definir como a saída do utilitário é exibida. Veja a seguir os modos de utilitário do OCI disponíveis:
|
|
Não encurta os valores na saída exibida. |
|
Encurta os valores na saída exibida. |
|
Responde "yes" em todos os prompts. |
|
Responde "não" em todos os prompts. |
|
Suprime mensagens de informações. |
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