# Autoaloja con Helm Este artículo le guiará a través del procedimiento para instalar y desplegar Bitwarden en diferentes despliegues de Kubernetes utilizando un gráfico de Helm. Este artículo describirá los pasos genéricos para alojar Bitwarden en Kubernetes. Guías específicas del proveedor están disponibles para profundizar en cómo podrías alterar una implementación basada en las ofertas específicas de cada proveedor: - [Despliegue de Azure AKS](https://bitwarden.com/es-la/help/azure-aks-deployment/) - [Despliegue de OpenShift](https://bitwarden.com/es-la/help/openshift-deployment/) - [Despliegue de AWS EKS](https://bitwarden.com/es-la/help/aws-eks-deployment/) ## Requisitos Antes de proceder con la instalación, asegúrese de que se cumplan los siguientes requisitos: - [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl) está instalado. - [Helm 3](https://helm.sh/docs/intro/install/) está instalado. - Tienes un certificado SSL y una clave o acceso para crear uno a través de un proveedor de certificados. - Tienes un servidor SMTP o acceso a un proveedor de SMTP en la nube. - Una [clase de almacenamiento](https://kubernetes.io/docs/concepts/storage/persistent-volumes/#access-modes) que admite ReadWriteMany. - Tienes una identificación de instalación y una clave obtenida de [https://bitwarden.com/host](https://bitwarden.com/es-la/host/). ## Prepara el gráfico ### Agrega el repositorio a Helm Agrega el repositorio a Helm usando los siguientes comandos: ```bash helm repo add bitwarden https://charts.bitwarden.com/ helm repo update ``` ### Crear un espacio de nombres Crea un espacio de nombres para desplegar Bitwarden. Nuestra documentación asume un espacio de nombres llamado `Bitwarden`, así que asegúrate de modificar los comandos si eliges un nombre diferente. ```bash kubectl create namespace bitwarden ``` ### Crear una configuración Crea un archivo de configuración `my-values.yaml`, que utilizarás para personalizar tu implementación, utilizando el siguiente comando: ```bash helm show values bitwarden/self-host > my-values.yaml ``` Como mínimo, debes configurar los siguientes valores en tu archivo `my-values.yaml`: | Valor | Descripción | |------|------| | `dominio.general:` | El dominio que apuntará a la dirección IP pública de tu clúster. | | `general.ingress.habilitado:` | Si usar el controlador de ingreso nginx definido en el gráfico ([ver un ejemplo usando un controlador de ingreso no incluido](https://bitwarden.com/es-la/help/self-host-with-helm/#adding-rawmanifest-files/)). | | `general.ingreso.nombreClase:` | Por ejemplo, `"nginx"` o `"azure-application-gateway"` ([ver un ejemplo](https://bitwarden.com/es-la/help/azure-aks-deployment/#azure-application-gateway/)). Establezca `general.ingress.enabled: false` para usar otros controladores de ingreso. | | `general.ingress.anotaciones:` | Anotaciones para agregar al controlador de ingreso. Si está utilizando el controlador nginx incluido, se proporcionan valores predeterminados que debe descomentar y personalizar según sea necesario. | | `general.ingreso.caminos:` | Si estás utilizando el controlador nginx predeterminado, se proporcionan valores predeterminados que puedes personalizar según sea necesario. | | `general.ingress.cert.tls.nombre:` | El nombre de tu certificado TLS. Caminaremos a través de [un ejemplo](https://bitwarden.com/es-la/help/self-host-with-helm/#example-certificate-setup/) más tarde, así que ingrésalo ahora si lo tienes o vuelve más tarde. | | `general.ingress.cert.tls.clusterIssuer:` | El nombre de su emisor de certificado TLS. Caminaremos a través de [un ejemplo](https://bitwarden.com/es-la/help/self-host-with-helm/#example-certificate-setup/) más tarde, así que ingrésalo ahora si lo tienes o vuelve más tarde. | | `general.email.responderAlCorreo:` | Dirección de correo electrónico utilizada para invitaciones, típicamente `no_reply@smtp_host`. | | `general.email.smtpHost:` | El nombre de host o la dirección IP de su servidor SMTP. | | `general.email.smtpPort:` | El puerto SMTP utilizado por el servidor SMTP. | | `general.email.smtpSsl:` | Si su servidor SMTP utiliza un protocolo de cifrado (`verdadero` = SSL, `falso` = TLS). | | `habilitarComunicacionEnLaNube:` | Establezca en `verdadero `para permitir la comunicación entre su servidor y nuestro sistema en la nube. Hacerlo [permite la sincronización de facturación y licencia](https://bitwarden.com/es-la/help/self-host-an-organization/#step-4-setup-billing-and-license-sync/). | | `región de nube` | Por defecto, `EE.UU.`. Establezca en `EU` si su organización fue iniciada a través del [servidor en la nube de la UE](https://bitwarden.com/es-la/help/server-geographies/). | | `sharedStorageClassName:` | El nombre de la clase de almacenamiento compartido, que deberá proporcionar y debe admitir [ReadWriteMany](https://kubernetes.io/docs/concepts/storage/persistent-volumes/#access-modes) ([vea un ejemplo usando Azure File Storage](https://bitwarden.com/es-la/help/azure-aks-deployment/#creating-a-storage-class/)) a menos que sea un clúster de un solo nodo. | | `secrets.nombreSecreto:` | El nombre de tu [objeto secreto de Kubernetes](https://kubernetes.io/docs/tasks/inject-data-application/distribute-credentials-secure/#define-container-environment-variables-using-secret-data). Crearás este objeto en el próximo paso, así que decide un nombre ahora o vuelve a este valor más tarde. | | `base de datos habilitada:` | Si usar o no el pod SQL incluido en el gráfico. Solo establezca en `falso` si está utilizando un servidor SQL externo. | | `componente.scim.habilitado` | El pod SCIM está desactivado por defecto. Para habilitar el pod SCIM, establece el valor `= verdadero`. | | `componente.volumen.registros.habilitado:` | Aunque no es necesario, recomendamos ajustar a `verdadero` para fines de resolución de problemas. | ### Crea un objeto secreto Crea un [objeto secreto de Kubernetes](https://kubernetes.io/docs/tasks/inject-data-application/distribute-credentials-secure/#define-container-environment-variables-using-secret-data) para establecer, como mínimo, los siguientes valores: | Valor | Descripción | |------|------| | `configuraciónGlobal__instalación__id` | Una id de instalación válida obtenida de [https://bitwarden.com/host](https://bitwarden.com/es-la/host/). Para obtener más información, consulte [¿Para qué se utilizan mi ID de instalación y mi clave de instalación?](https://bitwarden.com/es-la/help/hosting-faqs/#general/) | | `configuraciónGlobal__instalación__clave` | Una clave de instalación válida obtenida de [https://bitwarden.com/host](https://bitwarden.com/es-la/host/). Para obtener más información, consulte [¿Para qué se utilizan mi ID de instalación y mi clave de instalación?](https://bitwarden.com/es-la/help/hosting-faqs/#general/) | | `configuracionesGlobales__correo__smtp__nombreDeUsuario` | Un nombre de usuario válido para su servidor SMTP. | | `configuracionesGlobales__correo__smtp__contraseña` | Una contraseña válida para el nombre de usuario ingresado del servidor SMTP. | | `globalSettings__yubico__IdCliente` | ID de cliente para el Servicio de Validación YubiCloud o el Servidor de Validación Yubico autoalojado. Si es YubiCloud, obtenga su ID de cliente y clave secreta [aquí](https://upgrade.yubico.com/getapikey/). | | `configuraciónGlobal__yubico__clave` | Clave secreta para el Servicio de Validación YubiCloud o el Servidor de Validación Yubico autoalojado. Si es YubiCloud, obtenga su ID de cliente y clave secreta [aquí](https://upgrade.yubico.com/getapikey/). | | `globalSettings__hibpApiKey` | Tu clave API de HaveIBeenPwned (HIBP), disponible [aquí](https://haveibeenpwned.com/API/Key). Esta clave permite a los usuarios ejecutar el [informe de filtración de datos](https://bitwarden.com/es-la/help/reports/#data-breach-individual-vaults-only/) y verificar su contraseña maestra para presencia en filtraciones cuando crean una cuenta. | | Si estás utilizando el pod SQL de Bitwarden, `SA_PASSWORD` Si estás utilizando tu propio servidor SQL, `globalSettings__sqlServer__connectionString` | Credenciales para la base de datos conectada a tu instancia de Bitwarden. Lo que se requiere dependerá de si está utilizando el pod SQL incluido o un servidor SQL externo. | Por ejemplo, usar el comando `kubectl create secret` para establecer estos valores se vería de la siguiente manera: > [!WARNING] Insecure way of setting a secret > Este ejemplo registrará comandos en el historial de tu terminal. Otros métodos pueden ser considerados para ajustar de manera segura un secreto. ```bash kubectl create secret generic custom-secret -n bitwarden \ --from-literal=globalSettings__installation__id="REPLACE" \ --from-literal=globalSettings__installation__key="REPLACE" \ --from-literal=globalSettings__mail__smtp__username="REPLACE" \ --from-literal=globalSettings__mail__smtp__password="REPLACE" \ --from-literal=globalSettings__yubico__clientId="REPLACE" \ --from-literal=globalSettings__yubico__key="REPLACE" \ --from-literal=globalSettings__hibpApiKey="REPLACE" \ --from-literal=SA_PASSWORD="REPLACE" ``` No olvides establecer el valor de `secrets.secretName:` en `my-values.yaml` al nombre del secreto creado, en este caso `custom-secret`. ### Ejemplo de configuración de certificado El despliegue requiere un certificado y clave TLS, o acceso a la creación de uno a través de un proveedor de certificados. El siguiente ejemplo te guiará a través del uso de [cert-manager](https://cert-manager.io/docs/) para generar un certificado con Let's Encrypt: 1. Instale cert-manager en el clúster utilizando el siguiente comando: ```bash kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.11.0/cert-manager.yaml ``` 2. Definir un emisor de certificados. Bitwarden recomienda usar la configuración de **Staging** en este ejemplo hasta que tus registros DNS hayan sido apuntados a tu clúster. Asegúrate de reemplazar el marcador de posición `correo electrónico:` con un valor válido: ### Escenificación ```bash cat <