클라우드 소비 인터페이스에는 관리자와 개발자가 프로그래밍 방식으로 CCI 작업을 수행하는 데 사용할 수 있는 명령줄 인터페이스가 포함되어 있습니다.

VMware Aria Automation 관리자는 명령줄 인터페이스를 사용하여 클라우드 계정을 생성하고 프로젝트, 지역 및 감독자 네임스페이스 클래스를 생성 및 구성합니다. 사용자는 CCI kubectl CLI 명령에 대해 일부 제한된 액세스 권한을 갖습니다.

CCI kubectl 플러그인 다운로드

Kubernetes 명령줄 도구(kubectl)를 사용하려면 CCI 플러그인을 다운로드합니다. 플러그인은 kubectl이 CCI와 상호 작용(예: CCI에 로그인할 때)할 수 있는 방법을 제공합니다.

참고: CCI kubectl 플러그인을 다운로드하기 전에 Kubernetes 도구가 설치되어 있어야 합니다. Kubernetes 도구에 대한 자세한 내용은 https://kubernetes.io/docs/tasks/tools/ 항목을 참조하십시오.
CCI kubectl 플러그인을 다운로드하려면 다음을 수행합니다.
  1. VMware Aria Automation에 로그인합니다.
  2. Service Broker를 클릭하여 시작합니다.
  3. 사용자인 경우 개요 페이지가 나타나면 CLI 플러그인 다운로드를 클릭합니다. [개요] 페이지에서 [CLI 플러그인 다운로드]를 클릭합니다.
  4. 개요 페이지에서 다운로드하지 않은 사용자 또는 관리자인 경우 사용 탭을 클릭하고 감독자 네임스페이스를 클릭합니다.
  5. 다운로드 방법은 환경에 따라 다릅니다.
    • 감독자 네임스페이스 시작 페이지가 표시되면 플러그인 다운로드를 클릭합니다.[감독자 네임스페이스 시작] 페이지에서 [플러그인 다운로드]를 클릭합니다.
    • 감독자 네임스페이스 페이지가 표시되면 다음을 수행합니다.
      1. 새 감독자 네임스페이스를 클릭합니다.
      2. 네임스페이스 생성 페이지에서 플러그인 다운로드 > CLI 플러그인 다운로드 > 를 클릭합니다.
Mac, Linux 또는 Windows 환경에서 kubectl-cci 플러그인을 실행 파일로 설정한 다음 실행 경로에 kubectl 실행 파일과 함께 복사합니다. 예를 들어 Mac 또는 Linux 환경에서는 다음 명령을 사용합니다.
chmod +x kubectl-cci && mv kubectl-cci /usr/local/bin

API 토큰 가져오기

세션을 인증하는 데 사용되는 토큰을 가져오려면 VMware Aria Automation ID 서비스 API를 사용합니다.

시작하기 전에 웹 브라우저와 VMware Aria Automation 서버 간의 채널을 확보합니다. 브라우저를 열고 URL(예: https://appliance.domain.com)을 입력합니다. 그런 후 다음 단계를 수행합니다.

  1. VMware Aria Automation ID 서비스 API를 사용하여 API 토큰을 가져옵니다.
    참고: API 토큰을 새로 고침 토큰이라고도 합니다. 90일 동안 유효합니다. 새로 고침 토큰은 해지할 수 없습니다.
    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. 출력은 다음 예와 같이 문자의 컴팩트 문자열입니다.
    {"refresh_token":"ZhzVZnoLEsg7OK4WMef9rUzfsZnWNm6a"}

Kubeconfig 컨텍스트 로그인 및 생성

API 토큰을 사용하여 CCI 서버에 로그인합니다.

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

편의를 위해 토큰 대신 사용자 이름을 사용하여 CCI에 로그인하도록 선택할 수 있습니다. 그러면 로그인 시 암호를 묻는 메시지가 표시되거나 암호를 저장할 변수를 정의할 수 있습니다.

예를 들어 다음을 사용하여 변수를 정의하는 경우:
export KUBECTL_CCI_PASSWORD=<User_Password>
CCI 로그인 명령은 값을 확인하며 다음을 사용하여 로그인할 때마다 사용자 자격 증명을 묻는 메시지가 표시되지 않습니다.
kubectl cci login -u <your_username> --server appliance.domain.com --insecure-skip-tls-verify

감독자 네임스페이스, 지역 또는 감독자 네임스페이스 클래스 생성과 같은 관리 작업을 위해 컨텍스트를 cci로 설정합니다.

kubectl config use-context cci
컨텍스트를 cci:project_name:supervisor_namespace로 설정하여 감독자 네임스페이스와 상호 작용합니다.
kubectl config use-context cci:project_name:supervisor_namespace
참고: CCI 로그인 명령이 Automation Service Broker 관리자 역할로 구성된 경우 --skip-set-context 인수를 사용하도록 선택할 수 있습니다. 이렇게 하면 VMware Aria Automation에 의해 관리되는 모든 기존 감독자 네임스페이스에 대해 kubeconfig 컨텍스트를 생성하지 않아도 됩니다.
다음 예에서는 특정 프로젝트에서 특정 감독자 네임스페이스에 대해 kubeconfig 컨텍스트를 수동으로 생성하는 방법을 보여줍니다.
kubectl cci set-context --project cci-explore --supervisor-namespace elastic-sky

명령에 대한 추가 정보를 보려면 kubectl cci [command] --help를 사용합니다.