Criando uma Configuração de Instância com a Entrada de Valores de Configuração

No Private Cloud Appliance, você pode criar uma configuração de instância informando valores para definições de configuração de instância individuais.

Observação

Se você especificar um tamanho de volume de inicialização maior que o padrão, será necessário aumentar o volume para aproveitar o tamanho maior. Consulte Redimensionando Volumes.

Evite inserir informações confidenciais em nomes e tags.

1. No menu de navegação UI do Compute Web, selecione Compute e, em seguida, Configurações de Instância.
2. Selecione Criar Configuração da Instância.
3. Na caixa de diálogo Criar Configuração da Instância, especifique as seguintes informações:
  
  Nome: Informe um nome para a configuração da instância.
  
  Criar no compartimento: Selecione o compartimento no qual deseja que esta configuração de instância seja criada.
  
  Compartimento para criar instâncias em: Selecione o compartimento em que deseja que as instâncias sejam criadas.
  
  Domínio de Falha: (Opcional) Você pode selecionar um domínio de falha. Por padrão, o sistema seleciona automaticamente o melhor domínio de falha para instâncias. Se você especificar um domínio de falha e o domínio de falha solicitado não puder acomodar a instância, a inicialização da instância falhará. Consulte mais informações sobre domínios de falha em Criando uma Instância.
  
  Imagem de Origem: Selecione uma imagem ou um volume de inicialização.
  
  Selecione o Tipo de Origem:
  
  Imagem da Plataforma: Selecione para criar uma instância com base em uma das imagens do Oracle Linux e do Oracle Solaris disponíveis em todos os compartimentos. Consulte Imagens da Plataforma Private Cloud Appliance.
  
  Imagem Personalizada: selecionável se uma imagem personalizada tiver sido criada. Talvez você precise selecionar o compartimento no qual a imagem personalizada está localizada. Consulte Gerenciando Imagens Personalizadas.
  
  Volume de Inicialização: Selecione para criar a instância com base em um volume de inicialização existente. Talvez seja necessário selecionar o compartimento no qual o volume de inicialização está localizado.
  
  Selecione uma imagem ou volume de inicialização na lista.
  
  Se você tiver selecionado Imagem da Plataforma, verá uma lista tabular com as colunas Sistema Operacional, Versão do Sistema Operacional e Criação de Imagem (a data em que a imagem foi criada). Você pode usar a seta do menu drop-down à direita da versão do sistema operacional para selecionar uma versão diferente. Por exemplo, para o Oracle Linux OS, você pode usar o menu suspenso para selecionar 9, 8 ou 7.9.
  
  Se você tiver selecionado Imagem Personalizada, verá uma lista tabular com as colunas Nome, Sistema Operacional e Versão do Sistema Operacional. Você pode usar as setas nos cabeçalhos de coluna para classificar a lista. Você pode filtrar a lista usando o menu drop-down Sistema Operacional acima da lista de imagens.
  
  Se você tiver selecionado Volume de Inicialização, verá uma lista tabular com as colunas Nome, Tamanho (GB) e Criado (a data em que o volume de inicialização foi criado). Você pode usar as setas nos cabeçalhos de coluna para classificar a lista. Na seção Volume de Inicialização (após a seção Forma), você pode personalizar o tamanho do volume de inicialização.
  
  Se a lista for muito longa para caber em uma exibição, use os botões de seta para exibir outra página da lista.
  
  Para usar uma imagem de plataforma que estava disponível anteriormente, mas não está mais listada, use a IU da Web do serviço Compute para criar a instância e especificar o OCID da imagem.
  
  Forma: Se você estiver usando uma imagem de plataforma, selecione VM.PCAStandard.E5. Flexibilize a forma e configure o número de OCPUs e memória.
  
  Para os valores de OCPU e memória, selecione dentro de cada campo de valor para ver os valores mínimo e máximo permitidos. A configuração de OCPU e memória pode ser alterada após a criação da instância.
  
  Para obter uma descrição da forma suportada, consulte Formas de Computação.
  
  Volume de Inicialização: (Opcional) Marque a caixa para especificar um tamanho de volume de inicialização personalizado ou uma definição de desempenho de volume.
  
  Tamanho do volume de inicialização (GB): O tamanho do volume de inicialização padrão para a imagem selecionada é mostrado. Para especificar um tamanho maior, insira um número inteiro de gigabytes até 16384 (16 TB) ou use as setas de incremento e de redução. Não é possível informar um valor menor que o tamanho padrão.
  
  Se você especificar um tamanho de volume personalizado de inicialização, será necessário aumentar o número de partições a fim de aproveitar o tamanho maior. As imagens da plataforma Oracle Linux incluem o pacote oci-utils. Use o comando oci-growfs desse pacote para estender a partição raiz e, em seguida, aumentar o sistema de arquivos. Para outros sistemas operacionais ou para imagens personalizadas, siga as instruções desse sistema operacional.
  
  Desempenho do volume de inicialização (VPUs): Use as setas de incremento e redução para alternar entre desempenho balanceado (10 VPUs/GB) e alto desempenho (20 VPUs/GB).
  
  Sub-rede: Selecione uma sub-rede.
  
  Selecione uma VCN na lista. Talvez você precise alterar o compartimento para o compartimento no qual a VCN está localizada.
  
  Selecione uma sub-rede.
  
  Endereço IP Público: Para usar o SSH para estabelecer conexão com as instâncias criadas com essa configuração de instância, marque a caixa Designar IP Público para que um endereço IP público seja designado às instâncias. Essa caixa será marcada por padrão se você especificar uma sub-rede pública. Se você não marcar essa caixa ou se desmarcar essa caixa e quiser designar um endereço IP público posteriormente, consulte Designando um Endereço IP Público Efêmero a uma Instância para obter instruções.
  
  VNICs Secundárias: (Opcional) Marque a caixa Criar VNIC Adicional para criar VNICs secundárias para instâncias criadas com essa configuração de instância. Para obter descrições das informações solicitadas, consulte Criando e Anexando uma VNIC Secundária.
  
  Endereço IP Privado: (Opcional) Especifique um endereço IP privado disponível no CIDR da sub-rede. Por padrão, um endereço IP privado é atribuído automaticamente.
  
  Observação
  
  Como o endereço IP privado deve ser exclusivo para cada instância, não especifique um endereço IP privado se você for usar essa configuração de instância para criar um pool de instâncias.
  
  Registro DNS: (Opcional) Marque a caixa Designar um registro DNS privado para designar um registro DNS às instâncias criadas com essa configuração de instância.
  
  Nome do Host: (Opcional) Informe um nome de host se você estiver usando DNS na rede na nuvem. O nome do host deve ser exclusivo em todas as VNICs da sub-rede.
  
  Observação
  
  Não especifique um nome de host se você for usar essa configuração de instância para criar um pool de instâncias.
  
  Por padrão, o nome da instância é usado para o nome do host. O nome do host também pode ser configurado no SO após a criação da instância.
  
  Se esta for uma instância do UNIX, consulte Criando um Ponto de Acesso NFS e Montando Sistemas de Arquivos em Instâncias baseadas no UNIX para obter mais informações sobre como definir o nome do host corretamente para montar sistemas de arquivos.
  
  Chaves SSH: Para estabelecer conexão com a instância usando SSH, forneça uma chave SSH pública.
  
  Observação
  
  Não é possível fornecer esta chave SSH após a criação da instância.
  
  Grupo de Segurança de Rede: (Opcional) Por padrão, as instâncias não são anexadas a nenhum NSG. Marque a caixa Ativar Grupo de Segurança de Rede para adicionar a VNIC principal dessa instância a um ou mais NSGs.
  
  Selecione um NSG na lista drop-down. Você pode precisar alterar o compartimento para localizar o NSG desejado.
  
  Selecione Adicionar Grupo de Segurança de Rede para anexar a outro NSG.
  
  Para remover um NSG da lista, selecione a lixeira à direita desse NSG. Para remover o último NSG ou todos os NSGs, desmarque a caixa Ativar Grupos de Segurança de Rede.
  
  Consulte Controlando o Tráfego com Grupos de Segurança de Rede para obter informações sobre NSGs.
  
  Opções de Instância: Marque a caixa para desativar Pontos Finais do Serviço de Metadados da Instância Legada. Por padrão, as rotas do IMDS (Instance Metadata Service) legado (/v1) são ativadas. Se você tiver feito upgrade de seus aplicativos para usar pontos finais /v2, marque esta caixa para desativar pontos finais /v1. Para obter mais informações sobre o Serviço de Metadados da Instância, consulte Recuperando Metadados da Instância de Dentro da Instância. Para obter mais informações sobre como fazer upgrade de seus aplicativos, consulte Upgrade para Pontos Finais do IMDS Versão 2.
  
  Configuração de disponibilidade: (Opcional) Por padrão, o sistema seleciona automaticamente a melhor opção de disponibilidade de instância durante uma operação de manutenção, como migração ao vivo. Marque a caixa Restaurar estado do ciclo de vida da instância após a manutenção da infraestrutura para especificar que as instâncias em execução devem ser reiniciadas automaticamente após um evento de manutenção. Se essa caixa não estiver marcada, a instância será recuperada no estado interrompido.
  
  Tagging: (Opcional) Adicione tags definidas ou de formato livre para esse recurso, conforme descrito em Adicionando Tags na Criação de Recursos. As tags também podem ser aplicadas posteriormente.
