Preparação para usar a Command Line Interface para executar tarefas da CCI

A Cloud Consumption Interface inclui uma interface de linha de comando que administradores e desenvolvedores podem usar para executar tarefas da CCI programaticamente.

Como administrador da VMware Aria Automation, você usa a interface de linha de comando para criar contas de nuvem, criar e configurar projetos, regiões e classes de namespace de Supervisor. Os usuários têm um certo acesso limitado aos comandos da CLI kubectl da CCI.

Baixar o plug-in da CCI para kubectl

Para usar a ferramenta de linha de comando Kubernetes (kubectl), baixe o plug-in da CCI. O plug-in fornece uma maneira para o kubectl interagir com a CCI, por exemplo, quando você faz login na CCI.

Observação: Antes de baixar o plug-in da CCI para kubectl, você precisa ter a ferramenta Kubernetes instalada. Para obter informações sobre a ferramenta Kubernetes, consulte https://kubernetes.io/docs/tasks/tools/.

Para baixar o plug-in da CCI para kubectl:

Faça login no VMware Aria Automation.
Clique para iniciar o Service Broker.
Se você é um usuário e a página Visão Geral aparecer, clique em:BAIXAR PLUG-IN DA CLI.
Se você é um administrador ou um usuário que não baixou a partir da página Visão Geral, clique na guia Consumir e depois clique em Namespace de Supervisor.
O método de download depende do seu ambiente.
- Se você vir a página Introdução a namespaces de supervisor, clique em BAIXAR PLUG-IN.
- Se você vir a página Namespaces de Supervisor:
  1. Clique em Novo Namespace de Supervisor.
  2. Na página Criar um namespace, clique em BAIXAR PLUG-IN > BAIXAR PLUG-IN DA CLI > .

Em um ambiente Mac, Linux ou Windows, defina o plug-in kubectl-cci como um executável e copie-o para o caminho de execução junto com o arquivo executável do kubectl. Por exemplo, em um ambiente Mac ou Linux, use o seguinte comando:

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

Fazer login na CCI

Para fazer login na CCI, escolha um dos seguintes métodos:

Entre com seu nome de usuário.
Entrar com o nome de usuário é a opção mais simples. O login solicitará uma senha, ou você pode definir uma variável para armazenar sua senha, por exemplo:
```
export KUBECTL_CCI_PASSWORD=<User_Password>
```
Se uma variável para a senha for atribuída, o comando de login da CCI verificará o valor, e você não precisará fornecer uma senha todas as vezes que fizer login com:
```
kubectl cci login -u <your_username> --server appliance.domain.com --insecure-skip-tls-verify
```
Fazer login com um token de API (opcional).
Você também pode usar um token de API para autenticar sua sessão. Para obter o token de atualização da API, execute as seguintes etapas:
1. Proteja um canal entre o navegador da Web e o servidor do VMware Aria Automation. Abra um navegador e digite a URL, como: https://appliance.domain.com.
2. Use a API do Serviço de Identidade do VMware Aria Automation para obter o token da API.
  Observação: O token de API também é conhecido como token de atualização. Ele é válido por 90 dias. Não é possível revogar o token de atualização.
```
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. A saída é uma string compacta de caracteres, como no exemplo a seguir:
```
{"refresh_token":"ZhzVZnoLEsg7OK4WMef9rUzfsZnWNm6a"}
```
Depois de obter seu token de API, use-o para fazer login no servidor da CCI.
```
kubectl cci login -t <YOUR_API_TOKEN> --server appliance.domain.com --insecure-skip-tls-verify
```

Criar o contexto Kubeconfig

Depois de fazer login na CCI, defina seu contexto como cci para operações de gerenciamento, como criação de namespaces de supervisor, regiões ou classes de namespaces de supervisor.

kubectl config use-context cci

Defina seu contexto como cci:project_name:supervisor_namespace para interagir com um namespace de supervisor.

kubectl config use-context cci:project_name:supervisor_namespace

Observação: Se o seu comando de login na CCI estiver configurado com a função de administrador do Automation Service Broker, você poderá optar por usar o argumento --skip-set-context. Dessa maneira, você evitará a criação de contextos kubeconfig para todos os namespaces de supervisor existentes gerenciados pelo VMware Aria Automation.

O exemplo a seguir mostra como criar um contexto kubeconfig manualmente para um Namespace de Supervisor específico a partir de um projeto específico.

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

Para visualizar informações adicionais sobre um comando, use kubectl cci [command] --help.