Gerenciando os grupos de posicionamento

Com grupos de posicionamento para o IBM Cloud® Virtual Private Cloud, é possível criar políticas para gerenciar cargas de trabalho de alta disponibilidade. É possível especificar uma opção de políticas de posicionamento para um grupo de instâncias fornecidas. Estas políticas podem ser usadas para influenciar o posicionamento físico de servidores virtuais VPC selecionados para atender a determinadas demandas de carga de trabalho.

Após a criação do grupo de posicionamento, é possível designar uma instância de servidor virtual selecionada ou um grupo de instâncias de servidor virtual ao grupo de posicionamento. Ao provisionar essas instâncias, elas são alocadas em um host de computação na zona designada para a instância, com base na estratégia do grupo de alocação. É possível usar o mesmo grupo de posicionamento para instâncias em várias VPCs.

Os grupos de posicionamento podem ser gerenciados com a IU, a CLI, a API ou o Terraform. É possível criar grupos de posicionamento extras, excluir recursos e exibir os detalhes dos grupos de posicionamento, que são úteis quando você designa grupos de posicionamento a instâncias. Além disso, todos os grupos de posicionamento existentes podem ser listados e renomeados se necessário.

Gerenciando o grupo de posicionamento no console

É possível gerenciar um grupo de posicionamento em seu IBM Cloud VPC usando o console do IBM Cloud.

Para concluir as tarefas de gerenciamento em seus grupos de posicionamento, conclua as etapas a seguir.

  1. No site IBM Cloud console, acesse o **ícone do menu de navegação Ícone do menu de navegação > Infraestrutura Ícone do VPC> Computação > Grupos de alocação.
  2. Na página Grupos de posicionamento para VPC, clique no ícone de Ações Ícone de mais ações para o posicionamento que você deseja gerenciar. É possível selecionar por meio das ações a seguir:
Ações disponíveis para grupos de colocação
Ação Descrição
Criar Criar um grupo de posicionamento
Excluir Se não precisar mais do grupo de posicionamento, será possível excluí-lo para removê-lo permanentemente de sua conta. Antes de poder excluir o grupo de posicionamento, primeiro deve-se excluir todas as instâncias de servidor virtual que estão designadas ao grupo de posicionamento.
Renomear Atualize o nome do grupo de posicionamento com um novo nome.

A VPC deve existir antes da criação de um grupo de posicionamento. Se a VPC não for criada primeiro, você receberá um erro quando criar o grupo de posicionamento e ele não será criado.

Criação do grupo de posicionamento no console

É possível criar um grupo de posicionamento em seu IBM Cloud VPC usando o console do IBM Cloud. Um grupo de posicionamento deve ser criado primeiro antes que uma instância possa usá-lo. Após a criação de um grupo de posicionamento, uma instância pode ser anexada a ele durante o fornecimento.

Use as seguintes etapas para criar um grupo de posicionamento:

  1. No site IBM Cloud console, acesse o **ícone do menu de navegação Ícone do menu de navegação > Infraestrutura Ícone do VPC> Computação > Grupos de alocação.
  2. Clique em Criar e insira as informações na Tabela 1 na página Novo posicionamento para VPC.
Campos necessários para criar um grupo de colocação
Campo Valor
Nome do grupo de posicionamento É necessário um nome de recurso exclusivo dentro da região para o seu grupo de posicionamento. Se você não especificar um nome, um nome será gerado e designado ao seu grupo de posicionamento.
Grupo de recursos Selecione o grupo de recursos que contém os recursos da conta e os usuários que você deseja que sejam capazes de acessar o grupo de posicionamento. Para obter mais informações sobre grupos de recursos, consulte Gerenciando grupos de recursos.
Região A região do grupo de posicionamento.
Tags de usuário Palavras-chave que são usadas para gerenciamento de perfil.
Estratégia de posicionamento Difusão de host - todas as instâncias fornecidas são colocadas em hosts separados que podem estar no mesmo rack.

Difusão de energia - todas as instâncias fornecidas são colocadas em racks diferentes com fontes de alimentação e de rede separadas. Cada rack também contém fontes de alimentação duplas de origens diferentes.

Criação de um grupo de alocação pela CLI

Um grupo de posicionamento deve ser criado primeiro antes que uma instância possa usá-lo. Após a criação de um grupo de posicionamento, uma instância pode ser anexada a ele durante o fornecimento.