4. Selecione Criar Configuração da Instância.
Use o comando oci compute-management instance-configuration create e os parâmetros necessários para criar uma configuração de instância informando valores de configuração.
```
oci compute-management instance-configuration create -c <compartment_OCID> --display-name <IC_name> --instance-details file://<custom_config_file>.json
```
É no compartimento especificado que esta configuração de instância é criada. Esse compartimento pode ser diferente do compartimento especificado no arquivo JSON de detalhes da instância, que é onde as instâncias serão criadas.

O nome de exibição especificado é o nome da configuração da instância. Se você não fornecer um valor para a opção --display-name, o nome padrão da configuração da instância será instanceconfiguration YYYYMMDDhhmmss , em que YYYYMMDDhhmmss é a data e a hora de criação.

Para obter uma lista completa de comandos, flags e opções da CLI, consulte a Referência da Linha de Comandos.
Procedimento

Obtenha as seguintes informações:

O OCID do compartimento no qual você deseja criar esta configuração de instância.

O OCID do compartimento no qual você deseja que as instâncias que usam essa configuração de instância sejam criadas.

O nome do domínio de disponibilidade das instâncias que usam essa configuração de instância.

O OCID da imagem ou do volume de inicialização das instâncias que usam essa configuração de instância.

O nome da forma das instâncias que usam essa configuração de instância.

