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 “Gerenciamento de grupos de recursos ”.
• Localização: A região de nuvem da implantação. Na 2ª geração, o serviço “ Databases for MongoDB ” está disponível atualmente apenas em Montreal (ca-mon), Chennai - Airtel (in-che), Mumbai (in-mum), Frankfurt (eu-de), Washington (us-east), Madri (eu-es), Sydney (au-syd), Dallas (us-south) e Londres (eu-gb).

Selecione a plataforma para sua implantação.

• Gen 1: a plataforma original da IBM Cloud®, disponível em todos os data centers da IBM Cloud.
• Gen 2: a mais recente plataforma da IBM Cloud®, baseada em uma arquitetura de rede definida por software altamente segura. O Gen 2 foi otimizado para aplicativos nativos da nuvem e, no momento, está disponível apenas em Montreal, Chennai, Mumbai, Frankfurt, Madri, Sydney, Washington e Londres.

Para obter mais detalhes, consulte a Visão geral da 1ª geração(Clássica)e da 2ª geração(VPC).

Modelo de hospedagem

Na Gen 2, o único modelo de hospedagem disponível é o Isolated, que é uma oferta segura de locação exclusiva para cargas de trabalho corporativas complexas e de alto desempenho. Para obter mais informações, consulte “Isolated Compute ”.

Alocação de recurso

Escolha o tamanho inicial do host e a configuração do disco para sua implantação. O tamanho do host e a alocação de disco se aplicam a cada membro da instância.

• Tamanho do servidor: Escolha entre as configurações disponíveis de vCPU e e memória RAM para atender às necessidades da sua carga de trabalho.
• Disco: Configure o tamanho inicial do disco para sua implantação. Use o controle deslizante para definir a capacidade do disco. O tamanho do disco determina a alocação de IOPS. Cada GB de disco oferece 5 IOPS.

O tamanho do disco pode ser aumentado após o provisionamento, mas não pode ser reduzido para evitar a perda de dados.

Configuração de serviço