Antes de Iniciar

  1. Certifique-se de fazer download, instalar e inicializar os seguintes plug-ins da CLI. Para obter mais informações, consulte Pré-requisitos da CLI.
    • CLI da IBM Cloud
    • O plug-in vpc-infrastructure
  2. Crie um IBM Cloud VPC.

Coleta de informações para criar um grupo de alocação na CLI

Pronto para criar um grupo de posicionamento? Antes de executar o comando ibmcloud is placement-group-create, é necessário saber as seguintes informações.

Reúna as informações necessárias a seguir:

Informações necessárias para criar um grupo de alocação usando a CLI
Campo Valor
Detalhes do grupo de posicionamento Opções
Estratégia A estratégia do grupo de posicionamento. host_spread ou power_spread
Nome O nome do grupo de posicionamento
ID do grupo de recursos O ID do grupo de recursos
Nome do grupo de recursos O nome do grupo de recursos

Criação do grupo de alocação pela CLI

É possível criar um grupo de posicionamento em seu IBM Cloud VPC usando a interface da linha de comandos (CLI).

Para criar um grupo de posicionamento usando a CLI, use o comando ibmcloud is placement-group-create. Especifique a estratégia de grupo de posicionamento para o grupo de posicionamento, o nome do grupo de posicionamento e a ID ou o nome do grupo de recursos.

O exemplo a seguir cria um grupo de alocação com uma estratégia de distribuição por host, denominado “ MyPlacementGroup ”, com o ID do grupo de recursos “ RESOURCE_GROUP_ID ”.

ibmcloud is placement-group-create --strategy host_spread --name MyPlacementGroup --resource-group-id RESOURCE_GROUP_ID

Criando um grupo de posicionamento com a API

É possível criar um grupo de posicionamento em seu IBM Cloud VPC usando a API.

Um grupo de posicionamento deve ser criado primeiro antes que uma instância possa usá-lo. Após a criação de um grupo de posicionamento, uma instância pode ser anexada a ele durante o fornecimento.

O exemplo a seguir cria um grupo de posicionamento que usa a estratégia do grupo de posicionamento de difusão de host.

curl -X POST "$vpc_api_endpoint/v1/placement_groups?version=2021-04-20&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-placement-group"
      "strategy": "host_spread"
    }'

Para obter mais informações sobre as variáveis de estratégia host_spread e power_spread, consulte Criar um grupo de posicionamento na documentação da API da Virtual Private Cloud.

Criando o grupo de posicionamento com o Terraform

É possível criar um grupo de posicionamento em seu IBM Cloud VPC usando o Terraform.

Um grupo de posicionamento deve ser criado primeiro antes que uma instância possa usá-lo. Após a criação de um grupo de posicionamento, uma instância pode ser anexada a ele durante o fornecimento.

Antes de Iniciar

Certifique-se de configurar o Terraform for VPC.

O exemplo a seguir cria um grupo de alocação com uma estratégia de distribuição por host chamada “ my-placement-group ” e um grupo de recursos chamado “ data.ibm_resource_group.default.id ”.

resource "ibm_is_placement_group" "is_placement_group" {
  strategy = "host_spread"
  name = "my-placement-group"
  resource_group = data.ibm_resource_group.default.id
}

Para obter mais informações sobre as variáveis de estratégia host_spread e power_spread, consulte Criar um grupo de posicionamento na documentação da API da Virtual Private Cloud.

Alteração do nome do grupo de posicionamento no console

É possível atualizar o nome de um grupo de posicionamento em seu IBM Cloud VPC usando o console do IBM Cloud.

Para renomear um grupo de posicionamento:

  1. No site IBM Cloud console, acesse o **ícone do menu de navegação Ícone do menu de navegação > Infraestrutura Ícone do VPC> Computação > Grupos de alocação.
  2. Selecione o grupo de posicionamento e clique em Renomear.
  3. Mude o nome do grupo de posicionamento.

Alteração do nome do grupo de alocação pela CLI

É possível atualizar o nome de um grupo de posicionamento em seu IBM Cloud VPC usando a interface da linha de comandos (CLI).

Para atualizar o nome do grupo de posicionamento usando a CLI, use o comando ibmcloud is placement-group-update. Especifique o ID ou o nome do grupo de posicionamento e o novo nome do grupo de posicionamento.

