AWS App Runner tidak akan lagi terbuka untuk pelanggan baru mulai 30 April 2026. Jika Anda ingin menggunakan App Runner, daftar sebelum tanggal tersebut. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat perubahan AWS App Runner ketersediaan.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS App Runner perubahan ketersediaan

Setelah mempertimbangkan dengan cermat, kami memutuskan AWS App Runner untuk menutup pelanggan baru mulai 30 April 2026. AWS App Runner Pelanggan yang sudah ada dapat terus menggunakan layanan seperti biasa, termasuk menciptakan sumber daya dan layanan baru. AWS terus berinvestasi dalam keamanan dan ketersediaan untuk AWS App Runner, tetapi kami tidak berencana untuk memperkenalkan fitur baru.

Kami menyarankan agar pelanggan menjelajahi Mode Ekspres Amazon Elastic Container Service (Amazon ECS) Container Service (Amazon ECS) saat bermigrasi dari. AWS App Runner Mode Amazon ECS Express mempertahankan kesederhanaan pengoperasian App Runner sambil menyediakan akses ke rangkaian fitur Amazon ECS yang lebih luas. Dengan satu panggilan API, Anda menyediakan gambar kontainer dan dua peran IAM, dan Amazon ECS menyediakan tumpukan aplikasi lengkap di AWS akun Anda, termasuk layanan ECS di Fargate, Application Load Balancer, penskalaan otomatis, dan jaringan. Tidak ada biaya tambahan untuk menggunakan Amazon ECS Express Mode. Anda hanya membayar untuk AWS sumber daya dasar yang dibuat untuk menjalankan aplikasi Anda.

Panduan ini menjelaskan cara memigrasikan layanan App Runner yang ada ke ECS Express Mode dan secara bertahap mengalihkan lalu lintas menggunakan perutean DNS.

Ikhtisar migrasi

Panduan ini menggunakan pendekatan blue/green penerapan dengan perutean berbobot DNS untuk memigrasikan lalu lintas dari App Runner ke Mode ECS Express. Kedua layanan berjalan secara bersamaan selama migrasi. Anda menggunakan Amazon Route 53 (atau penyedia DNS Anda) untuk secara bertahap mengalihkan lalu lintas dari layanan App Runner ke layanan ECS Express Mode, dimulai dengan persentase kecil dan meningkat seiring waktu. Pendekatan ini meminimalkan waktu henti dan memungkinkan Anda memutar kembali dengan menyesuaikan bobot DNS jika masalah muncul.

Migrasi tipikal mencakup langkah-langkah berikut:

Prasyarat

Sebelum Anda mulai, pastikan Anda memiliki yang berikut:

Jika Anda ingin mempertahankan domain kustom yang ada selama migrasi, Anda juga perlu:

Sebelum Anda mulai

Panduan migrasi

Diagram berikut menunjukkan cara kerja migrasi menggunakan Route 53 untuk menggeser catatan DNS antara layanan App Runner dan layanan ECS Express Mode Anda.

Langkah 1: Tinjau konfigurasi App Runner yang ada

Di konsol App Runner, tinjau layanan yang ada dan catat nilai yang ingin Anda teruskan. Minimal, perhatikan hal berikut:

Anda juga dapat meninjau pengaturan runtime lain yang ingin Anda teruskan ke layanan baru.

Untuk detail domain kustom, lihatMengelola nama domain khusus untuk layanan App Runner.

Langkah 2: Buat layanan ECS Express Mode

Buat layanan ECS Express Mode menggunakan gambar kontainer yang sama yang digunakan oleh layanan App Runner Anda. Anda dapat membuat layanan menggunakan salah satu Konsol Manajemen AWSatau AWS CLI.

Contoh perintah CLI:

aws ecs create-express-gateway-service \
    --execution-role-arn arn:aws:iam::123456789012:role/ecsTaskExecutionRole \
    --infrastructure-role-arn arn:aws:iam::123456789012:role/ecsInfrastructureRoleForExpressServices \
    --primary-container '{
        "image": "123456789012.dkr.ecr.us-east-1.amazonaws.com/my-app:latest",
        "containerPort": 8080,
        "environment": [{
            "name": "ENV_VAR_NAME",
            "value": "value"
        }]
    }' \
    --service-name "my-application" \
    --health-check-path "/" \
    --scaling-target '{"minTaskCount":1,"maxTaskCount":4}' \
    --monitor-resources