• Versão do banco de dados: Set only at deployment Esta é a versão da sua implantação do MongoDB. O console destaca a versão recomendada para garantir o desempenho ideal. Para obter mais informações, consulte a política de controle de versões.
• Edição do banco de dados: Set only at deployment Na 2ª geração, apenas a edição Standard está disponível.
• Criptografia: Set only at deployment Se você usarKey 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.
• Endpoints Set only at deployment[Set only at deployment- Para a 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, será importante alternar para uma senha descartável (ibmcloud login --sso) ou usar uma chave de API (ibmcloud --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. É possível provisionar instâncias d IBM Cloud® Databases for MongoDB no modelo de hospedagem Isolated Compute na plataforma Gen 2.

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 '{"host_flavor": "<host_flavor value>"}'
   

   Por exemplo, para provisionar uma instância do Databases for MongoDB, use um comando como:

   ibmcloud resource service-instance-create test-database databases-for-mongodb standard-gen2 us-south -p '{"host_flavor": "bx3d.4x20.encrypted", "storage_gb": 10 }'
   

   Provisione uma instância isolada do Databases for MongoDB com o mesmo parâmetro host_flavor -p, 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 2.

   Como a seleção de planos oferecida aos membros inclui opções de capacidade de CPU e RAM (bx3d.4x20.encrypted oferece 4 CPUs e 20 de RAM), esta solicitação não permite tanto a seleção de um plano “Isolated” quanto a escolha separada de alocações de CPU e RAM.

   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 usado 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 MongoDB, use databases-for-mongodb.
   SERVICE_PLAN_NAME Required	standard-gen2
   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
   host_flavor	Para provisionar uma instância de computação isolada, acesse {"host_flavor": "<host_flavor value>"}. Para o Isolated Compute, selecione a configuração desejada de CPU e RAM. Para obter mais informações, consulte a Tabela 2 a seguir.

   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-mongodb: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>
   

   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-mongodb:us-south:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
   GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
   Location:              <LOCATION>
   Service Name:          databases-for-mongodb
   Service Plan Name:     standard-gen2
   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 mongodb with version 7.17 (100%)
   

   • Opcional: Para excluir uma instância de serviço, execute o seguinte comando:

   ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
   

O parâmetro host_flavor

O parâmetro host_flavor define o dimensionamento do Compute. Para provisionar uma instância de computação isolada, insira o valor adequado para a configuração desejada de CPU e RAM.

O parâmetro --parameters

O comando service-instance-create suporta o sinalizador -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 exigir um host maior, com o tamanho 16x80, o comando ficaria assim:

ibmcloud resource service-instance-create databases-for-mongodb <SERVICE_NAME> standard-gen2 us-south \
-p \ '{
  "backup_id": "crn:v1:blue:public:databases-for-mongodb:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "host_flavor": "bx3d.16x80.encrypted"
}'

Exemplo

Para criar uma instância de computação isolada, siga este exemplo:

```sh {: pre}
  curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: Bearer <IAM token>" -H 'Content-Type: application/json' -d '{
  "name": "my-instance",
  "target": "ca-mon",
  "resource_group": "5c49eabc-f5e8-5881-a37e-2d100a33b3df",
  "resource_plan_id": databases-for-mongodb-gen2-standard",
  "dataservices": {
    "mongodb": {
        "storage_gb": 10,
        "host_flavor": "bx3d.4x20.encrypted"
      },
    "encryption": {
      "disk": "crn:v1..."
    },
    "version": "8",
  },
}'
```
Providencie uma instância isolada do Databases for MongoDB 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 2](#members_host-flavor-parameter-api). Por exemplo, `{"host_flavor": "bx3d.4x20.encrypted"}`.

Como a seleção de planos oferecida aos membros inclui opções de capacidade de CPU e RAM (bx3d.4x20.encrypted oferece 4 CPUs e 20 de RAM), esta solicitação não permite tanto a seleção de um plano “Isolated” quanto a escolha separada de alocações de CPU e RAM.

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

O parâmetro host_flavor

O parâmetro host_flavor define o dimensionamento do Compute. Para provisionar uma instância de computação isolada, insira o valor adequado para a configuração desejada de CPU e RAM.

Lista de parâmetros adicionais

No objeto --parameters , você pode fornecer informações adicionais para criar sua instância de serviço, incluindo:

• backup_id - Um CRN de um recurso de backup a partir do qual restaurar.. O backup deve ser criado por meio de uma implantação de banco de dados com o mesmo ID de serviço. O backup é carregado após o fornecimento e a nova implementação que usa esses dados é inicializada. Um CRN de backup está no formato crn:v1:<...>:backup:<uuid>. Se omitido, o banco de dados será provisionado vazio.
• version - A versão do banco de dados a ser provisionado. Se omitido, o banco de dados será criado com a versão principal e secundária mais recentes.
• disk_encryption_key_crn- O CRN de uma chave KMS ( Key Protect ), que é então usado para criptografia de disco. O CRN de uma chave KMS tem o formato crn:v1:<...>:key:<id>.
• backup_encryption_key_crn- O CRN de uma chave KMS ( Key Protect ), que é então usado para a criptografia do backup. O CRN de uma chave KMS tem o formato crn:v1:<...>:key:<id>.

Para usar uma chave em seus backups, você deve primeiro [habilitar a delegação entre serviços](/docs/cloud-databases?topic=cloud-databases-key-protect&interface=api#key-byok).
{: note}

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

Providencie uma instância isolada do Databases for MongoDB 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": "bx3d.4x20.encrypted"}. Observe que, como a seleção do tipo de host inclui os tamanhos de CPU e RAM (bx3d.4x20.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.

data "ibm_resource_group" "group" {
  name = "<your_group>"
}
resource "ibm_database" "<your_database>" {
  name              = "<your_database_name>"
  plan              = "standard"
  location          = "eu-gb"
  service           = "databases-for-mongodb"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  adminpassword                = "password12"
  group {
    group_id = "member"
    host_flavor {
      id = "bx3d.4x20.encrypted"
    }
    disk {
      allocation_mb = 256000
    }
  }
  users {
    name     = "user123"
    password = "password12"
  }
  allowlist {
    address     = "172.168.1.1/32"
    description = "desc"
  }
}
output "ICD MongoDB database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

O parâmetro host flavor

O parâmetro host_flavor define o dimensionamento do Compute. Para provisionar uma instância de computação isolada, insira o valor adequado para a configuração desejada de CPU e RAM. Consulte os valores na tabela a seguir.