콘텐츠로 이동

온박스 명령어

두 개의 별도 명령어 세트가 Customer Edge에 도달하며, 어느 쪽도 다른 쪽을 포함하지 않습니다.

  • 박스 내부에서 Site CLI는 최상위 명령어 6개execcli 하위 명령어 82개를 갖습니다.
  • 네트워크를 통해, debug API는 자체 34개 카탈로그를 보유합니다.

온박스 인터페이스의 대부분은 API에 해당하는 항목이 없습니다. 전체 Vega 컨트롤 플레인, Envoy 래퍼, 패킷 캡처, kubelet 매개변수 세트, edit-* 파일 및 보조 루트 액세스 쌍은 박스에서만 접근할 수 있습니다.

이에 접근하려면 SSH 또는 시리얼 콘솔이 필요하며, 어디에도 문서화되지 않은 한 가지 사항이 있습니다:

아래 세트는 벤더 문서에서 옮겨 적은 것이 아닙니다. scripts/sitecli_ssh_harvest.py를 사용하여 라이브 노드에서 직접 읽어 그 출처와 함께 sitecli/exec-catalog.json에 커밋되었습니다. 세 가지 등록 상태에서 세 번 실행한 결과:

측정 시점최상위execcli
site_state: PROVISIONING682
site_state: PROVISIONED682
site_state: ONLINE682

세 번 모두 동일한 세트를 반환했습니다 — 단순히 총계가 같은 것이 아니라 이름이 동일했으며, 마지막은 다른 사이트 및 리소스 이름을 가진 다른 배포였습니다. 따라서 명령어 인터페이스는 등록 상태에 따라 변하지 않으며, 없는 명령어는 아직 제공되지 않는 것이 아니라 진정으로 없는 것입니다.

debug API의 34개와 비교하면 두 가지 수치를 명확히 구분해야 합니다:

  • 51개execcli 하위 명령어는 API에 해당하는 항목이 없습니다.
  • 55개는 전체 온박스 인터페이스에서 계산된 동일한 수치로, execcli 하위가 아닌 최상위에 있는 4개의 configure* 명령어도 포함됩니다.

둘 다 올바른 수치입니다. 독자가 하나를 재계산하여 다른 값을 찾았다면 실수한 것이 아닙니다. 여기의 모든 수치는 sitecli/catalog.jsonsitecli/exec-catalog.json에서 도출되었습니다.

문서화된 항목과 목록만 제공된 항목

섹션 제목: “문서화된 항목과 목록만 제공된 항목”

Customer Edge는 Linux와 여러 서드파티 데몬을 실행합니다. 해당 명령어를 문서화하면 자체 참조를 중복하고 F5가 소유한 것처럼 암시하므로, 규칙은 다음과 같습니다: F5 소프트웨어는 문서화하고, 나머지는 CE에 특화된 내용만 문서화합니다.

“우리 것”과 “그들 것”이 명확히 구분되지 않으므로 세 계층이 있습니다. 분류는 sitecli/command-classification.json에 기록되어 있습니다.

계층처리 방식
F5 소프트웨어전체 문서화 — 목적, 구문, 인수, 캡처된 출력, 확인할 사항. Argo, Vega, vpm, vifdump, configure*, edit-* 세트, kubelet 매개변수, 루트 액세스.
CE 특화 해석CE에서 특별한 의미를 갖는 서드파티 도구. CE 특화 해석이 문서화되고 도구 자체의 의미론은 업스트림에 맡깁니다.
패스스루CE에 특화된 내용이 없는 일반 Linux 또는 서드파티. 사용 가능 항목으로 나열하고 업스트림으로 포인터 제공. 본문 없음.

이 구분이 페이지 존재 여부를 결정하며, 이 문서가 man 페이지의 더 나쁜 사본으로 변질되는 것을 방지합니다.

박스에서 사용 가능하지만 여기서는 문서화하지 않습니다 — 이것들은 F5 소프트웨어가 아닌 운영 체제와 서드파티 데몬이며, 자체 참조가 이 페이지에서 재서술하는 것보다 낫습니다.

명령어업스트림
ping, netstat, lsof, ip, ip-link-show, nmcli, tracepathiproute2, NetworkManager
top, check-mem, sysctl, load-sysctl-conf, journalctl, files, rpm-ostree, chronyc-sourcescoreutils, procps, systemd, rpm-ostree, chrony
edit-etc-hosts, edit-sysctl-conf해당 파일들은 운영 체제의 것입니다
systemctl-status-crio, systemctl-status-docker, systemctl-status-kubelet, systemctl-status-iscsid, systemctl-status-multipathdsystemd
systemctl-restart-crio, systemctl-restart-docker, systemctl-restart-kubelet, systemctl-restart-iscsid, systemctl-restart-multipathdsystemd — 이 명령어들은 모두 노드의 워크로드를 중단시킵니다

이 중 두 가지는 별도 페이지가 없더라도 알아둘 가치가 있습니다. files는 파일 작업을 수행하며 /tmp 하위에만 쓸 수 있습니다. 그리고 모든 systemctl-restart-*는 정의상 중단을 유발합니다 — crio 또는 kubelet을 재시작하면 해당 노드의 워크로드가 중단됩니다.