O exemplo a seguir atualiza o grupo de veiculação com o ID 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 para o nome new-name.

ibmcloud is placement-group-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name NEW_NAME

Mudando o nome do grupo de posicionamento com a API

É possível atualizar o nome de um grupo de posicionamento em seu IBM Cloud VPC usando a API. O exemplo a seguir atualiza o nome do grupo de posicionamento com o novo nome my-updated=placement-group.

curl -X PATCH "$vpc_api_endpoint/v1/placement_groups/$id?version=2021-05-04&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-updated-placement-group",
    }'

Mudando o nome do grupo de posicionamento com o Terraform

É possível atualizar o nome de um grupo de posicionamento em seu IBM Cloud VPC usando o Terraform.

O exemplo a seguir atualiza o grupo de veiculação com o ID is_placement_group para o nome my-placement-group-modified.

resource "ibm_is_placement_group" "is_placement_group" {
  strategy = "host_spread"
  name = "my-placement-group-modified"
  resource_group = data.ibm_resource_group.default.id
}

Excluindo um grupo de posicionamento com a UI

É possível excluir um grupo de posicionamento em seu IBM Cloud VPC usando o console do IBM Cloud. Um grupo de posicionamento não pode ser excluído se instâncias estiverem anexadas a ele. Todas as instâncias devem ser removidas primeiro. Para obter mais informações sobre como excluir uma instância de nuvem privada virtual e seus recursos associados, consulte Excluindo uma VPC.

Use as seguintes etapas para excluir um grupo de posicionamento:

  1. No site IBM Cloud console, acesse o **ícone do menu de navegação Ícone do menu de navegação > Infraestrutura Ícone do VPC> Computação > Grupos de alocação.
  2. Selecione o grupo de posicionamento e clique em Excluir.
  3. Uma mensagem de confirmação é exibida. Clique em Excluir.

Excluindo um grupo de posicionamento com a CLI

É possível excluir um grupo de posicionamento em seu IBM Cloud VPC usando a interface da linha de comandos (CLI). Um grupo de posicionamento não pode ser excluído se instâncias estiverem anexadas a ele. Todas as instâncias devem ser removidas primeiro. Para obter mais informações sobre como excluir uma instância de nuvem privada virtual e seus recursos associados, consulte Excluindo uma VPC.

Para excluir grupo de posicionamento usando a CLI, use o comando ibmcloud is placement-group-delete. Especifique a ID ou o nome do grupo de posicionamento.

O exemplo a seguir exclui um grupo de posicionamento com a ID ou o nome PLACEMENT_GROUP.

ibmcloud is placement-group-delete PLACEMENT_GROUP --output JSON

Excluindo um grupo de posicionamento com a API

Um grupo de posicionamento não pode ser excluído se instâncias estiverem anexadas a ele. Todas as instâncias devem ser removidas primeiro. Para obter mais informações sobre como excluir uma instância de nuvem privada virtual e seus recursos associados, consulte Excluindo uma VPC.

O exemplo a seguir exclui o grupo de posicionamento.

curl -X DELETE "$vpc_api_endpoint/v1/placement_groups/$id?version=2021-04-20&generation=2" -H "Authorization: Bearer $iam_token"

Excluindo um grupo de posicionamento com o Terraform

É possível excluir um grupo de posicionamento em seu IBM Cloud VPC usando o Terraform. Um grupo de posicionamento não pode ser excluído se instâncias estiverem anexadas a ele. Todas as instâncias devem ser removidas primeiro. Para obter mais informações sobre como excluir uma instância de nuvem privada virtual e seus recursos associados, consulte Excluindo uma VPC.

O exemplo a seguir exclui um grupo de posicionamento chamado PLACEMENT_GROUP.

terraform destroy -target=ibm_is_placement_group.is_placement_group

Listando todos os grupos de posicionamento com a UI

É possível gerar uma lista de grupos de posicionamento para uma região.

Para exibir uma lista de todos os grupos de posicionamento existentes:

  1. No site IBM Cloud console, acesse o **ícone do menu de navegação Ícone do menu de navegação > Infraestrutura Ícone do VPC> Computação > Grupos de alocação.
  2. Todos os grupos de posicionamento existentes são exibidos.