O OCID da sub-rede para instâncias que usam essa configuração de instância.

Crie o arquivo de configuração que fornece entrada para o comando de criação de configuração.

O arquivo de configuração é um arquivo JSON de pares de propriedade/valor.

Use o seguinte comando para gerar a sintaxe correta do arquivo de configuração e os nomes das propriedades:

$ oci compute-management instance-configuration create --generate-param-json-input instance-details > instance_details.json

Você não precisa de todos os dados que são gerados por esse comando. Copie apenas as informações necessárias, tendo o cuidado de manter cada propriedade em seu contexto correto.

Se você omitir a especificação do domínio de falha, o sistema selecionará automaticamente o melhor domínio de falha. Se você especificar apenas um único domínio de falha, todas as instâncias serão colocadas somente nesse domínio de falha.

Se um domínio de falha especificado não tiver recursos suficientes, as instâncias poderão falhar ao iniciar:

Quando você cria uma única instância (Usando uma Configuração de Instância para Criar uma Instância) e especifica um domínio de falha na configuração da instância, somente esse domínio de falha especificado é usado para criar a instância. Restrições de recurso podem fazer com que a inicialização da instância falhe.

Quando você cria instâncias em um pool, os domínios de falha especificados na configuração de posicionamento substituem os domínios de falha especificados na configuração da instância. Consulte Criando um Pool de Instâncias para mais informações.

Você pode especificar VNICs e sub-redes secundárias. Se você especificar um label de nome de host para uma VNIC secundária, o label de nome de host especificado deverá ser exclusivo em todas as VNICs da sub-rede. Se você fornecer um valor para a propriedade hostnameLabel, também deverá definir o valor de assignPrivateDnsRecord como true.

Se o label de nome de host especificado já estiver em uso na sub-rede, a inicialização da instância (Usando uma Configuração de Instância para Criar uma Instância) falhará com o erro "Nome do Host hostname já em uso para a sub-rede".

A propriedade hostnameLabel é ignorada quando você usa a configuração da instância para criar um pool de instâncias. Por padrão, o nome da instância é usado para o nome do host.

Se você omitir a propriedade assignPublicIp, um endereço IP público será designado por padrão se você especificar uma sub-rede pública. Se você definir essa propriedade como false e depois decidir designar um endereço IP público posteriormente, consulte Designando um Endereço IP Público Efêmero a uma Instância para obter instruções.

Se os usuários usarem ssh para estabelecer conexão com a instância, especifique a chave pública SSH como o valor da propriedade ssh_authorized_keys no bloco metadata. Não é possível adicionar a chave pública SSH após a criação da instância.

