Preparar el uso de la interfaz de línea de comandos para realizar tareas de CCI

La interfaz de consumo de nube incluye una interfaz de línea de comandos que los administradores y los desarrolladores pueden utilizar para realizar tareas de CCI de forma programática.

Los administradores de VMware Aria Automation pueden utilizar la interfaz de línea de comandos para crear cuentas de nube, además de crear y configurar proyectos, regiones y clases de espacio de nombres de supervisor. Los usuarios tienen acceso un poco limitado a los comandos de CLI de kubectl de CCI.

Descargar el complemento kubectl de CCI

Para utilizar la herramienta de línea de comandos de Kubernetes (kubectl), descargue el complemento CCI. Este complemento proporciona una forma para que kubectl interactúe con CCI, por ejemplo, cuando se inicia sesión en CCI.

Nota: Antes de descargar el complemento kubectl de CCI, debe tener instalada la herramienta Kubernetes. Para obtener información sobre la herramienta Kubernetes, consulte https://kubernetes.io/docs/tasks/tools/.

Para descargar el complemento kubectl de CCI:

1. Inicie sesión en VMware Aria Automation.
2. Haga clic para iniciar Service Broker.
3. Si usted es un usuario y se muestra la página Descripción general, haga clic en: DESCARGAR COMPLEMENTO DE CLI.
4. Si es un administrador o un usuario que no descargó de la página Descripción general, haga clic en la pestaña Consumir y después haga clic en Espacio de nombres de supervisor.
5. El método de descarga depende de su entorno.
   • Si ve la página Introducción a los espacios de nombres de supervisor, haga clic en DESCARGAR COMPLEMENTO.
   • Si ve la página Espacios de nombres de supervisor:
     1. Haga clic en Nuevo espacio de nombres de supervisor.
     2. En la página Crear un espacio de nombres, haga clic en DESCARGAR COMPLEMENTO > DESCARGAR COMPLEMENTO DE CLI > .

En un entorno Mac, Linux o Windows, establezca el complemento kubectl-cci como ejecutable y después cópielo a su ruta de ejecución junto con el archivo ejecutable kubectl. Por ejemplo, en un entorno de Mac o Linux, utilice el siguiente comando:

chmod +x kubectl-cci && mv kubectl-cci /usr/local/bin

Obtener un token de API

Para obtener el token que se utiliza para autenticar su sesión, utilice la API del servicio de identidad de VMware Aria Automation.

Antes de empezar, proteja un canal entre el navegador web y el servidor de VMware Aria Automation. Abra un navegador e introduzca la dirección URL, como: https://appliance.domain.com. A continuación, realice los siguientes pasos.

1. Utilice la API del servicio de identidad de VMware Aria Automation para obtener el token de API.
   Nota: El token de API también se conoce como token de actualización. Es válido durante 90 días. No puede revocar el token de actualización.

   curl --insecure --location --request POST \
     'https://<Your_Aria_Automation_FQDN>/csp/gateway/am/api/login?access_token' \
     --header 'Content-Type: application/json' \
     --data-raw '{
     "username": "<Your_Username>",
     "password": "<Your_Password>"
     "domain": "<Your_Domain>"}'

   echo

2. La salida es una cadena compacta de caracteres como en el siguiente ejemplo:

   {"refresh_token":"ZhzVZnoLEsg7OK4WMef9rUzfsZnWNm6a"}

Inicie sesión y cree el contexto kubeconfig

Utilice el token de API para iniciar sesión en el servidor CCI.

kubectl cci login -t <YOUR_API_TOKEN> --server appliance.domain.com --insecure-skip-tls-verify

Para su comodidad, puede optar por iniciar sesión en CCI con un nombre de usuario en lugar de un token. A continuación, en el inicio de sesión se le solicitará una contraseña o puede definir una variable para almacenar su contraseña.

Por ejemplo, si define una variable con:

export KUBECTL_CCI_PASSWORD=<User_Password>

El comando de inicio de sesión de CCI comprueba el valor y no se le solicitan las credenciales de usuario cada vez que inicie sesión con:

kubectl cci login -u <your_username> --server appliance.domain.com --insecure-skip-tls-verify

Establezca el contexto en cci para las operaciones de administración, como la creación de espacios de nombres de supervisor, regiones o clases de espacios de nombres de supervisor.

kubectl config use-context cci

Establezca el contexto en cci:project_name:supervisor_namespace para interactuar con un espacio de nombres de supervisor.

kubectl config use-context cci:project_name:supervisor_namespace

Nota: Si el comando de inicio de sesión de CCI está configurado con la función de administrador de Automation Service Broker, puede optar por utilizar el argumento --skip-set-context. De esta manera, evitará crear contextos kubeconfig para todos los espacios de nombres de supervisor existentes administrados por VMware Aria Automation.

El siguiente ejemplo muestra cómo se puede crear manualmente un contexto kubeconfig para un espacio de nombres de supervisor específico a partir de un proyecto específico.

kubectl cci set-context --project cci-explore --supervisor-namespace elastic-sky

Para ver información adicional sobre un comando, utilice kubectl cci [command] --help.