apigeectl
์ Kubernetes ํด๋ฌ์คํฐ์์ Apigee Hybrid๋ฅผ ์ค์นํ๊ณ ๊ด๋ฆฌํ ์ ์๋ ๋ช
๋ น์ค ์ธํฐํ์ด์ค(CLI)์
๋๋ค.
apigeectl
๋ค์ด๋ก๋ ๋ฐ ์ค์น์ ๋ํ ์์ธํ ๋ด์ฉ์ apigeectl ๋ค์ด๋ก๋ ๋ฐ ์ค์น๋ฅผ ์ฐธ์กฐํ์ธ์.
apigeectl
์ ์ฉ ๋ฒ์
apigeectl
ํ๋๊ทธ๋ฅผ ์ฌ์ฉํ๋ฉด ๋ช
๋ น์ด๊ฐ ๊ตฌ์ฑ ๋ณ๊ฒฝ์ฌํญ์ ์ ์ฉํ ๋ฒ์๋ฅผ ์ ์ดํ ์ ์์ต๋๋ค. Apigee Hybrid ๋ฐํ์ ๋ด ๋ฒ์ ๊ฐ์๋ ๋ฐํ์ ์๋น์ค ๊ตฌ์ฑ ๊ฐ์๋ฅผ ์ฐธ์กฐํ์ธ์.
๋ฒ์ | ๊ตฌ์ฑ์์ | apigeectl ํ๋๊ทธ |
---|---|---|
์คํ ๋ฆฌ์ง | Cassandra | โโdatastore |
์ธ๋ฉ๋ชจ๋ฆฌ ์คํ ๋ฆฌ์ง | Redis | โโredis |
ํ๊ฒฝ | ๋ฐํ์ ๋๊ธฐํ ๋ด๋น์ UDCA |
โโallโenvs โโenv |
Organization | 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-system ๋ค์์คํ์ด์ค์ Apigee Operator์ 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์ ๊ฐ์ ์๊ฒฉ ๋ถ์ ๊ตฌ์ฑ์์์ ๊ตฌ์ฑ์ ์ ์ฉํฉ๋๋ค. |
โโv int |
์์ธ ๋ก๊ทธ๋ฅผ std err์ ์ถ๋ ฅํฉ๋๋ค. โโverbose ์ต์
์ ๋์ฒดํฉ๋๋ค. |
์์
ํด๋ฌ์คํฐ ๊ตฌ์ฑ ์ด๊ธฐํ
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