Implementar y administrar la extensión TKG para la detección de servicios de DNS externos

El DNS externo permite configurar registros de DNS de forma dinámica en función de los servicios con carga equilibrada de Kubernetes. Puede implementar la extensión TKG para DNS externo a fin de proporcionar la detección dinámica de servicios para el clúster.

Requisitos previos de la extensión

Cumpla los siguientes requisitos antes de implementar la extensión TKG v1.3.1 para DNS externo.

• Aprovisionar un clúster de Tanzu Kubernetes. Consulte Flujo de trabajo para aprovisionar clústeres de Tanzu Kubernetes mediante la API v1alpha2 de TKGS.
• Conectarse al clúster de Tanzu Kubernetes. Consulte Conectarse a un clúster de Tanzu Kubernetes como usuario de vCenter Single Sign-On.
• Descargar el paquete de extensiones TKG v1.3.1 Al host cliente en el que se ejecuta kubectl.
• Instalar los requisitos previos de las extensiones TKG en el clúster de Tanzu Kubernetes de destino.

Otros requisitos

Las configuraciones de muestra proporcionadas con la extensión DNS externo incluyen ejemplos con y sin el controlador de entrada de Contour. Si utiliza Contour, instálelo antes de instalar la extensión DNS externo. Consulte Implementar y administrar la extensión TKG para la entrada de Contour.

La extensión DNS externo permite la detección dinámica de servicios. Un caso de uso común es con el registro de Harbor. Harbor requiere una zona de DNS configurada en un proveedor de DNS dinámico compatible con RFC 2136, como AWS Route53, Azure DNS, Google Cloud DNS o un servidor DNS local como BIND. Consulte Implementar y administrar la extensión TKG para el registro de Harbor.

Implementar la extensión DNS externo

Complete los siguientes pasos antes de instalar la extensión TKG v1.3.1 para DNS externo.

1. Cambie el directorio en el que descargó los archivos de la extensión DNS externo.

   cd /tkg-extensions-v1.3.1+vmware.1/extensions/service-discovery/external-dns

2. Cree el espacio de nombres y varios objetos de control de acceso basado en funciones para usarlos con la extensión DNS externo.

   kubectl apply -f namespace-role.yaml

   Este comando crea el espacio de nombres tanzu-system-service-discovery y los objetos RBAC asociados. Ejecute kubect get ns para comprobarlos.

3. Cree un archivo de valores de datos. El archivo de valores de datos de ejemplo proporciona la configuración mínima que se pide.

   Hay archivos de valores de datos de ejemplo para AWS, Azure y un proveedor de DNS dinámico compatible con RFC 2136; cada uno con y sin entrada de Contour. Elija el archivo de ejemplo adecuado y cópielo.

   Por ejemplo, si utiliza AWS Route 53 con Contour, ejecute el siguiente comando.

   cp external-dns-data-values-aws-with-contour.yaml.example external-dns-data-values-aws-with-contour.yaml

   O bien, si utiliza Azure con Contour, ejecute el siguiente comando.

   cp external-dns-data-values-azure-with-contour.yaml.example external-dns-data-values-azure-with-contour.yaml

4. Configure los valores de datos de DNS externos.

   Por ejemplo, a continuación se muestra la configuración de DNS de Azure. Proporcione los valores de domain-filter y azure-resource-group.

   #@data/values
   #@overlay/match-child-defaults missing_ok=True
   ---
   externalDns:
     image:
       repository: projects.registry.vmware.com/tkg
     deployment:
       #@overlay/replace
       args:
       - --provider=azure
       - --source=service
       - --source=ingress
       - --domain-filter=my-zone.example.org #! zone where services are deployed
       - --azure-resource-group=my-resource-group #! Azure resource group
       #@overlay/replace
       volumeMounts:
       - name: azure-config-file
         mountPath: /etc/kubernetes
         readOnly: true
       #@overlay/replace
       volumes:
       - name: azure-config-file
         secret:
           secretName: azure-config-file

5. Cree un secreto genérico con el archivo de valores de datos que ha rellenado.

   Por ejemplo, el siguiente comando crea el secreto mediante el archivo de valores de datos DNS de Azure.

   kubectl create secret generic external-dns-data-values --from-file=values.yaml=external-dns-data-values-azure-with-contour.yaml -n tanzu-system-service-discovery

   Debería ver que secret/external-dns-data-values created se ha creado en el espacio de nombres tanzu-system-service-discovery. Puede verificarlo con el comando kubectl get secrets -n tanzu-system-service-discovery.

6. Implemente la extensión DNS externo.

   kubectl apply -f external-dns-extension.yaml

   Si todo es correcto, debería ver app.kappctrl.k14s.io/external-dns created.

7. Compruebe el estado de la implementación de la extensión.

   kubectl get app external-dns -n tanzu-system-service-discovery

   El estado de la aplicación debe cambiar de Reconciling a Reconcile succeeded una vez que DNS externo se implemente correctamente. Si el estado es Reconcile failed, consulte Solucionar problemas de la implementación.
8. Ver estado detallado.

   kubectl get app external-dns -n tanzu-system-service-discovery -o yaml

Solucionar problemas de la implementación

