Documentação do Oracle Cloud Infrastructure

Criando uma Configuração de Instância

As configurações de instâncias permitem que você especifique as definições a serem usadas na criação de instâncias de computação. Use uma configuração de instância nos seguintes cenários:

  • Para criar uma ou mais instâncias em um pool de instâncias.
  • Como modelo para iniciar instâncias individuais que não fazem parte de um pool.

Ao criar uma configuração de instância, você pode usar uma instância de computação existente como modelo ou pode fornecer uma lista de definições de configuração.

Opcionalmente, você pode especificar uma placa de interface de rede virtual (VNIC) secundária e volumes em blocos para anexar às instâncias criadas com base em uma configuração de instância. Para fazer isso, crie a configuração da instância fornecendo uma lista de definições de configuração.

Limitações e Considerações

  • Se você usar uma instância existente como modelo para criar uma configuração de instância, esteja ciente das seguintes informações:

    • A configuração da instância não inclui qualquer informação do volume de inicialização da instância, como aplicativos instalados, binários e arquivos da instância. Para criar uma configuração de instância que inclua a configuração personalizada de uma instância, primeiro crie uma imagem personalizada da instância e, em seguida, use a imagem personalizada para criar uma nova instância. Por fim, crie a configuração da instância com base na instância que você criou usando a imagem personalizada.
    • A configuração da instância não inclui o conteúdo de qualquer volume em blocos anexado à instância.
    • Quaisquer instâncias criadas com base na configuração da instância são colocadas no mesmo compartimento que a instância que foi usada como base para a configuração da instância, independentemente do compartimento da configuração da instância. Por exemplo, uma instância no compartimento A é usada para criar uma configuração de instância. Por exemplo, você usa uma instância no compartimento A como base para criar uma configuração de instância. Você coloca a configuração da instância no compartimento B. Quaisquer instâncias criadas usando essa configuração de instância serão localizadas no compartimento A, o mesmo compartimento da instância original.

  • Se você fornecer uma lista de definições de configuração para criar uma configuração de instância, esteja ciente das seguintes informações:

    • Quando você cria uma instância com base na configuração da instância, muitas das definições especificadas na configuração da instância não podem ser alteradas. Por exemplo, o domínio de disponibilidade, o compartimento, a imagem, a forma e a sub-rede não podem ser alterados quando você cria a instância.

    • Muitas das definições para criar configurações de instância são as mesmas do workflow criar instância de computação. No entanto, nem todas as definições estão disponíveis para configurações de instância. Para algumas definições, você pode fornecer um valor ao criar uma instância com base na configuração da instância.

      • Para o tipo de capacidade, você não pode selecionar capacidade preemptível ao criar a configuração da instância. No entanto, se você selecionar a capacidade sob demanda para a configuração da instância, as instâncias criadas com base na configuração da instância poderão usar a capacidade preemptível.

    • Para instâncias do Linux: Usando chaves SSH (Secure Shell) com configurações de instância:

      • Se você adicionar uma chave SSH ao criar a configuração da instância, essa chave SSH deverá ser usada para estabelecer conexão com todas as instâncias criadas com base na configuração da instância.
      • Depois de criar a configuração da instância, você não poderá alterar a chave SSH.
      • Se você criar uma configuração de instância sem uma chave SSH, poderá adicionar uma chave SSH a instâncias individuais criadas com base na configuração da instância.
      • Se você usar a configuração da instância para criar um pool de instâncias, deverá adicionar uma chave SSH ao criar a configuração da instância.
  • Quando um pool de instâncias cria instâncias no pool com base na configuração de uma instância, as definições do pool especificam o domínio de disponibilidade e a sub-rede, independentemente das definições na configuração da instância.
  • Se a configuração da instância estiver associada a uma reserva de capacidade, essa reserva será aplicada automaticamente a qualquer instância ou pools de instâncias criado com o uso dessa configuração de instância. Enquanto houver capacidade suficiente disponível, quando as instâncias forem iniciadas, elas usarão a capacidade da reserva associada.

Antes de começar

Se você estiver fornecendo uma lista de definições de configuração, prepare os seguintes itens:

  • Configure uma rede virtual na nuvem (VCN) para iniciar as instâncias criadas com base na configuração da instância. Para obter informações sobre a configuração de redes na nuvem, consulte Networking.
  • (Para instâncias do Linux) Se quiser usar sua própria chave SSH para estabelecer conexão usando SSH com as instâncias criadas na configuração da instância, você precisará da chave pública do par de chaves SSH que pretende usar. A chave deve estar no formato OpenSSH. Para obter mais informações, consulte Gerenciando Pares de Chaves em Instâncias do Linux.

  • Se quiser iniciar instâncias da configuração da instância usando um tipo de capacidade de host diferente da capacidade sob demanda, prepare a capacidade:

    • Para iniciar uma instância e tê-la em uma reserva de capacidade, você deve ter uma reserva de capacidade no mesmo domínio de disponibilidade da instância.
    • Para colocar uma instância em um host de máquina virtual dedicado, você deve ter um host de máquina virtual dedicado no mesmo domínio de disponibilidade e domínio de falha no qual deseja iniciar a instância.

    Os tipos de capacidade são mutuamente exclusivos.

