Im Lieferumfang der Cloud Consumption Interface befindet sich eine Befehlszeilenschnittstelle, mit der Administratoren und Entwickler CCI-Aufgaben programmgesteuert durchführen können.

Als VMware Aria Automation-Administrator können Sie mithilfe der Befehlszeilenschnittstelle Cloud-Konten erstellen sowie Projekte, Regionen und Supervisor-Namespace-Klassen erstellen und konfigurieren. Benutzer haben eingeschränkten Zugriff auf die CLI-Befehle von CCI kubectl.

Herunterladen des CCI kubectl-Plug-Ins

Laden Sie das CCI-Plug-In herunter, um das Kubernetes-Befehlszeilentool (kubectl) zu verwenden. Mithilfe des Plug-Ins kann kubectl mit CCI interagieren, z. B. beim Anmelden bei CCI.

Hinweis: Vor dem Herunterladen des CCI-kubectl-Plug-Ins muss das Kubernetes-Tool installiert sein. Informationen über das Kubernetes-Tool finden Sie unter https://kubernetes.io/docs/tasks/tools/.
So laden Sie das CCI-Kubectl-Plug-In herunter:
  1. Melden Sie sich bei VMware Aria Automation an.
  2. Klicken Sie, um Service Broker zu starten.
  3. Wenn Ihnen als Benutzer die Seite Übersicht angezeigt wird, klicken Sie auf CLI-PLUG-IN HERUNTERLADEN. Klicken Sie auf der Seite „Übersicht“ auf „CLI-Plug-In herunterladen“.
  4. Wenn Sie als Administrator oder Benutzer den Download nicht über die Seite Übersicht durchgeführt haben, klicken Sie auf die Registerkarte Verbrauchen und dann auf Supervisor-Namespace.
  5. Die Downloadmethode hängt von Ihrer Umgebung ab.
    • Wenn die Seite Erste Schritte mit Supervisor-Namespaces angezeigt wird, klicken Sie auf PLUG-IN HERUNTERLADEN.Klicken Sie auf der Seite „Erste Schritte mit Supervisor-Namespaces“ auf „Plug-In herunterladen“.
    • Wenn die Seite Supervisor-Namespaces angezeigt wird, gehen Sie folgendermaßen vor:
      1. Klicken Sie auf Neuer Supervisor-Namespace.
      2. Klicken Sie auf der Seite Namespace erstellen auf PLUG-IN HERUNTERLADEN > CLI-PLUG-IN HERUNTERLADEN > .
In einer Mac-, Linux- oder Windows-Umgebung legen Sie das kubectl-cci-Plug-In als ausführbare Datei fest und kopieren es dann zusammen mit der ausführbaren kubectl-Datei in den Ausführungspfad. Verwenden Sie beispielsweise in einer Mac- oder Linux-Umgebung den folgenden Befehl: 
chmod +x kubectl-cci && mv kubectl-cci /usr/local/bin

Abrufen eines API-Tokens

Rufen Sie das Token, das zur Authentifizierung Ihrer Sitzung verwendet wird, mithilfe der VMware Aria Automation-Identitätsdienst-API ab.

Sichern Sie einen Kanal zwischen dem Webbrowser und dem VMware Aria Automation-Server, bevor Sie beginnen. Öffnen Sie einen Browser und geben Sie die URL ein, wie z. B.: https://appliance.domain.com. Führen Sie dann die folgenden Schritte aus.

  1. Verwenden Sie die VMware Aria Automation-Identitätsdienst-API, um das API-Token abzurufen.
    Hinweis: Das API-Token wird auch als Aktualisierungstoken bezeichnet. Es ist 90 Tage lang gültig. Sie können das Aktualisierungstoken nicht widerrufen. 
    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. Bei der Ausgabe handelt es sich um eine kompakte Zeichenfolge, die in folgendem Beispiel dargestellt wird:
    {"refresh_token":"ZhzVZnoLEsg7OK4WMef9rUzfsZnWNm6a"}

Anmelden und Erstellen von Kubeconfig-Kontext

Verwenden Sie Ihr API-Token, um sich beim CCI-Server anzumelden.

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

Der Einfachheit halber können Sie sich bei CCI mit einem Benutzernamen anstelle eines Tokens anmelden. Anschließend werden Sie bei der Anmeldung zur Eingabe eines Kennworts aufgefordert. Sie können aber auch eine Variable zum Speichern des Kennworts definieren.

Beispiel: Bei Definition einer Variablen: 
export KUBECTL_CCI_PASSWORD=<User_Password>
Der CCI-Anmeldebefehl überprüft den Wert, und Sie werden nicht jedes Mal zur Eingabe der Benutzeranmeldedaten aufgefordert, wenn Sie sich anmelden mit: 
kubectl cci login -u <your_username> --server appliance.domain.com --insecure-skip-tls-verify

Legen Sie den Kontext für Verwaltungsvorgänge wie das Erstellen von Supervisor-Namespaces, Regionen oder Supervisor-Namespace-Klassen auf cci fest.

kubectl config use-context cci
Legen Sie den Kontext auf cci:project_name:supervisor_namespace fest, um mit einem Supervisor-Namespace zu interagieren. 
kubectl config use-context cci:project_name:supervisor_namespace
Hinweis: Wenn der CCI-Anmeldebefehl mit der Automation Service Broker-Administratorrolle konfiguriert ist, können Sie das Argument --skip-set-context verwenden. Auf diese Weise vermeiden Sie die Erstellung von kubeconfig-Kontexten für alle vorhandenen Supervisor-Namespaces, die von VMware Aria Automation verwaltet werden.
Das folgende Beispiel zeigt die manuelle Erstellung von kubeconfig-Kontext für einen bestimmten Supervisor-Namespace anhand eines bestimmten Projekts. 
kubectl cci set-context --project cci-explore --supervisor-namespace elastic-sky

Verwenden Sie kubectl cci [command] --help, um zusätzliche Informationen zu einem Befehl anzuzeigen.