Documentação do Oracle Cloud Infrastructure

Criando um Pool de Instâncias

No Private Cloud Appliance, você pode criar um pool de instâncias que estejam dentro da mesma região.

A execução de operações como redefinição ou exclusão no objeto do pool executa essa operação em todas as instâncias que são membros do pool. A execução dessas operações em uma instância individual que é membro do pool não afeta nenhuma outra instância membro.

A criação de um pool de instâncias requer uma configuração de instância e uma configuração de posicionamento. As instâncias adicionadas ao pool em uma atualização de pool podem ser criadas com diferentes configurações de instância e posicionamento.

Para instâncias em um pool, o valor da propriedade displayName na configuração da instância é ignorado. As instâncias em um pool são denominadas inst-aaaaa-pool_name, em que aaaaa tem cinco caracteres alfanuméricos aleatórios.

Configuração de Posicionamento

Além de uma configuração de instância, a criação do pool requer uma configuração de posicionamento. Os valores especificados em uma configuração de posicionamento substituem os valores especificados na configuração da instância.

Uma configuração de posicionamento pode especificar domínios de falha, sub-rede principal e sub-redes de VNIC secundária.

Domínios de Falha

Se você não especificar um domínio de falha na configuração da instância ou na configuração de posicionamento, o sistema selecionará automaticamente os melhores domínios de falha para as instâncias do pool. Se você especificar apenas um único domínio de falha, todas as instâncias serão colocadas somente nesse domínio de falha. Se você especificar mais de um domínio de falha, as instâncias do pool serão colocadas nesses domínios de falha uniformemente, fornecendo melhor Alta Disponibilidade para o pool. Se um domínio de falha não puder acomodar instâncias adicionais, a criação da instância será interrompida. O sistema não colocará mais instâncias em um domínio de falha do que em outro.

Se algumas instâncias não puderem ser iniciadas por causa de restrições de recursos, essas instâncias permanecerão no estado Provisionamento e o pool permanecerá no estado Dimensionamento. Depois que as instâncias do size forem iniciadas, o pool poderá fazer a transição para o estado Em Execução. Enquanto o pool estiver no estado Dimensionamento, as instâncias do pool que estiverem no estado Em Execução estarão disponíveis para uso.

Estes são exemplos de ações que você pode executar se uma instância do pool falhar ao ser iniciada devido a restrições de recursos:

  • Atualize o pool e reduza o valor "Número de instâncias" ou size.

  • Atualize o pool e altere a especificação do Domínio de Falha na IU da Web do serviço Compute ou em uma nova instância ou configuração de posicionamento.

  • Atualize o pool para especificar uma nova configuração de instância que crie instâncias que exijam menos recursos.

  • Interrompa uma instância que não seja membro de um pool no mesmo domínio de falha em que a instância do pool não foi iniciada por causa de restrições de recursos.

  • Exclua uma instância que não seja membro de um pool no mesmo domínio de falha em que a instância do pool não foi iniciada por causa de restrições de recursos.

Pré-requisito

