๊ถŒ์žฅ๋˜๋Š” ๋‹ค์Œ ๋‹จ๊ณ„

์ด ํŽ˜์ด์ง€๋Š” Apigee ๋ฐ Apigee Hybrid์— ์ ์šฉ๋ฉ๋‹ˆ๋‹ค.

Apigee Edge ๋ฌธ์„œ ๋ณด๊ธฐ

์ด ๋‹จ๊ณ„์—์„œ ์ˆ˜ํ–‰ํ•  ์ž‘์—…

ํ…Œ์ŠคํŠธ API ํ”„๋ก์‹œ๋ฅผ ๋งŒ๋“ค๊ณ  ๋ฐฐํฌํ•˜๋ ค๋ฉด ๋‹ค์Œ ๋‹จ๊ณ„๋ฅผ ๋”ฐ๋ฅด์„ธ์š”. ๋งˆ์ง€๋ง‰์œผ๋กœ HTTP ์š”์ฒญ์„ ์ „์†กํ•˜์—ฌ API ํ”„๋ก์‹œ๋ฅผ ํ…Œ์ŠคํŠธํ•ฉ๋‹ˆ๋‹ค.

API ํ”„๋ก์‹œ ๋งŒ๋“ค๊ธฐ ๋ฐ ๋ฐฐํฌ

Apigee ํ”„๋กœ๋น„์ €๋‹ ์ ˆ์ฐจ๋Š” API ํ”„๋ก์‹œ๋ฅผ ์ž๋™์œผ๋กœ ๋งŒ๋“ค๊ณ  ๋ฐฐํฌํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ํ”„๋ก์‹œ ๋งŒ๋“ค๊ธฐ ๋ฐ ๋ฐฐํฌ๋ฅผ ์ˆ˜๋™์œผ๋กœ ์ˆ˜ํ–‰ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

Cloud ์ฝ˜์†”์˜ Apigee UI

