Menu Docs
Página inicial do Docs
/
Corretor de serviço aberto do Atlas
/
comando de banco de dados

Distribuir um conjunto de réplicas

Importante

O Atlas Open Service Corretor está obsoleto. Em vez disso, use o Operador do MongoDB Atlas.

Um conjunto de réplicas é um grupo de sistemas do MongoDB que mantém o mesmo conjunto de dados. Os conjuntos de réplicas fornecem redundância e alta disponibilidade e são a base para todos os sistemas de produção.

Para saber mais sobre conjuntos de réplicas, consulte a Introdução à replicação no manual do MongoDB.

Você pode usar o Atlas Open Service Corretor para implantar um novo conjunto de réplica gerenciado pelo Atlas. Após a implantação, utilize o Atlas para gerenciar o monitoramento, os backups e a configuração de projetos, como emparelhamento de VPC ou cobrança.

Pré-requisitos

Você cria conjuntos de réplica do Atlas definindo um objeto. Para implantar um conjunto de réplica utilizando um objeto Kubernetes, você deve primeiro instalar o Atlas Open Service Corretor.

Considerações

Atlas Public API

O Atlas Open Service Corretor usa o endpoint Criar um Cluster da API Pública do Atlas para implantar conjuntos de réplicas. Quaisquer requisitos ou limitações da API também se aplicam ao Atlas Open Service Corretor.

Procedimento

1

Crie uma definição de recurso para seu conjunto de réplicas.

  1. Copie um dos seguintes exemplos de definição de recurso com base no escopo da sua instância do agente de serviços.

    Se você registrou a instância do Atlas Open Service Corretor como um ClusterServiceBroker com escopo de cluster , selecione Instância com escopo de cluster. Se você registrou a instância do Atlas Open Service Corretor como um ServiceBroker com escopo de namespace , selecione Instância com escopo de namespace.


    Copie o seguinte arquivo YAML, que você pode modificar para atender à configuração desejada:

    apiVersion: servicecatalog.k8s.io/v1beta1
    kind: ServiceInstance
    metadata:
      name: <CLUSTER_NAME>
      namespace: <NAMESPACE>
    spec:
      clusterServiceClassExternalName: <CLOUD_SERVICE_PROVIDER_CLASS>
      clusterServicePlanExternalName: <INSTANCE_SIZE_PLAN>
      parameters:
        cluster:
          providerSettings:
            regionName: <ATLAS_REGION>

    Copie o seguinte arquivo YAML, que você pode modificar para atender à configuração desejada:

    apiVersion: servicecatalog.k8s.io/v1beta1
    kind: ServiceInstance
    metadata:
      name: <CLUSTER_NAME>
      namespace: <NAMESPACE>
    spec:
      serviceClassExternalName: <CLOUD_SERVICE_PROVIDER_CLASS>
      servicePlanExternalName: <INSTANCE_SIZE_PLAN>
      parameters:
        cluster:
          providerSettings:
            regionName: <ATLAS_REGION>

  2. Abra seu editor de texto preferido e cole a definição do recurso em um novo arquivo de texto.

2

Configure as configurações necessárias.

As configurações destacadas são necessárias para implantar um conjunto de réplicas:

Chave
Descrição
Exemplo

metadata.name

O nome do cluster no Kubernetes. O Atlas gera aleatoriamente um nome do conjunto de réplica correspondente .

my-atlas-cluster

metadata.namespace

O namespace Kubernetes onde este cluster é criado.

atlas

spec.clusterServiceClassExternalName

A classe Kubernetes que corresponde ao seu provedor de serviços de nuvem Atlas .

Para visualizar as classes disponíveis invocando o seguinte comando:

svcat marketplace -n <NAMESPACE>

Os nomes das classe são listados na coluna CLASS da saída de comando.

Observação

Você deve usar a classe mongodb-atlas-tenant para implantar conjuntos de réplicas M2 ou M5. O valor especificado para a configuração do spec.regionName determina para qual provedor de nuvem o cluster é implantado.

mongodb-atlas-aws

spec.clusterServicePlanExternalName

O plano de serviço do Kubernetes que corresponde ao tamanho de instância do Atlas desejado.

Para visualizar os planos disponíveis, execute o seguinte comando:

svcat marketplace -n <NAMESPACE>

Os nomes do plano são listados na coluna PLANS da saída do comando.

M10

spec.regionName

A região do Atlas onde o conjunto de réplicas é criado.

Importante

Certifique-se de usar o nome da região do Atlas para a região desejada, não o nome da região do provedor de nuvem . Se você implantar clusters M2 ou M5, verifique se a região selecionada suporta esses tamanhos de cluster.

Para obter uma lista das regiões disponíveis, consulte a documentação do Atlas do seu provedor de serviço de nuvem:

EU_CENTRAL_1

Chave
Descrição
Exemplo

