Rute gerbang

Untuk membuat rute gateway menggunakan AWS Management Console

1. Buka konsol App Mesh di https://console.aws.amazon.com/appmesh/.

2. Pilih mesh di mana Anda ingin membuat rute gateway. Semua jerat yang Anda miliki dan yang telah dibagikan dengan Anda terdaftar.

3. Pilih gateway Virtual di navigasi kiri.

4. Pilih gateway virtual yang ingin Anda kaitkan dengan rute gateway baru. Jika tidak ada yang terdaftar, maka Anda perlu membuat gateway virtual terlebih dahulu. Anda hanya dapat membuat rute gateway untuk gateway virtual yang akun Anda terdaftar sebagai pemilik Sumber Daya.

5. Dalam tabel rute Gateway, pilih Buat rute gateway.

6. Untuk nama rute Gateway, tentukan nama yang akan digunakan untuk rute gateway Anda.

7. Untuk jenis rute Gateway pilih http, http2, atau grpc.

8. Pilih nama layanan Virtual yang ada. Jika tidak ada yang terdaftar, maka Anda perlu membuat layanan virtual terlebih dahulu.

9. Pilih port yang sesuai dengan target untuk port penyedia layanan Virtual. Port penyedia layanan virtual diperlukan ketika penyedia (router atau node) dari layanan virtual yang dipilih memiliki banyak pendengar.

10. (Opsional) Untuk Prioritas, tentukan prioritas untuk rute gateway ini.

11. Untuk konfigurasi Match, tentukan:

    • Jika http/http2 adalah jenis yang dipilih:

      • (Opsional) Metode - Menentukan header metode yang akan dicocokkan dalam permintaan http/ http2 masuk.

      • (Opsional) Pencocokan port - Cocokkan port untuk lalu lintas masuk. Pencocokan port diperlukan jika gateway virtual ini memiliki banyak pendengar.

      • (Opsional) Nama host Exact/Suffix - Menentukan nama host yang harus dicocokkan pada permintaan masuk untuk rute ke layanan virtual target.

      • (Opsional) Prefix/Exact/Regexjalur - Metode pencocokan jalur URL.

        • Pencocokan awalan - Permintaan yang cocok oleh rute gateway ditulis ulang ke nama layanan virtual target dan awalan yang cocok ditulis ulang, secara default. / Bergantung pada bagaimana Anda mengkonfigurasi layanan virtual Anda, itu bisa menggunakan router virtual untuk merutekan permintaan ke node virtual yang berbeda, berdasarkan awalan atau header tertentu.

          penting

          • Anda tidak dapat menentukan salah satu /aws-appmesh* atau /aws-app-mesh* untuk kecocokan Awalan. Awalan ini dicadangkan untuk penggunaan internal App Mesh di masa mendatang.

          • Jika beberapa rute gateway ditentukan, maka permintaan dicocokkan dengan rute dengan awalan terpanjang. Misalnya, jika ada dua rute gateway, dengan satu memiliki awalan /chapter dan satu memiliki awalan/, maka permintaan untuk www.example.com/chapter/ akan dicocokkan dengan rute gateway dengan awalan. /chapter

          catatan

          Jika Anda mengaktifkan pencocokan berbasis Path/ Prefix, App Mesh mengaktifkan normalisasi jalur (normalize_path dan merge_slashes) untuk meminimalkan kemungkinan kerentanan kebingungan jalur.

          Kerentanan kebingungan jalur terjadi ketika pihak yang berpartisipasi dalam permintaan menggunakan representasi jalur yang berbeda.

        • Pencocokan tepat - Parameter yang tepat menonaktifkan pencocokan sebagian untuk rute dan memastikan bahwa itu hanya mengembalikan rute jika jalurnya sama dengan URL saat ini.

        • Pencocokan Regex - Digunakan untuk menggambarkan pola di mana beberapa URLs mungkin benar-benar mengidentifikasi satu halaman di situs web.

      • (Opsional) Parameter kueri - Bidang ini memungkinkan Anda untuk mencocokkan pada parameter kueri.

      • (Opsional) Header - Menentukan header untuk http dan http2. Itu harus sesuai dengan permintaan yang masuk untuk merutekan ke layanan virtual target..

    • Jika grpc adalah tipe yang dipilih:

      • Jenis pencocokan nama host dan (opsional) Pencocokan Exact/Suffix - Menentukan nama host yang harus dicocokkan pada permintaan masuk untuk merutekan ke layanan virtual target.

      • nama layanan grpc - Layanan grpc bertindak sebagai API untuk aplikasi Anda dan didefinisikan dengan. ProtoBuf

        penting

        Anda tidak dapat menentukan /aws.app-mesh* atau aws.appmesh untuk nama Layanan. Nama layanan ini dicadangkan untuk penggunaan internal App Mesh di masa mendatang.

      • (Opsional) Metadata - Menentukan metadata untuk grpc. Ini harus sesuai dengan permintaan yang masuk untuk merutekan ke layanan virtual target.

