# Guía Paso a Paso para Integrar un Clúster de Kubernetes con GitLab para Despliegues Automáticos con Helm

- Link: https://binariocero.com/linux/guia-paso-a-paso-para-integrar-un-cluster-de-kubernetes-con-gitlab-para-despliegues-automaticos-con-helm
- Published: 2024-11-28T12:52:12+01:00
- Author: Binario 0

![Loading](https://binariocero.com/wp-content/plugins/page-views-count/ajax-loader-
2x.gif)

Guía paso a paso para enganchar un clúster de Kubernetes a un repositorio de GitLab
para despliegues automatizados con Helm:

### Paso 1: Preparar el clúster de Kubernetes

Antes de integrar GitLab con Kubernetes, asegúrate de que tu clúster de Kubernetes
esté funcionando y accesible.

 1. **Instala y configura `kubectl`** para instalar `kubectl`.
 2. **Configura el acceso a tu clúster**: Usa el archivo de configuración de Kubernetes(`
    kubeconfig`) para autenticarte en el clúster. Ejemplo de configuración:
    `export
    KUBECONFIG=~/.kube/config`
 3. **Verifica la conexión**:
    `kubectl get nodes `Deberías ver una lista de nodos de
    tu clúster.

### Paso 2: Configurar GitLab CI/CD

 1. **Crear un proyecto en GitLab**:
 2.  * Accede a tu cuenta de GitLab y crea un nuevo proyecto.
     * Clona el repositorio en tu máquina local o configura un repositorio existente
       en GitLab.
 3. **Agregar el archivo `.gitlab-ci.yml`**: En el repositorio de GitLab, crea un archivo`.
    gitlab-ci.yml` en la raíz. Este archivo define el pipeline de CI/CD.
    Aquí hay un
    ejemplo básico de `.gitlab-ci.yml` para desplegar en Kubernetes usando Helm:`stages:``-
    deploy ``variables: ` `KUBERNETES_SERVER: "https://your-k8s-api-server" ` `KUBERNETES_NAMESPACE:"
    default" ` `HELM_RELEASE_NAME: "my-release" ` `HELM_CHART_PATH: "./chart" # Ruta
    al chart de Helm ``before_script: ` `- apt-get update -qq && apt-get install -y
    curl ` `- curl https://get.helm.sh/helm-v3.9.1-linux-amd64.tar.gz -o helm.tar.gz``-
    tar -zxvf helm.tar.gz ` `- mv linux-amd64/helm /usr/local/bin/helm ``deploy: ` `
    stage: deploy ` `script: ` `- echo $KUBE_CONFIG | base64 -d > /root/.kube/config``-
    helm upgrade --install $HELM_RELEASE_NAME $HELM_CHART_PATH --namespace $KUBERNETES_NAMESPACE--
    create-namespace ` `only: ` `- main # Solo se desplegará en la rama main`

### Paso 3: Configurar los secretos de Kubernetes en GitLab

Para que GitLab pueda acceder a tu clúster de Kubernetes, debes configurar el acceso
mediante un `Kubeconfig` codificado en base64.

 1. **Obtener el archivo `kubeconfig` de Kubernetes**: En tu entorno de Kubernetes,
    obtén el archivo `kubeconfig` usando:
    `kubectl config view --raw > kubeconfig`
 2. **Codificar el archivo `kubeconfig` en base64**: Codifica el archivo `kubeconfig`:
    `
    cat kubeconfig | base64`
 3. **Agregar el secreto en GitLab**:
 4.  * Entra al proyecto de GitLab y ve a `Settings > CI / CD`.
     * En la sección "Variables", agrega una nueva variable:
        - **Key**: `KUBE_CONFIG`
        - **Value**: el valor codificado en base64 de tu archivo `kubeconfig`.

### Paso 4: Instalar y configurar Helm

 1. **Instalar Helm en tu máquina local**.
 2. **Configurar el repositorio de Helm**: Si usas charts desde un repositorio, añade
    el repositorio de Helm:
    `helm repo add my-repo https://charts.example.com ``helm
    repo update`

### Paso 5: Desplegar usando GitLab CI/CD

 1. **Haz un commit y push de tu archivo `.gitlab-ci.yml`**: Asegúrate de que el archivo`.
    gitlab-ci.yml` esté en la rama correcta (por ejemplo, `main`) y haz commit:
    `git
    add .gitlab-ci.yml ``git commit -m "Add GitLab CI/CD pipeline for Kubernetes deployment"``
    git push origin main`
 2. **Verificar el pipeline**: Después de hacer el push, GitLab comenzará a ejecutar
    el pipeline automáticamente. Ve a la página de CI/CD en GitLab y revisa el progreso
    del pipeline.
 3. **Desplegar con Helm**: Si todo está configurado correctamente, el pipeline ejecutará
    Helm en tu clúster de Kubernetes, desplegando tu aplicación automáticamente.

### Paso 6: Monitoreo y mantenimiento

 * **Verifica el estado del despliegue**: Puedes usar `kubectl` para verificar que
   la aplicación está desplegada correctamente:
   `kubectl get pods --namespace=default`
 * **Realiza cambios y actualiza**: Cada vez que actualices tu código en GitLab 
   y hagas push, el pipeline de CI/CD se ejecutará nuevamente, asegurando que siempre
   tengas la versión más reciente de la aplicación desplegada.

### Conclusión

Este proceso configura una integración continua con GitLab y Helm para desplegar
aplicaciones automáticamente en un clúster de Kubernetes. Puedes personalizar aún
más el pipeline según las necesidades específicas de tu proyecto.