Listando todos os grupos de posicionamento com a CLI

É possível gerar uma lista de grupos de posicionamento para uma região. Você pode listar todos os grupos de alocação existentes no seu IBM Cloud VPC usando a interface de linha de comando (CLI).

Para listar todos os grupos de posicionamento existentes usando a CLI, use o comando ibmcloud is placement-groups.

O exemplo a seguir lista todos os grupos de posicionamento existentes.

ibmcloud is placement-groups --output JSON

Listando todos os grupos de posicionamento com a API

É possível gerar uma lista de grupos de posicionamento para uma região. O exemplo a seguir gera uma lista de todos os grupos de posicionamento.

curl -X GET "$vpc_api_endpoint/v1/placement_groups?version=2021-04-20&generation=2" -H "Authorization: Bearer $iam_token"

Listando todos os grupos de posicionamento com o Terraform

É possível gerar uma lista de grupos de posicionamento para uma região. É possível listar todos os grupos de posicionamento existentes em seu IBM Cloud VPC usando o Terraform.

O exemplo a seguir lista todos os grupos de posicionamento existentes.

data "ibm_is_placement_groups" "is_placement_groups" {
}

Visualizando detalhes do grupo de posicionamento com a UI

É possível visualizar detalhes sobre um grupo de alocação, como o nome do grupo, o grupo de recursos atribuído, o ID do grupo, a localização, a data de criação do grupo e a estratégia de alocação especificada.

Para visualizar detalhes sobre um grupo de posicionamento, conclua as etapas a seguir.

  1. No site IBM Cloud console, acesse o **ícone do menu de navegação Ícone do menu de navegação > Infraestrutura Ícone do VPC> Computação > Grupos de alocação.
  2. Clique no nome do grupo de posicionamento sobre o qual você deseja visualizar detalhes.

Visualizando detalhes do grupo de posicionamento com a CLI

É possível visualizar detalhes sobre um grupo de alocação, como o nome do grupo, o grupo de recursos atribuído, o ID do grupo, a localização, a data de criação do grupo e a estratégia de alocação especificada.

Você pode consultar os detalhes de um grupo de alocação no seu IBM Cloud VPC usando a interface de linha de comando (CLI).

Para recuperar os detalhes de um grupo de posicionamento usando a CLI, use o comando ibmcloud is placement-group. Especifique a ID ou o nome do grupo de posicionamento.

O exemplo a seguir recupera os detalhes de um grupo de colocação com a ID ou o nome PLACEMENT_GROUP.

ibmcloud is placement-group PLACEMENT_GROUP --output JSON

Visualizando detalhes do grupo de posicionamento com a API

É possível visualizar detalhes sobre um grupo de alocação, como o nome do grupo, o grupo de recursos atribuído, o ID do grupo, a localização, a data de criação do grupo e a estratégia de alocação especificada.

O exemplo a seguir recupera um grupo de posicionamento único que é especificado pelo identificador na URL.

curl -X GET "$vpc_api_endpoint/v1/placement_groups/$id?version=2021-04-20&generation=2" -H "Authorization: Bearer $iam_token"

Visualizando detalhes do grupo de posicionamento com o Terraform

É possível visualizar detalhes sobre um grupo de alocação, como o nome do grupo, o grupo de recursos atribuído, o ID do grupo, a localização, a data de criação do grupo e a estratégia de alocação especificada.

Você pode obter os detalhes de um grupo de alocação no seu IBM Cloud VPC usando o Terraform.

O exemplo a seguir recupera detalhes para um único grupo de posicionamento com um ID de ibm_is_placement_group.is_placement_group.name.

data "ibm_is_placement_group" "d_is_placement_group" {
  name = ibm_is_placement_group.is_placement_group.name
}

Usando grupos de posicionamento com uma reserva

Tenha em mente as informações a seguir ao usar um grupo de colocação com uma reserva. Para obter mais informações sobre reservas, consulte Sobre reservas para VPC.

O suporte para uma instância com um grupo de posicionamento e um destino de reserva ainda não é suportado ainda.

Grupos de posicionamento e reservas são mutuamente exclusivos. O que significa que uma instância que é um membro de um grupo de posicionamento não pode ser criada ou atualizada para também destinar uma reserva. Tal solicitação de API POST ou PATCH resulta em um erro.