Docs Menu
Docs Home
/
Atlas Open Service Broker
/
Implementación de base de datos

Implementar un set de réplicas

Importante

Atlas Open Service Broker está obsoleto. Utilice el Operador Atlas de MongoDB en su lugar.

Una set de réplicas es un grupo de implementaciones de MongoDB que mantienen el mismo conjunto de datos. Los sets de réplicas proporcionan redundancia y alta disponibilidad y son la base de todas las implementaciones en producción.

Para obtener más información sobre los conjuntos de réplicas, consulte Introducción a la replicación en el manual de MongoDB.

Puede utilizar el Atlas Open Service Broker para implementar un nuevo conjunto de réplicas gestionado por Atlas. Después de la implementación, usa Atlas para gestionar la supervisión, las copias de seguridad y la configuración del proyecto, como el emparejamiento de VPC o la facturación.

Requisitos previos

You create Atlas replica sets by defining an object. To deploy a replica set using an Kubernetes object, you must first Instalar Atlas Open Service Broker.

Considerations

API pública de Atlas

Atlas Open Service Broker uses the Create a Cluster endpoint of the Atlas Public API to deploy replica sets. Any requirements or limitations of the API also apply to the Atlas Open Service Broker.

Procedimiento

1

Cree una definición de recurso para su conjunto de réplicas.

  1. Copie uno de los siguientes ejemplos de definición de recursos según el alcance de su instancia de Service Broker.

    If you registered the Atlas Open Service Broker instance as a cluster-scoped ClusterServiceBroker, select Cluster-scoped Instance. If you registered the Atlas Open Service Broker instance as a namespace-scoped ServiceBroker, select Namespace-scoped Instance.


    Copie el siguiente archivo YAML, que puede modificar para adaptarlo a su configuración deseada:

    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 el siguiente archivo YAML, que puede modificar para adaptarlo a su configuración deseada:

    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 su editor de texto preferido y pegue la definición del recurso en un nuevo archivo de texto.

2

Configure los ajustes necesarios.

Las configuraciones resaltadas son necesarias para implementar un conjunto de réplicas:

Clave
Descripción
Ejemplo

metadata.name

El nombre del clúster en Kubernetes. Atlas genera aleatoriamente el nombre correspondiente del conjunto de réplicas.

my-atlas-cluster

metadata.namespace

El espacio de nombres de Kubernetes donde se crea este clúster.

atlas

spec.clusterServiceClassExternalName

La clase de Kubernetes que corresponde a su proveedor de servicios en la nube Atlas.

Vea las clases disponibles invocando el siguiente comando:

svcat marketplace -n <NAMESPACE>

Los nombres de clase se enumeran en la columna CLASS de la salida del comando.

Nota

Debe usar la clase mongodb-atlas-tenant para implementar conjuntos de réplicas M2 o M5. El valor que especifique para la configuración spec.regionName determina en qué proveedor de nube se implementa el clúster.

mongodb-atlas-aws

spec.clusterServicePlanExternalName

El plan de servicio de Kubernetes que corresponde al tamaño de instancia de Atlas deseado.

Vea los planes disponibles invocando el siguiente comando:

svcat marketplace -n <NAMESPACE>

Los nombres de los planes se muestran en la columna PLANS de la salida del comando.

M10

spec.regionName

La región del Atlas donde se crea el conjunto de réplicas.

Importante

Asegúrese de usar el nombre de la región de Atlas para la región deseada, no el nombre de la región del proveedor de la nube. Si implementa clústeres M2 o M5, asegúrese de que la región que seleccione admita estos tamaños de clúster.

Para obtener una lista de las regiones disponibles, consulte la documentación de Atlas para su proveedor de servicios en la nube:

EU_CENTRAL_1

Clave
Descripción
Ejemplo

metadata.name

El nombre del clúster en Kubernetes. Atlas genera aleatoriamente el nombre correspondiente del conjunto de réplicas.

my-atlas-cluster

metadata.namespace

El espacio de nombres de Kubernetes donde se crea este clúster.

atlas

spec.serviceClassExternalName

La clase de Kubernetes que corresponde a su proveedor de servicios en la nube Atlas.

Vea las clases disponibles invocando el siguiente comando:

svcat marketplace -n <NAMESPACE>

Los nombres de clase se enumeran en la columna CLASS de la salida del comando.

Nota

Debe usar la clase mongodb-atlas-tenant para implementar conjuntos de réplicas M2 o M5. El valor que especifique para la configuración spec.regionName determina en qué proveedor de nube se implementa el clúster.

mongodb-atlas-aws

spec.servicePlanExternalName

El plan de servicio de Kubernetes que corresponde al tamaño de instancia de Atlas deseado.

Vea los planes disponibles invocando el siguiente comando:

svcat marketplace -n <NAMESPACE>

Los nombres de los planes se muestran en la columna PLANS de la salida del comando.

M10

spec.regionName

La región del Atlas donde se crea el conjunto de réplicas.

Importante

Asegúrese de usar el nombre de la región de Atlas para la región deseada, no el nombre de la región del proveedor de la nube. Si implementa clústeres M2 o M5, asegúrese de que la región que seleccione admita estos tamaños de clúster.

Para obtener una lista de las regiones disponibles, consulte la documentación de Atlas para su proveedor de servicios en la nube:

EU_CENTRAL_1

3

(Opcional) Configure cualquier configuración adicional para una implementación de un conjunto de réplicas.

Puedes especificar configuraciones adicionales del clúster bajo la llave spec.parameters.cluster. Estas configuraciones corresponden a los parámetros del cuerpo de la solicitud del método Crear un clúster de la API pública.

Importante

Los siguientes parámetros de API se sobrescriben con las configuraciones requeridas de Atlas Open Service Broker del paso anterior y no se deben especificar:

  • providerSettings.instanceSizeName

  • providerSettings.providerName

  • name

Ejemplo

Esta definición de recurso de ejemplo crea un clúster llamado my-atlas-cluster en el espacio de nombres atlas que tiene la siguiente configuración:

  • Administrado por un Atlas Open Service Broker con ámbito de clúster (ClusterServiceBroker)

  • AWS como proveedor de servicios en la nube

  • Un tamaño de instancia de M10

  • Ubicado en la región de la UE (Frankfurt)

  • Escalado automático deshabilitado

  • Instantáneas de proveedor de nube Atlas habilitadas

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

Ejemplo

Esta definición de recurso de ejemplo crea un clúster llamado my-atlas-cluster en el espacio de nombres atlas que tiene la siguiente configuración:

  • Administrado por un Atlas Open Service Broker con ámbito de espacio de nombres (ServiceBroker)

  • AWS como proveedor de servicios en la nube

  • Un tamaño de instancia de M10

  • Ubicado en la región de la UE (Frankfurt)

  • Escalado automático deshabilitado

  • Instantáneas de proveedor de nube Atlas habilitadas

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

Guarde el archivo replica-set.yaml como.

5

Implementar el conjunto de réplicas.

Invoque el siguiente comando de Kubernetes para crear su conjunto de réplicas:

kubectl apply -f replica-set.yaml
6

Realice un seguimiento del estado de la implementación de su conjunto de réplicas.

Para ver el estado de su implementación, pase metadata.name de replica-set.yaml al siguiente comando:

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

A medida que se implementa el conjunto de réplicas, el comando devuelve el siguiente estado:

Provisioning - The instance is being provisioned asynchronously

Una vez que el conjunto de réplicas se implementa correctamente, el comando devuelve el siguiente estado:

Ready - The instance was provisioned successfully

Volver

Implementación de base de datos

Next

Implementar un clúster particionado

En esta página