metadata.name

O nome do cluster no Kubernetes. O Atlas gera aleatoriamente um nome do conjunto de réplica correspondente .

my-atlas-cluster

metadata.namespace

O namespace Kubernetes onde este cluster é criado.

atlas

spec.serviceClassExternalName

A classe Kubernetes que corresponde ao seu provedor de serviços de nuvem Atlas .

Para visualizar as classes disponíveis invocando o seguinte comando:

svcat marketplace -n <NAMESPACE>

Os nomes das classe são listados na coluna CLASS da saída de comando.

Observação

Você deve usar a classe mongodb-atlas-tenant para implantar conjuntos de réplicas M2 ou M5. O valor especificado para a configuração do spec.regionName determina para qual provedor de nuvem o cluster é implantado.

mongodb-atlas-aws

spec.servicePlanExternalName

O plano de serviço do Kubernetes que corresponde ao tamanho de instância do Atlas desejado.

Para visualizar os planos disponíveis, execute o seguinte comando:

svcat marketplace -n <NAMESPACE>

Os nomes do plano são listados na coluna PLANS da saída do comando.

M10

spec.regionName

A região do Atlas onde o conjunto de réplicas é criado.

Importante

Certifique-se de usar o nome da região do Atlas para a região desejada, não o nome da região do provedor de nuvem . Se você implantar clusters M2 ou M5, verifique se a região selecionada suporta esses tamanhos de cluster.

Para obter uma lista das regiões disponíveis, consulte a documentação do Atlas do seu provedor de serviço de nuvem:

EU_CENTRAL_1

3

(Opcional) Configure quaisquer configurações adicionais para uma implantação de conjunto de réplica.

Você pode especificar configurações de cluster adicionais na chave spec.parameters.cluster. Essas configurações correspondem aos parâmetros do corpo da solicitação do método Criar um Cluster Público de API.

Importante

Os seguintes parâmetros da API são substituídos pelas configurações necessárias do Atlas Open Service Agent da etapa anterior e não devem ser especificados:

  • providerSettings.instanceSizeName

  • providerSettings.providerName

  • name

Exemplo

Esta definição de recurso de exemplo cria um cluster chamado my-atlas-cluster no namespace atlas que tem a seguinte configuração:

  • Gerenciado por um Corretor de Serviço Aberto do Atlas com escopo de cluster (ClusterServiceBroker)

  • Amazon Web Services como provedor de serviços de nuvem

  • Um tamanho de instância de M10

  • Localizado na região da UE (Frankfurt)

  • Auto-scaling desabilitado

  • Snapshots do provedor de nuvem do Atlas habilitado

apiVersion: servicecatalog.k8s.io/v1beta1
kind: ServiceInstance
metadata:
  name: my-atlas-cluster
  namespace: atlas
spec:
  clusterServiceClassExternalName: mongodb-atlas-aws
  clusterServicePlanExternalName: M10
  parameters:
    cluster:
      providerSettings:
        regionName: EU_CENTRAL_1
      autoscaling:
        diskGBEnabled: false
      providerBackupEnabled: true

Exemplo

Esta definição de recurso de exemplo cria um cluster chamado my-atlas-cluster no namespace atlas que tem a seguinte configuração:

  • Gerenciado por um Corretor de Serviço Aberto do Atlas com escopo de namespace (ServiceBroker)

  • Amazon Web Services como provedor de serviços de nuvem

  • Um tamanho de instância de M10

  • Localizado na região da UE (Frankfurt)

  • Auto-scaling desabilitado

  • Snapshots do provedor de nuvem do Atlas habilitado

apiVersion: servicecatalog.k8s.io/v1beta1
kind: ServiceInstance
metadata:
  name: my-atlas-cluster
  namespace: atlas
spec:
  serviceClassExternalName: mongodb-atlas-aws
  servicePlanExternalName: M10
  parameters:
    cluster:
      providerSettings:
        regionName: EU_CENTRAL_1
      autoscaling:
        diskGBEnabled: false
      providerBackupEnabled: true
4

Salve o arquivo como replica-set.yaml.

5

Implemente o conjunto de réplicas.

Invoque o seguinte comando do Kubernetes para criar seu conjunto de réplicas:

kubectl apply -f replica-set.yaml
6

Monitore o status da implantação do conjunto de réplicas.

Para visualizar o status do seu sistema, passe o metadata.name de replica-set.yaml para o seguinte comando:

svcat describe instance <METADATA.NAME> -n <NAMESPACE>

Conforme o conjunto de réplicas está sendo implementado, o comando retorna o seguinte status:

Provisioning - The instance is being provisioned asynchronously

Depois que o conjunto de réplicas for implementado com sucesso, o comando retornará o seguinte status:

Ready - The instance was provisioned successfully

Voltar

comando de banco de dados

Próximo

Implementar um cluster fragmentado

Nesta página