Localização e plataforma

• Localização — Escolha a região onde você deseja implantar seu banco de dados. Cada região da lista indica qual plataforma é compatível — Gen 1 ou Gen 2 — para ajudar na sua escolha.
• Plataforma — Selecione a plataforma na qual você deseja implantar seu banco de dados. As opções disponíveis dependem da região que você escolher. Para obter mais informações sobre as diferenças entre a 1ª geração e a 2ª geração, consulte a seção “Visão geral da 1ª geração e da 2ª geração ”.

Detalhes do serviço

• Nome do serviço — O nome pode ser qualquer sequência de caracteres e é o nome utilizado na web e na CLI para identificar a nova implantação.
• Grupo de recursos — Se você estiver organizando seus serviços em grupos de recursos, especifique o grupo de recursos neste campo. Caso contrário, é possível deixá-lo como o padrão. Para obter mais informações, consulte Gerenciando grupos de recursos.

Modelo de hospedagem

Para implantações da 2ª geração, apenas o modelo de hospedagem isolada está disponível.

Isolado: Oferta segura de ambiente de locatário único para cargas de trabalho corporativas complexas e de alto desempenho. Para obter mais informações, consulte Modelos de hospedagem.

Alocação de recurso

Ajuste com precisão a alocação de recursos. Use as tabelas para escolher o tamanho da máquina para cada componente da sua implantação e especifique o tamanho do disco.

Configuração de serviço

• Versão do banco de dados [Set only at deployment] {: tag-red}- A versão de implantação do seu banco de dados. Para garantir um desempenho ideal, execute a versão recomendada. Automaticamente, utiliza-se a versão secundária mais recente. Para obter mais informações, consulte a política de controle de versões.
• Criptografia — Se você usar Key Protect, é possível selecionar uma instância e uma chave para criptografar o disco da implantação. Se você não usar sua chave, a implementação criará e gerenciará automaticamente a própria chave de criptografia de disco.
• Pontos de extremidade Set only at deployment- Configure ospontos de extremidade do serviço em sua implantação. Na 2ª geração, apenas endpoints privados são suportados.

Depois de selecionar as configurações adequadas, clique em Criar para iniciar o processo de fornecimento.

Criar uma instância de serviço por meio da CLI

Antes do provisionamento, siga as instruções fornecidas na documentação para instalar a ferramenta CLI do IBM Cloud.

1. Efetue login no IBM Cloud. Se você usar um ID de usuário federado, é importante que mude para um código de acesso único (ibmcloud login --sso) ou utilize uma chave de API (ibmcloud login --apikey key or @key_file) para se autenticar. Para obter mais informações sobre como fazer login usando a CLI, consulte os comandos gerais da CLI(ibmcloud) em ibmcloud login.

   ibmcloud login
   

2. Selecione o modelo de hospedagem no qual deseja que seu banco de dados seja provisionado. É possível mudá-lo posteriormente.

