Documentação do Oracle Cloud Infrastructure

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

No Compute Cloud@Customer, 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 estender o volume para tirar proveito do tamanho maior. Consulte Redimensionando Volumes.

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

Informações Importantes sobre o Uso de Imagens do Marketplace para Criar Instâncias

Na primeira vez que criar uma instância usando uma imagem do Marketplace, você deverá usar a Console do Compute Cloud@Customer para que possa aceitar o acordo do usuário. Depois disso, você pode usar a Console, a CLI e a API para criar instâncias com uma imagem do Marketplace.

Para manter a integridade das imagens do Marketplace, existem restrições e ações permitidas. Para obter mais informações, consulte Restrições de Imagem do Marketplace e Administração Permitida de Imagem do Marketplace.

    1. No menu de navegação da Console do Compute Cloud@Customer, selecione Compute e, em seguida, selecione Configurações da Instância.

    2. Selecione Criar Configuração da Instância.

    3. Na caixa de diálogo Criar Configuração de Instância, forneça as seguintes informações:

      • Nome: Informe um nome para a configuração da instância.

      • Criar no compartimento: Selecione o compartimento no qual você deseja que esta configuração de instância seja criada.

      • Compartimento no qual as instâncias serão criadas: Selecione o compartimento no qual você 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.

        1. 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 que estão disponíveis em cada compartimento. Consulte Imagens da Plataforma Compute Cloud@Customer.
          • 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 você precise selecionar o compartimento no qual o volume de inicialização está localizado.
          • Imagem do Marketplace: Selecionável se as imagens do Marketplace estiverem disponíveis no Compute Cloud@Customer. Consulte Imagens do Marketplace.

        2. Selecione uma imagem ou um 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 SO e Construção da Imagem (a data em que a imagem foi criada). Você pode usar a seta do menu suspenso à direita da versão do SO para selecionar uma versão diferente. Por exemplo, para o SO Oracle Linux, você pode usar o menu drop-down para selecionar 9, 8 ou 7.9.

          Se você selecionou Imagem Personalizada, verá uma lista tabular com as colunas Nome, Sistema Operacional e Versão do SO. Você pode usar as setas nos cabeçalhos das colunas para classificar a lista. Você pode filtrar a lista usando o menu drop-down Sistema Operacional acima da lista de imagens.

          Se você selecionou 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 das colunas 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 Console para criar a instância e especificar o OCID da imagem.

          Se você selecionou uma imagem do Marketplace, selecione uma imagem do Marketplace. Se esta for a primeira vez que você criou uma instância com esta imagem do Marketplace, um Painel do Acordo será exibido. Antes da criação da instância, selecione Aceitar Acordo e confirme o acordo.

      • Forma: Se você estiver usando uma imagem de plataforma, selecione VM.PCAStandard.E5. Forma flexível e configura 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, digite um número inteiro de gigabytes até 16384 (16 TB) ou use as setas de incremento e decréscimo. Não é possível informar um valor menor que o tamanho padrão.

          Se você especificar um tamanho de volume de inicialização personalizado, será necessário estender a partição para tirar proveito do 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 diminuição para alternar entre desempenho balanceado (10 VPUs/GB) e alto desempenho (20 VPUs/GB).

      • Sub-rede: Selecione uma sub-rede.

        1. Selecione uma VCN na lista. Talvez você precise alterar o compartimento para o compartimento no qual a VCN está localizada.

        2. Selecione uma sub-rede.

      • Endereço IP Público: Para usar SSH para estabelecer conexão com instâncias criadas com essa configuração de instância, marque a caixa Designar IP Público para ter um endereço IP público designado às instâncias. Esta caixa fica marcada por default se você especificou 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 é designado 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 de DNS: (Opcional) Marque a caixa Designar um registro de DNS privado para designar um registro de 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 o 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 sistema operacional após a criação da instância.

        Se esta for uma instância UNIX, consulte Criando um Ponto de Acesso NFS e Montando Sistemas de Arquivos em Instâncias Baseadas em UNIX para obter mais informações sobre como definir o nome do host corretamente para a montagem de 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 essa 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 desta instância a um ou mais NSGs.

        1. Selecione um NSG na lista suspensa. Talvez você precise alterar o compartimento para localizar o NSG desejado.

        2. Selecione Adicionar Grupo de Segurança de Rede para anexar a outro NSG.

        3. 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 da Instância: Marque a caixa para desativar Pontos Finais do Serviço de Metadados da Instância Legada. Por padrão, as rotas legadas (/v1) do Serviço de Metadados da Instância (IMDS) são ativadas. Se você tiver feito upgrade de seus aplicativos para usar pontos finais /v2, marque essa 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 Fazendo 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 esta caixa não estiver marcada, a instância será recuperada no estado interrompido.

      • Tagging: (Opcional) Adicione uma ou mais tags a esse recurso. As tags também podem ser aplicadas posteriormente. Para obter mais informações sobre tags de recursos, consulte Tags de Recurso.

    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

    O compartimento especificado é onde 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 para 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 de Linha de Comando.

    Procedimento

    1. Obtenha as seguintes informações:

      • O OCID do compartimento no qual 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 para instâncias que usam essa configuração de instância.

      • O OCID da imagem ou do volume de inicialização para 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.

    2. 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 gerados por esse comando. Copie apenas as informações necessárias, tendo cuidado para 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, talvez as instâncias não sejam iniciadas:

        • 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 recursos podem causar falha na inicialização da instância.

        • 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 obter 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, defina também 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 de 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 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 comando a seguir 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 obrigatórios.

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

      {
  "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. Forneça 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. Não é possível alterar outras propriedades em launchOptions.

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

    3. Execute o comando de criação 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

      O compartimento especificado é onde 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 para 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 que a saída 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.