Si se produce un error en la reconciliación, ejecute el comando kubectl get pods -A para ver el estado de los pods. En condiciones normales, debería ver que el estado del pod external-dns-XXXXX es Running. Si se produce un error en la reconciliación o el estado del pod es ImagePullBackOff o ImagecRashLoopBackOff, quiere decir que no se pudo extraer la imagen del contenedor del repositorio. Compruebe la dirección URL del repositorio en los valores de datos y los archivos YAML de extensión, y asegúrese de que sean precisos.

Para comprobar los registros del contenedor, ejecute los siguientes comandos, donde name-XXXX es el nombre único del pod que puede ver cuando ejecuta kubectl get pods -A:

kubectl logs pod/external-dns-XXXXX -c external-dns -n tanzu-system-service-discovery

Actualizar la extensión DNS externo

Actualice la extensión DNS externo que está implementada en el clúster de Tanzu Kubernetes.

1. Obtenga los valores de datos de Contour del secreto.

   kubectl get secret external-dns-data-values -n tanzu-system-service-discovery -o 'go-template={{ index .data "values.yaml" }}' | base64 -d > external-dns-data-values.yaml

2. Actualice los valores de datos de DNS externo en external-dns-data-values.yaml. Consulte Configurar la extensión DNS externo.
3. Actualice el secreto de los valores de datos de Contour.

   kubectl create secret generic external-dns-data-values --from-file=values.yaml=external-dns-data-values.yaml -n tanzu-system-service-discovery -o yaml --dry-run | kubectl replace -f-

   La extensión DNS externo se conciliará con los nuevos valores de datos.

   Nota: De forma predeterminada, kapp-controller sincronizará las aplicaciones cada 5 minutos. La actualización debería tener efecto en 5 minutos o menos. Si desea que la actualización se aplique inmediatamente, cambie los valores de syncPeriod en external-dns-extension a un valor menor y aplique la extensión de Contour mediante kubectl apply -f external-dns-extension.
4. Compruebe el estado de la extensión.

   kubectl get app external-dns -n tanzu-system-service-disovery

   El estado de la aplicación debe cambiar a Reconcile Succeeded una vez que se actualice.

5. Vea el estado detallado y solucione los problemas.

   kubectl get app external-dns -n tanzu-system-service-disovery -o yaml

Eliminar la extensión DNS externo

Elimine la extensión DNS externo de un clúster de Tanzu Kubernetes.

Nota: Complete los pasos en orden. No elimine los objetos de función ni el espacio de nombres de destino antes de eliminar la aplicación y la extensión. Al eliminar el espacio de nombres y los objetos de función, se elimina la cuenta de servicio que utiliza kapp-controller. Si esta cuenta de servicio se elimina antes de eliminar la aplicación y la extensión, se pueden producir errores en el sistema.

1. Cambie el directorio en el que descargó los archivos de la extensión.

   cd /tkg-extensions-v1.3.1+vmware.1/extensions/service-discovery/external-dns

2. Elimine la extensión DNS externo.

   kubectl delete -f external-dns-extension.yaml

3. Compruebe que la extensión se haya eliminado.

   kubectl get app contour -n tanzu-system-ingress

   Resultado esperado: el estado de la aplicación es Not Found.

4. Elimine el espacio de nombres.
   Solo después de confirmar que la aplicación y la extensión Contour se han eliminado completamente se pueden eliminar de forma segura los objetos de función y espacio de nombres.

   kubectl delete -f namespace-role.yaml

   Resultado esperado: se elimina el espacio de nombres donde está implementada la extensión y los objetos de control de acceso basado en funciones asociados.

Configurar la extensión DNS externo

La extensión DNS externo se puede configurar con parámetros personalizados.

Configure los parámetros de implementación para el proveedor de DNS externo. Consulte el sitio de Kubernetes https://github.com/kubernetes-sigs/external-dns#running-externaldns para obtener más instrucciones.

Tabla 1. Parámetros de configuración de la extensión Harbor

Parámetro	Descripción	Tipo	Predeterminado
externalDns.namespace	Espacio de nombres en el que se implementará el DNS externo	string	tanzu-system-service-discovery
externalDns.image.repository	Repositorio que contiene la imagen de DNS externo	string	projects.registry.vmware.com/tkg
externalDns.image.name	Nombre de external-dns	string	external-dns
externalDns.image.tag	Etiqueta de la imagen de DNS externo	string	v0.7.4_vmware.1
externalDns.image.pullPolicy	Directiva de extracción de la imagen de DNS externo	string	IfNotPresent
externalDns.deployment.annotations	Anotaciones en la implementación de external-dns	map<string,string>	{}
externalDns.deployment.args	Argumentos transmitidos a través de la línea de comandos a external-dns	list<string>	[] (parámetro obligatorio)
externalDns.deployment.env	Variables de entorno que se transferirán a external-dns	list<string>	[]
externalDns.deployment.securityContext	Contexto de seguridad del contenedor de DNS externo	SecurityContext	{}
externalDns.deployment.volumeMounts	Montajes de volumen del contenedor de external-dns	list<VolumeMount>	[]
externalDns.deployment.volumes	Volúmenes del pod de DNS externo	list<Volume>	[]