Se quiser anexar volumes em blocos às instâncias criadas com base na configuração da instância, execute uma das seguintes ações:

  • Ao criar uma configuração de instância, você pode usar uma instância de computação existente como modelo ou pode fornecer uma lista de definições de configuração.

    Criar uma Configuração de Instância Usando uma Instância Existente como Modelo

    1. Abra o menu de navegação e clique em Compute. No serviço Compute, clique em Instâncias.
    2. Em Escopo da lista, selecione o compartimento que contém a instância que você deseja usar como modelo.
    3. Clique no nome da instância que deseja usar como modelo.
    4. Clique em Ações e em Criar configuração da instância.
    5. Selecione o compartimento no qual você deseja criar a configuração da instância.
    6. Especifique um nome para a configuração da instância. Ele não precisa ser exclusivo e você pode alterá-lo posteriormente. Evite digitar informações confidenciais.
    7. Para adicionar tags à configuração da instância, clique em Mostrar opções de tag e digite os valores de tag.

      Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore esta opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.

    8. Clique em Criar configuração de instância.

    Criar uma Configuração de Instância Fornecendo uma Lista de Definições

    1. Abra o menu de navegação e clique em Compute. Em Compute, clique em Configurações de Instâncias.
    2. Clique em Criar configuração de instância.
    3. Especifique um nome para a configuração da instância. Ele não precisa ser exclusivo e você pode alterá-lo posteriormente. Evite digitar informações confidenciais.
    4. Selecione o compartimento no qual você deseja criar a configuração da instância.
    5. Para adicionar tags à configuração da instância, clique em Mostrar opções de tag e digite os valores de tag.

      Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore esta opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.

    6. Na lista Compartimento no qual as instâncias serão criadas, selecione o compartimento no qual você deseja colocar as instâncias criadas nesta configuração de instância.

    7. Nas seções Definir Detalhes da Instância, Selecionar uma Imagem, Selecionar uma Forma e Configurar VNIC Principal, especifique os detalhes das instâncias criadas com base nessa configuração de instância.

      Para obter mais informações sobre as definições destas seções, consulte Criando uma Instância.

      Observação

      Para configurações de instâncias, em Tipo de capacidade, a Capacidade preemptível não é uma opção. No entanto, se você selecionar Capacidade sob demanda para a configuração de instância, as instâncias criadas com base nessa configuração de instância poderão usar capacidade preemptível.

    8. Se quiser criar uma VNIC secundária a ser anexada às instâncias criadas por meio dessa configuração de instância, na seção Rede, clique em Criar VNIC adicional. Em seguida, especifique os detalhes de configuração da VNIC secundária.

      Para obter mais informações sobre as definições nesta seção, consulte Para criar e anexar uma VNIC secundária.

    9. (Para instâncias do Linux) Na seção Adicionar chaves SSH, gerar um par de chaves SSH ou fazer upload da chave pública para as instâncias criadas nessa configuração de instância.

      Importante

      • Se você adicionar uma chave SSH ao criar a configuração da instância, essa chave SSH deverá ser usada para estabelecer conexão com todas as instâncias criadas com base na configuração da instância.
      • Depois de criar a configuração da instância com uma chave SSH, você não poderá alterar a chave SSH.
      • Se você criar uma configuração de instância sem uma chave SSH, poderá adicionar uma chave SSH a instâncias individuais criadas com base na configuração da instância.
      • Se você usar a configuração da instância para criar um pool de instâncias, adicione a chave SSH ao criar a configuração da instância.

      Para obter mais informações sobre as definições nesta seção, consulte Criando uma Instância. Para obter mais informações sobre chaves SSH, consulte Gerenciando Pares de Chave nas Instâncias do Linux.

      Cuidado

      Qualquer um que tenha acesso à chave privada pode estabelecer conexão com a instância. Armazene a chave privada em um local seguro.

    10. Especifique os detalhes do Volume de inicialização das instâncias criadas com base nessa configuração de instância.

      Para obter mais informações sobre as definições nesta seção, consulte Criando uma Instância.

    11. Se quiser anexar volumes em blocos às instâncias criadas com base nesta configuração de instância, na seção Volumes em blocos, clique em Anexar volume em blocos. Em seguida, especifique os detalhes da configuração do volume em blocos.

      Para obter mais informações sobre as definições nesta seção, consulte Anexando um Volume.

    12. Para configurar definições avançadas para as instâncias criadas com base nessa configuração de instância, como as tags adicionadas às instâncias, clique em Mostrar opções avançadas. Em seguida, especifique as definições.

      Para obter mais informações sobre as definições nesta seção, consulte Criando uma Instância.

    13. Clique em Criar.

  • Para criar uma configuração de instância usando a CLI, abra um prompt de comando e execute o comando instance-configuration create:

    oci compute-management instance-configuration create --compartment-id <COMPARTMENT_OCID> --instance-details <file://path/to/file.json>

    <file://path/to/file.json> é o caminho para um arquivo JSON que define os detalhes da instância. Para obter informações sobre como gerar um exemplo do arquivo JSON, consulte Opções Avançadas de JSON.

    Para obter informações sobre como usar a CLI, consulte Interface de Linha de Comando (CLI).

  • Para obter informações sobre como usar a API e assinar solicitações, consulte a documentação da API REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte SDKs e a CLI.

    Use a operação do CreateInstanceConfiguration para criar uma configuração de instância.