Documentação do Oracle Cloud Infrastructure

Criando um Pool de Instâncias

No Compute Cloud@Customer, você pode criar um pool de instâncias que estão na mesma região.

A execução de operações como redefinir ou excluir no objeto de 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 seja membro do pool não afeta outras instâncias de 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árias.

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 size forem iniciadas, o pool poderá fazer a transição para o estado Em Execução. Enquanto o pool estiver no estado Dimensionando, as instâncias do pool que estão no estado Em Execução estão disponíveis para uso.

Veja a seguir exemplos de ações que você pode executar se uma instância de pool não for iniciada por causa de 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 Console do Compute Cloud@Customer 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 está sendo 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 está sendo iniciada por causa de restrições de recursos.

Pré-requisito

Para que possa criar um pool de instâncias, você precisa de uma configuração de instância. Uma configuração de instância é um modelo que define as configurações a serem usadas ao criar instâncias. Consulte Como Trabalhar com Configurações de Instância.

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

    1. No menu de navegação da Console do Compute Cloud@Customer, selecione Compute e, em seguida, selecione Configurações da 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: Digite 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 do pool de instâncias. Observe que as instâncias do pool serão criadas no compartimento especificado na configuração da instância.

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

      • Posicionamento do Pool: Selecione os Domínios de Falha, a VCN e a Sub-rede para instâncias neste pool de instâncias. Você pode selecionar outro compartimento do qual escolher a VCN e a Sub-rede. Consulte as descrições de Configuração de Colocação 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 essas instâncias do pool serão adicionadas.

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

        • Selecione a VNIC a ser usada ao adicionar a instância ao conjunto de backend. 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 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.

    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 denominadas 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 de Linha de Comando.

    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. Este é 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 essas instâncias do pool serão adicionadas: 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. Crie 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 esse pool, construa um argumento para a opção --load-balancers.

      Use o seguinte comando para mostrar o conteúdo do argumento de 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 de criação 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 depois adicionar novas instâncias ao pool, as novas instâncias terão o novo nome.

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

      Para listar as instâncias que pertencem a esse 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 seguinte comando mostra a mesma saída abreviada somente 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.