{"id":2351,"date":"2016-07-26T15:49:28","date_gmt":"2016-07-26T15:49:28","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=2351"},"modified":"2025-06-13T23:03:40","modified_gmt":"2025-06-14T06:03:40","slug":"configure-official-couchbase-docker-test","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/configure-official-couchbase-docker-test\/","title":{"rendered":"Configurar la imagen Docker oficial de Couchbase en tiempo de prueba con TestContainers"},"content":{"rendered":"

En el anterior<\/a> blog<\/a> posts expliqu\u00e9 c\u00f3mo utilizar Docker<\/a> contenedores ejecutando Couchbase durante tus pruebas. Ambos post ten\u00edan como requisito que tuvieras que construir tu propia imagen Docker de Couchbase con el cluster y los datos ya configurados. En este post te contar\u00e9 c\u00f3mo puedes usar nuestra imagen Docker oficial y configurar el Cluster a tu gusto durante la fase de configuraci\u00f3n de tu test.<\/p>\n

Un Couchbase TestContainer personalizado<\/h2>\n

TestContainers ya soporta varios tipos espec\u00edficos de contenedores, especialmente en el mundo relacional como se puede ver en su documentaci\u00f3n<\/a>. Ofrecen algunas caracter\u00edsticas avanzadas como una conexi\u00f3n JDBC que te permite usar la base de datos subyacente directamente. Con el mismo esp\u00edritu podemos crear un CouchbaseContainer personalizado que te permitir\u00e1 configurar el cluster y los buckets durante tus pruebas.<\/p>\n

Se encargar\u00e1 de arrancar la imagen docker y devuelve una instancia de CouchbaseCluster configurada. Primero definimos el identificador por defecto de la imagen docker y el puerto Liveness como puerto 8091. Este es el que ser\u00e1 testeado por la estrategia de espera HTTP por defecto para la ruta '\/ui\/index.html#\/'. Una vez que podamos llegar a esta p\u00e1gina podemos empezar a configurar el cluster.<\/p>\n

    public CouchbaseContainer() {\r\n        super(\"couchbase:4.5.0\");\r\n    }\r\n\r\n    @Override\r\n    protected Integer getLivenessCheckPort() {\r\n        return getMappedPort(8091);\r\n    }\r\n<\/code><\/pre>\n
El segundo paso es sobrescribir el m\u00e9todo configure para asegurarnos de que exponemos todos los puertos necesarios y establecemos la estrategia de espera HTTP,<\/p>\n
    @Override\r\n    protected void configure() {\r\n        addExposedPorts(8091, 8092, 8093, 8094, 11207, 11210, 11211, 18091, 18092, 18093);\r\n        setWaitStrategy(new HttpWaitStrategy().forPath(\"\/ui\/index.html#\/\"));\r\n    }\r\n<\/code><\/pre>\n
En este punto puedes probar ese contenedor gen\u00e9rico. Tendr\u00edas la imagen funcionando en un estado en el que necesitas configurar Couchbase. Necesitas seguir todos los pasos del asistente. Estos pasos se pueden automatizar a trav\u00e9s de las herramientas CLI o la API REST. Vamos a utilizar la API para configurar el cl\u00faster.<\/p>\n
Hay tres llamadas obligatorias que tenemos que hacer. Una para configurar las cuotas de ram, otra para configurar el nombre de usuario y la contrase\u00f1a del usuario admin y otra para configurar los servicios disponibles en el cluster (key\/value, index, query y fts).<\/p>\n
Usando curl esas llamadas se ver\u00edan as\u00ed:<\/p>\n
    curl -v -X POST https:\/\/192.168.99.100:8091\/pools\/default -d memoryQuota=300 -d indexMemoryQuota=300\r\n    curl -v https:\/\/192.168.99.100:8091\/node\/controller\/setupServices -d 'services=kv%2Cn1ql%2Cindex'\r\n    curl -v -X POST curl -v -X POST https:\/\/192.168.99.100:8091\/settings\/web -d port=8091 -d username=Administrator -d password=password\r\n<\/code><\/pre>\n
Hay m\u00faltiples maneras de hacer un POST en Java, aqu\u00ed hay un ejemplo:<\/p>\n
        public void callCouchbaseRestAPI(String url, String payload, String username, String password) throws IOException {\r\n            HttpURLConnection httpConnection = (HttpURLConnection) ((new URL(url).openConnection()));\r\n            httpConnection.setDoOutput(true);\r\n            httpConnection.setDoInput(true);\r\n            httpConnection.setRequestMethod(\"POST\");\r\n            httpConnection.setRequestProperty(\"Content-Type\",\r\n                    \"application\/x-www-form-urlencoded\");\r\n            if (username != null) {\r\n                String encoded = Base64.encode((username + \":\" + password).getBytes(\"UTF-8\"));\r\n                httpConnection.setRequestProperty(\"Authorization\", \"Basic \"+encoded);\r\n            }\r\n            DataOutputStream out = new DataOutputStream(httpConnection.getOutputStream());\r\n            out.writeBytes(payload);\r\n            out.flush();\r\n            out.close();\r\n            httpConnection.getResponseCode();\r\n            httpConnection.disconnect();\r\n        }\r\n<\/code><\/pre>\n
Todas estas llamadas se realizar\u00e1n desde el initCluster<\/code> m\u00e9todo. El contenido de esas llamadas depender\u00e1 de la configuraci\u00f3n proporcionada al contenedor. Podemos a\u00f1adir algunos m\u00e9todos para definir qu\u00e9 servicios est\u00e1n habilitados, cu\u00e1les son el nombre de usuario y la contrase\u00f1a, las cuotas de ram o los buckets de muestra a instalar.<\/p>\n
Despu\u00e9s de implementar ese m\u00e9todo, vamos a exponer un CouchbaseEnvironnement y un CouchbaseCluster. El getter del entorno es responsable de ejecutar initCluster<\/code> si a\u00fan no se ha inicializado. Este m\u00e9todo tambi\u00e9n requiere el m\u00e9todo estrategia de espera personalizada<\/a> escribi\u00f3 en el post anterior. B\u00e1sicamente sondea en '\/pools\/default' hasta que el primer nodo presenta un estado saludable.<\/p>\n
Aqu\u00ed est\u00e1 el c\u00f3digo de la clase completa:<\/p>\n