{"id":6914,"date":"2019-05-14T21:16:37","date_gmt":"2019-05-15T04:16:37","guid":{"rendered":"http:\/\/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\/es\/quick-start-with-helm\/","title":{"rendered":"Inicio r\u00e1pido: Despliegue de Couchbase Autonomous Operator con Helm"},"content":{"rendered":"

\u00bfQu\u00e9 es Helm?<\/span><\/h2>\n

Helm es una herramienta que agiliza la instalaci\u00f3n y gesti\u00f3n de aplicaciones en plataformas Kubernetes. El cuadro de Helm de Couchbase Autonomous Operator permite a los usuarios combinar definiciones de Kubernetes para recursos como Servicios, Roles y Despliegues en un \u00fanico paquete personalizable. Dado que Helm es esencialmente un gestor de paquetes para aplicaciones Kubernetes, todos los recursos instalados pueden ser gestionados y actualizados como una sola unidad utilizando un enfoque de todo o nada que asegura que cada dependencia necesaria para cada versi\u00f3n se instala correctamente al actualizar. Este blog describe c\u00f3mo usar Helm para instalar el Operador Aut\u00f3nomo Couchbase junto con un Cluster Couchbase en tu entorno Kubernetes.<\/span><\/p>\n

 <\/p>\n

Instalaci\u00f3n de Helm<\/span><\/h2>\n

Asumiendo que tienes un cluster kubernetes corriendo en al menos la versi\u00f3n 1.11, entonces est\u00e1s listo para comenzar con helm para desplegar un Cluster Couchbase. El primer paso es instalar el cliente de l\u00ednea de comandos Helm. Los siguientes comandos descargar\u00e1n y descomprimir\u00e1n el binario helm en una ruta ejecutable para linux (para un sistema operativo diferente ver <\/span>libera<\/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>Ejecute el siguiente comando para crear las reglas RBAC y ServiceAccount necesarias para el servicio 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 \u00faltimo, instale el servicio tiller en el cl\u00faster kubernetes:<\/span><\/p>\n
helm init --service-account tiller<\/pre>\n
\u00a1Hora de empezar a timonear!<\/p>\n
Instalaci\u00f3n de gr\u00e1ficos<\/span><\/h2>\n
Instalar la carta del operador<\/span><\/h2>\n
Couchbase Operator Chart despliega el controlador de admisi\u00f3n din\u00e1mico, el Operator en s\u00ed, y todos los recursos necesarios para ejecutarlos dentro de tu cluster.  Este es el poder\/magia de helm, ya que funciona de forma muy similar a un gestor de paquetes al representar un grupo de recursos como una \u00fanica unidad instalable y actualizable.<\/span><\/p>\n
Para instalar los gr\u00e1ficos deber\u00e1 dirigir el cliente helm a nuestro repositorio asociado con el siguiente comando:<\/span><\/p>\n
helm repo add couchbase https:\/\/couchbase-partners.github.io\/helm-charts\/<\/pre>\n
Y ahora vamos a instalar el gr\u00e1fico de operador:<\/span><\/p>\n
helm install --name op-example couchbase\/couchbase-operator<\/pre>\n
La instalaci\u00f3n devuelve una lista de comandos a ejecutar para comprobar los registros del 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 el primer comando para asegurarse de que el operador se ha iniciado correctamente:<\/span><\/p>\n
kubectl logs -f deployment\/op-example-couchbase-operator --namespace default<\/pre>\n
Y deber\u00edas ver que el operador est\u00e1 escuchando eventos, lo que significa que est\u00e1 esperando un cluster que gestionar:<\/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 la tabla de cl\u00fasteres de Couchbase<\/span><\/h2>\n
El gr\u00e1fico de cl\u00faster couchbase proporciona una versi\u00f3n templada del tipo de cl\u00faster couchbase.  Por defecto, este gr\u00e1fico instalar\u00e1 un cluster de 3 nodos. Si tiene curiosidad sobre los detalles de este gr\u00e1fico, puede ver los valores predeterminados con el siguiente comando:<\/span><\/p>\n
helm inspect couchbase\/couchbase-cluster<\/pre>\n
Ahora vamos a poner en marcha un cluster instalando la tabla de cluster con el siguiente comando:<\/span><\/p>\n
helm install --name cb-example couchbase\/couchbase-cluster<\/pre>\n
La instalaci\u00f3n devuelve los pasos para obtener el estado del cl\u00faster junto con una forma r\u00e1pida de ver la consola de administraci\u00f3n.\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 a ejecutar el segundo comando para ver la consola:<\/span><\/p>\n
kubectl port-forward --namespace default cb-example-couchbase-cluster-0000 8091:8091\r\n<\/pre>\n
Este comando crear\u00e1 un proxy de la consola de administraci\u00f3n a su localhost en el puerto 8091. Navegue a <\/span>https:\/\/localhost:8091<\/span><\/a> para ver el cl\u00faster.  Si a\u00fan no ve el cl\u00faster, ejecute kubectl describe po cb-example-couchbase-cluster-0000<\/span>\u00a0 para obtener el estado del Pod que se est\u00e1 reenviando porque puede ser que las im\u00e1genes a\u00fan se est\u00e9n creando, lo que suele ocurrir cuando se ejecuta en un cl\u00faster completamente nuevo.<\/span><\/p>\n
Gesti\u00f3n de gr\u00e1ficos<\/span><\/h2>\n
En este punto deber\u00eda tener al menos dos gr\u00e1ficos instalados, uno para el operador y otro para el cluster.  Para ver la lista de gr\u00e1ficos instalados, ejecute lista de cascos<\/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
Cuando se instala una carta, Helm la denomina\u00a0liberar<\/code>. Puede instalar varias versiones desde un \u00fanico gr\u00e1fico. Cuando se elimina una versi\u00f3n mediante helm delete<\/code>todos sus recursos empaquetados (Pods, Servicios, Secretos) tambi\u00e9n son eliminados.  Para m\u00e1s informaci\u00f3n sobre c\u00f3mo personalizar el operador y el gr\u00e1fico de cluster, consulta la documentaci\u00f3n de Couchbase Operator en Actualizaci\u00f3n de una versi\u00f3n<\/a>.<\/p>\n
Instalaci\u00f3n con TLS y vol\u00famenes persistentes<\/span><\/h2>\n
Para crear un cluster con TLS y Persistent Volumes utilizaremos el template overriding de helm para proporcionar personalizaciones del gr\u00e1fico del cluster.<\/span><\/p>\n
Cree un archivo llamado misvalores.yaml<\/code> con los siguientes 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 helm ha autogenerado el certificado de CA utilizado por el operador y los clientes junto con el certificado y la clave del 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 ver la consola de administraci\u00f3n, ejecute el comando de reenv\u00edo de puerto desde el puerto de administraci\u00f3n habilitado para TLS (18091) de un pod a su localhost con el siguiente comando:<\/span><\/p>\n
kubectl port-forward --namespace default cbs-example-couchbase-cluster-0000 18091:18091<\/pre>\n
Vaya a <\/span>https:\/\/localhost:18091<\/span><\/a> para ver el cl\u00faster.<\/span><\/p>\n
Seguir adelante<\/span><\/h2>\n
Si est\u00e1s pensando \"eso ha sido demasiado f\u00e1cil\", probablemente tengas raz\u00f3n.  Si piensa: \"Quiero saber m\u00e1s\", eche un vistazo a la secci\u00f3n Gu\u00eda de instalaci\u00f3n<\/a> para conocer las mejores pr\u00e1cticas a la hora de poner su entorno en producci\u00f3n.<\/p>\n
M\u00e1s recursos sobre el operador aut\u00f3nomo Couchbase<\/h4>\n