12. (Opsional) Untuk konfigurasi Tulis Ulang:

    • Jika http/http2 adalah jenis yang dipilih:

      • Jika Awalan adalah jenis kecocokan yang dipilih:

        • Ganti penulisan ulang otomatis nama host - Secara default nama host ditulis ulang ke nama layanan virtual target.

        • Ganti penulisan ulang otomatis awalan - Saat diaktifkan, Prefix rewrite menentukan nilai awalan yang ditulis ulang.

      • Jika Exact Path adalah jenis kecocokan yang dipilih:

        • Ganti penulisan ulang otomatis nama host - secara default nama host ditulis ulang ke nama layanan virtual target.

        • Path rewrite - Menentukan nilai jalur ditulis ulang. Tidak ada jalur default.

      • Jika Regex Path adalah jenis kecocokan yang dipilih:

        • Ganti penulisan ulang otomatis nama host - secara default nama host ditulis ulang ke nama layanan virtual target.

        • Path rewrite - Menentukan nilai jalur ditulis ulang. Tidak ada jalur default.

    • Jika grpc adalah tipe yang dipilih:

      • Ganti penulisan ulang otomatis nama host - Secara default nama host ditulis ulang ke nama layanan virtual target.

13. Pilih Buat rute gateway untuk menyelesaikan.

1. aws appmesh create-virtual-gateway \ 
   --mesh-name meshName \ 
   --virtual-gateway-name virtualGatewayName \
   --gateway-route-name gatewayRouteName \ 
   --cli-input-json file://create-gateway-route.json

2. Isi contoh create-gateway-route .json:

   {
       "spec": {
           "httpRoute" : {
               "match" : {
                   "prefix" : "/"
               },
               "action" : {
                   "target" : {
                       "virtualService": {
                           "virtualServiceName": "serviceA.svc.cluster.local"
                       }
                   }
               }
           }
       }
   }

3. Contoh output:

   {
       "gatewayRoute": {
           "gatewayRouteName": "gatewayRouteName",
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualGateway/virtualGatewayName/gatewayRoute/gatewayRouteName",
               "createdAt": "2022-04-06T11:05:32.100000-05:00",
               "lastUpdatedAt": "2022-04-06T11:05:32.100000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 1
           },
           "spec": {
               "httpRoute": {
                   "action": {
                       "target": {
                           "virtualService": {
                               "virtualServiceName": "serviceA.svc.cluster.local"
                           }
                       }
                   },
                   "match": {
                       "prefix": "/"
                   }
               }
           },
           "status": {
               "status": "ACTIVE"
           },
           "virtualGatewayName": "gatewayName"
       }
   }
   

Untuk menghapus rute gateway menggunakan AWS Management Console

1. Buka konsol App Mesh di https://console.aws.amazon.com/appmesh/.

2. Pilih mesh dari mana Anda ingin menghapus rute gateway. Semua jerat yang Anda miliki dan yang telah dibagikan dengan Anda terdaftar.

3. Pilih gateway Virtual di navigasi kiri.

4. Pilih gateway virtual dari mana Anda ingin menghapus rute gateway.

5. Dalam tabel rute Gateway, pilih rute gateway yang ingin Anda hapus dan pilih Hapus. Anda hanya dapat menghapus rute gateway jika akun Anda terdaftar sebagai pemilik Sumber Daya.

6. Di kotak konfirmasi, ketik delete dan kemudian klik Hapus.

Untuk menghapus rute gateway menggunakan AWS CLI

1. Gunakan perintah berikut untuk menghapus rute gateway Anda (ganti red nilainya dengan milik Anda sendiri):

   aws appmesh delete-gateway-route \
        --mesh-name meshName \
        --virtual-gateway-name virtualGatewayName \
        --gateway-route-name gatewayRouteName

2. Contoh output:

   {
       "gatewayRoute": {
           "gatewayRouteName": "gatewayRouteName",
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualGateway/virtualGatewayName/gatewayRoute/gatewayRouteName",
               "createdAt": "2022-04-06T11:05:32.100000-05:00",
               "lastUpdatedAt": "2022-04-07T10:36:33.191000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 2
           },
           "spec": {
               "httpRoute": {
                   "action": {
                       "target": {
                           "virtualService": {
                               "virtualServiceName": "serviceA.svc.cluster.local"
                           }
                       }
                   },
                   "match": {
                       "prefix": "/"
                   }
               }
           },
           "status": {
               "status": "DELETED"
           },
           "virtualGatewayName": "virtualGatewayName"
       }
   }