Ganti gambar, port, variabel lingkungan, dan nilai penskalaan dengan nilai dari layanan App Runner Anda.

Perintah ini menyediakan tumpukan aplikasi lengkap di AWS akun Anda, termasuk layanan ECS di Fargate, Application Load Balancer dengan grup target dan pemeriksaan kesehatan, kebijakan auto-scaling, grup keamanan dan konfigurasi jaringan, dan URL default.

Penyediaan biasanya memakan waktu 3-5 menit. Anda dapat melacak kemajuan di konsol Amazon ECS di bawah tab Sumber Daya.

Setelah selesai, uji layanan ECS Express Mode Anda menggunakan URL default yang ditampilkan di konsol. Verifikasi bahwa aplikasi Anda berfungsi dengan benar sebelum melanjutkan dengan pergeseran lalu lintas.

Langkah 3: Konfigurasikan domain khusus untuk ECS Express Mode

Jika layanan App Runner Anda menggunakan domain kustom, konfigurasikan domain kustom yang sama untuk layanan Mode Ekspres ECS sebelum mengalihkan lalu lintas. Langkah ini mengonfigurasi Application Load Balancer yang dibuat untuk layanan ECS Express Mode sehingga menerima lalu lintas untuk domain Anda dan menggunakan sertifikat ACM untuk HTTPS.

Untuk petunjuk mendetail, lihat Menambahkan domain khusus ke layanan Anda di Panduan Pengembang Amazon ECS.

Gambar berikut menunjukkan contoh konfigurasi kondisi header host dalam aturan pendengar Application Load Balancer.

Langkah 4: Pergeseran lalu lintas menggunakan perutean tertimbang Route 53

Jika layanan App Runner sudah menggunakan domain kustom, Anda dapat secara bertahap mengalihkan lalu lintas ke layanan Mode Ekspres ECS dengan menggunakan perutean tertimbang Route 53. Perutean tertimbang memungkinkan Anda merutekan lalu lintas untuk nama host yang sama ke beberapa titik akhir. Setiap titik akhir didefinisikan sebagai catatan DNS terpisah dengan bobotnya sendiri, dan Route 53 mendistribusikan permintaan sesuai dengan bobot tersebut.

Mengonversi rekaman App Runner yang ada menjadi catatan tertimbang:

Buat catatan tertimbang untuk ECS Express Mode:

Secara bertahap menggeser lalu lintas:

Setelah catatan DNS dikonfigurasi, mulailah memindahkan lalu lintas dengan meningkatkan bobot Mode Ekspres ECS sambil mengurangi bobot App Runner secara proporsional. Pendekatan yang direkomendasikan:

Pada setiap langkah, uji aplikasi sebelum menggeser lalu lintas tambahan. Jika masalah terjadi pada titik mana pun, putar kembali dengan menyesuaikan bobot kembali ke nilai sebelumnya.

Langkah 5: Selesaikan migrasi

Setelah memverifikasi bahwa layanan ECS Express Mode menangani lalu lintas produksi dengan benar dan periode validasi telah berlalu, selesaikan migrasi:

Hapus layanan App Runner:

aws apprunner delete-service --service-arn your-app-runner-service-arn

Juga pertimbangkan untuk menghapus sumber daya apa pun yang tidak lagi diperlukan:

Migrasi penerapan berbasis sumber

Jika layanan App Runner yang ada di-deploy dari kode sumber dan bukan image container, Anda perlu menambahkan langkah kontainerisasi sebelum menerapkan ke ECS Express Mode. Tidak seperti App Runner, ECS Express Mode membutuhkan gambar kontainer. Namun, Anda dapat mereplikasi pengalaman penerapan otomatis App Runner menggunakan CI/CD alat seperti GitHub Tindakan dengan Amazon ECS Deploy Express Service Action. GitHub

Alur kerja migrasi memiliki tiga tahap:

