{"id":6914,"date":"2019-05-14T21:16:37","date_gmt":"2019-05-15T04:16:37","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=6914"},"modified":"2025-06-13T21:33:43","modified_gmt":"2025-06-14T04:33:43","slug":"quick-start-with-helm","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/quick-start-with-helm\/","title":{"rendered":"In\u00edcio r\u00e1pido: Implantar o operador aut\u00f4nomo do Couchbase com o Helm"},"content":{"rendered":"

O que \u00e9 o Helm?<\/span><\/h2>\n

O Helm \u00e9 uma ferramenta que simplifica a instala\u00e7\u00e3o e o gerenciamento de aplicativos em plataformas Kubernetes. O gr\u00e1fico do Helm do Couchbase Autonomous Operator permite que os usu\u00e1rios combinem defini\u00e7\u00f5es do Kubernetes para recursos como servi\u00e7os, fun\u00e7\u00f5es e implanta\u00e7\u00f5es em um \u00fanico pacote personaliz\u00e1vel. Como o Helm \u00e9 essencialmente um gerenciador de pacotes para aplicativos do Kubernetes, todos os recursos instalados podem ser gerenciados e atualizados como uma \u00fanica unidade usando uma abordagem do tipo tudo ou nada, que garante que todas as depend\u00eancias necess\u00e1rias para cada vers\u00e3o sejam instaladas com \u00eaxito durante a atualiza\u00e7\u00e3o. Este blog descreve como usar o Helm para instalar o Operador Aut\u00f4nomo do Couchbase junto com um Cluster do Couchbase no seu ambiente do Kubernetes.<\/span><\/p>\n

 <\/p>\n

Instalando o Helm<\/span><\/h2>\n

Supondo que voc\u00ea tenha um cluster do Kubernetes em execu\u00e7\u00e3o pelo menos na vers\u00e3o 1.11, est\u00e1 tudo pronto para come\u00e7ar a usar o helm para implantar um cluster do Couchbase. A primeira etapa \u00e9 instalar o cliente de linha de comando Helm. Os comandos a seguir far\u00e3o o download e descompactar\u00e3o o bin\u00e1rio do helm em um caminho execut\u00e1vel para o Linux (para um sistema operacional diferente, consulte <\/span>libera\u00e7\u00f5es<\/span><\/a>)<\/span><\/p>\n

# Install helm\r\nwget https:\/\/storage.googleapis.com\/kubernetes-helm\/helm-v2.13.1-linux-amd64.tar.gz\r\ntar -zxvf helm-v2.13.1-linux-amd64.tar.gz\r\nsudo mv linux-amd64\/helm \/usr\/local\/bin\/helm\r\n\r\n<\/pre>\n
Now let’s install Helms templating service which is called `tiller`<\/strong><\/em>. Tiller does all the work of interacting directly with the Kubernetes API for creating resources like Services, Secrets, and Pods. \u00a0As with every good quick-start guide, we\u2019re going to be a bit loose with security for the sake of brevity, which means giving the `tiller` service the ability to create resources within any Kubernetes namespace. \u00a0<\/span>Execute o seguinte comando para criar as regras RBAC e a ServiceAccount necess\u00e1rias para o servi\u00e7o Tiller:<\/span><\/p>\n
echo \"apiVersion: v1\r\nkind: ServiceAccount\r\nmetadata:\r\n  name: tiller\r\n  namespace: kube-system\r\n---\r\napiVersion: rbac.authorization.k8s.io\/v1\r\nkind: ClusterRoleBinding\r\nmetadata:\r\n  name: tiller\r\nroleRef:\r\n  apiGroup: rbac.authorization.k8s.io\r\n  kind: ClusterRole\r\n  name: cluster-admin\r\nsubjects:\r\n  - kind: ServiceAccount\r\n    name: tiller\r\n    namespace: kube-system\" | kubectl create -f -\r\n<\/pre>\n
Por fim, instale o servi\u00e7o tiller no cluster do kubernetes:<\/span><\/p>\n
helm init --service-account tiller<\/pre>\n
\u00c9 hora de come\u00e7ar a pilotar!<\/p>\n
Instala\u00e7\u00e3o de gr\u00e1ficos<\/span><\/h2>\n
Instalar o diagrama do operador<\/span><\/h2>\n
O Couchbase Operator Chart implementa o controlador de admiss\u00e3o din\u00e2mica, o pr\u00f3prio Operator e todos os recursos necess\u00e1rios para execut\u00e1-los em seu cluster.  Esse \u00e9 o poder\/m\u00e1gica do helm, pois ele funciona de forma muito semelhante a um gerenciador de pacotes, representando um grupo de recursos como uma \u00fanica unidade instal\u00e1vel e atualiz\u00e1vel.<\/span><\/p>\n
Para instalar os gr\u00e1ficos, voc\u00ea precisar\u00e1 apontar o cliente helm para o nosso reposit\u00f3rio de parceiros com o seguinte comando:<\/span><\/p>\n
helm repo add couchbase https:\/\/couchbase-partners.github.io\/helm-charts\/<\/pre>\n
E agora vamos instalar o gr\u00e1fico do operador:<\/span><\/p>\n
helm install --name op-example couchbase\/couchbase-operator<\/pre>\n
A instala\u00e7\u00e3o retorna uma lista de comandos a serem executados para verificar os registros do operador. \u00a0<\/span><\/p>\n
NOTES: \r\n\r\n1. couchbase-operator deployed. Check the couchbase-operator logs\r\nkubectl logs -f deployment\/op-example-couchbase-operator --namespace default \r\n\r\n2. admission-controller deployed. Check the admission-controller logs\r\nkubectl logs -f deployment\/op-example-couchbase-admission-controller --namespace default<\/pre>\n
Copie o primeiro comando para garantir que o operador tenha iniciado com \u00eaxito:<\/span><\/p>\n
kubectl logs -f deployment\/op-example-couchbase-operator --namespace default<\/pre>\n
E voc\u00ea deve ver que o operador est\u00e1 escutando eventos, o que significa que ele est\u00e1 esperando um cluster para gerenciar:<\/p>\n
time=\"2019-05-02T23:42:12Z\" level=info msg=\"couchbase-operator v1.2.0 (release)\" module=main\r\n...\r\ntime=\"2019-05-02T23:42:28Z\" level=info msg=\"CRD initialized, listening for events...<\/pre>\n
 <\/p>\n
Instalar o gr\u00e1fico do cluster do Couchbase<\/span><\/h2>\n
O gr\u00e1fico de cluster do couchbase fornece uma vers\u00e3o de modelo do tipo de cluster do couchbase.  Por padr\u00e3o, esse gr\u00e1fico instalar\u00e1 um cluster de 3 n\u00f3s. Se voc\u00ea estiver curioso sobre os detalhes desse gr\u00e1fico, poder\u00e1 exibir os valores padr\u00e3o com o seguinte comando:<\/span><\/p>\n
helm inspect couchbase\/couchbase-cluster<\/pre>\n
Agora, vamos colocar um cluster em execu\u00e7\u00e3o instalando o gr\u00e1fico de cluster com o seguinte comando:<\/span><\/p>\n
helm install --name cb-example couchbase\/couchbase-cluster<\/pre>\n
A instala\u00e7\u00e3o retorna etapas para obter o status do cluster, juntamente com uma maneira r\u00e1pida de visualizar o console do administrador.\u00a0<\/span><\/p>\n
NOTES: \r\n1. Get couchbase cluster status \u00a0\r\nkubectl describe --namespace default couchbasecluster cb-example-couchbase-cluster \r\n\r\n2. Connect to Admin console \u00a0\r\nkubectl port-forward --namespace default cb-example-couchbase-cluster-0000 8091:8091 \u00a0# open https:\/\/localhost:8091<\/pre>\n
\u00a0Vamos executar o segundo comando para visualizar o console:<\/span><\/p>\n
kubectl port-forward --namespace default cb-example-couchbase-cluster-0000 8091:8091\r\n<\/pre>\n
Esse comando criar\u00e1 um proxy do console administrativo para o seu host local na porta 8091. Navegue at\u00e9 <\/span>https:\/\/localhost:8091<\/span><\/a> para visualizar o cluster.  Se voc\u00ea ainda n\u00e3o estiver vendo o cluster, execute kubectl describe po cb-example-couchbase-cluster-0000<\/span>\u00a0 para obter o status do POD que est\u00e1 sendo encaminhado, pois pode ser que as imagens ainda estejam sendo criadas, o que geralmente acontece quando se executa em um cluster totalmente novo.<\/span><\/p>\n
Gerenciando gr\u00e1ficos<\/span><\/h2>\n
Nesse ponto, voc\u00ea deve ter pelo menos dois gr\u00e1ficos instalados, um para o operador e outro para o cluster.  Para visualizar a lista de gr\u00e1ficos instalados, execute lista de lemes<\/code>:<\/p>\n
~$ helm list\r\n\r\nNAME      \tREVISION\tUPDATED                 \tSTATUS  \tCHART                   \tAPP VERSION\tNAMESPACE\r\ncb-example\t1       \tThu May  9 23:44:31 2019\tDEPLOYED\tcouchbase-cluster-0.1.2 \t1.2        \tdefault  \r\nop-example\t1       \tThu May  9 23:40:36 2019\tDEPLOYED\tcouchbase-operator-0.1.2\t1.2        \tdefault<\/pre>\n
Quando um gr\u00e1fico \u00e9 instalado, ele \u00e9 chamado pelo Helm de\u00a0libera\u00e7\u00e3o<\/code>. Voc\u00ea pode instalar v\u00e1rias vers\u00f5es a partir de um \u00fanico gr\u00e1fico. Quando uma vers\u00e3o \u00e9 exclu\u00edda usando exclus\u00e3o do leme<\/code>todos os seus recursos empacotados (Pods, Servi\u00e7os, Segredos) tamb\u00e9m s\u00e3o exclu\u00eddos.  Para obter mais informa\u00e7\u00f5es sobre como personalizar o operador e o gr\u00e1fico do cluster, consulte a documenta\u00e7\u00e3o do Couchbase Operator em Atualiza\u00e7\u00e3o de uma vers\u00e3o<\/a>.<\/p>\n
Instala\u00e7\u00e3o com TLS e volumes persistentes<\/span><\/h2>\n
Para criar um cluster com TLS e Volumes persistentes, usaremos a substitui\u00e7\u00e3o de modelo do helm para fornecer personaliza\u00e7\u00f5es do gr\u00e1fico de cluster.<\/span><\/p>\n
Crie um arquivo chamado myvalues.yaml<\/code> com os seguintes valores:<\/span><\/p>\n
echo \"couchbaseCluster:\r\n  servers:\r\n    all_services:\r\n      pod:\r\n        volumeMounts:\r\n          default: couchbase\r\n          data:  couchbase\r\n  securityContext:\r\n    fsGroup: 1000\r\n  volumeClaimTemplates:\r\n    - metadata:\r\n        name: couchbase\r\n      spec:\r\n        storageClassName: default\r\n        resources:\r\n          requests:\r\n            storage: 1Gi\r\ncouchbaseTLS:\r\n  create: true\" > myvalues.yaml\r\n<\/pre>\n
The above values assume you have a storage class named `default`, if this is not the case then change it to the appropriate value for your environment. \u00a0Now install the cluster chart with the value overrides:<\/span><\/p>\n
helm install \u00a0--name cbs-example -f myvalues.yaml couchbase\/couchbase-cluster<\/pre>\n
Observe que o helm gerou automaticamente o certificado CA usado pelo operador e pelos clientes, juntamente com o certificado e a chave do servidor.<\/span><\/p>\n
RESOURCES:\r\n==> v1\/Secret\r\nNAME \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0AGE\r\ncbs-example-couchbase-cluster \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a01s\r\ncbs-example-couchbase-cluster-server-tls \u00a0\u00a0\u00a01s\r\ncbs-example-couchbase-cluster-operator-tls \u00a01s<\/pre>\n
Para visualizar o console de administra\u00e7\u00e3o, execute o comando de encaminhamento de porta da porta de administra\u00e7\u00e3o ativada por TLS (18091) de um pod para o seu host local com o seguinte comando:<\/span><\/p>\n
kubectl port-forward --namespace default cbs-example-couchbase-cluster-0000 18091:18091<\/pre>\n
Navegue at\u00e9 <\/span>https:\/\/localhost:18091<\/span><\/a> para visualizar o cluster.<\/span><\/p>\n
Seguindo em frente<\/span><\/h2>\n
Se voc\u00ea estiver pensando \"isso foi muito f\u00e1cil\", provavelmente est\u00e1 certo.  Se estiver pensando: \"Quero saber mais\", d\u00ea uma olhada na p\u00e1gina Guia de configura\u00e7\u00e3o<\/a> para conhecer as pr\u00e1ticas recomendadas para levar seu ambiente \u00e0 produ\u00e7\u00e3o!<\/p>\n
Mais recursos do operador aut\u00f4nomo do Couchbase<\/h4>\n