Етапи API Gateway та конфігурація під час виконання

Автоматизація розгортань в AWS

Dunieski Otano

Amazon Web Services Solutions Architect

Три URL — один API

• Тому самому checkout API потрібні dev, staging і prod
• Кожне середовище звертається до інших бекенд-ресурсів
• Жорстке кодування значень змушує збирати заново для кожного середовища
• Змінні етапу вирішують це під час виконання

Що таке етап API Gateway

• Етап — це розгортання API
• Кожен етап має власний URL
• Типові етапи: dev, staging, prod
• Одне визначення API, багато етапів

Чому етапи важливі для розгортань

• Тестуйте в dev без впливу на prod
• Просувайте той самий API між середовищами
• Відкочуйте етап не зачіпаючи інші
• Кожен етап веде свою історію розгортань

Змінні етапу

• Пари ключ-значення, обмежені одним етапом
• Посилання через ${stageVariables.varName}
• Використовуйте для конфігурації на середовище
• Зміни значень без змін у коді

Змінні етапу в дії

• checkout-api -> етап dev: lambdaAlias = dev
• checkout-api -> етап prod: lambdaAlias = prod
• Інтеграція викликає payments:${stageVariables.lambdaAlias}
• Один API звертається до двох різних псевдонімів Lambda

Власні доменні імена

• Типовий URL некрасивий: abc123.execute-api.us-east-1.amazonaws.com/dev
• Власний домен: api.example.com
  • Потрібен сертифікат ACM для TLS
• Прив'язка базового шляху поєднує шляхи з етапами
  • api.example.com/v1 → етап prod

Як усе поєднується

• Змінні етапу <-> псевдоніми Lambda з відео 2.3
• Та сама ідея для версій визначень завдань ECS і імен таблиць DynamoDB
• Затверджені версії на середовище, без змін у коді
• Розділ 3 розширює це між сервісами

Давайте потренуємось!

Автоматизація розгортань в AWS