Para poder criar um pool de instâncias, você precisa de uma configuração de instância. Uma configuração da instância é um modelo que define as definições a serem utilizadas na criação das instâncias. Consulte Como trabalhar com configurações de instâncias.

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. Na parte superior da página, selecione o compartimento que contém a configuração de instância que você deseja usar para criar o pool.

    3. Selecione a configuração de instância que você deseja usar para as instâncias neste pool.

    4. Em Recursos, selecione Pools de Instâncias Anexados.
    5. Na parte superior da página, selecione outros compartimentos para listar pools em outros compartimentos.

      Selecione Criar Pool de Instâncias.

    6. Na caixa de diálogo Anexar Pool de Instâncias a instance_configuration_name, especifique as seguintes informações:

      • Nome: Informe um nome para o pool de instâncias. O nome não precisa ser exclusivo. Esse nome é usado nos nomes das instâncias criadas. Se você não fornecer um nome para o pool, o nome padrão do pool de instâncias será instancepoolYYYYMMDDhhmmss, em que YYYYMMDDhhmmss é a data e a hora de criação.

      • Criar no Compartimento: Selecione um compartimento para esta definição de pool de instâncias Observe que as instâncias no pool serão criadas no compartimento especificado na configuração da instância.

      • Número de instância: Especifique o número de instância a serem criadas nesse pool de instância.

      • Posicionamento de Pool: Selecione os Domínios de Falha, a VCN e a Sub-rede para instâncias nesse pool de instâncias. Você pode selecionar outro compartimento no qual escolher a VCN e a Sub-rede. Consulte as descrições de Configuração de Posicionamento e Domínios de Falha no início desta seção.

      • Balanceadores de Carga: Marque a caixa Anexar Balanceadores de Carga para especificar o balanceamento de carga para esse pool. Para obter informações sobre balanceamento de carga, consulte Balanceador de Carga como Serviço. Forneça as seguintes informações:

        • Selecione o balanceador de carga a ser anexado a este pool.

        • Selecione o conjunto de backend ao qual adicionar essas instâncias do pool.

        • Informe o número da porta nas instâncias nas quais o balanceador de carga deve direcionar tráfego.

        • Selecione a VNIC a ser usada ao adicionar a instância ao conjunto de back-end O endereço IP privado é usado.

        Para anexar outro balanceador de carga, selecione Adicionar Balanceador de Carga. Para anexar um balanceador de carga após a criação do pool de instâncias, consulte Gerenciando Anexos do Balanceador de Carga do Pool de Instâncias.

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

    7. Selecione Criar Pool de Instâncias.

      A página de detalhes do novo pool é exibida. As instâncias solicitadas são listadas na tabela Instâncias Anexadas na seção Recursos à medida que são criadas. As novas instâncias são nomeadas inst-aaaaa-pool_name, em que aaaaa tem cinco caracteres alfanuméricos aleatórios. Se você alterar o nome do pool e depois adicionar novas instâncias ao pool, as novas instâncias terão o novo nome.

      Selecione Solicitações de Serviço na caixa Recursos para verificar o status da criação do pool de instâncias.

  • Use o comando oci compute-management instance-pool create e os parâmetros necessários para criar um pool de instâncias.

    oci compute-management instance-pool create --compartment-id <compartment_OCID> --instance-configuration-id <instance-configuration_OCID> --placement-configurations <placement_configurations.json> [OPTIONS]

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

    Procedimento

    1. Obtenha as seguintes informações:

      • O OCID do compartimento no qual você deseja criar a definição do pool de instâncias: oci iam compartment list

        Observe que as instâncias no pool são criadas no compartimento especificado na configuração da instância.

      • O OCID da configuração da instância que você deseja usar: oci compute-management instance-configuration list

      • O tamanho do pool de instâncias. Esse é o número de instâncias de computação no pool de instâncias.

      • Se quiser balanceamento de carga para este pool, obtenha as seguintes informações:

        • OCID do balanceador de carga a ser anexado a este pool e nome do conjunto de backend ao qual adicionar estas instâncias de pool: oci lb load-balancer list

        • Valor da porta a ser usado ao criar o conjunto de backend.

        • VNIC a ser associada ao balanceador de carga. O valor pode ser PrimaryVnic ou o nome para exibição de uma das VNICs secundárias na configuração da instância associada ao pool de instâncias.

    2. Construa um argumento para a opção --placement-configurations.

      Consulte as descrições de Configuração de Posicionamento e Domínios de Falha no início desta seção.

      Use o seguinte comando para mostrar o conteúdo do argumento de configurações de posicionamento:

      $ oci compute-management instance-pool create --generate-param-json-input placement-configurations

    3. Se quiser balanceamento de carga para este pool, construa um argumento para a opção --load-balancers.

      Use o seguinte comando para mostrar o conteúdo do argumento balanceadores de carga:

      $ oci compute-management instance-pool create --generate-param-json-input load-balancers

      Para anexar um balanceador de carga após a criação do pool de instâncias, consulte Gerenciando Anexos do Balanceador de Carga do Pool de Instâncias.

    4. Execute o comando create do pool de instâncias.

      Sintaxe:

      oci compute-management instance-pool create -c compartment_OCID --instance-configuration-id instance_configuration_OCID --placement-configurations file://placement_configuration.json --size number_of_instances

      Exemplo:

      $ oci compute-management instance-pool create --compartment-id ocid1.compartment.unique_ID --display-name support-pool --instance-configuration-id ocid1.instanceConfiguration.unique_ID --placement-configurations file://./placement_configurations.json --load-balancers file://./load_balancers.json --size 10

      O valor da opção --display-name é o nome do pool. O nome do pool não precisa ser exclusivo. Se você não fornecer um valor para a opção --display-name, o nome padrão do pool de instâncias será instancepoolYYYYMMDDhhmmss, em que YYYYMMDDhhmmss é a data e a hora de criação.

      O nome do pool é usado nos nomes das instâncias. As instâncias em um pool são denominadas inst-aaaaa-pool_name, em que aaaaa tem cinco caracteres alfanuméricos aleatórios. Se você alterar o nome do pool e, em seguida, adicionar novas instâncias ao pool, as novas instâncias terão o novo nome.

      A saída desse comando é a mesma do comando instance-pool get. A lista de instâncias no pool não é mostrada.

      Para listar as instâncias que pertencem a este pool, use o seguinte comando:

      $ oci compute-management instance-pool list-instances -c <compartment_OCID> --instance-pool-id <instance_pool_OCID>

      A saída de cada instância é abreviada em comparação com a saída do comando instance get.

      O comando a seguir mostra a mesma saída abreviada apenas para a instância especificada:

      $ oci compute-management instance-pool-instance get --instance-id ocid1.instance.unique_ID \
--instance-pool-id ocid1.instancePool.unique_ID

  • Use a operação CreateInstancePool para criar um pool de instâncias.

    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.