Stage API Gateway a konfigurace za běhu

Automatizace deploymentů na AWS

Dunieski Otano

Amazon Web Services Solutions Architect

Tři adresy URL, jedno API

• Stejné checkout API potřebuje prostředí dev, staging a prod
• Každé prostředí komunikuje s jinými navazujícími zdroji
• Pevně zadané hodnoty vyžadují nové sestavení pro každé prostředí
• Stage variables to řeší za běhu

Co je stage v API Gateway

• Stage je nasazení API
• Každý stage má vlastní URL
• Běžné stage: dev, staging, prod
• Jedna definice API, mnoho stage

Proč jsou stage důležité pro nasazení

• Testuj v dev bez dopadu na prod
• Povyš stejné API do dalších prostředí
• Vrať stage zpět, aniž ovlivníš ostatní
• Každý stage má vlastní historii nasazení

Stage variables

• Páry klíč-hodnota platné pro jeden stage
• Odkazuj na ně pomocí ${stageVariables.varName}
• Použij je pro konfiguraci podle prostředí
• Když se hodnoty liší, není třeba měnit kód

Stage variables v praxi

• checkout-api -> stage dev: lambdaAlias = dev
• checkout-api -> stage prod: lambdaAlias = prod
• Integrace volá payments:${stageVariables.lambdaAlias}
• Jedno API využívá dva různé Lambda aliasy

Vlastní názvy domén

• Výchozí URL je nepřehledná: abc123.execute-api.us-east-1.amazonaws.com/dev
• Vlastní doména: api.example.com
  • Vyžaduje certifikát ACM pro TLS
• Mapování základní cesty spojuje cesty se stage
  • api.example.com/v1 → stage prod

Jak to všechno souvisí

• Stage variables <-> Lambda aliasy z videa 2.3
• Stejný princip platí pro verze definic úloh ECS a názvy tabulek DynamoDB
• Schválené verze pro každé prostředí, bez zásahů do kódu
• Kapitola 3 tento koncept rozšiřuje na další služby

Pojďme cvičit!

Automatizace deploymentů na AWS