์ฒซ ๋ฒˆ์งธ ํ”„๋ก์‹œ๋ฅผ ๋งŒ๋“ค๊ณ  ๋ฐฐํฌํ•˜๋ ค๋ฉด ๋‹ค์Œ ์•ˆ๋‚ด๋ฅผ ๋”ฐ๋ฅด์„ธ์š”.

  1. Google Cloud ์ฝ˜์†”์—์„œ ํ”„๋ก์‹œ ๊ฐœ๋ฐœ > API ํ”„๋ก์‹œ ํŽ˜์ด์ง€๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค.

    API ํ”„๋ก์‹œ๋กœ ์ด๋™

  2. Google Cloud ์ฐฝ์˜ ํ”„๋กœ์ ํŠธ ์„ ํƒ ๋„๊ตฌ์—์„œ ์กฐ์ง ์ด๋ฆ„์ด ์„ ํƒ๋˜์–ด ์žˆ๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ์กฐ์ง ์ด๋ฆ„์€ Google Cloud ํ”„๋กœ์ ํŠธ ์ด๋ฆ„๊ณผ ๋™์ผํ•ฉ๋‹ˆ๋‹ค.
  3. + ๋งŒ๋“ค๊ธฐ๋ฅผ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.

    ํ”„๋ก์‹œ ๋งŒ๋“ค๊ธฐ ํŽ˜์ด์ง€๊ฐ€ ์—ด๋ฆฝ๋‹ˆ๋‹ค.

  4. ํ”„๋ก์‹œ ํ…œํ”Œ๋ฆฟ ์ƒ์ž์—์„œ ๋ฆฌ๋ฒ„์Šค ํ”„๋ก์‹œ(๊ฐ€์žฅ ์ผ๋ฐ˜์ )๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  5. 1๋‹จ๊ณ„: ํ”„๋ก์‹œ ์„ธ๋ถ€์ •๋ณด์—์„œ ๋‹ค์Œ ๊ฐ’์œผ๋กœ ํ”„๋ก์‹œ๋ฅผ ๊ตฌ์„ฑํ•ฉ๋‹ˆ๋‹ค.
    ๋งค๊ฐœ๋ณ€์ˆ˜ ์ด๋ฆ„ ๊ฐ’
    ํ”„๋ก์‹œ ์ด๋ฆ„ hello-world
    ๊ธฐ๋ณธ ๊ฒฝ๋กœ /hello-world
    ๋Œ€์ƒ(๊ธฐ์กด API) mocktarget.apigee.net
  6. ๋‹ค์Œ์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  7. 2๋‹จ๊ณ„: ๋ฐฐํฌ(์„ ํƒ์‚ฌํ•ญ)์—์„œ ๋‹ค์Œ ์•ˆ๋‚ด๋ฅผ ๋”ฐ๋ฅด์„ธ์š”.
    • ๋ฐฐํฌ ํ™˜๊ฒฝ: ์„ ํƒ์‚ฌํ•ญ. ์ฒดํฌ๋ฐ•์Šค๋ฅผ ์‚ฌ์šฉํ•ด์„œ ํ”„๋ก์‹œ๋ฅผ ๋ฐฐํฌํ•˜๋ ค๋Š” ํ™˜๊ฒฝ์„ ํ•˜๋‚˜ ์ด์ƒ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค. ์ด ์‹œ์ ์—์„œ ํ”„๋ก์‹œ๋ฅผ ๋ฐฐํฌํ•˜์ง€ ์•Š์œผ๋ ค๋ฉด ๋ฐฐํฌ ํ™˜๊ฒฝ ํ•„๋“œ๋ฅผ ๋น„์›Œ ๋‘ก๋‹ˆ๋‹ค. ๋‚˜์ค‘์— ์–ธ์ œ๋“ ์ง€ ํ”„๋ก์‹œ๋ฅผ ๋ฐฐํฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
    • ์„œ๋น„์Šค ๊ณ„์ •: ์„ ํƒ์‚ฌํ•ญ. ์„œ๋น„์Šค ๊ณ„์ •์˜ ์—ญํ•  ๋ฐ ๊ถŒํ•œ์— ์ง€์ •๋œ ๋Œ€๋กœ ๋ฐฐํฌ์— ์„œ๋น„์Šค ๊ณ„์ •์„ ์—ฐ๊ฒฐํ•˜์—ฌ Google Cloud์„œ๋น„์Šค์— ์•ก์„ธ์Šคํ•˜๋„๋ก ํ”„๋ก์‹œ๋ฅผ ์‚ฌ์šฉ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค.
  8. ๋งŒ๋“ค๊ธฐ๋ฅผ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.

    ์ƒˆ API ํ”„๋ก์‹œ๊ฐ€ ์ƒ์„ฑ๋˜๊ณ  ์„ ํƒํ•œ ํ™˜๊ฒฝ์— ๋ฐฐํฌ๋ฉ๋‹ˆ๋‹ค.

  9. ์ƒˆ๋กœ ๋งŒ๋“  ํ”„๋ก์‹œ์˜ ํ”„๋ก์‹œ ์š”์•ฝ ํŽ˜์ด์ง€๊ฐ€ ์—ด๋ฆฝ๋‹ˆ๋‹ค. ์ƒํƒœ์—์„œ ๋…น์ƒ‰ ์ฒดํฌํ‘œ์‹œ๋Š” ํ”„๋ก์‹œ๊ฐ€ ์„ฑ๊ณต์ ์œผ๋กœ ๋ฐฐํฌ๋˜์—ˆ์Œ์„ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค. ํ”„๋ก์‹œ๊ฐ€ ๋ฐฐํฌ๋˜์ง€ ์•Š์•˜์œผ๋ฉด API ํ”„๋ก์‹œ ๋ฐฐํฌ๋ฅผ ์„ ํƒํ•˜๊ณ  ๋‹จ๊ณ„์— ๋”ฐ๋ผ ์ˆ˜๋™์œผ๋กœ ๋ฐฐํฌํ•ฉ๋‹ˆ๋‹ค.
  10. ์™ผ์ชฝ ํƒ์ƒ‰ ์ฐฝ์—์„œ ๊ด€๋ฆฌ > ํ™˜๊ฒฝ > ํ™˜๊ฒฝ ๊ทธ๋ฃน์„ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  11. ํ™˜๊ฒฝ ๊ทธ๋ฃน์˜ ํ˜ธ์ŠคํŠธ ์ด๋ฆ„์„ ๋ณต์‚ฌํ•ฉ๋‹ˆ๋‹ค. ๋‹ค์Œ ๋‹จ๊ณ„์—์„œ ์ด ํ˜ธ์ŠคํŠธ ์ด๋ฆ„์„ ์‚ฌ์šฉํ•˜์—ฌ API ํ”„๋ก์‹œ๋ฅผ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค.

๊ธฐ๋ณธ Apigee

