ZEVENET 명령 줄 인터페이스 ZCLI 사용 설명서

게시자 Zevenet | 1 년 2020 월 XNUMX 일

ZCLI 란 무엇인가

zcli 약어입니다 ZEVENET 명령 줄 인터페이스. 이 도구를 사용하면 명령 줄에서 여러로드 밸런서를 관리하거나 작업 스크립트에서로드 밸런서 작업을 자동화 할 수 있습니다.

zcli 의 래퍼입니다 ZAPI (ZEVENET Application Programming Interface)에는로드 밸런서 모듈과 해당 객체를보다 쉽게 ​​탐색 할 수있는 자동 완성 기능이 있습니다.

버전 EE 6.1 이상의 ZEVENET로드 밸런서와 함께 사용할 수 있습니다.

zcli를 사용한 첫 단계

설치

zcli 에서 사용할 수 있습니다 공식 ZEVENET APT 리포지토리 다음을 사용하여 ZEVENET로드 밸런서에 설치할 수 있습니다.

apt-get update && apt-get install zcli

또한이 패키지는 데비안, 우분투 또는 배포판에도 적용됩니다. 로드 밸런서에 원격으로 명령을 실행하기위한 패키지.

사용자 프로필

사용자 프로필 명령이 실행될로드 밸런서 및 명령을 실행할 사용자와 관련된 정보를 포함합니다. 그만큼 사용자 기능은 ZEVENET Enterprise에서만 사용할 수 있으며 RBAC 모듈에서 관리되며 명령은 사용자의 권한에 따라 실행됩니다. zcli 다른 프로필을 관리 할 수 ​​있습니다.

설정

실행하기 전에 zcli a ZAPI 키 필요합니다. 메뉴의 ZEVENET Web GUI에서 활성화 할 수 있습니다. 시스템> 사용자.

ZEVENET zcli Zapi 키 구성

일단 zcli 설치되어 있으면 다음을 실행하여 시작할 수 있습니다. zcli 껍질에. 로드 밸런서에서 실행되면 기본 프로필로 실행됩니다. 로컬 호스트 로컬로드 밸런서를 관리하고 ZAPI 키가 요청됩니다. 다른 경우에는 구성 지원이 시작됩니다.

ZEVENET zcli 프로파일 생성

프로필 설정을 수정하거나 다른 프로필을 만들어야하는 경우 zcli 윤곽 객체가 실행되어야합니다.

동안 프로파일을 설정할 수 있습니다 zcli 를 사용하는 호출 시간 -p 옵션은 아래와 같습니다.

sh:~$ zcli -p my_profile

또는 함께 명령을 사용하여 zcli 대화식 모드에서 :

zcli: profile apply my_profile

예는 다음과 같습니다.

프로파일이있는 ZEVENET zcli 대화식 모드

사용 방법

zcli 두 가지 작업 모드가 있습니다.

1. 인수없이 시작된 zcli 쉘은 대화식 모드에서 실행됩니다. 이 모드는 자동 완성 기능을 제공하며 명령이 실행 된 후 종료되지 않습니다. zcli 쉘, 타입 종료 또는 누르십시오 Ctrl + D.

2. zcli 인수와 함께 호출됩니다. 이것은 입력하지 않고 명령을 실행합니다 zcli 대화식 쉘 및 시스템 콘솔로 돌아갑니다.

ZEVENET 명령 줄 인터페이스에서 사용할 수있는 명령을 아래에서 살펴 보겠습니다.

명령

명령의 구문은 다음과 같습니다.

sh:~$  zcli [   options   ] [        object      ] [action] [   ids list   ] [    parameters    ]

예로서 :

sh:~$ zcli -nc -p test-lb2 farms-services-backend   set    farm1 service1 0 -ip 1.1.1.1 -port 80
           ^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^   ^^^    ^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^
               options            object           action      ids list         parameters

모든 매개 변수에 대한 설명을 아래에서 찾으십시오.

옵션: 그들은에 설정 zcli 기도. 전체 옵션 목록이 도움말에 자세히 설명되어 있습니다.
대상: 선택한로드 밸런서 개체의 종류입니다.
동작: 실행될 동사입니다.
ID 목록: 객체를 나타내는 식별자입니다. 이 ID는 모듈과 관련이 있습니다.
매개 변수: 객체에서 설정하는 파라미터입니다. 대부분 객체가 생성 / 추가 또는 수정 될 때 예상됩니다.

이러한 모든 매개 변수는 JSON 형식으로 사용할 수 있습니다. -j (– json) 옵션.

다음을 눌러 예상되는 명령 인수를 검색 할 수 있습니다. 엔터 버튼. 때로는 이전 인수가 설정 될 때까지 매개 변수가 확장되지 않습니다.

ZEVENET zcli 도움말 설명

zcli 자동 완성 기능이있어 두 번 눌러 트리거 할 수 있음 TAB 버튼을 클릭합니다.

ZEVENET zcli 자동 완성

업데이트 된 도움말은 아래 명령으로 확인할 수 있습니다.

sh:~$ zcli help

출력 데이터

그리고, zcli 프롬프트는 명령 오류 코드에 따라 색상을 변경합니다. 따라서 출력은 녹색 명령이 성공한 경우 빨간 명령 실행 중 오류가 발생한 경우 또한 프로파일 이름은 다음과 같이 인쇄됩니다 회색 언제 zcli 로드 밸런서에 연결할 수 없습니다. 이러한 종류의 오류의 경우 프로필 구성 및로드 밸런서 ZAPI 키를 검토하는 것이 유용합니다.

출력은 컬러 JSON 형식으로 인쇄되지만 옵션을 사용하여 비활성화 할 수 있습니다 -체크 안함 (– 색상 없음). 일부 정보 메시지가 표시 될 수 있으며 해당 메시지는 생략됩니다. zcli 대화식없이 명령 실행 모드에서 시작 zcli).

오류 메시지는 STDERR 출력.

명령 예

예제의 전체 목록은 ZAPI 설명서. 다음은 몇 가지 유용한 예입니다.

시스템 정보 얻기

sh:~$ zcli system get

시스템 통계 가져 오기

sh:~$ zcli statistic-system get

농장의 개요를 나열하십시오

sh:~$ zcli farm list

농장 만들기

sh:~$ zcli farm create -profile http -farmname farm1 -vip 10.0.0.241 -vport 443

팜의 구성을 검색합니다

sh:~$ zcli farm get farm1

농장 수정

sh:~$ zcli farm set farm1 -listener https

팜을 다시 시작

sh:~$ zcli farm restart farm1

서비스 만들기

sh:~$ zcli farm-service add farm1 -id images

서비스 수정

sh:~$ zcli farm-service set farm1 images -urlp /images

백엔드 추가

sh:~$ zcli farm-service-backend add farm1 images -ip 10.0.4.40 -port 443

백엔드 수정

sh:~$ zcli farm-service-backend set farm1 images 0 -priority 1

백엔드 삭제

sh:~$ zcli farm-service-backend remove farm1 images 0

유지 관리 모드에서 백엔드 설정 해제

sh:~$ zcli farm-service-backend maintenance farm1 images 0

유지 관리 모드에서 백엔드 설정

sh:~$ zcli farm-service-backend non_maintenance farm1 images 0

소스 코드 리포지토리

그리고, zcli 소스 코드 프로젝트는 URL에서 사용할 수 있습니다 https://github.com/zevenet/zcli

즐겨 zcliZEVENET 명령 줄 인터페이스!

공유 :

GNU Free Documentation License의 조건에 따른 문서.

이 글이 도움 되었나요?

관련 기사