apigeectl은 Kubernetes 클러스터에서 Apigee Hybrid 설치 및 관리를 위한 명령줄 인터페이스(CLI)입니다.
apigeectl 다운로드 및 설치에 대한 자세한 내용은 apigeectl 다운로드 및 설치를 참조하세요.
apigeectl 구문
apigeectl [command] [flags]
각 항목의 의미는 다음과 같습니다.
command: 수행할 작업을 지정합니다. 전체 명령어 목록은 apigeectl 명령어를 참조하세요.
flags: 명령어 매개변수를 지정합니다. 전체 플래그 목록은 apigeectl 플래그를 참조하세요.
apigeectl 명령어
다음 표에는 apigeectl 명령어가 나와 있습니다.
명령어
설명
apply
Apigee Hybrid 런타임 구성요소 구성을 Kubernetes 클러스터에 적용합니다.
하나 이상의 구성요소를 쉼표로 구분하여 지정하려면 -c 플래그를 사용합니다.
-c 플래그를 지정하지 않으면 apply 명령어가 모든 구성요소를 클러스터에 적용합니다.
check‑ready
하이브리드 구성요소 pod의 상태를 확인합니다. 모든 구성요소 포드가 준비되면 '모든 컨테이너 준비됨' 메시지가 출력됩니다.
자동 스크립팅의 경우 컨테이너가 모두 준비되면 명령어가 상태 0으로 종료됩니다. 하나 이상의 pod가 준비되지 않은 경우 명령어가 상태 1로 종료됩니다.
-c 플래그를 지정하지 않으면 check-ready 명령어가 클러스터의 모든 구성요소에 적용됩니다.
delete
클러스터에서 하이브리드 구성요소를 삭제합니다. --all 플래그를 사용하여 모든 구성요소를 삭제합니다. --all을 생략하면 Apigee 관련 구성요소만 삭제됩니다(apigeectl init로 설치된 구성요소는 삭제되지 않음). Apigee 관련 구성요소는 apply 명령어로 설치되는 구성요소입니다.
-c 플래그를 지정하지 않으면 delete 명령어가 클러스터에서 배포된 모든 구성요소에 적용됩니다.
help
온라인 도움말을 인쇄합니다.
init
Istio 및 Apigee 배포와 같은 기본 요건 구성요소 구성을 클러스터에 적용합니다.
하나 이상의 구성요소를 쉼표로 구분하여 지정하려면 -c 플래그를 사용합니다.
version
CLI 버전 정보를 인쇄합니다.
apigeectl 플래그
다음 표에는 apigeectl 플래그가 나와 있습니다.
플래그
설명
-c, --components
명령어가 적용되는 단일 구성요소를 지정합니다.
이 플래그를 지정하지 않으면 명령어가 클러스터의 모든 구성요소(전체 배포)에 적용됩니다. 가능한 값은 다음과 같습니다.
cassandra
logger
mart
metrics
runtime
synchronizer
udca
예를 들면 -c cassandra입니다.
또는 여러 구성요소를 지정하려면 쉼표로 구분된 값(-c cassandra, runtime)을 추가합니다.
--dry-run
클러스터를 변경하지 않고 지정된 명령어를 실행합니다. 렌더링된 객체 사양을 파일에 출력하려면 ‑‑print-yaml과 함께 사용합니다.
‑f, ‑‑file‑override‑config
하이브리드 배포의 커스텀 구성 속성을 포함하는 YAML 파일을 지정합니다. 기본값은 ./overrides.yaml입니다. apply, check-ready, delete, init 명령어에 재정의 파일이 필요합니다.
init를 사용하여 클러스터에 기본 요건 구성요소 구성을 적용합니다.
apply 전에 init 명령어를 실행해야 합니다.
apigeectl init -f my_overrides.yaml
클러스터 구성 적용
하이브리드 구성을 Kubernetes 클러스터에 적용하려면 apply 명령어를 사용합니다. apply를 처음 실행하면 모든 하이브리드 런타임 구성요소가 클러스터에 생성됩니다. 구성을 변경하는 경우 apply를 다시 실행하여 변경사항만 적용하거나 -c를 사용하여 특정 구성요소만 적용합니다.
다음 예시에서는 하이브리드 런타임 영역 구성요소 구성을 클러스터에 적용합니다.
apigeectl apply -f my_overrides.yaml
단일 구성요소에 구성 적용
apply 명령어를 특정 구성요소로 제한하려면 apigeectl 플래그에 설명된 대로 -c 플래그를 사용합니다.
설치 문제를 디버깅하는 경우 구성 설정을 검사할 수 있도록 전체 클러스터 구성을 파일에 인쇄하는 것이 유용합니다. --print-yaml 플래그는 하이브리드 구성을 stdout으로 인쇄하며 --dry-run 플래그를 사용하면 클러스터를 변경하지 않고 명령어를 실행할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(UTC)"],[[["\u003cp\u003e\u003ccode\u003eapigeectl\u003c/code\u003e is a command-line interface (CLI) used for managing Apigee hybrid in a Kubernetes cluster, requiring \u003ccode\u003ekubectl\u003c/code\u003e to be installed and configured.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eapigeectl\u003c/code\u003e tool uses commands and flags to perform operations, such as \u003ccode\u003eapply\u003c/code\u003e, \u003ccode\u003echeck-ready\u003c/code\u003e, \u003ccode\u003edelete\u003c/code\u003e, \u003ccode\u003ehelp\u003c/code\u003e, \u003ccode\u003einit\u003c/code\u003e, and \u003ccode\u003eversion\u003c/code\u003e, allowing users to configure and manage Apigee hybrid components.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eapply\u003c/code\u003e command is used to deploy configurations to the cluster, while the \u003ccode\u003einit\u003c/code\u003e command sets up prerequisites; \u003ccode\u003eapigeectl init\u003c/code\u003e must be run before \u003ccode\u003eapigeectl apply\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e-c\u003c/code\u003e flag in \u003ccode\u003eapigeectl\u003c/code\u003e commands enables operations to target specific components, and if not specified, the command affects all components.\u003c/p\u003e\n"],["\u003cp\u003eThe apigeectl tool can be used with dry-run and print yaml flags to inspect the resulting configurations, without changing the cluster, useful for debugging purposes.\u003c/p\u003e\n"]]],[],null,["# apigeectl\n\n| You are currently viewing version 1.2 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\n\n`apigeectl` is a command-line interface (CLI)\nfor installing and managing Apigee hybrid in a Kubernetes cluster.\nFor\ninformation on downloading and installing `apigeectl`, see\n[Download and install apigeectl](/apigee/docs/hybrid/v1.2/install-download-install#download-and-install-apigeectl).\n| **NOTE:** You must have [`kubectl`](https://kubernetes.io/docs/reference/kubectl/overview/) installed and set up on your Kubernetes administration machine to use the `apigeectl` command.\n\napigeectl syntax\n----------------\n\n```\napigeectl [command] [flags]\n```\n\nWhere:\n\n- \u003cvar translate=\"no\"\u003ecommand\u003c/var\u003e: Specifies the operation you want to\n perform. For a complete list of commands, see [apigeectl commands](#commands).\n\n- \u003cvar translate=\"no\"\u003eflags\u003c/var\u003e: Specifies command\n parameters. For a complete list of flags, see [apigeectl flags](#options).\n\napigeectl commands\n------------------\n\nThe following table lists the `apigeectl` commands:\n\napigeectl flags\n---------------\n\nThe following table lists the `apigeectl` flags:\n\n| The `apigeectl` command uses `kubectl` behind the scenes to do\n| its work. The `apigeectl` command options (`apply` and `delete`,\n| and the use of YAML configuration files, are similar to their kubectl counterparts.\n| To learn more about how objects are managed in a Kubernetes cluster, see the following topics:\n|\n| - [Imperative Management of Kubernetes Objects Using Configuration Files](https://kubernetes.io/docs/tasks/manage-kubernetes-objects/imperative-config/)\n| - [Overview of kubectl](https://kubernetes.io/docs/reference/kubectl/overview/)\n\nExamples\n--------\n\n### Initialize the cluster configuration\n\n\nApply prerequisite component configurations to your cluster with `init`.\nYou must run the `init`\ncommand before `apply`. \n\n```\napigeectl init -f my_overrides.yaml\n```\n\n### Apply the cluster configuration\n\nTo apply hybrid configurations to your Kubernetes cluster, use the\n`apply` command. The first time you run `apply` all of the\nhybrid runtime components are created in your cluster. If you make configuration changes, rerun\n`apply` to apply only the changes or use `-c` to apply a specific\ncomponent only.\n\nThe following example applies the configuration for hybrid runtime plane\ncomponents to your cluster: \n\n```\napigeectl apply -f my_overrides.yaml\n```\n\n### Apply the configuration for a single component\n\nTo restrict the `apply` command to a particular component, use the\n`-c` flag, as described in\n[apigeectl flags](#options).\n\nThe following example only applies the configuration for the Synchronizer\ncomponent: \n\n```\napigeectl apply -c synchronizer -f my_overrides.yaml\n```\n\nThe following example only applies the configuration for the Cassandra and runtime\ncomponents: \n\n```\napigeectl apply -c cassandra,runtime -f my_overrides.yaml\n```\n\n### Print the configuration to a file\n\nIf you're debugging an installation problem, it's useful to print out the entire\ncluster configuration to a file so that you can inspect the configuration\nsettings. The `--print-yaml` flag prints\nthe hybrid configuration to stdout, and the `--dry-run` flag allows the\ncommand to run without making any changes to the cluster. \n\n```\napigeectl apply -f my_overrides.yaml --dry-run --print-yaml \u003e apigee-hybrid.yaml\n```\n| **NOTE:** It is a good practice to save a copy of the YAML output in source control for future reference. But be aware that the output file contains passwords and secrets that you may not want to store.\n\n### Check pod status\n\nThe following example checks the status of pods deployed to your cluster: \n\n```\napigeectl check-ready\nAll containers ready in namespace 'my-namespace'\n```\n\n### Delete hybrid from the cluster\n\nThe following example deletes only the hybrid runtime components to your\nKubernetes cluster. To delete everything, use the `--all` flag.\n**NOTE:** To uninstall successfully, you must have `kubectl` version 1.11.x or later installed. \n\n```\napigeectl delete -f my_overrides.yaml\n```"]]