3. Configure seu banco de dados com o seguinte comando:

   ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> <RESOURCE_GROUP> -p '{"members_host_flavor": "<members_host_flavor value>"}' --service-endpoints="<Endpoint>"
   

   Por exemplo, para provisionar uma instância do modelo de hospedagem “Shared Compute” do Databases for PostgreSQL, use um comando como:

   ibmcloud resource service-instance-create test-database databases-for-postgresql standard us-south -p '{"members_host_flavor": "multitenant", "members_memory_allocation_mb": "8192"}' --service-endpoints="private"
   

   Provisione uma instância isolada do Databases for PostgreSQL com o mesmo parâmetro "members_host_flavor" -p, definindo-o para o tamanho isolado desejado. Os tamanhos de hospedagem disponíveis e seus parâmetros de members_host_flavor value estão listados na Tabela 2. Por exemplo, {"members_host_flavor": "b3c.4x16.encrypted"}. Observe que, como a seleção do tipo de host inclui os tamanhos de CPU e RAM (b3c.4x16.encrypted corresponde a 4 CPUs e 16 de RAM), essa solicitação não aceita tanto a seleção do tamanho “Isolated” quanto seleções separadas de alocação de CPU e RAM.

   ibmcloud resource service-instance-create test-database databases-for-postgresql enterprise us-south -p '{"members_host_flavor": "b3c.4x16.encrypted"}' --service-endpoints="private"
   

   Os campos no comando estão descritos na tabela a seguir.

   Campos do formato básico de comando

   Campo	Descrição	Sinalize
   INSTANCE_NAME Required	O nome da instância pode ser qualquer sequência de caracteres e é o nome utilizado na web e na CLI para identificar a nova implantação.
   SERVICE_NAME Required	Nome ou ID do serviço. Para acessar o site Databases for PostgreSQL, use databases-for-postgresql.
   SERVICE_PLAN_NAME Required	Plano padrão (standard)
   LOCATION Required	O local onde você deseja fazer a implantação. Para obter uma lista de regiões, use o comando ibmcloud regions .
   RESOURCE_GROUP	O nome do grupo de recursos. O valor padrão é default.	-g
   --parameters	Arquivo JSON ou sequência JSON de parâmetros para criar a instância de serviço	-p
   members_host_flavor	Para provisionar uma instância de computação isolada, acesse {"members_host_flavor": "<members_host_flavor value>"}. Para o Isolated Compute, selecione a configuração desejada de CPU e RAM. Para obter mais informações, consulte a tabela a seguir ou a seção “Modelos de hospedagem ”.
   members	Defina como “ 1 ” para provisionar uma formação de um único nó, sem alta disponibilidade (HA). Omita esse parâmetro ou defina-o como “ 2 ” para provisionar a formação padrão de alta disponibilidade.
   --service-endpoints Required	Suporta apenas private.

   Você verá uma resposta como esta:

   Creating service instance INSTANCE_NAME in resource group default of account    USER...
   OK
   Service instance INSTANCE_NAME was created.
   Name:                INSTANCE_NAME
   ID:                  crn:v1:bluemix:public:databases-for-postgresql:us-south:a/   40ddc34a846383BGB5b60e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
   GUID:                dd13152c-fe15-4bb6-af94-fde0af56897
   Location:            LOCATION
   State:               provisioning
   Type:                service_instance
   Sub Type:            Public
   Service Endpoints:   private
   Allow Cleanup:       false
   Locked:              false
   Created at:          2023-06-26T19:42:07Z
   Updated at:          2023-06-26T19:42:07Z
   Last Operation:
                        Status    create in progress
                        Message   Started create instance operation
   

   • Para verificar o status do provisionamento, use o seguinte comando:

     ibmcloud resource service-instance <INSTANCE_NAME_OR_CRN>
     

     Quando terminar, você verá uma resposta como esta:

     Retrieving service instance INSTANCE_NAME in resource group default under account USER's Account as USER...
     OK
     Name:                  INSTANCE_NAME
     ID:                    crn:v1:bluemix:public:databases-for-postgresql:us-south:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
     GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
     Location:              <LOCATION>
     Service Name:          databases-for-postgresql
     Service Plan Name:     standard
     Resource Group Name:   default
     State:                 active
     Type:                  service_instance
     Sub Type:              Public
     Locked:                false
     Service Endpoints:     private
     Created at:            2023-06-26T19:42:07Z
     Created by:            USER
     Updated at:            2023-06-26T19:53:25Z
     Last Operation:
                            Status    create succeeded
                            Message   Provisioning postgresql with version 12 (100%)
     

   • (Opcional) Excluindo uma instância de serviço Exclua uma instância executando um comando como este:

     ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
     

O parâmetro members host flavor

O parâmetro members_host_flavor define o dimensionamento do Compute.

Para provisionar uma instância de computação isolada, especifique os valores de CPU e RAM que atendam à configuração desejada.