์ฒซ ๋ฒˆ์งธ ํ”„๋ก์‹œ๋ฅผ ๋งŒ๋“ค๊ณ  ๋ฐฐํฌํ•˜๋ ค๋ฉด ๋‹ค์Œ ์•ˆ๋‚ด๋ฅผ ๋”ฐ๋ฅด์„ธ์š”.

  1. Apigee UI์— ๋กœ๊ทธ์ธํ•ฉ๋‹ˆ๋‹ค.
  2. UI ์™ผ์ชฝ ์ƒ๋‹จ ๋ชจ์„œ๋ฆฌ์— ์žˆ๋Š” ๋“œ๋กญ๋‹ค์šด ๋ฉ”๋‰ด์—์„œ ์กฐ์ง ์ด๋ฆ„์ด ์„ ํƒ๋˜์–ด ์žˆ๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ์กฐ์ง ์ด๋ฆ„์€ Google Cloud ํ”„๋กœ์ ํŠธ ์ด๋ฆ„๊ณผ ๋™์ผํ•ฉ๋‹ˆ๋‹ค.
  3. ๊ธฐ๋ณธ ๋ทฐ์—์„œ API ํ”„๋ก์‹œ๋ฅผ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  4. ํ™˜๊ฒฝ ์„ ํƒ ๋“œ๋กญ๋‹ค์šด ๋ชฉ๋ก์—์„œ ํ™˜๊ฒฝ์„ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  5. ์ƒˆ๋กœ ๋งŒ๋“ค๊ธฐ๋ฅผ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  6. ๋ฆฌ๋ฒ„์Šค ํ”„๋ก์‹œ(๊ฐ€์žฅ ์ผ๋ฐ˜์ )๋ฅผ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  7. ํ”„๋ก์‹œ ์„ธ๋ถ€์ •๋ณด ํŽ˜์ด์ง€์—์„œ ๋‹ค์Œ ๊ฐ’์œผ๋กœ ํ”„๋ก์‹œ๋ฅผ ๊ตฌ์„ฑํ•ฉ๋‹ˆ๋‹ค.
    ๋งค๊ฐœ๋ณ€์ˆ˜ ์ด๋ฆ„ ๊ฐ’
    ์ด๋ฆ„ hello-world
    ๊ธฐ๋ณธ ๊ฒฝ๋กœ /hello-world
    ๋Œ€์ƒ(๊ธฐ์กด API) https://mocktarget.apigee.net
  8. ๋‹ค์Œ์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  9. ์ผ๋ฐ˜ ์ •์ฑ… ํŽ˜์ด์ง€์˜ ๋ณด์•ˆ: ์Šน์ธ์—์„œ ํ†ต๊ณผ(์Šน์ธ ์—†์Œ)๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  10. ๋‹ค์Œ์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  11. ์š”์•ฝ ํŽ˜์ด์ง€์˜ ์„ ํƒ์  ๋ฐฐํฌ์—์„œ ํ”„๋ก์‹œ๋ฅผ ๋ฐฐํฌํ•  ํ™˜๊ฒฝ์„ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  12. ๋งŒ๋“ค๊ธฐ ๋ฐ ๋ฐฐํฌ๋ฅผ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.

    ์ƒˆ API ํ”„๋ก์‹œ๊ฐ€ ์ƒ์„ฑ๋˜๊ณ  ์„ ํƒํ•œ ํ™˜๊ฒฝ์— ๋ฐฐํฌ๋ฉ๋‹ˆ๋‹ค.

  13. ํ”„๋ก์‹œ ๋ชฉ๋ก์œผ๋กœ ์ด๋™์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค. ์ƒํƒœ์—์„œ ๋…น์ƒ‰ ์ฒดํฌํ‘œ์‹œ๋Š” ํ”„๋ก์‹œ๊ฐ€ ์„ฑ๊ณต์ ์œผ๋กœ ๋ฐฐํฌ๋˜์—ˆ์Œ์„ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค. ํ”„๋ก์‹œ๊ฐ€ ๋ฐฐํฌ๋˜์ง€ ์•Š์•˜์œผ๋ฉด API ํ”„๋ก์‹œ ๋ฐฐํฌ๋ฅผ ์„ ํƒํ•˜๊ณ  ๋‹จ๊ณ„์— ๋”ฐ๋ผ ์ˆ˜๋™์œผ๋กœ ๋ฐฐํฌํ•ฉ๋‹ˆ๋‹ค.
  14. ์™ผ์ชฝ ํƒ์ƒ‰ ์ฐฝ์—์„œ ๊ด€๋ฆฌ์ž > ํ™˜๊ฒฝ > ๊ทธ๋ฃน์„ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  15. ์ฝ˜์†”์—์„œ Google Cloud ๋ณด๊ธฐ๋ฅผ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  16. ํ™˜๊ฒฝ ๊ทธ๋ฃน์˜ ํ˜ธ์ŠคํŠธ ์ด๋ฆ„์„ ๋ณต์‚ฌํ•ฉ๋‹ˆ๋‹ค. ๋‹ค์Œ ๋‹จ๊ณ„์—์„œ ์ด ํ˜ธ์ŠคํŠธ ์ด๋ฆ„์„ ์‚ฌ์šฉํ•˜์—ฌ API ํ”„๋ก์‹œ๋ฅผ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค.
  17. Google Cloud ์ฝ˜์†”์„ ๋‹ซ์Šต๋‹ˆ๋‹ค.

