apigeectl
์ Kubernetes ํด๋ฌ์คํฐ์์ Apigee Hybrid ์ค์น ๋ฐ ๊ด๋ฆฌ๋ฅผ ์ํ ๋ช
๋ น์ค ์ธํฐํ์ด์ค(CLI)์
๋๋ค.
apigeectl
๋ค์ด๋ก๋ ๋ฐ ์ค์น์ ๋ํ ์์ธํ ๋ด์ฉ์ apigeectl ๋ค์ด๋ก๋ ๋ฐ ์ค์น๋ฅผ ์ฐธ์กฐํ์ธ์.
apigeectl
์ ์ฉ ๋ฒ์
apigeectl
ํ๋๊ทธ๋ฅผ ์ฌ์ฉํ๋ฉด ๋ช
๋ น์ด๊ฐ ๊ตฌ์ฑ ๋ณ๊ฒฝ์ฌํญ์ ์ ์ฉํ ๋ฒ์๋ฅผ ์ ์ดํ ์ ์์ต๋๋ค. Apigee Hybrid ๋ฐํ์ ๋ด ๋ฒ์ ๊ฐ์๋ ๋ฐํ์ ์๋น์ค ๊ตฌ์ฑ ๊ฐ์๋ฅผ ์ฐธ์กฐํ์ธ์.
๋ฒ์ | ๊ตฌ์ฑ์์ | apigeectl ํ๋๊ทธ |
---|---|---|
์คํ ๋ฆฌ์ง | Cassandra | --datastore |
์ธ๋ฉ๋ชจ๋ฆฌ ์คํ ๋ฆฌ์ง | Redis | --redis |
ํ๊ฒฝ | ๋ฐํ์ ๋๊ธฐํ ๋ด๋น์ UDCA |
--all-envs --env |
์กฐ์ง | Apigee Connect ์์ด์ ํธ MART Watcher |
--org |
๋ณด๊ณ | Logger ์ธก์ ํญ๋ชฉ |
--telemetry |
apigeectl ๊ตฌ๋ฌธ
apigeectl [command] [flags]
๊ฐ ํญ๋ชฉ์ ์๋ฏธ๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค.
command: ์ํํ ์์ ์ ์ง์ ํฉ๋๋ค. ์ ์ฒด ๋ช ๋ น์ด ๋ชฉ๋ก์ apigeectl ๋ช ๋ น์ด๋ฅผ ์ฐธ์กฐํ์ธ์.
flags: ๋ช ๋ น์ด ๋งค๊ฐ๋ณ์๋ฅผ ์ง์ ํฉ๋๋ค. ์ ์ฒด ํ๋๊ทธ ๋ชฉ๋ก์ apigeectl ํ๋๊ทธ๋ฅผ ์ฐธ์กฐํ์ธ์.
apigeectl ๋ช ๋ น์ด
๋ค์ ํ์๋ apigeectl
๋ช
๋ น์ด๊ฐ ๋์ ์์ต๋๋ค.
๋ช ๋ น์ด | ์ค๋ช |
---|---|
apply |
Apigee Hybrid ๋ฐํ์ ๊ตฌ์ฑ์์ ๊ตฌ์ฑ์ Kubernetes ํด๋ฌ์คํฐ์ ์ ์ฉํฉ๋๋ค. ํ๋๊ทธ๊ฐ ์๋
apigeectl ํ๋๊ทธ: |
checkโready |
ํ์ด๋ธ๋ฆฌ๋ ๊ตฌ์ฑ์์ ํฌ๋์ ์ํ๋ฅผ ํ์ธํฉ๋๋ค. ๋ชจ๋ ๊ตฌ์ฑ์์ ํฌ๋๊ฐ ์ค๋น๋๋ฉด '๋ชจ๋ ์ปจํ ์ด๋ ์ค๋น๋จ' ๋ฉ์์ง๊ฐ ์ถ๋ ฅ๋ฉ๋๋ค. ์๋ ์คํฌ๋ฆฝํ ์ ๊ฒฝ์ฐ ์ปจํ ์ด๋๊ฐ ๋ชจ๋ ์ค๋น๋๋ฉด ๋ช ๋ น์ด๊ฐ ์ํ 0์ผ๋ก ์ข ๋ฃ๋ฉ๋๋ค. ํ๋ ์ด์์ ํฌ๋๊ฐ ์ค๋น๋์ง ์์ ๊ฒฝ์ฐ ๋ช ๋ น์ด๊ฐ ์ํ 1๋ก ์ข ๋ฃ๋ฉ๋๋ค.
apigeectl ํ๋๊ทธ: |
delete |
ํด๋ฌ์คํฐ์์ ํ์ด๋ธ๋ฆฌ๋ ๊ตฌ์ฑ์์๋ฅผ ์ญ์ ํฉ๋๋ค. ์ ํ์ ์ธ ํ๋๊ทธ๊ฐ ์๋
apigeectl ํ๋๊ทธ: |
diagnostic |
ํ์์ ๋ฐ๋ผ Apigee Hybrid ์ธ์คํด์ค์ Kubernetes ๊ตฌ์ฑ์์์์ ์ง๋จ ๋ฐ์ดํฐ๋ฅผ ์บก์ฒํ๊ณ ์ด๋ฅผ Google Cloud Storage ๋ฒํท์ ์ ์ฅํ๋ ์ง๋จ ์์ง๊ธฐ๋ฅผ ํธ์ถํฉ๋๋ค. ์ง๋จ ์์ง๊ธฐ์๋ ์ด๋ฆ ์ง์ ๋ Google Cloud Storage ๋ฒํท, ์คํ ๋ฆฌ์ง ๊ด๋ฆฌ์ ์ญํ ์ด ์๋ ์๋น์ค ๊ณ์ , ์ง๋จ ์์ง๊ธฐ๋ฅผ ํธ์ถํ๋ฉด ' ์ง๋จ ์์ง๊ธฐ๋ฅผ ํธ์ถํฉ๋๋ค. apigeectl diagnostic -f OVERRIDES_FILE ์ง๋จ ์์ง๊ธฐ๋ฅผ ์ญ์ ํฉ๋๋ค. apigeectl diagnostic delete -f OVERRIDES_FILE
apigeectl ํ๋๊ทธ:
|
encode |
์ง์ ๋ ์กฐ์ง ๋๋ ์ง์ ๋ ์กฐ์ง ๋ด ์ง์ ๋ ํ๊ฒฝ์ ๋ชจ๋ ApigeeDeployment์ ์ธ์ฝ๋ฉ๋ ์ด๋ฆ ๋ชฉ๋ก์ ๋ฐํํฉ๋๋ค. ์ธ์ฝ๋ฉ๋ ์ด๋ฆ์๋ ์กฐ์ง์ ํด์๋ ์ด๋ฆ์ด ์๋ ๊ตฌ์ฑ์์ ์ด๋ฆ์ด ํฌํจ๋๋ฉฐ,
./apigeectl encode --org hybrid-example List of ApigeeDeployments are: apigee-connect-agent-hybrid-example-6a82f8a apigee-mart-hybrid-example-6a82f8a apigee-watcher-hybrid-example-6a82f8a ./apigeectl encode --org hybrid-example --env example-env List of ApigeeDeployments are: apigee-runtime-hybrid-example-example-env-9e87e2d apigee-synchronizer-hybrid-example-example-env-9e87e2d apigee-udca-hybrid-example-example-env-9e87e2d
apigeectl ํ๋๊ทธ: |
help |
์จ๋ผ์ธ ๋์๋ง์ ์ธ์ํฉ๋๋ค. |
init |
Apigee ์์คํ ๋ค์์คํ์ด์ค์ Apigee Operators ๋ฐ CRD๋ฅผ ์ค์นํฉ๋๋ค.
apigeectl ํ๋๊ทธ: |
version |
CLI ๋ฒ์ ์ ๋ณด๋ฅผ ์ถ๋ ฅํฉ๋๋ค.
apigeectl ํ๋๊ทธ: |
apigeectl ํ๋๊ทธ
๋ค์ ํ์๋ apigeectl
ํ๋๊ทธ๊ฐ ๋์ ์์ต๋๋ค.
ํ๋๊ทธ | ์ค๋ช |
---|---|
--all |
delete ๋ง ํด๋น: ASM(Istio)๊ณผ cert-manager๋ฅผ ์ ์ธํ ์ ์ฒด Apigee Hybrid ์ค์น๋ฅผ ํด๋ฌ์คํฐ์์ ์ญ์ ํฉ๋๋ค. |
--all-envs |
์ฌ์ ์ ๊ตฌ์ฑ ํ์ผ์ ์ง์ ๋ ์กฐ์ง์ ๋ชจ๋ ํ๊ฒฝ์ |
--datastore |
Datastore ๋ฒ์(Cassandra)์ ๊ตฌ์ฑ์ ์ ์ฉํฉ๋๋ค. |
โโdryโrun |
ํด๋ฌ์คํฐ๋ฅผ ๋ณ๊ฒฝํ์ง ์๊ณ ์ง์ ๋ ๋ช
๋ น์ด๋ฅผ ์คํํฉ๋๋ค. โโprint-yaml ๊ณผ ํจ๊ป ์ฌ์ฉํ์ฌ ๋ ๋๋ง๋ ๊ฐ์ฒด ์ฌ์์ ํ์ผ์ ์ถ๋ ฅํฉ๋๋ค.
|
--env env-name |
์ง์ ๋ ํ๊ฒฝ์ ๊ตฌ์ฑ์ ์ ์ฉํฉ๋๋ค. ์ด ํ๋๊ทธ๋ apigee-runtime, apigee-synchronizer, apigee-udca ํ๊ฒฝ ๋ฒ์ ๊ตฌ์ฑ์์์ ๊ตฌ์ฑ์ ์ ์ฉํฉ๋๋ค.
apigeectl apply --org hybrid-example --env example-env \ -f overrides/overrides.yaml |
โf |
ํ์ด๋ธ๋ฆฌ๋ ๋ฐฐํฌ์ ์ปค์คํ
๊ตฌ์ฑ ์์ฑ์ ํฌํจํ๋ YAML ํ์ผ์ ์ง์ ํฉ๋๋ค. ๊ธฐ๋ณธ๊ฐ์ ./overrides.yaml ์
๋๋ค. apply , check-ready , delete , init ๋ช
๋ น์ด์ ์ฌ์ ์ ํ์ผ์ด ํ์ํฉ๋๋ค.
์ด ํ๋๊ทธ์๋ ์ ์ฒด ๊ฒฝ๋ก๋ฅผ ์ง์ ํด์ผ ํฉ๋๋ค. ์์ธํ ๋ด์ฉ์ ๋ฐํ์ ์์ญ ๊ตฌ์ฑ์์ ๊ด๋ฆฌ๋ฅผ ์ฐธ์กฐํ์ธ์. |
-h |
๋ช ๋ น์ด์ ๋ํ ๋์๋ง์ ํ์ํฉ๋๋ค. |
--org |
์ง์ ๋ ์กฐ์ง์ ๊ตฌ์ฑ์ ์ ์ฉํฉ๋๋ค. ์ด ํ๋๊ทธ๋ apigee-connect-agent, apigee-mart, apigee-watcher์ ์กฐ์ง ๋ฒ์ ๊ตฌ์ฑ์์์ ๊ตฌ์ฑ์ ์ ์ฉํฉ๋๋ค. |
--printโyaml |
๊ตฌ์ฑ ํ ํ๋ฆฟ ์ถ๋ ฅ์ stdout์ ์ธ์ํฉ๋๋ค. ์ด ํ๋๊ทธ๋ฅผ ์ฌ์ฉํ๋ ์์๋ ๊ตฌ์ฑ์ ํ์ผ๋ก ์ธ์๋ฅผ ์ฐธ์กฐํ์ธ์. |
--redis |
๋ฉ๋ชจ๋ฆฌ ๋ด ๋ฐ์ดํฐ ์คํ ๋ฆฌ์ง ๋ฒ์(Redis)์ ๊ตฌ์ฑ์ ์ ์ฉํฉ๋๋ค. |
--restore |
|
-s |
๋ช
๋ น์ด๊ฐ ์ ์ฉ๋๋ ๊ตฌ์ฑ์ ์ง์ ํฉ๋๋ค. ํ์ฌ ์ด ํ๋๊ทธ๋ ์๋ฅผ ๋ค์ด ์ฌ์ ์ ํ์ผ์ apigeectl apply -f my-overrides.yaml --settings virtualhosts \ --org example-org --env example-env |
--telemetry |
apigee-logger ๋ฐ apigee-metrics์ ๊ฐ์ ํ ๋ ๋ฉํธ๋ฆฌ ๊ตฌ์ฑ์์์ ๊ตฌ์ฑ์ ์ ์ฉํฉ๋๋ค. |
--verbose |
์์ธ ๋ก๊ทธ๋ฅผ std err์ ์ถ๋ ฅํฉ๋๋ค. |
์์
ํด๋ฌ์คํฐ ๊ตฌ์ฑ ์ด๊ธฐํ
init
๋ฅผ ์ฌ์ฉํ์ฌ ํด๋ฌ์คํฐ์ ๊ธฐ๋ณธ ์๊ฑด ๊ตฌ์ฑ์์ ๊ตฌ์ฑ์ ์ ์ฉํฉ๋๋ค.
apply
์ ์ init
๋ช
๋ น์ด๋ฅผ ์คํํด์ผ ํฉ๋๋ค.
apigeectl init -f my_overrides.yaml
ํด๋ฌ์คํฐ ๊ตฌ์ฑ ์ ์ฉ
ํ์ด๋ธ๋ฆฌ๋ ๊ตฌ์ฑ์ Kubernetes ํด๋ฌ์คํฐ์ ์ ์ฉํ๋ ค๋ฉด apply
๋ช
๋ น์ด๋ฅผ ์ฌ์ฉํฉ๋๋ค. apply
๋ฅผ ์ฒ์ ์คํํ๋ฉด ๋ชจ๋ ํ์ด๋ธ๋ฆฌ๋ ๋ฐํ์ ๊ตฌ์ฑ์์๊ฐ ํด๋ฌ์คํฐ์ ์์ฑ๋ฉ๋๋ค. ๊ตฌ์ฑ์ ๋ณ๊ฒฝํ๋ ๊ฒฝ์ฐ apply
๋ฅผ ๋ค์ ์คํํ์ฌ ๋ณ๊ฒฝ์ฌํญ๋ง ์ ์ฉํ๊ฑฐ๋, ํ๋๊ทธ๋ฅผ ์ฌ์ฉํ์ฌ ํน์ ๋ฒ์์๋ง ๋ณ๊ฒฝ์ฌํญ์ ์ ์ฉํฉ๋๋ค.
๋ค์ ์์์์๋ ํ์ด๋ธ๋ฆฌ๋ ๋ฐํ์ ์์ญ ๊ตฌ์ฑ์์ ๊ตฌ์ฑ์ ํด๋ฌ์คํฐ์ ์ ์ฉํฉ๋๋ค.
apigeectl apply -f my_overrides.yaml
๋จ์ผ ๊ตฌ์ฑ์์์ ๊ตฌ์ฑ ์ ์ฉ
apply
๋ช
๋ น์ด๋ฅผ ํน์ ๊ตฌ์ฑ์์๋ก ์ ํํ๋ ค๋ฉด apigeectl ํ๋๊ทธ์ ์ค๋ช
๋ ํ๋๊ทธ๋ฅผ ์ฌ์ฉํฉ๋๋ค.
๋ค์ ์์์๋ Cassandra ๊ตฌ์ฑ์์์ ๊ตฌ์ฑ๋ง ์ ์ฉํฉ๋๋ค.
apigeectl apply --datastore -f my_overrides.yaml
๊ตฌ์ฑ์ ํ์ผ๋ก ์ถ๋ ฅ
์ค์น ๋ฌธ์ ๋ฅผ ๋๋ฒ๊น
ํ๋ ๊ฒฝ์ฐ ๊ตฌ์ฑ ์ค์ ์ ๊ฒ์ฌํ ์ ์๋๋ก ์ ์ฒด ํด๋ฌ์คํฐ ๊ตฌ์ฑ์ ํ์ผ์ ์ธ์ํ๋ ๊ฒ์ด ์ ์ฉํฉ๋๋ค. --print-yaml
ํ๋๊ทธ๋ ํ์ด๋ธ๋ฆฌ๋ ๊ตฌ์ฑ์ stdout์ผ๋ก ์ธ์ํ๋ฉฐ --dry-run
ํ๋๊ทธ๋ฅผ ์ฌ์ฉํ๋ฉด ํด๋ฌ์คํฐ๋ฅผ ๋ณ๊ฒฝํ์ง ์๊ณ ๋ช
๋ น์ด๋ฅผ ์คํํ ์ ์์ต๋๋ค.
apigeectl apply -f my_overrides.yaml --dry-run=client --print-yaml > apigee-hybrid.yaml
ํฌ๋ ์ํ ํ์ธ
๋ค์ ์์์์๋ ํด๋ฌ์คํฐ์ ๋ฐฐํฌ๋ ํฌ๋์ ์ํ๋ฅผ ํ์ธํฉ๋๋ค.
apigeectl check-ready -f overrides/overrides.yaml All containers ready in namespace 'my-namespace'
ํด๋ฌ์คํฐ์์ ํ์ด๋ธ๋ฆฌ๋ ์ญ์
๋ค์ ์์์์๋ Kubernetes ํด๋ฌ์คํฐ์์ ํ์ด๋ธ๋ฆฌ๋ ๋ฐํ์ ๊ตฌ์ฑ์์๋ง ์ญ์ ํฉ๋๋ค. ๋ชจ๋ ํญ๋ชฉ์ ์ญ์ ํ๋ ค๋ฉด --all
ํ๋๊ทธ๋ฅผ ์ฌ์ฉํฉ๋๋ค.
apigeectl delete -f my_overrides.yaml