O dimensionamento automático de CPU e RAM não é compatível com o Isolated Compute d Cloud Databases; no entanto, o dimensionamento automático de disco é compatível. Monitore seus recursos com a integração do IBM Cloud® Monitoring, que acompanha o uso de memória, espaço em disco e E/S de disco. Para aumentar os recursos, faça o escalonamento da sua implantação manualmente.

O parâmetro --parameters

O comando service-instance-create suporta o parâmetro -p , que permite que parâmetros no formato JSON sejam passados para o processo de provisionamento. Por exemplo, você pode passar Nomes de Recursos na Nuvem (CRNs) como valores de parâmetros, os quais identificam de forma exclusiva um recurso na nuvem. Todos os nomes de parâmetros e valores são transmitidos como sequências.

Por exemplo, se um banco de dados estiver sendo provisionado a partir de um backup específico e a implantação do novo banco de dados precisar de um total de 12 GB de memória distribuídos entre três membros, o comando para provisionar 4 GB por membro seria o seguinte:

ibmcloud resource service-instance-create databases-for-postgresql <INSTANCE_NAME> standard us-south \
-p \ '{
  "backup_id": "crn:v1:blue:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "members_memory_allocation_mb": "4096"
}' --service-endpoints="private"

O parâmetro host flavor

O parâmetro members_host_flavor define o dimensionamento do Compute.

Para provisionar uma instância de computação isolada, especifique os valores de CPU e RAM que atendam à configuração desejada.

O dimensionamento automático de CPU e RAM não é compatível com o Isolated Compute d Cloud Databases; no entanto, o dimensionamento automático de disco é compatível. Monitore seus recursos com a integração do IBM Cloud® Monitoring, que acompanha o uso de memória, espaço em disco e E/S de disco. Para aumentar os recursos, faça o escalonamento da sua implantação manualmente.

Provisionamento de recursos de computação isolados com o Terraform

Providencie uma instância isolada do Databases for PostgreSQL com o mesmo parâmetro "host_flavor", definindo-o para o tamanho isolado desejado. Os tamanhos de hospedagem disponíveis e seus parâmetros de host_flavor value estão listados na Tabela 1. Por exemplo, {"host_flavor": "b3c.4x16.encrypted"}. Observe que, como a seleção do tipo de host inclui os tamanhos de CPU e RAM (b3c.4x16.encrypted corresponde a 4 CPUs e 16 de RAM), essa solicitação não aceita tanto a seleção do tamanho “Isolated” quanto seleções separadas de alocação de CPU e RAM.

O Gen 2 não fornece um usuário ou senha de administrador padrão. Crie uma credencial de serviço com a função “Manager” usando o ibm_resource_key para gerar credenciais de banco de dados após o provisionamento.

data "ibm_resource_group" "group" {
  name = "<your_group>"
}
resource "ibm_database" "<your_database>" {
  name              = "<your_database_name>"
  plan              = "standard"
  location          = "<region>"
  service           = "databases-for-postgresql"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  group {
    group_id = "member"
    host_flavor {
      id = "b3c.8x32.encrypted"
    }
    disk {
      allocation_mb = 256000
    }
  }
  allowlist {
    address     = "172.168.1.1/32"
    description = "desc"
  }
}
resource "ibm_resource_key" "this" {
  name                 = "<your_credential_name>"
  resource_instance_id = "<your_database_resource_instance_id>"
  parameters           = { "role" = "Manager" }
}

O parâmetro host flavor

O parâmetro host_flavor define o dimensionamento do Compute.

Computação isolada — Para provisionar uma instância de Computação isolada, especifique os valores de CPU e RAM que atendam à configuração desejada.

O dimensionamento automático de CPU e RAM não é compatível com o Isolated Compute d Cloud Databases; no entanto, o dimensionamento automático de disco é compatível. Monitore seus recursos com a integração do IBM Cloud® Monitoring, que acompanha o uso de memória, espaço em disco e E/S de disco. Para aumentar os recursos, faça o escalonamento da sua implantação manualmente.