{"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\/pt\/configure-official-couchbase-docker-test\/","title":{"rendered":"Configure a imagem oficial do Docker do Couchbase no tempo de execu\u00e7\u00e3o do teste com TestContainers"},"content":{"rendered":"

No anterior<\/a> blog<\/a> expliquei como usar o Docker<\/a> executando o Couchbase durante seus testes. Ambas as publica\u00e7\u00f5es tinham o requisito de que voc\u00ea precisava criar sua pr\u00f3pria imagem do Docker do Couchbase com o cluster e os dados j\u00e1 configurados. Nesta publica\u00e7\u00e3o, mostrarei como voc\u00ea pode usar nossa imagem oficial do Docker e configurar o cluster como desejar durante a fase de configura\u00e7\u00e3o do seu teste.<\/p>\n

Um cont\u00eainer de teste personalizado do Couchbase<\/h2>\n

O TestContainers j\u00e1 oferece suporte a v\u00e1rios tipos espec\u00edficos de cont\u00eaineres, especialmente no mundo relacional, como voc\u00ea pode ver na p\u00e1gina documenta\u00e7\u00e3o<\/a>. Eles oferecem alguns recursos avan\u00e7ados, como uma conex\u00e3o JDBC que permite que voc\u00ea use o banco de dados subjacente diretamente. Com o mesmo esp\u00edrito, podemos criar um CouchbaseContainer personalizado que permitir\u00e1 que voc\u00ea configure o cluster e os buckets durante os testes.<\/p>\n

Ele ser\u00e1 respons\u00e1vel por iniciar a imagem do Docker e retornar\u00e1 uma inst\u00e2ncia configurada do CouchbaseCluster. Primeiro, definimos o identificador padr\u00e3o da imagem da plataforma e a porta Liveness como a porta 8091. Essa \u00e9 a porta que ser\u00e1 testada pela estrat\u00e9gia de espera HTTP padr\u00e3o para o caminho '\/ui\/index.html#\/'. Quando conseguirmos acessar essa p\u00e1gina, poderemos come\u00e7ar a configurar o 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
A segunda etapa \u00e9 substituir o m\u00e9todo configure para garantir que todas as portas necess\u00e1rias sejam expostas e definir a estrat\u00e9gia 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
Nesse ponto, voc\u00ea pode testar esse cont\u00eainer gen\u00e9rico. A imagem ser\u00e1 executada em um estado em que voc\u00ea precisar\u00e1 configurar o Couchbase. Voc\u00ea precisa passar por todas as etapas do assistente. Essas etapas podem ser automatizadas por meio das ferramentas da CLI ou da API REST. Vamos usar a API para configurar o cluster.<\/p>\n
H\u00e1 tr\u00eas chamadas obrigat\u00f3rias que precisamos fazer. Uma para configurar as cotas de RAM, uma para configurar o nome de usu\u00e1rio e a senha do usu\u00e1rio administrador e uma para configurar os servi\u00e7os dispon\u00edveis no cluster (chave\/valor, \u00edndice, consulta e fts).<\/p>\n
Usando o curl, essas chamadas teriam a seguinte apar\u00eancia:<\/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
H\u00e1 v\u00e1rias maneiras de fazer um POST em Java, veja um exemplo:<\/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 essas chamadas ser\u00e3o feitas a partir do initCluster<\/code> method. O conte\u00fado dessas chamadas depender\u00e1 da configura\u00e7\u00e3o fornecida ao cont\u00eainer. Podemos adicionar alguns m\u00e9todos para definir quais servi\u00e7os est\u00e3o ativados, quais s\u00e3o o nome de usu\u00e1rio e a senha, as cotas de RAM ou os buckets de amostra a serem instalados.<\/p>\n
Depois de implementar esse m\u00e9todo, vamos expor um CouchbaseEnvironnement e um CouchbaseCluster. O getter do ambiente \u00e9 respons\u00e1vel por executar initCluster<\/code> se ainda n\u00e3o tiver sido inicializado. Esse m\u00e9todo tamb\u00e9m requer o estrat\u00e9gia de espera personalizada<\/a> escreveu na postagem anterior. Basicamente, ele faz uma pesquisa em '\/pools\/default' at\u00e9 que o primeiro n\u00f3 apresente um estado \u00edntegro.<\/p>\n
Aqui est\u00e1 o c\u00f3digo da classe completa:<\/p>\n