{"id":4093,"date":"2017-10-30T09:05:19","date_gmt":"2017-10-30T16:05:19","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=4093"},"modified":"2025-06-13T15:55:15","modified_gmt":"2025-06-13T22:55:15","slug":"fast-failover-couchbase-server-5","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/fast-failover-couchbase-server-5\/","title":{"rendered":"Failover r\u00e1pido con Couchbase Server 5.0"},"content":{"rendered":"
\n

La conmutaci\u00f3n r\u00e1pida por error es una de las muchas mejoras que incorpora la versi\u00f3n de Servidor Couchbase 5.0<\/a> (ya disponible para descargar).<\/p>\n<\/div>\n

\n

La conmutaci\u00f3n por error es uno de los conceptos importantes que hay que entender cuando se trata de bases de datos distribuidas. El teorema CAP<\/a> establece que una base de datos distribuida no puede estar disponible a la vez y<\/em> coherente todos<\/em> del tiempo. La arquitectura de Couchbase Server est\u00e1 dise\u00f1ada para ser siempre<\/em> consistente, y tolerar particiones. Con la r\u00e1pida conmutaci\u00f3n por error, Couchbase Server est\u00e1 cerrando la brecha en alta disponibilidad<\/a>.<\/p>\n<\/div>\n

\n

En esta entrada de blog, voy a demostrar la conmutaci\u00f3n por error en acci\u00f3n. Usar\u00e9 Docker para crear un cl\u00faster de 3 nodos Couchbase en mi m\u00e1quina local.<\/p>\n<\/div>\n

\n

Puedes seguir el ejemplo de c\u00f3digo en esta entrada del blog: es disponible en GitHub<\/a>.<\/em><\/p>\n<\/div>\n

\n

Visi\u00f3n general de la conmutaci\u00f3n r\u00e1pida por error<\/h2>\n
\n
\n

Necesitar\u00e1s un poco de preparaci\u00f3n.<\/p>\n<\/div>\n

\n

Primero, crea un cluster de 3 nodos (al menos) de Couchbase Server. Hay varias formas de hacerlo, incluyendo Vagabundos<\/a>M\u00e1quinas virtuales, m\u00e1quinas reales, Azure<\/a>y mucho m\u00e1s.<\/p>\n<\/div>\n

\n

Opt\u00e9 por utilizar Docker. Ya escrib\u00ed en el blog c\u00f3mo crear un Cluster Couchbase en Docker y acceder a \u00e9l con una aplicaci\u00f3n .NET Core<\/a> (\u00a1no te olvides de la red de puentes!). As\u00ed que volv\u00ed a seguir las mismas instrucciones. La \u00fanica diferencia es que utilic\u00e9 una aplicaci\u00f3n de consola en lugar de una aplicaci\u00f3n ASP.NET (sobre la que puedes leer m\u00e1s adelante en este post).<\/p>\n<\/div>\n

\n

\"Three<\/span><\/p>\n<\/div>\n

\n

Utilic\u00e9 el Imagen Couchbase Server 5.0.0-beta2 de Docker Hub<\/a>pero para cuando leas esto, la versi\u00f3n oficial de Couchbase Server 5.0 ya estar\u00e1 disponible. disponible en el repositorio oficial de docker Couchbase<\/a>.<\/p>\n<\/div>\n

\n

A continuaci\u00f3n, cree un bucket llamado \"mybucket\". Aseg\u00farate de habilitar las r\u00e9plicas para crear copias adicionales de datos dentro del mismo cl\u00faster.<\/p>\n<\/div>\n

\n

\"Couchbase<\/span><\/p>\n<\/div>\n

\n

Despu\u00e9s de eso, crea un usuario (yo llam\u00e9 al m\u00edo \"myuser\") con al menos permiso de Data Writer y Data Reader para \"mybucket\"). Si a\u00fan no est\u00e1 familiarizado con Couchbase Server Control de acceso basado en funciones (RBAC)<\/a>empezar con esta entrada del blog sobre Autenticaci\u00f3n con RBAC y .NET.<\/a><\/em><\/p>\n<\/div>\n

\n

\"Couchbase<\/span><\/p>\n<\/div>\n

\n

Por \u00faltimo, activa la conmutaci\u00f3n por error r\u00e1pida autom\u00e1tica. Desde la Consola de Couchbase, ve a Configuraci\u00f3n, y luego a Auto-Failover. Marca la casilla \"Activar auto-failover\". A partir de la versi\u00f3n 5.0, puedes establecer el valor de Timeout a tan s\u00f3lo 5 (segundos). Anteriormente, el valor ten\u00eda que ser de al menos 30 segundos.<\/p>\n<\/div>\n

\n

\"Enable<\/span><\/p>\n<\/div>\n

\n

Hay una raz\u00f3n por la que el auto-failover est\u00e1 desactivado por defecto. Por favor, revise la documentaci\u00f3n sobre la conmutaci\u00f3n autom\u00e1tica por error<\/a> para asegurarte de que te conviene.<\/em><\/p>\n<\/div>\n<\/div>\n<\/div>\n

\n

Ejemplo .NET<\/h2>\n
\n
\n

Ahora que tienes un cluster de 3 nodos corriendo dentro de tu host Docker, es hora de escribir una aplicaci\u00f3n de demostraci\u00f3n. Decid\u00ed escribir una aplicaci\u00f3n de consola que continuamente realizara lecturas contra Couchbase. En alg\u00fan momento, \"desconectar\u00e9\" uno de los nodos para mostrar la conmutaci\u00f3n r\u00e1pida autom\u00e1tica en acci\u00f3n.<\/p>\n<\/div>\n

\n

Conexi\u00f3n al cl\u00faster<\/h3>\n
\n

Despu\u00e9s de crear una nueva aplicaci\u00f3n de consola .NET Core en Visual Studio, a\u00f1ad\u00ed el archivo Couchbase .NET SDK (actualmente versi\u00f3n 2.5.1) usando NuGet<\/a>.<\/p>\n<\/div>\n

\n

A continuaci\u00f3n, he creado una configuraci\u00f3n para conectarse al cl\u00faster de 3 nodos, autenticar a \"myuser\", y abrir \"mybucket\".<\/p>\n<\/div>\n

\n
\n
var clientConfig = new ClientConfiguration\r\n{\r\n    Servers = new List<Uri>\r\n    {\r\n        new Uri(\"https:\/\/172.17.0.2\"),\r\n        new Uri(\"https:\/\/172.17.0.3\"),\r\n        new Uri(\"https:\/\/172.17.0.4\")\r\n    }\r\n};\r\nvar cluster = new Cluster(clientConfig);\r\n\r\nvar credentials = new PasswordAuthenticator(\"myuser\", \"password\");\r\ncluster.Authenticate(credentials);\r\n\r\n_bucket = cluster.OpenBucket(\"mybucket\");<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Esas direcciones IP son las direcciones que interno<\/em> al host Docker. Esta aplicaci\u00f3n .NET Core tambi\u00e9n se ejecutar\u00e1 dentro del host Docker, donde se resolver\u00e1n esas direcciones IP. Desde fuera de<\/em> el host docker, s\u00f3lo se resolver\u00e1 \"localhost:8091\" (suponiendo que est\u00e1 siguiendo la etiqueta tutorial<\/a> que he enlazado antes). Si no est\u00e1s usando Docker, pon las direcciones IP de las m\u00e1quinas Azure, las VMs, etc, en su lugar.<\/p>\n<\/div>\n
\n
Siguiente, Contrase\u00f1aAutenticaci\u00f3n<\/code> para garantizar el acceso a los cubos.<\/p>\n<\/div>\n
\n
Por \u00faltimo, obtenga un objeto cubo utilizando OpenBucket<\/code>.<\/p>\n<\/div>\n<\/div>\n
\n
Creaci\u00f3n de documentos<\/h3>\n
\n
Para esta demostraci\u00f3n, quiero crear un mont\u00f3n de documentos de los que luego leer\u00e9 repetidamente. En primer lugar, escrib\u00ed un bucle para crear un n\u00famero arbitrario de documentos, que cada uno tiene una clave como \"documentKey[num]\" (por ejemplo, \"documentKey1\", \"documentKey2\", etc).<\/p>\n<\/div>\n
\n
\n
var docKeys = new List<string>();\r\nfor (var i = 0; i < numDocuments; i++)\r\n{\r\n    var key = \"documentKey\" + i;\r\n    docKeys.Add(key);\r\n    _bucket.Upsert(key, new { name = \"Document\" + i });\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
En mi c\u00f3digo, n\u00fameroDocumentos<\/code> est\u00e1 fijado en 50. Pero si usted est\u00e1 siguiendo a lo largo, no dude en establecer que a otro n\u00famero y ver qu\u00e9 pasa.<\/p>\n<\/div>\n<\/div>\n
\n
Lectura de documentos<\/h3>\n
\n
Por lo tanto, hay 50 documentos con claves conocidas. El resto del programa ser\u00e1 un bucle continuo. Cada iteraci\u00f3n del bucle intentar\u00e1 recuperar los 50 documentos.<\/p>\n<\/div>\n
\n
\n
var iteration = 0;\r\nwhile (true)\r\n{\r\n    Console.WriteLine($\"Getting {numDocuments} documents [{iteration++}]\");\r\n    foreach(var docKey in docKeys)\r\n    {\r\n        var result = _bucket.Get<dynamic>(docKey);\r\n        if(terse)\r\n            ShowResultTerse(result, docKey);\r\n        else\r\n            ShowResult(result, docKey);\r\n    }\r\n    Console.WriteLine();\r\n\r\n    Thread.Sleep(2000);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
En primer lugar, observa que hay un bucle dentro del bucle. El bucle interior se ejecutar\u00e1 50 veces para realizar un Visite<\/code> en cada documento. MostrarResultado<\/code> mostrar\u00e1 lo que ocurre en la consola (MostrarResultadoTerse<\/code> hace lo mismo, pero de forma mucho m\u00e1s compacta. MostrarResultado<\/code> est\u00e1 m\u00e1s abajo, pero en las capturas de pantalla posteriores se utilizar\u00e1 MostrarResultadoTerse<\/code>).<\/p>\n<\/div>\n
\n
\n
private static void ShowResult(IOperationResult<dynamic> result, string id)\r\n{\r\n    \/\/ happy path, document was found\r\n    if (result.Success)\r\n    {\r\n        Console.WriteLine(\"Result: success\");\r\n        return;\r\n    }\r\n\r\n    \/\/ error, possibly node down\r\n    \/\/ show error, try to get replica\r\n    Console.WriteLine($\"Result: unsuccessful {result.Message}\");\r\n    Console.WriteLine(\"\\tAttempting to get replica.\");\r\n\r\n    var replica = _bucket.GetFromReplica<dynamic>(id);\r\n\r\n    \/\/ happy path for replica, it was found\r\n    if (replica.Success)\r\n    {\r\n        Console.WriteLine(\"\\tReplica result: success\");\r\n        return;\r\n    }\r\n\r\n    \/\/ error! replication may not be configured\r\n    \/\/ or it's possible something catastrophic happened\r\n    \/\/ this should be rare, but definitely want to log it\r\n    \/\/ maybe retry and\/or escalate\r\n    \/\/ in this example, it's just logged to console\r\n    Console.WriteLine(\"\\tReplica result unsuccessful: {result.Message}\");\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Los comentarios le ayudar\u00e1n a seguir el hilo, pero MostrarResultado<\/code> hace tres comprobaciones:<\/p>\n<\/div>\n
\n
    \n
  1. \u00bfHa tenido \u00e9xito la lectura? Si es as\u00ed, ind\u00edcalo. \u00a1Listo! Si no...<\/li>\n
  2. Intenta obtener una r\u00e9plica (de otro nodo). \u00bfTuvo \u00e9xito? Si es as\u00ed, env\u00edalo. \u00a1Listo! Si no...<\/li>\n
  3. La aplicaci\u00f3n no ha podido leer el documento o una de sus r\u00e9plicas. En este ejemplo, esto va a ser muy raro. En realidad, podr\u00eda significar que el documento no existe, o que la replicaci\u00f3n no est\u00e1 configurada correctamente, o que algo m\u00e1s ha ido mal.<\/li>\n<\/ol>\n<\/div>\n
    \n
    Entonces, est\u00e1s listo para ejecutar la aplicaci\u00f3n. Si est\u00e1s usando Docker, no olvides ejecutar esta aplicaci\u00f3n en Docker (que es f\u00e1cil de hacer desde Visual Studio<\/a>). (Aseg\u00farese tambi\u00e9n de conectar el contenedor de aplicaciones .NET Core a la red puente de Docker).<\/em><\/p>\n<\/div>\n<\/div>\n
    \n
    \u00a1Tira del enchufe!<\/h3>\n
    \n
    Antes de desconectar uno de los nodos, veamos cu\u00e1l es la salida \"normal\" cuando se ejecuta la aplicaci\u00f3n .NET Core anterior.<\/p>\n<\/div>\n
    \n
    En el siguiente GIF, lo ver\u00e1s:<\/p>\n<\/div>\n
    \n