๋‚ด๋ถ€ ์•ก์„ธ์Šค ๊ถŒํ•œ์„ ์‚ฌ์šฉํ•˜์—ฌ ํ”„๋ก์‹œ ํ˜ธ์ถœ

4๋‹จ๊ณ„: ์•ก์„ธ์Šค ๋ผ์šฐํŒ… ๋งž์ถค์„ค์ •์—์„œ ๋‚ด๋ถ€ ์•ก์„ธ์Šค ๊ถŒํ•œ์„ ํ—ˆ์šฉํ•œ ๊ฒฝ์šฐ ๋‚ด๋ถ€ ์ „์šฉ ์•ก์„ธ์Šค ๊ถŒํ•œ์œผ๋กœ API ํ”„๋ก์‹œ ํ˜ธ์ถœ์˜ ์•ˆ๋‚ด๋ฅผ ๋”ฐ๋ฅด์„ธ์š”.

์™ธ๋ถ€ ์•ก์„ธ์Šค ๊ถŒํ•œ์„ ์‚ฌ์šฉํ•˜์—ฌ ํ”„๋ก์‹œ ํ˜ธ์ถœ

4๋‹จ๊ณ„: ์•ก์„ธ์Šค ๋ผ์šฐํŒ… ๋งž์ถค์„ค์ •์—์„œ ์™ธ๋ถ€ ์•ก์„ธ์Šค ๊ถŒํ•œ์„ ํ—ˆ์šฉํ•œ ๊ฒฝ์šฐ ๋‹ค์Œ ๋‹จ๊ณ„๋ฅผ ๋”ฐ๋ฅด์„ธ์š”.

  1. ํ˜ธ์ŠคํŠธ์˜ DNS ํ•ญ๋ชฉ์„ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค. ์ด ํƒœ์Šคํฌ๋ฅผ ์ˆ˜ํ–‰ํ•˜๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๋‘ ๊ฐ€์ง€ ๋ฐฉ๋ฒ•์ด ์žˆ์Šต๋‹ˆ๋‹ค.
    • ๋“ฑ๋ก ๊ธฐ๊ด€์—์„œ DNS ๊ตฌ์„ฑ ์•„๋ž˜์˜ ๋งˆ๋ฒ•์‚ฌ ํŽ˜์ด์ง€์— ํ‘œ์‹œ๋œ IP๋กœ ํ™˜๊ฒฝ ๊ทธ๋ฃน ํ˜ธ์ŠคํŠธ ์ด๋ฆ„์„ ์—ฐ๊ฒฐํ•˜๋Š” A ๋ ˆ์ฝ”๋“œ๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค. ์˜ˆ๋ฅผ ๋“ค์–ด ํ˜ธ์ŠคํŠธ ์ด๋ฆ„์ด sales.example.com์ด๊ณ  IP๊ฐ€ 10.23.0.2์ด๋ฉด sales.example.com์˜ ๋ ˆ์ฝ”๋“œ๋ฅผ 10.23.0.2 ์ฃผ์†Œ๋กœ ์—ฐ๊ฒฐํ•ฉ๋‹ˆ๋‹ค.
    • Google Cloud DNS๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ URL์„ IP ์ฃผ์†Œ์— ๋งคํ•‘ํ•ฉ๋‹ˆ๋‹ค.
  2. ํ„ฐ๋ฏธ๋„ ์ฐฝ์—์„œ ๋‹ค์Œ ์š”์ฒญ์„ ์ „์†กํ•˜์—ฌ API ํ”„๋ก์‹œ๋ฅผ ํ…Œ์ŠคํŠธํ•ฉ๋‹ˆ๋‹ค.
    curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
      https://YOUR_INSTANCE_IP_OR_DNS/hello-world

    ๊ฐ ํ•ญ๋ชฉ์˜ ์˜๋ฏธ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

    • Host ํ—ค๋”(YOUR_ENV_GROUP_HOSTNAME) ๊ฐ’์€ ํ™˜๊ฒฝ > ํ™˜๊ฒฝ ๊ทธ๋ฃน ํŽ˜์ด์ง€์˜ ํ˜ธ์ŠคํŠธ ์ด๋ฆ„์ž…๋‹ˆ๋‹ค.

    ์š”์ฒญ์— ์„ฑ๊ณตํ•˜๋ฉด Hello, Guest! ๋ฌธ์ž์—ด์ด ๋ฐ˜ํ™˜๋ฉ๋‹ˆ๋‹ค. ์š”์ฒญ์ด ์‹คํŒจํ•˜๋ฉด ๋ฌธ์ œ ํ•ด๊ฒฐ์„ ์ฐธ์กฐํ•˜์„ธ์š”.

๋‹ค์Œ ๋‹จ๊ณ„