{"id":5721,"date":"2018-09-04T11:03:50","date_gmt":"2018-09-04T18:03:50","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=5721"},"modified":"2025-11-24T08:27:24","modified_gmt":"2025-11-24T16:27:24","slug":"couchbase-autonomous-operator-with-persistent-volumes-on-azure-aks","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/couchbase-autonomous-operator-with-persistent-volumes-on-azure-aks\/","title":{"rendered":"Operador aut\u00f4nomo do Couchbase com volumes persistentes no Azure AKS"},"content":{"rendered":"

Estamos muito animados em anunciar que o setor PRIMEIRO<\/strong> Banco de dados NoSQL integrado nativamente com a API do Kubernetes (k8s), por meio do CRD, proporcionando imenso poder, agilidade e portabilidade de nuvem aos clientes para que eles possam ser gratuito<\/strong><\/em> de<\/p>\n

    \n
  1. Gerenciar ou administrar o cluster do Couchbase<\/li>\n
  2. Preocupado com falhas de n\u00f3s, o operador do k8s gira um pod para voc\u00ea<\/li>\n
  3. Preocupado em realizar a opera\u00e7\u00e3o de rebalanceamento ap\u00f3s a adi\u00e7\u00e3o do n\u00f3, o operador do k8s faz isso para voc\u00ea<\/li>\n
  4. Bloqueio do fornecedor<\/li>\n<\/ol>\n

    A integra\u00e7\u00e3o nativa com o k8s nos permite definir um controlador personalizado, por meio do qual podemos definir fluxo(s) de trabalho para determinadas condi\u00e7\u00f5es que ocorrem no cluster do Couchbase. Ao escrever essa l\u00f3gica no controlador personalizado, podemos gerenciar melhor o cluster do Couchbase.<\/p>\n

    A execu\u00e7\u00e3o do Operador Aut\u00f4nomo do Couchbase no Azure AKS est\u00e1 atualmente em pr\u00e9-visualiza\u00e7\u00e3o t\u00e9cnica.<\/p>\n

    Aqui est\u00e1 o que faremos<\/p>\n

      \n
    1. Fa\u00e7a login no Azure com a CLI (login az)<\/li>\n
    2. Criar um grupo de recursos<\/li>\n
    3. Criar um cluster k8s no AKS<\/li>\n
    4. Acesse o painel de controle do k8s (opcional)<\/li>\n
    5. Implantar o operador aut\u00f4nomo do Couchbase<\/li>\n
    6. Implantar o cluster do Couchbase no AKS<\/li>\n
    7. Inserir alguns (~100K) documentos no cluster<\/li>\n
    8. Aumente a escala do cluster com um comando<\/li>\n
    9. Excluir um pod, simulando uma falha de n\u00f3<\/li>\n
    10. Veja que o k8s observa esse evento e cria o novo pod para corresponder \u00e0 defini\u00e7\u00e3o do cluster<\/li>\n
    11. Refer\u00eancias<\/li>\n<\/ol>\n

      Agora, vamos analisar a implanta\u00e7\u00e3o do Operador Aut\u00f4nomo no Servi\u00e7o Azure Kubernetes passo a passo de forma extremamente detalhada<\/p>\n

      Fa\u00e7a login no Azure com a CLI (login az)<\/h3>\n
      az login\r\nTo sign in, use a web browser to open the page https:\/\/aka.ms\/devicelogin and enter the code BFU6N7R8L to authenticate.\r\n[\r\n{\r\n\"cloudName\": \"AzureCloud\",\r\n\"id\": \"xxxxxx-deff-4604-xxxxx-xxxxxxxxx\",\r\n\"isDefault\": true,\r\n\"name\": \"MyOrgAzure\",\r\n\"state\": \"Enabled\",\r\n\"tenantId\": \"xxbf6-f537-4fde-bc07-ooooooo777777\",\r\n\"user\": {\r\n\"name\": \"ram@couchbase.com\",\r\n\"type\": \"user\"\r\n}\r\n}\r\n]<\/pre>\n
      Criar um grupo de recursos<\/h3>\n
      az group create --name ramresourcegp --location eastus<\/pre>\n
      Criar um cluster k8s<\/h3>\n
      Fa\u00e7a login no portal do Azure e procure o Azure Kubernetes Service no \u00edcone de pesquisa.<\/p>\n
      \"\"
      \n 
      \nEscolha o tamanho da inst\u00e2ncia para n\u00f3s k8s e selecione o n\u00famero de n\u00f3s de acordo com os requisitos<\/p>\n
      \"\"
      \n 
      \nSele\u00e7\u00e3o dos tipos de inst\u00e2ncia<\/p>\n\"\"\n
       
      \nAtivar o RBAC para o cluster k8s<\/p>\n
      \"\"
      \n 
      \nEscolha a rede padr\u00e3o<\/p>\n
      \"
      \n 
      \nHabilitar o monitoramento de cont\u00eaineres<\/p>\n\"\"\n
       
      \nCertifique-se de que a valida\u00e7\u00e3o seja aprovada e pressione create<\/p>\n
      \"\"
      \n 
      \nExecute o comando para colocar o cluster do k8s em execu\u00e7\u00e3o no Azure, localmente (acho isso pessoalmente \u00fatil, pois me d\u00e1 a capacidade de gerenciar o cluster do k8s remoto em execu\u00e7\u00e3o no AKS. Outra op\u00e7\u00e3o seria usar Shell do Azure<\/a>)<\/p>\n
      az aks get-credentials --resource-group=ramresourcegp --name=ramk8saks\r\nMerged \"ramk8saks\" as current context in \/Users\/ram.dhakne\/.kube\/config<\/pre>\n
      A captura de tela abaixo d\u00e1 uma ideia de como verificar se a configura\u00e7\u00e3o do cluster AKS est\u00e1 definida corretamente no local ou n\u00e3o.<\/p>\n
      \"\"
      \n <\/p>\n
      Acesse o painel de controle do k8s (opcional)<\/h3>\n
      Todos os ativos do k8s podem ser gerenciados por meio do kubectl e, com o acesso da GUI ao cluster do Couchbase, ele se torna mais gerenci\u00e1vel. No entanto, eu tamb\u00e9m gostaria de administrar os ativos do k8s por meio do k8s Dashboard.<\/p>\n
      az aks browse --resource-group ramresourcegp --name ramk8saks\r\nMerged \"ramk8saks\" as current context in \/var\/folders\/0l\/sr0jnvw10nb55xt8nz6zcrzc0000gn\/T\/tmpvw6ub8_7\r\nProxy running on https:\/\/127.0.0.1:8001\/\r\nPress CTRL+C to close the tunnel...\r\nForwarding from 127.0.0.1:8001 -> 9090\r\nForwarding from [::1]:8001 -> 9090\r\nHandling connection for 8001<\/pre>\n
      [TIP]<\/strong> Se o painel do k8s apresentar problemas de permiss\u00e3o como<\/p>\n
      warning\r\nconfigmaps is forbidden: User \"system:serviceaccount:kube-system:kubernetes-dashboard\" cannot list configmaps in the namespace \"default\" <\/code><\/pre>\n
      Em seguida, execute o seguinte comando<\/p>\n
      kubectl create clusterrolebinding kubernetes-dashboard --clusterrole=cluster-admin --serviceaccount=kube-system:kubernetes-dashboard\r\nclusterrolebinding.rbac.authorization.k8s.io \"kubernetes-dashboard\" created<\/pre>\n
      Nesse momento, devemos ter acesso ao painel do k8s em execu\u00e7\u00e3o no URL\u00a0https:\/\/127.0.0.1:8001\/<\/a><\/p>\n
      Implantar o operador aut\u00f4nomo do Couchbase<\/h3>\n
      Lembre-se de que a implanta\u00e7\u00e3o do operador CB \u00e9 um trabalho \u00fanico e muito simples<\/p>\n
      Fiz o download dos arquivos zip da operadora em meu laptop local a partir do URL Baixar o pacote do operador do Couchbase<\/a><\/p>\n
      Ativar o RBAC para o cluster do couchbase no k8s<\/h5>\n
      kubectl create -f cluster-role.yaml\r\nkubectl create serviceaccount couchbase-operator --namespace default\r\nserviceaccount \"couchbase-operator\" created\r\nkubectl create clusterrolebinding couchbase-operator --clusterrole couchbase-operator --serviceaccount default:couchbase-operatorclusterrolebinding.rbac.authorization.k8s.io \"couchbase-operator\" created<\/pre>\n
      Implantar o operador do couchbase<\/h5>\n
      kubectl create -f operator.yaml\r\ndeployment.extensions \"couchbase-operator\" created<\/pre>\n
      kubectl get deployments\r\nNAME                 DESIRED CURRENT UP-TO-DATE AVAILABLE AGE\r\ncouchbase-operator       1       1       1          0      9s<\/pre>\n
      Ele fica pronto em menos de um minuto, e podemos assistir \u00e0 implanta\u00e7\u00e3o enquanto ela est\u00e1 acontecendo<\/p>\n
      kubectl get deployments -l app=couchbase-operator --watch\r\nNAME                DESIRED CURRENT UP-TO-DATE AVAILABLE AGE\r\ncouchbase-operator     1        1       1          0      8s\r\ncouchbase-operator     1        1       1          1      13s<\/pre>\n
       <\/p>\n
      Implantar o cluster do Couchbase no AKS<\/h3>\n
      Agora que implantamos o operador aut\u00f4nomo no AKS, vamos implantar o cluster do Couchbase<\/p>\n
      Com o AKS, temos o StorageClass por padr\u00e3o, vamos verificar<\/p>\n
      kubectl get sc\r\nNAME                  PROVISIONER         AGE\r\ndefault (default) kubernetes.io\/azure-disk 8h\r\nmanaged-premium   kubernetes.io\/azure-disk 8h<\/pre>\n
      Para nossa implementa\u00e7\u00e3o, escolheremos o managed-premium<\/p>\n
      O arquivo yaml detalhado pode ser encontrado aqui, couchbase-persistent-cluster.yaml<\/a><\/p>\n
      kubectl create -f couchbase-persistent-cluster.yaml<\/pre>\n
      Leva alguns minutos para que o cluster do couchbase seja ativado e criaremos 4 pods e, pela primeira vez, ele baixa a imagem do docker do registro.<\/p>\n
      kubectl get pods --watch\r\nNAME\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0READY    STATUS      RESTARTS     AGE\r\ncb-op-aks-demo-0000\u00a0 \u00a0 \u00a0 \u00a0 1\/1\u00a0 \u00a0 Running\u00a0 \u00a0 \u00a0 \u00a0 0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 48m\r\ncb-op-aks-demo-0001\u00a0 \u00a0 \u00a0 \u00a0 1\/1\u00a0 \u00a0 Running\u00a0 \u00a0 \u00a0 \u00a0 0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 44m\r\ncb-op-aks-demo-0002\u00a0 \u00a0 \u00a0 \u00a0 1\/1\u00a0 \u00a0 Running\u00a0 \u00a0 \u00a0 \u00a0 0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 40m\r\ncb-op-aks-demo-0003\u00a0 \u00a0 \u00a0 \u00a0 1\/1\u00a0 \u00a0 Running\u00a0 \u00a0 \u00a0 \u00a0 0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 37m\r\ncouchbase-operator-6cb7687498-zfzq5 1\/1 Running  1           1h<\/pre>\n
      A exposi\u00e7\u00e3o do servi\u00e7o cb-op-aks-demo-ui do NodePort (padr\u00e3o para LoadBalancer) nos permite acessar a GUI do Couchbase Server pelo IP p\u00fablico<\/p>\n\"\"\n
      Comando em execu\u00e7\u00e3o<\/p>\n
      kubectl get services<\/pre>\n
      deve fornecer o resultado como abaixo<\/p>\n
      cb-op-aks-demo-ui LoadBalancer 10.0.191.163 40.121.65.8 8091:30427\/TCP,18091:31034\/TCP<\/pre>\n
      Agora, fa\u00e7a login na GUI com o nome de usu\u00e1rio\/senha padr\u00e3o, ou seja, Administrator\/senha<\/p>\n\"\"\n
      Inserir alguns (~100K) documentos no cluster<\/h3>\n
      cbc-pillowfight -U couchbase:\/\/localhost\/default -u Administrator -P password -J -t 4 -I 99998 -p `hostname`<\/pre>\n
      [TIP]<\/strong> O utilit\u00e1rio cbc-pillowfight precisa ser instalado no cont\u00eainer antes de ser executado. Sua instala\u00e7\u00e3o est\u00e1 al\u00e9m do escopo deste blog.<\/p>\n
      Dever\u00edamos ver o gr\u00e1fico de estat\u00edsticas de balde iluminado<\/p>\n
      \"\"
      \n <\/p>\n
      Aumente a escala do cluster com um comando<\/h3>\n
      Dimensionar o cluster do couchbase \u00e9 uma tarefa muito simples com o Kubernetes, basta atualizar o arquivo couchbase-persistent-cluster.yaml. Digamos que queiramos aumentar a capacidade dos n\u00f3s de dados de 3 para 5, portanto, altere servers:size para 5<\/p>\n
      \"\"
      \n 
      \nVeremos que os novos pods est\u00e3o sendo criados e os pods e n\u00f3s do couchbase est\u00e3o sendo adicionados ao cluster, o rebalanceamento \u00e9 realizado, simplesmente incr\u00edvel!<\/p>\n
      kubectl logs -f couchbase-operator-6cb7687498-zfzq5<\/pre>\n\"\"\n
      O cluster foi ampliado e a nova defini\u00e7\u00e3o de cluster tem a seguinte apar\u00eancia, observando que, de um total de 100 mil itens, cada n\u00f3 tem cerca de 20 mil itens\/n\u00f3<\/p>\n
      \"\"
      \n 
      \n[TIP]<\/strong> Vamos verificar se temos PVs em nossos cont\u00eaineres<\/p>\n
      Fa\u00e7a login no pod e execute o comando lsblk -a<\/em><\/strong><\/p>\n
      kubectl exec -ti cb-op-aks-demo-0000 \/bin\/bash<\/pre>\n
      root@cb-op-aks-demo-0000:\/# lsblk -a\r\nNAME   MAJ:MIN RM SIZE RO TYPE MOUNTPOINT\r\nloop1   7:1    0   0     loop\r\nsdd     8:48   0   4G  0  disk  \/mnt\/data<\/strong>\r\nsdb     8:16   0  32G  0  disk\r\n `-sdb1 8:17   0  32G 0 part\r\nloop6 7:6 0 0 loop\r\nloop4 7:4 0 0 loop\r\nsr0 11:0 1 690K 0 rom\r\nloop2 7:2 0 0 loop\r\nsde     8:64  0 4G 0 disk \/mnt\/index<\/strong>\r\nloop0 7:0 0 0 loop\r\nsdc     8:32  0 4G 0 disk \/opt\/couchbase\/var\/lib\/couchbase<\/strong>\r\nsda 8:0 0 30G 0 disk\r\n `-sda1 8:1   0 30G 0 part \/opt\/couchbase\/var\r\nloop7 7:7 0 0 loop\r\nloop5 7:5 0 0 loop\r\nloop3 7:3 0 0 loop<\/pre>\n
      Em\u00a0couchbase-persistent-cluster.yaml<\/strong><\/em> definimos o volume de armazenamento como sendo de 4GiB e, no trecho destacado, vemos que temos diret\u00f3rios do Couchbase de 4GiB!<\/p>\n
      Excluir um pod, simulando uma falha de n\u00f3<\/h3>\n
      Exclua um pod cb-op-aks-demo-0000 do painel do k8s, pois ele \u00e9 um n\u00f3 de servi\u00e7o de dados<\/p>\n
      \"\"
      \n 
      \nCom o autoFailoverTimeout<\/em> tempo limite vari\u00e1vel definido em couchbase-persistent-cluster.yaml, o n\u00f3 sofre falha autom\u00e1tica e \u00e9 detectado pelo operador aut\u00f4nomo e, portanto, pelo cluster do Couchbase<\/p>\n
      \"\"
      \n 
      \nO controlador personalizado do Couchbase est\u00e1 constantemente observando a defini\u00e7\u00e3o do cluster e precisa ter um total de 4 n\u00f3s ou pods k8s, e ele v\u00ea que um deles desapareceu, portanto, cria um novo pod, junta-se ao cluster e o rebalanceamento \u00e9 realizado.<\/p>\n
      \"\"
      \n 
      \nDos registros de pods do operador do couchbase<\/p>\n
      \"\"
      \n 
      \nVamos parar um pouco para ver o que aconteceu aqui!<\/p>\n
      Um n\u00f3 falhou, foi detectado pelo Custom Controller, tamb\u00e9m conhecido como Couchbase Operator, que tamb\u00e9m observa a defini\u00e7\u00e3o do cluster do couchbase e v\u00ea que precisa ter 7 pods ou 7 n\u00f3s do couchbase no total, v\u00ea que um deles falhou, aguarda o autoFailoverTimeout e cria um novo pod, junta-se ao cluster e a opera\u00e7\u00e3o de rebalanceamento \u00e9 executada.<\/p>\n
      Aqui na Couchase, acreditamos na diferencia\u00e7\u00e3o sustentada para melhor atender nossos clientes em termos de agilidade, desempenho e tecnologia de ponta. Isso certamente \u00e9 um divisor de \u00e1guas. Agradecemos seus coment\u00e1rios e esperamos facilitar sua jornada rumo aos microsservi\u00e7os com o Couchbase Autonomous Operator no kubernetes em execu\u00e7\u00e3o no AKS.<\/p>\n
      Refer\u00eancias<\/h4>\n
      https:\/\/docs.microsoft.com\/en-us\/azure\/aks\/azure-disks-dynamic-pv<\/p>\n
      https:\/\/docs.microsoft.com\/en-us\/azure\/aks\/tutorial-kubernetes-deploy-cluster<\/p>\n
      O novo Couchbase Autonomous Operator 1.0 para Kubernetes e OpenShift agora \u00e9 GA!<\/a><\/p><\/blockquote>\n