En esta página, se explica cómo configurar un servidor de registro de contenedores existente para el software de Google Distributed Cloud solo para VMware.
Esta página está destinada a administradores, arquitectos y operadores que configuran, supervisan y administran la infraestructura tecnológica. Para obtener más información sobre los roles comunes y las tareas de ejemplo a las que hacemos referencia en el contenido de Google Cloud , consulta Roles y tareas comunes del usuario de GKE.
Descripción general
De forma predeterminada, durante la creación o actualización del clúster, Google Distributed Cloud
extrae imágenes del sistema
de gcr.io/gke-on-prem-release con la
cuenta de servicio de acceso a componentes.
De manera opcional, puedes proporcionar tu propio servidor de registro de contenedores para que
las imágenes del sistema se extraigan de tu servidor de registro privado.
Google Distributed Cloud no admite registros de contenedores no seguros. Cuando inicias el servidor de Container Registry, debes proporcionar un certificado y una clave. Una autoridad certificada (CA) pública puede firmar el certificado, o este se puede autofirmar.
Crea un servidor de registro de contenedores
Para aprender a crear un servidor de registro de contenedores, consulta Ejecuta un registro de acceso externo en la documentación de Docker.
Configura el registro
Para usar un registro de contenedores privado, puedes usar la herramienta de línea de comandos de gkectl
o Terraform.
gkectl
Agrega la sección
privateRegistryal archivo de configuración del clúster de administrador antes de crear el clúster.Cuando se completa esta sección, sucede lo siguiente:
Cuando ejecutas el comando
gkectl prepareantes de crear o actualizar el clúster, el comando extrae las imágenes del archivo tar que se especifica en el campobundlePathdel archivo de configuración del clúster de administrador y envía las imágenes al servidor de registro privado.Durante la creación o actualización del clúster, las imágenes del sistema se extraen de tu servidor de registro privado.
Si la red está detrás de un servidor proxy, completa la sección
proxy.
Terraform
- Sigue los pasos de la pestaña Terraform en Crea un clúster de administrador para completar el archivo de configuración del clúster de administrador.
Agrega lo siguiente al archivo de configuración del clúster de administrador:
private_registry_config { address = "ADDRESS" ca_cert = "CA_CERT" }Reemplaza lo siguiente:
ADDRESS: Es la dirección IP o el FQDN (nombre de dominio completamente calificado) de la máquina que ejecuta tu registro privado.CA_CERT: son los datos del certificado de la AC de la clave pública, pero con todas las líneas nuevas reemplazadas por la cadena\n.
Ejecuta el siguiente comando para reemplazar las líneas nuevas por
\n:awk 'ORS="\\n" {print}' PUBLIC_KEY_PATHReemplaza
PUBLIC_KEY_PATHpor la ruta de acceso a la clave pública.Copia el resultado del comando anterior y pégalo en la variable de marcador de posición
CA_CERT.
Si tu red está detrás de un servidor proxy, agrega lo siguiente:
proxy { url: "PROXY_SERVER_ADDRESS" no_proxy: "BYPASS_LIST" }Reemplaza lo siguiente:
PROXY_SERVER_ADDRESS: Es la dirección HTTP de tu servidor proxy. Debes incluir el número de puerto incluso si es el mismo que el puerto predeterminado del esquema.BYPASS_LIST: Es una lista separada por comas de direcciones IP, rangos de direcciones IP, nombres de host y nombres de dominio que no deben pasar por el servidor proxy.
Ejemplo:
url: "http://my-proxy.example.local:80" no_proxy: "192.0.2.0/24,my-host.example.local,198.51.100.0"Cuando Google Distributed Cloud envía una solicitud a una de estas direcciones, hosts o dominios, la solicitud omite el servidor proxy y se envía directamente al destino.
Continúa con los pasos de la pestaña Terraform en Crea un clúster de administrador para verificar el archivo de configuración y el plan de Terraform y, luego, crea el clúster de arranque.
Cuando ejecutas el comando
gkectl register bootstrap,gkectlte solicita que ingreses el nombre de usuario y, luego, la contraseña del registro privado.
Durante la creación del clúster, las imágenes del sistema se extraen de tu servidor de registro privado.
Limitaciones con los clústeres avanzados y el paquete completo
Hay dos paquetes de Google Distributed Cloud disponibles: completo y normal. Para determinar
qué paquete se encuentra en tu estación de trabajo de administrador, verifica el campo bundlePath en el
archivo de configuración del clúster de administrador. Si el nombre del archivo termina en -full, el paquete completo
está en tu estación de trabajo de administrador. Si el nombre del archivo no termina en -full, el
paquete normal se encuentra en tu estación de trabajo de administrador.
Si creaste la estación de trabajo de administrador con el comando gkeadm, este
crea la VM de la estación de trabajo de administrador con el paquete completo y configura el
campo bundlePath en el archivo de configuración del clúster de administrador.
Si el clúster avanzado está habilitado, existen limitaciones para usar el paquete completo con un registro privado, como se indica a continuación:
Versión 1.31: El paquete completo no es compatible con un registro privado. Para usar un registro privado en un clúster avanzado, sigue estos pasos:
- Descarga el paquete de tamaño normal en tu estación de trabajo de administrador.
- Actualiza el nombre del archivo en el campo
bundlePathdel archivo de configuración del clúster de administrador.
Versión 1.32: Se admite el uso del paquete completo, pero el comando
gkectl prepareextrae imágenes degcr.io/gke-on-prem-releaseen lugar del archivo tar. Sin embargo, el comando envía las imágenes a tu registro privado para que las imágenes del sistema se extraigan de tu registro privado durante la creación o actualización del clúster.
Diferencias entre los clústeres normales y los avanzados
El clúster avanzado presenta varias diferencias clave en comparación con los clústeres estándar:
- Cuando usas un registro privado, las imágenes parecen extraerse de
gcr.io, no del nombre de host de tu registro privado. Este cambio es el esperado, aunque las imágenes se extraigan de tu servidor de registro privado. - Las extracciones de imágenes usan credenciales del archivo
/etc/containerd/config.tomlen cada máquina que se conecta al registro privado, en lugar del secretoprivate-registry-credsdentro del clúster. - Para todas las imágenes de
gcr.io, el clúster primero intenta extraer del registro privado. Si la imagen no está en el registro privado, el sistema la extrae degcr.ioa través de Internet. Para detener este resguardo, configuranoProxyo usa reglas de firewall para bloquear el tráfico degcr.io.
Para verificar que las imágenes se extraigan de la fuente correcta, consulta Verifica que las imágenes se extraigan de tu servidor de registro.
Verifica que las imágenes se extraigan de tu servidor de registro
La forma en que verificas que las imágenes se extraigan de tu servidor de registro depende de si el clúster avanzado está habilitado.
Si el clúster avanzado no está habilitado, ejecuta el siguiente comando:
kubectl --kubeconfig ADMIN_CLUSTER_KUBECONFIG get pods \ --all-namespaces -o jsonpath="{.items[*].spec['initContainers', 'containers'][*].image}"Reemplaza
ADMIN_CLUSTER_KUBECONFIGpor la ruta de acceso del archivo kubeconfig del clúster de administrador.El resultado de este comando muestra todas las imágenes de tu clúster. Puedes verificar que todas las imágenes de Google Distributed Cloud provengan de tu propio servidor de registro.
Si el clúster avanzado está habilitado, sigue estos pasos:
Para determinar si
containerdextrae imágenes de tu registro local, examina el contenido de un archivo llamadoconfig.tomlcomo se muestra en los pasos siguientes:- Accede a un nodo y examina el contenido del archivo
/etc/containerd/config.toml. Verifica el campo
plugins."io.containerd.grpc.v1.cri".registry.mirrorsdel archivoconfig.tomlpara ver si el servidor de registro aparece en el campoendpoint.A continuación, se muestra un extracto de un archivo
config.tomlde ejemplo.version = 2 root = "/var/lib/containerd" state = "/run/containerd" ... [plugins."io.containerd.grpc.v1.cri".registry] [plugins."io.containerd.grpc.v1.cri".registry.configs] [plugins."io.containerd.grpc.v1.cri".registry.configs."gcr.io"] [plugins."io.containerd.grpc.v1.cri".registry.configs."privateregistry2.io".tls] ca_file = '/etc/containerd/certs.d/privateregistry2.io/ca.crt' [plugins."io.containerd.grpc.v1.cri".registry.mirrors] [plugins."io.containerd.grpc.v1.cri".registry.mirrors."gcr.io"] endpoint = ["http://privateregistry.io", "http://privateregistry2.io"] ...Si la duplicación del registro aparece en el campo
endpoint, el nodo extrae imágenes de la duplicación del registro en lugar de Artifact Registry.
- Accede a un nodo y examina el contenido del archivo