Todos los productos
Search
Centro de documentos

Container Compute Service:Connect to a cluster by using kubectl

Última actualización: Sep 06, 2026

Un archivo kubeconfig almacena la credencial de acceso al clúster, incluida la información de identidad del usuario que ha iniciado sesión. Una vez que obtenga el archivo kubeconfig desde la consola, utilice un cliente kubectl para conectarse y gestionar un clúster de Alibaba Cloud Container Compute Service (ACS).

kubectl y kubeconfig

kubectl es la herramienta de línea de comandos estándar para gestionar Kubernetes. Utilice kubectl para conectarse y gestionar los clústeres de ACS. Un archivo kubeconfig contiene información sobre los clústeres, los usuarios, los namespaces y los mecanismos de autenticación. kubectl usa este archivo para conectarse al clúster.

Métodos de conexión

Elija un método de conexión según la ubicación de la computadora donde se ejecuta su cliente kubectl.

  • Conexión por red pública: use este método cuando su computadora cliente esté en la red pública. El clúster debe tener habilitado el acceso público al servidor de API, lo cual expone dicho servidor mediante una dirección IP elástica (EIP). Para conocer las instrucciones sobre cómo habilitar el acceso público, consulte Control public access to the API server of a cluster.

  • Conexión por red interna: use este método cuando solo necesite acceso interno. La computadora donde se ejecuta su cliente kubectl debe estar en la misma Virtual Private Cloud (VPC) que el clúster.

Paso 1: Instalar kubectl

Instale kubectl en su computadora cliente según su sistema operativo y la versión del clúster.

Paso 2: Configurar la credencial del clúster

Los clústeres de ACS proporcionan dos credenciales de clúster en forma de archivos kubeconfig: una para el acceso por red pública y otra para el acceso por red interna. De manera predeterminada, kubectl busca un archivo llamado config en el directorio $HOME/.kube de la computadora cliente. Este archivo almacena la credencial de acceso del clúster que va a gestionar, y kubectl lo utiliza para establecer la conexión.

  1. Inicie sesión en la consola de ACS. En el panel de navegación izquierdo, haga clic en Clusters.

  2. En la página Clusters, haga clic en el nombre del clúster de destino o bien haga clic en Details dentro de la columna Actions.

  3. En la página Cluster Information, haga clic en la pestaña Connection Information. Seleccione un kubeconfig temporal o permanente. Si elige uno temporal, establezca el periodo de validez.

  4. Haga clic en la pestaña Internal Access o Public Access y, a continuación, haga clic en Copy.

  5. Pegue el contenido en el archivo $HOME/.kube/config de su cliente y guarde el archivo.

    Nota: Si el directorio o el archivo no existen, créelos primero.
  6. Compruebe la conexión mediante la lista de todos los namespaces:

    kubectl get namespaces

    Resultado esperado:

    NAME              STATUS   AGE
    default           Active   4h39m
    kube-node-lease   Active   4h39m
    kube-public       Active   4h39m
    kube-system       Active   4h39m

Preguntas frecuentes

A continuación se muestran varios comandos que usan YOUR_KUBECONFIG_PATH como marcador de posición para la ruta absoluta del archivo kubeconfig. De manera predeterminada, kubectl usa el archivo $HOME/.kube/config para conectarse al clúster. Para especificar un archivo kubeconfig distinto, establezca la variable de entorno KUBECONFIG o el parámetro --kubeconfig.

Pregunta 1: ¿Cómo obtengo la información de identidad asociada al certificado que se usa en un archivo kubeconfig?

Ejecute el siguiente comando:

grep client-certificate-data YOUR_KUBECONFIG_PATH |awk '{print $2}' |base64 -d | openssl x509 -noout -text |grep Subject:

El resultado esperado es similar al siguiente:

        Subject: O=system:users, OU=, CN=1***-1673419473

A continuación se describen los parámetros del resultado:

  • O indica el grupo de usuarios de Kubernetes al que pertenece el usuario. En este ejemplo, el nombre del grupo es system:users.

  • CN indica el usuario asociado. En este ejemplo, el usuario es 1***-1673419473, donde 1*** corresponde a un identificador de usuario de Alibaba Cloud dentro de la cuenta.

Pregunta 2: ¿Cómo obtengo la fecha de caducidad del certificado que se usa en un archivo kubeconfig?

Ejecute el siguiente comando:

grep client-certificate-data YOUR_KUBECONFIG_PATH |awk '{print $2}' |base64 -d | openssl x509 -noout -enddate

El resultado esperado es similar al siguiente:

notAfter=Jan 10 06:44:34 2026 GMT

El valor Jan 10 06:44:34 2026 GMT representa la fecha de caducidad del certificado.

Obtenga un archivo kubeconfig con un certificado nuevo desde la consola o mediante OpenAPI durante los 60 días previos a la caducidad del certificado, o en cualquier momento posterior a dicha fecha.

Pregunta 3: ¿Cómo resuelvo el error certificate is valid for que aparece al conectarme a un clúster mediante kubectl?

Si asocia una nueva dirección IP a la instancia de Server Load Balancer (SLB) del servidor de API del clúster y luego usa kubectl para acceder a esa dirección, el comando falla. Como resultado, se devuelve el error Error while proxying request: x509: certificate is valid for xxx o el error Unable to connect to the server: x509: certificate is valid for xxx.

Agregue la nueva dirección IP al nombre alternativo del firmante (SAN) del certificado del servidor de API, tal como se describe en Customize the SAN of the API server certificate for a cluster. A continuación se muestra un ejemplo de la configuración:

En el cuadro de diálogo Update Custom Certificate SAN, introduzca la nueva dirección IP, por ejemplo 192.168.1.137, en el campo Custom Certificate SAN. Separe varias direcciones IP o nombres de dominio con comas (,). Después, haga clic en OK. Nota: modificar el SAN provoca que el servidor de API se reinicie brevemente.