{"id":13215,"date":"2022-05-13T08:30:26","date_gmt":"2022-05-13T15:30:26","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=13215"},"modified":"2025-06-13T21:33:18","modified_gmt":"2025-06-14T04:33:18","slug":"cloud-native-management-utility-for-couchbase","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/cloud-native-management-utility-for-couchbase\/","title":{"rendered":"Apresentando o utilit\u00e1rio CAO para automa\u00e7\u00e3o de banco de dados nativo da nuvem"},"content":{"rendered":"

A vers\u00e3o 2.3.0 do Couchbase Autonomous Operator oferece alguns aprimoramentos interessantes para a automa\u00e7\u00e3o do ciclo de vida com o <\/span>cao<\/span><\/i> utilit\u00e1rio. Esse utilit\u00e1rio aprimora as ferramentas de configura\u00e7\u00e3o anteriores, consolidando o provisionamento e facilitando a capacidade de suporte com a adi\u00e7\u00e3o de um recurso de autocertifica\u00e7\u00e3o. Para come\u00e7ar, fa\u00e7a o download do <\/span>Pacote de banco de dados nativo da nuvem<\/span><\/a> e descompacte-o no mesmo diret\u00f3rio em que voc\u00ea normalmente executa <\/span>kubectl<\/span><\/i>.<\/span><\/p>\n

Fora com o velho<\/span><\/h2>\n

Em vers\u00f5es anteriores, a instala\u00e7\u00e3o do Operador Aut\u00f4nomo era realizada pelo <\/span>cbopcfg<\/span><\/i><\/a> ferramenta. Essa ferramenta tamb\u00e9m executava outras a\u00e7\u00f5es, como a cria\u00e7\u00e3o de fun\u00e7\u00f5es de backup e a gera\u00e7\u00e3o de modelos. A partir da vers\u00e3o 2.3.0, toda essa funcionalidade foi descontinuada na <\/span>cbopcfg <\/span><\/i>e mudou-se para o <\/span>cao<\/span><\/i><\/a> utilidade.<\/span><\/p>\n

Al\u00e9m disso, a capacidade de suporte anterior fornecida pelo <\/span>cbopinfo<\/span><\/i><\/a> para coleta de registros e recursos tamb\u00e9m foi descontinuado. A partir da vers\u00e3o 2.3.0, os mesmos recursos de suporte agora existem no <\/span>cao<\/span><\/i> juntamente com a funcionalidade adicional de autocertifica\u00e7\u00e3o.<\/span><\/p>\n

Com o aprimoramento<\/span><\/h2>\n

Quando voc\u00ea come\u00e7ar a usar o <\/span>cao<\/span><\/i> voc\u00ea descobrir\u00e1 que todos os recursos antigos fornecidos em vers\u00f5es anteriores existem com sintaxe semelhante. O menu de ajuda oferece uma vis\u00e3o geral dos comandos fornecidos pelo utilit\u00e1rio <\/span>cao<\/span><\/i> utilidade:<\/span><\/p>\n

Comandos dispon\u00edveis:\r\n  certify Executa o conjunto de certifica\u00e7\u00e3o da plataforma\r\n  collect-logs Coleta de registros e recursos para o suporte do Operador Aut\u00f4nomo do Couchbase\r\n  completion Gera o script de conclus\u00e3o autom\u00e1tica para o shell especificado\r\n  create Cria componentes do Couchbase Autonomous Operator\r\n  delete Exclui os componentes do Couchbase Autonomous Operator\r\n  generate Gera manifestos YAML\r\n  help Ajuda sobre qualquer comando\r\n  restore Restaura a topologia de dados de um cluster\r\n  save Salva a topologia de dados de um cluster\r\n  version Imprime a vers\u00e3o do comando<\/pre>\n
Use o criar<\/em> para criar o Operador Aut\u00f4nomo e o Controlador de Admiss\u00e3o para come\u00e7ar.<\/span><\/p>\n
cao create operator\r\ncao create admission<\/pre>\n
O Operador Aut\u00f4nomo ser\u00e1 usado para certificar e gerenciar o cluster que voc\u00ea criar\u00e1 nas etapas a seguir.  O controlador de admiss\u00e3o fornece valida\u00e7\u00e3o e verifica\u00e7\u00e3o de cada recurso dentro do ecossistema do Autonomous Operator.<\/span><\/p>\n
Teste de cria\u00e7\u00e3o de cluster aut\u00f4nomo<\/span><\/h2>\n
Agora que o Operador Aut\u00f4nomo est\u00e1 em execu\u00e7\u00e3o, voc\u00ea pode executar a certifica\u00e7\u00e3o da plataforma para garantir a capacidade de suporte do seu ambiente.  Por uma quest\u00e3o de brevidade, voc\u00ea pode executar um \u00fanico teste de certifica\u00e7\u00e3o.  Ao preparar um cluster para fins de produ\u00e7\u00e3o, voc\u00ea dever\u00e1 executar todo o conjunto de certifica\u00e7\u00e3o.<\/span><\/p>\n
cao certify --clean -- -test TestCreateCluster<\/pre>\n
A certifica\u00e7\u00e3o \u00fanica pode ajudar a solucionar problemas de um teste com falha ou validar um aspecto espec\u00edfico do cluster. Por exemplo, se voc\u00ea quiser obter um feedback r\u00e1pido sobre a validade da sua camada de armazenamento, poder\u00e1 executar o teste TestPersistentVolumeCreateCluster<\/em> para verificar o sucesso da cria\u00e7\u00e3o do cluster com volumes persistentes. Os testes dispon\u00edveis ser\u00e3o listados no in\u00edcio de cada execu\u00e7\u00e3o de certifica\u00e7\u00e3o completa, caso voc\u00ea precise fazer refer\u00eancia a outros.<\/span><\/p>\n
Salvando a topologia do cluster<\/span><\/h2>\n
Em seguida, voc\u00ea pode criar um cluster aut\u00f4nomo usando o comando <\/span>Gr\u00e1fico de leme do Couchbase<\/span><\/a>. Como o Operador Aut\u00f4nomo e o Controlador de Admiss\u00e3o j\u00e1 foram criados, desative essas implanta\u00e7\u00f5es ao instalar o gr\u00e1fico para garantir que apenas o Cluster do Couchbase seja instalado:<\/span><\/p>\n
helm install cb-example --set install.couchbaseOperator=false \\\r\n                        --set install.admissionController=false \\\r\n                        couchbase\/couchbase-operator<\/pre>\n
Esse comando cria um cluster do Couchbase composto por 3 pods. Quando todos os pods estiverem em execu\u00e7\u00e3o e o bucket for criado, o comando <\/span>cao save<\/span><\/i> pode ser usado para salvar a topologia de dados do cluster. O comando <\/span>salvar<\/span><\/i> converte todos os recursos descobertos em tipos de recursos nativos do Kubernetes, preservando todas as informa\u00e7\u00f5es de configura\u00e7\u00e3o e vincula\u00e7\u00e3o.<\/span><\/p>\n
\u00a0cao save --couchbase-cluster cb-example --filename cb-example.yaml<\/pre>\n
Salvar a topologia do cluster \u00e9 especialmente vantajoso para casos de uso que envolvem v\u00e1rios buckets com escopo espec\u00edfico e regras de coleta para mesclar ou restaurar em clusters adicionais. Para obter mais informa\u00e7\u00f5es, consulte a documenta\u00e7\u00e3o sobre <\/span>funcionalidade de salvar e restaurar<\/span><\/a>.\u00a0<\/span><\/p>\n
Considera\u00e7\u00f5es sobre o ciclo de vida<\/span><\/h2>\n
Como acontece com qualquer ferramenta, \u00e9 importante entender quando e como usar esse utilit\u00e1rio em uma perspectiva completa de ponta a ponta. Felizmente, o <\/span>cao<\/span><\/i> O utilit\u00e1rio \u00e9 uma excelente op\u00e7\u00e3o para qualquer cen\u00e1rio de instala\u00e7\u00e3o, pois pode configurar ambientes de desenvolvimento e de escala de produ\u00e7\u00e3o.<\/span><\/p>\n
No entanto, \u00e9 importante observar que esse utilit\u00e1rio n\u00e3o \u00e9 uma solu\u00e7\u00e3o completa para o provisionamento do Couchbase Server. Embora cao <\/i>possa implementar os recursos de gerenciamento (por exemplo, Operator e Admission Controllers), voc\u00ea precisar\u00e1 provisionar manualmente seu pr\u00f3prio cluster separadamente.<\/span><\/p>\n
Embora voc\u00ea possa misturar e combinar o uso dessa ferramenta com outros instaladores, como <\/span>leme<\/span><\/i> para realizar a instala\u00e7\u00e3o do cluster conforme demonstrado acima, \u00e9 recomend\u00e1vel evitar instaladores fragmentados, pois isso pode complicar o processo de atualiza\u00e7\u00e3o no futuro. De muitas maneiras, o poder do <\/span>cao<\/span><\/i> juntamente com o utilit\u00e1rio simples <\/span>kubectl<\/span><\/i> pode ser uma vantagem para a cria\u00e7\u00e3o de pipelines de integra\u00e7\u00e3o e implanta\u00e7\u00e3o modulares que envolvem a implanta\u00e7\u00e3o b\u00e1sica do operador juntamente com v\u00e1rias configura\u00e7\u00f5es de cluster personalizadas.<\/span><\/p>\n
Leitura adicional<\/span><\/h2>\n
A documenta\u00e7\u00e3o do Couchbase Autonomous Operator abrange todos os t\u00f3picos que abordamos acima; leia mais sobre eles aqui:<\/span><\/p>\n