Conexión a Oracle Kubernetes Engine

Versión previa a Disponibilidad General: 2026-02-26

B Conexión a Oracle Kubernetes Engine

Puede utilizar la interfaz de línea de comandos (CLI) de OCI para acceder a un cluster de Oracle Kubernetes Engine (OKE).

En las siguientes instrucciones, se asume que un archivo kubeconfig ya está disponible.

Instale la CLI de OCI.
- En Linux o macOS, introduzca el siguiente comando:
```
bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh
```
- En Microsoft Windows, utilice el instalador .msi vinculado desde Instalación de la CLI.
Para obtener más información sobre la CLI de OCI, consulte Trabajar con la CLI.
Instale kubectl.
- En macOS, introduzca el siguiente comando homebrew.
```
brew install kubectl
```
- En Linux, introduzca el siguiente comando curl:
```
VERSION=(curl−L−shttps://dl.k8s.io/release/stable.txt)curl−LO"https://dl.k8s.io/release/{VERSION}/bin/linux/amd64/kubectl"; chmod +x kubectl && sudo mv kubectl /usr/local/bin/
```
- En Microsoft Windows, utilice el siguiente comando Chocolatey.
```
choco install kubernetes-cli
```
Para obtener más información sobre la instalación de kubectl, consulte Instalar herramientas en la documentación de Kubernetes.
Introduzca el siguiente comando para configurar las credenciales de la CLI de OCI.
```
oci setup config
```
Proporcione la siguiente información al comando.
- OCID del arrendamiento
- Su OCID de usuario
- La región (por ejemplo, ap-mumbai-1)
- Su clave API (huella digital/ruta de acceso de clave privada)
Para obtener una nueva clave de API, introduzca el siguiente comando y, a continuación, seleccione Identidad y seguridad, Usuarios, Your User Account y, por último, Claves de API para cargar la clave pública en la consola.
```
oci setup keys
```
Agregue el archivo kubeconfig a la ruta de acceso predeterminada, de modo que kubectl pueda acceder a él.
- En macOS y Linux, agregue el archivo kubeconfig al siguiente directorio.
```
~/.kube/config
```
- En Microsoft Windows, agregue el archivo kubeconfig al siguiente directorio.
```
%USERPROFILE%.kube\config
```
Genere el archivo kubeconfig para el cluster de Kubernetes.
1. En la página de cluster de OCI, seleccione Acciones y, a continuación, Acceder al cluster. Se muestra la ventana Acceder al cluster.
2. Seleccione Acceso local.
3. Seleccione Copiar para el comando de acceso de punto final público.
4. Ejecute el comando copiado para generar el archivo kubeconfig.
Ejecute los siguientes comandos para validar la conectividad al cluster.
```
kubectl cluster-info
kubectl get nodes -o wide
kubectl get ns
```
Los clusters de punto final privado requieren acceso de red a la red virtual en la nube (VCN). Los clusters de punto final públicos requieren conectividad a Internet al punto final del servidor de API.
Si utiliza varios perfiles de OCI, defina la siguiente variable de entorno.
- Linux y macOS: export OCI_CLI_PROFILE=
- Microsoft Windows: $env:OCI_CLI_PROFILE=""

Si kubectl devuelve un error 401 o 403, verifique que las políticas de gestión de identidad y acceso (IAM) le permiten utilizar y gestionar una familia de clusters en el compartimento y que el archivo kubeconfig se ha generado para el cluster y la región correctos.

Para escalar el cluster de OKE, complete los pasos siguientes.

En la consola de OCI, seleccione el cluster de OKE y, a continuación, seleccione Pools de nodos.
Seleccione el pool de nodos que desea escalar.
En el menú Acciones, seleccione Editar. Se muestra la página Editar pool de nodos.
Realice los cambios necesarios en el recuento de nodos o la unidad de nodo. Para cambiar la unidad de nodo (que afecta al número de OCPU y a la cantidad de memoria), seleccione Cambiar unidad.
Seleccione Actualizar para confirmar los cambios.
En el menú Acciones, seleccione Nodos de ciclo para aplicar la configuración actualizada. Se muestra la página Nodos de ciclo.
En Opciones de ciclo, seleccione Sustituir nodos. Introduzca los números para Nodos de ciclo y Número máximo no disponible y, a continuación, seleccione Nodos de ciclo. Cuando el estado del pool de nodos se actualiza a Activo, la escala se completa.

También, si ha instalado desplegando una pila, puede hacer clic en Destruir para suprimir la pila actual en la consola de OCI. A continuación, seleccione Editar y, a continuación, Editar pila para editar la definición de pila para cambiar el recuento de nodos o la unidad de nodo según sea necesario. Seleccione Ejecutar aplicación y Guardar cambios para crear una pila que utilice los nuevos parámetros.