メむンコンテンツぞスキップ
芋出し画像

【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 Succeeded

    5. むメヌゞをタグ付け & 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でコンテナをどう動かすかを定矩したす。コン゜ヌル手順芁点

    1. ECSコン゜ヌル → タスク定矩 → 新しいタスク定矩を䜜成

    2. 以䞋のように蚭定したす。

    タスク定矩の蚭定

    • タスク定矩ファミリヌ `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. サヌビスを䜜成しおデプロむ

    1. ECSクラスタヌ → サヌビス → 䜜成

    2. 以䞋のように蚭定したす。

    サヌビスの詳现

    • タスク定矩ファミリヌ`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䞊で耇数タスクを䞊行皌働を構成したす。
    ※予定は、倉曎する堎合がございたすが、ご了承ください。

    では
    たた、次回に


    過去の蚘事



     
     
    むンフラ゚ンゞニアずしお実務メモを、 写真䜜家ずしお写真物語を、 童話䜜家ずしお物語を曞いおいたす。 写真䜜品は、ポヌトフォリオサむトずしおたずめおいく予定です。

    あなたぞのおすすめ