A propriedade displayName é usada para o nome da instância quando você usa o comando launch-compute-instance conforme descrito em Usando uma Configuração de Instância para Criar uma Instância. Se você não fornecer um valor para a propriedade displayName, o nome padrão das instâncias será instance YYYYMMDDhhmmss , em que YYYYMMDDhhmmss é a data e a hora de criação.

A propriedade displayName é ignorada quando você cria instâncias em um pool, conforme descrito em Criando um Pool de Instâncias.

O seguinte comando mostra quais propriedades são necessárias para criar uma instância:

$ oci compute instance launch -h

Role até a seção Parâmetros Obrigatórios. Os parâmetros opcionais são descritos abaixo dos parâmetros necessários.

Os nomes das propriedades no arquivo de configuração são semelhantes aos nomes das opções instance launch, mas diferentes deles. Além disso, algumas propriedades são organizadas em grupos de propriedades, como createVnicDetails, shapeConfig e sourceDetails, conforme mostrado no seguinte arquivo de configuração de exemplo:

{ "instanceType": "compute", "launchDetails": { "availabilityDomain": "AD-1", "compartmentId": "compartment_OCID", "createVnicDetails": { "assignPublicIp": true, "freeformTags": { "ConfigType": "Configuration for an XYZ instance." }, "subnetId": "subnet_OCID" }, "displayName": "instance_name", "instanceOptions": { "areLegacyImdsEndpointsDisabled": true }, "metadata": { "ssh_authorized_keys": "public_SSH_key" }, "shape": "shape_name", "shapeConfig": { "memoryInGBs": 512, "ocpus": 32 }, "sourceDetails": { "bootVolumeSizeInGBs": 100, "bootVolumeVpusPerGB": 20, "imageId": "image_OCID", "sourceType": "image" } } }

Use instanceOptions se precisar desativar pontos finais IMDSv1 para esta instância. Consulte Recuperando Metadados da Instância de Dentro da Instância.

Especifique a forma flexível, VM.PCAStandard.E5.Flex, e também especifique a configuração da forma. É necessário fornecer um valor para ocpus. A propriedade memoryInGBs é opcional; o valor padrão em gigabytes é 16 vezes o número de ocpus.

Para obter informações sobre o bootVolumeSizeInGBs, consulte "Tamanho do volume de inicialização" na guia CLI Criando uma Configuração de Instância com base em uma Instância.

Para obter informações sobre bootVolumeVpusPerGB, consulte "Alto Desempenho" na guia da CLI Criando uma Configuração de Instância com base em uma Instância. Quando as instâncias são iniciadas, o valor de bootVolumeVpusPerGB é null porque essa propriedade de volume de inicialização não é armazenada no objeto de instância após a instância ser iniciada. Para verificar o valor, use o comando get boot volume e veja o valor de vpus-per-gb.

Para alterar o valor da propriedade firmware, forneça um valor para a propriedade launchOptions. O valor padrão é BIOS. Como alternativa, você pode especificar UEFI_64. Outras propriedades no launchOptions não podem ser alteradas.

"launchOptions": { "bootVolumeType": "PARAVIRTUALIZED", "firmware": "UEFI_64", "isConsistentVolumeNamingEnabled": false, "isPvEncryptionInTransitEnabled": false, "networkType": "PARAVIRTUALIZED", "remoteDataVolumeType": "PARAVIRTUALIZED" }

Execute o comando create da configuração da instância.

Sintaxe:

oci compute-management instance-configuration create -c <compartment_OCID> --display-name <IC_name> --instance-details file://<custom_config_file>.json

É no compartimento especificado que esta configuração de instância é criada. Esse compartimento pode ser diferente do compartimento especificado no arquivo JSON de detalhes da instância, que é onde as instâncias serão criadas.

O nome de exibição especificado é o nome da configuração da instância. Se você não fornecer um valor para a opção --display-name, o nome padrão da configuração da instância será instanceconfiguration YYYYMMDDhhmmss , em que YYYYMMDDhhmmss é a data e a hora de criação.

A saída desse comando é a mesma do comando instance-configuration get.
Use a operação CreateInstanceConfiguration para criar uma configuração de instância que informe valores de configuração.

Para obter informações sobre como usar a API e assinar solicitações, consulte APIs REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando.

Documentação do Oracle Cloud Infrastructure

Criando uma Configuração de Instância com a Entrada de Valores de Configuração