
ãITãAWS ECSãPoCç°å¢äœæã§åŠã¶çæéäžè¬åº§ã第3ç« ïŒECRã«PushããŠECS(EC2)ã§FastAPIãèµ·åããã
çããŸãããã«ã¡ã¯
æ°åã«ããããAWS ECSã«PoCç°å¢ãæ§ç¯ããŠãããŸãã
ä»åã¯ãïŒåç®ã§ãã
ååã®èšäº
1. ä»åã®ç®ç
第1ç« ã§äœã£ã FastAPIã³ã³ããïŒamd64ïŒ ã
ECR (Elastic Container Registry) ã«pushããECSã¯ã©ã¹ã¿ãŒäžã§ ã¿ã¹ã¯å®çŸ©ïŒãµãŒãã¹ ãäœæããŠèµ·å
å®éã« FastAPIã¢ããªããã©ãŠã¶ããã¢ã¯ã»ã¹ç¢ºèª
ããã§ãã¯ã©ãŠãäžã§ããªãã®FastAPIãåãåºããŸãã
2. å šäœã®æµã
(1) ããŒã«ã«ïŒECRã«ãã°ã€ã³
(2) ããŒã«ã«ïŒã€ã¡ãŒãžãã¿ã°ä»ã â push
(3) ECSã³ã³ãœãŒã«ïŒã¿ã¹ã¯å®çŸ©ãäœæ
(4) ECSã³ã³ãœãŒã«ïŒãµãŒãã¹ãäœæïŒã¯ã©ã¹ã¿ãŒã«ãããã€ïŒ
(5) ãã©ãŠã¶ïŒEC2ãããªãã¯IP:8000 ã«ã¢ã¯ã»ã¹ç¢ºèª3. ECSæ§æã®ä¿¯ç°å³ïŒç¬¬3ç« æç¹ïŒ
ECRïŒã³ã³ããå庫ïŒâ ECSïŒãªãŒã±ã¹ãã¬ãŒã¿ãŒïŒâ EC2ïŒå®è¡ããŒãïŒâ ãã©ãŠã¶
ãšããæµãã俯ç°ããŠã¿ãŸãããã
âââââââââââââââââââââââ
â Developer (You) â
â ââââââââââââââââ â
â Docker build / pushâ
âââââââââââ¬ââââââââââââ
â
âŒ
âââââââââââââââââââââââââââââââââââ
â ECR (Elastic Container Registry)â
â âââââââââââââââââââââââââââââââ â
â fastapi-ecs-poc:v20251102-1 â
âââââââââââ¬ââââââââââââââââââââââââ
â (Pull)
âŒ
âââââââââââââââââââââââââââââââââââ
â ECS Cluster: poc-ecs-cluster â
â âââââââââââââââââââââââââââââââ â
â âââââââââââââââââââââââââââââ â
â â Service: fastapi-service â â
â â TaskDef: fastapi-task â â
â â âââââââââââââââââââââââ â â
â â Container: FastAPI(8000) â â
â âââââââââââââââââââââââââââââ â
âââââââââââ¬ââââââââââââââââââââââââ
â (Managed by AutoScalingGroup)
âŒ
âââââââââââââââââââââââââââââââââââ
â EC2 Instance (ECS Optimized) â
â âââââââââââââââââââââââââââââââ â
â Amazon Linux 2 + ECS Agent â
â Public IP: xx.xx.xx.xx â
âââââââââââ¬ââââââââââââââââââââââââ
â
âŒ
ââââââââââââââââââââââââââ
â Browser / Client â
â âââââââââââââââ â
â Access via: â
â http://<EC2_IP>:8000/ â
ââââââââââââââââââââââââââð¡ ã€ã¡ãŒãžã§èŠãããšæ¥œã«ãªãïŒ
ECRïŒå庫ãECSïŒåžä»€å¡ãEC2ïŒå µå£«ã
ã¿ã¹ã¯å®çŸ©ãâäœæŠæžâããµãŒãã¹ãâåžžæç£èŠæ åœâã
èµ·ååœä»€ãåºããšãASGãEC2ãç«ã¡äžããECSãšãŒãžã§ã³ããæ¥ç¶ããŸãã
ECS å šäœåã®ãè»éã¢ãã«ãã€ã¡ãŒãž(ãåèïŒ
ââââââââââââââââââââââââââââââââ
â ECRïŒååº«ïŒ â
â ââ ã³ã³ããã€ã¡ãŒãžä¿ç®¡åº« â
ââââââââââââââââââââââââââââââââ
â pull
âŒ
ââââââââââââââââââââââââââââââââ
â ECSïŒåžä»€å¡ïŒ â
â â ã¿ã¹ã¯å®çŸ©ïŒäœæŠæžïŒ â
â â ãµãŒãã¹ïŒåžžæç£èŠïŒ â
â â ã¹ã±ãžã¥ãŒã©ïŒé
眮æä»€å®ïŒ â
ââââââââââââââââââââââââââââââââ
â â
ïŒåœä»€åºãïŒâ âïŒåœä»€åºãïŒ
⌠âŒ
ââââââââââââââââââââ ââââââââââââââââââââ
â EC2 èµ·åã¿ã€ã â or â Fargate èµ·åã¿ã€ã â
â ãå
µå£«ã®å®¿èã â â ãã¬ã³ã¿ã«å
µå£«ã â
â EC2 + ECS Agent â â AWSãè£ã§å®¿èçšæ â
ââââââââââââââââââââ ââââââââââââââââââââ
â å®è¡å Žæ
âŒ
ã³ã³ããïŒéšéïŒèµ·åïŒ4. ECR ã«ãã°ã€ã³
ECRã«pushããã«ã¯AWS CLIã§èªèšŒããŸãã
ïŒAWS CLIã®èšå®æžã¿ãåæãšããŸãïŒ
aws ecr get-login-password --region ap-northeast-1 \
| docker login --username AWS --password-stdin <AWS_ACCOUNT_ID>.dkr.ecr.ap-northeast-1.amazonaws.comæåãããšïŒ
Login Succeeded5. ã€ã¡ãŒãžãã¿ã°ä»ã & Push
第1ç« ã§äœæããDockerã€ã¡ãŒãžããECRã«åãããŠã¿ã°ä»ãããPushããŸãã
# 0) 倿°ïŒå¿
ãèªåã®å€ã«ïŒ
ACCOUNT_ID=<12æ¡ã®AWSã¢ã«ãŠã³ãID> # äŸ: 123456789012
REGION=ap-northeast-1
REPO=fastapi-ecs-poc
TAG=v20251102-1
# 1) ECRã«ãã°ã€ã³ïŒãªãŒãžã§ã³ãå¿
ãåãããïŒ
aws ecr get-login-password --region $REGION \
| docker login --username AWS --password-stdin ${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com
# 2) ãªããžããªã®ååšç¢ºèªïŒç¡ããã°äœæïŒ
aws ecr describe-repositories --region $REGION --repository-names $REPO \
|| aws ecr create-repository --region $REGION --repository-name $REPO
# 3) æ£ããURIã§ã¿ã°ä»ãïŒURI㯠"account.dkr.ecr.region.amazonaws.com/repo:tag"ïŒ
docker tag fastapi-ecs-poc:latest ${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com/${REPO}:${TAG}
# 4) Push
docker push ${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com/${REPO}:${TAG}6. ã¿ã¹ã¯å®çŸ©ãäœæãã
ECSã§ã³ã³ãããã©ãåããããå®çŸ©ããŸããïŒã³ã³ãœãŒã«æé ïŒèŠç¹ïŒïŒ
ECSã³ã³ãœãŒã« â ã¿ã¹ã¯å®çŸ© â æ°ããã¿ã¹ã¯å®çŸ©ãäœæ
以äžã®ããã«èšå®ããŸãã
ã¿ã¹ã¯å®çŸ©ã®èšå®
ã¿ã¹ã¯å®çŸ©ãã¡ããªãŒ ïŒ`fastapi-poc-task`
ã€ã³ãã©ã¹ãã©ã¯ãã£ã®èŠä»¶
èµ·åã¿ã€ãïŒ`Amazon EC2 ã€ã³ã¹ã¿ã³ã¹`ã®ã¿ãã§ãã¯ïŒä»ã¯å€ãïŒ
OSãã¢ãŒããã¯ãã£ããããã¯ãŒã¯ã¢ãŒã
ãªãã¬ãŒãã£ã³ã°ã·ã¹ãã /ã¢ãŒããã¯ãã£ïŒLinux/X86_64
ãããã¯ãŒã¯ã¢ãŒãïŒbridge(äžæŠãã·ã³ãã«ã«)
ã¿ã¹ã¯ãµã€ãºïŒCPU .25 vCPU / ã¡ã¢ãªãŒ .3 GB
ã¿ã¹ã¯ããŒã«ïŒ`ecsTaskExecutionRole`
ã¿ã¹ã¯å®è¡ããŒã«ïŒ`ecsTaskExecutionRole`
ã³ã³ãããŒÂ
ã³ã³ããã®è©³çް
ååïŒ`fastapi-poc-container`
ã€ã¡ãŒãžURI `<AWS_ACCOUNT_ID>.dkr.ecr.ap-northeast-1.amazonaws.com/fastapi-ecs-poc:v20251102-1`
ããŒããããã³ã°ïŒ8000 â 8000
ã¡ã¢ãªå¶éïŒ.28(ããŒã)ã.25(ãœãã) â»CPUå¶éæªæå®
ã¿ã°
ãããžã§ã¯ãã®ã¿ã°ã远å ïŒ`ecs-poc-fastapi-task`
7. ãµãŒãã¹ãäœæããŠãããã€
ECSã¯ã©ã¹ã¿ãŒ â ãµãŒãã¹ â äœæ
以äžã®ããã«èšå®ããŸãã
ãµãŒãã¹ã®è©³çް
ã¿ã¹ã¯å®çŸ©ãã¡ããªãŒïŒ`fastapi-poc-task`
ã¿ã¹ã¯å®çŸ©ã®ãªããžã§ã³ïŒææ°ïŒææ°ã®çªå·ãéžæïŒ
ãµãŒãã¹åïŒ`fastapi-poc-task-service-12345`(ä»»æã®åå)
ç°å¢
ã³ã³ãã¥ãŒãã£ã³ã°èšå® (- ã¢ããã³ã¹ã)
ã³ã³ãã¥ãŒãã£ã³ã°ãªãã·ã§ã³ïŒèµ·åã¿ã€ã
èµ·åã¿ã€ãïŒEC2
ã¿ã°
ãããžã§ã¯ãã®ã¿ã°ã远å ïŒ`ecs-poc-service`
ä»ã®èšå®ïŒãã®ãŸãŸ
â æ°ååŸãECSãAuto Scaling Groupçµç±ã§EC2ãèµ·åããã¿ã¹ã¯ãé 眮ããŸãã
8. åäœç¢ºèª
ECSã³ã³ãœãŒã«ã§
ãµãŒãã¹ â ã¢ã¯ãã£ãïŒ1
ã¿ã¹ã¯ â å®è¡äžïŒ1

ã¿ã¹ã¯ã®ç»é¢ãã確èª
ã¯ã©ã¹ã¿ãŒ â ã¿ã¹ã¯ â 察象ã®ã¿ã¹ã¯ â ãããã¯ãŒã¯ãã€ã³ã ãéžæ
ããªãŒãã³ã¢ãã¬ã¹ãã®ãªã³ã¯ãã¯ãªãã¯
http://<EC2_IP>:8000/â 衚瀺äŸïŒ
{
"message": "Hello ECS PoC (FastAPI) ð³",
"arch_hint": "x86_64"
}
9. ãããããã©ãã«ãšå¯Ÿç

10. ãã®ç« ã®ãŽãŒã«ãã§ãã¯
ECRã«ã€ã¡ãŒãžãpushã§ãã
ã¿ã¹ã¯å®çŸ©ãäœæã§ãã (`fastapi-task`)
ãµãŒãã¹ (`fastapi-service`) ãRunning
EC2ã€ã³ã¹ã¿ã³ã¹ãèªåèµ·åãã
FastAPIã«ãã©ãŠã¶ããã¢ã¯ã»ã¹æå
次åã®ïŒç« ã§ã¯ã
1å°ã®EC2äžã§è€æ°ã¿ã¹ã¯ã䞊è¡çšŒåãæ§æããŸãã
â»äºå®ã¯ã倿Žããå ŽåãããããŸããããäºæ¿ãã ããã
ã§ã¯
ãŸããæ¬¡åã«ïŒ