Preparazione all'utilizzo dell'interfaccia della riga di comando per l'esecuzione delle attività di CCI

Cloud Consumption Interface include un'interfaccia della riga di comando che amministratori e sviluppatori possono utilizzare per eseguire le attività di CCI in modo programmatico.

In qualità di amministratore di VMware Aria Automation, è possibile utilizzare l'interfaccia della riga di comando per creare account cloud, nonché creare e configurare progetti, regioni e classi di spazi dei nomi supervisore. Gli utenti possono accedere, con alcune limitazioni, ai comandi della CLI del kubectl di CCI.

Download del plug-in kubectl di CCI

Per utilizzare lo strumento della riga di comando kubernetes (kubectl), scaricare il plug-in CCI. Il plug-in fornisce un modo per consentire a kubectl di interagire con CCI, ad esempio quando si accede a CCI.

Nota: Prima di scaricare il plug-in kubectl di CCI, è necessario che sia installato lo strumento Kubernetes. Per informazioni sullo strumento Kubernetes, vedere https://kubernetes.io/docs/tasks/tools/.

Per scaricare il plug-in kubectl di CCI:

Accedere a VMware Aria Automation.
Fare clic per avviare Service Broker.
Se si è un utente e viene visualizzata la pagina Panoramica, fare clic su SCARICA IL PLUG-IN CLI.
Se si è un amministratore o un utente che non ha eseguito il download dalla pagina Panoramica, fare clic sulla scheda Utilizza e quindi su Spazio dei nomi supervisore.
Il metodo di download dipende dall'ambiente in uso.
- Se viene visualizzata la pagina Guida introduttiva agli spazi dei nomi supervisore, fare clic su SCARICA PLUG-IN.
- Se viene visualizzata la pagina Spazi dei nomi supervisore:
  1. Fare clic su Nuovo spazio dei nomi supervisore.
  2. Nella pagina Crea uno spazio dei nomi, fare clic su SCARICA PLUG-IN > SCARICA IL PLUG-IN CLI > .

In un ambiente Mac, Linux o Windows, impostare il plug-in kubectl-cci come eseguibile, quindi copiarlo nel percorso di esecuzione insieme al file eseguibile kubectl. Ad esempio, in un ambiente Mac o Linux, utilizzare il comando seguente:

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

Accedere a CCI

Per accedere a CCI, scegliere uno dei metodi seguenti:

Accedere con il proprio nome utente.
L'accesso con il proprio nome utente è l'opzione più semplice. In questo caso, all'accesso viene richiesta una password oppure è possibile definire una variabile per archiviare la password, ad esempio:
```
export KUBECTL_CCI_PASSWORD=<User_Password>
```
Se viene assegnata una variabile per la password, il comando di accesso a CCI controlla il valore e non viene richiesta alcuna password ogni volta che si accede con:
```
kubectl cci login -u <your_username> --server appliance.domain.com --insecure-skip-tls-verify
```
Accedere con un token API (facoltativo).
È inoltre possibile utilizzare un token API per eseguire l'autenticazione della propria sessione. Per ottenere il token di aggiornamento dell'API, eseguire i passaggi seguenti:
1. Proteggere un canale tra il browser Web e il server di VMware Aria Automation. Aprire un browser e immettere l'URL, ad esempio: https://appliance.domain.com.
2. Utilizzare l'API del servizio di identità di VMware Aria Automation per ottenere il token API.
  Nota: Il token API è anche noto come token di aggiornamento. È valido per 90 giorni. Non è possibile revocare il token di aggiornamento.
```
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
```
3. L'output è una stringa compatta di caratteri come nell'esempio seguente:
```
{"refresh_token":"ZhzVZnoLEsg7OK4WMef9rUzfsZnWNm6a"}
```
Dopo aver ottenuto il token API, utilizzarlo per accedere al server CCI.
```
kubectl cci login -t <YOUR_API_TOKEN> --server appliance.domain.com --insecure-skip-tls-verify
```

Creare il contesto kubeconfig

Dopo l'accesso a CCI, impostare il contesto su cci per le operazioni di gestione come la creazione di spazi dei nomi supervisore, regioni o classi di spazi dei nomi supervisore.

kubectl config use-context cci

Impostare il contesto su cci:project_name:supervisor_namespace per interagire con uno spazio dei nomi supervisore.

kubectl config use-context cci:project_name:supervisor_namespace

Nota: Se il comando di accesso CCI è configurato con il ruolo di amministratore di Automation Service Broker, è possibile scegliere di utilizzare l'argomento --skip-set-context. In questo modo, si eviterà di creare contesti kubeconfig per tutti gli spazi dei nomi supervisore esistenti gestiti da VMware Aria Automation.

L'esempio seguente illustra come creare manualmente un contesto kubeconfig per uno spazio dei nomi supervisore specifico da un progetto specifico.

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

Per visualizzare ulteriori informazioni su un comando, utilizzare kubectl cci [command] --help.