Diagram berikut menunjukkan cara kerja alur kerja ini menggunakan GitHub Tindakan:

Kontainerisasi aplikasi Anda

Jika aplikasi Anda belum memiliki Dockerfile, buat satu di root repositori Anda. Dockerfile berfungsi sebagai cetak biru untuk membangun dan mengemas kode sumber Anda ke dalam gambar kontainer.

Struktur repositori Anda harus mencakup:

your-app/
├── src/                    # Application source code
├── Dockerfile              # Container build instructions
├── package.json            # Dependencies and scripts
└── .github/                # GitHub configuration
    └── workflows/          # GitHub Actions workflows
        └── deploy.yml      # ECS Express Mode deployment workflow

Mengatur GitHub Tindakan untuk penerapan otomatis

Untuk mereplikasi penerapan otomatis App Runner pada push kode, konfigurasikan GitHub Tindakan dengan yang berikut:

Contoh Alur kerja GitHub Tindakan

Buat file alur kerja di.github/workflows/deploy.yml:

name: Build and Deploy to ECS

on:
  push:
    branches: [ main ]

env:
  AWS_REGION: ${{ vars.AWS_REGION }}
  AWS_ACCOUNT_ID: ${{ vars.AWS_ACCOUNT_ID }}
  ECR_REPOSITORY: ${{ vars.ECR_REPOSITORY }}
  ECS_SERVICE: ${{ vars.ECS_SERVICE }}
  ECS_CLUSTER: ${{ vars.ECS_CLUSTER }}

jobs:
  deploy:
    name: Deploy
    runs-on: ubuntu-latest
    environment: production
    permissions:
      id-token: write
      contents: read

    steps:
    - name: Checkout
      uses: actions/checkout@v6

    - name: Configure AWS credentials
      uses: aws-actions/configure-aws-credentials@v5
      with:
        aws-region: ${{ env.AWS_REGION }}
        role-to-assume: arn:aws:iam::${{ env.AWS_ACCOUNT_ID }}:role/github-actions-ecs-role
        role-session-name: GitHubActionsECSDeployment

    - name: Login to Amazon ECR
      id: login-ecr
      uses: aws-actions/amazon-ecr-login@v2

    - name: Get short commit hash
      run: echo "IMAGE_TAG=${GITHUB_SHA:0:7}" >> $GITHUB_ENV

    - name: Build, tag, and push image to Amazon ECR
      id: build-image
      env:
        ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }}
      uses: docker/build-push-action@v6
      with:
        context: .
        push: true
        tags: ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}:latest,${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}:${{ env.IMAGE_TAG }}

    - name: Deploy to ECS Express Mode
      uses: aws-actions/amazon-ecs-deploy-express-service@v1
      env:
        ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }}
      with:
        service-name: ${{ env.ECS_SERVICE }}
        image: ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}:${{ env.IMAGE_TAG }}
        execution-role-arn: arn:aws:iam::${{ env.AWS_ACCOUNT_ID }}:role/ecsTaskExecutionRole
        infrastructure-role-arn: arn:aws:iam::${{ env.AWS_ACCOUNT_ID }}:role/ecsInfrastructureRoleForExpressServices
        cluster: ${{ env.ECS_CLUSTER }}
        container-port: 8080
        environment-variables: |
          [
            {"name": "ENV", "value": "Prod"}
          ]
        cpu: '1024'
        memory: '2048'
        health-check-path: /health
        min-task-count: 1
        max-task-count: 4
        auto-scaling-metric: AVERAGE_CPU
        auto-scaling-target-value: 70

Saat Anda mendorong perubahan kode ke cabang utama Anda, GitHub Actions secara otomatis membuat image container baru, mendorongnya ke Amazon Elastic Container Registry, dan menerapkannya ke layanan ECS Express Mode Anda. Ini mereplikasi pengalaman penerapan otomatis yang Anda miliki dengan App Runner.

Setelah layanan ECS Express Mode berjalan, ikuti Langkah 3—5 dalam panduan migrasi untuk mengonfigurasi domain kustom, mengalihkan lalu lintas menggunakan perutean DNS, dan menyelesaikan migrasi.

Sumber daya tambahan