Rute

Untuk membuat rute menggunakan AWS Management Console

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

2. Pilih mesh yang ingin Anda buat rute. Semua jerat yang Anda miliki dan yang telah dibagikan dengan Anda terdaftar.

3. Pilih Router virtual di navigasi kiri.

4. Pilih router virtual yang ingin Anda kaitkan dengan rute baru. Jika tidak ada yang terdaftar, maka Anda perlu membuat router virtual terlebih dahulu.

5. Dalam tabel Rute, pilih Buat rute. Untuk membuat rute, ID akun Anda harus terdaftar sebagai pemilik sumber daya rute.

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

7. Untuk jenis Rute, pilih protokol yang ingin Anda rutekan. Protokol yang Anda pilih harus sesuai dengan protokol listener yang Anda pilih untuk router virtual Anda dan node virtual yang Anda rutekan lalu lintas.

8. (Opsional) Untuk prioritas Rute, tentukan prioritas dari 0-1000 yang akan digunakan untuk rute Anda. Rute dicocokkan berdasarkan nilai yang ditentukan, di mana 0 adalah prioritas tertinggi.

9. (Opsional) Pilih Konfigurasi tambahan. Dari protokol di bawah, pilih protokol yang Anda pilih untuk Jenis rute dan tentukan pengaturan di konsol sesuai keinginan.

10. Untuk konfigurasi Target, pilih node virtual App Mesh yang ada untuk merutekan lalu lintas ke dan menentukan Berat. Anda dapat memilih Tambahkan target untuk menambahkan target tambahan. Persentase untuk semua target harus bertambah hingga 100. Jika tidak ada node virtual yang terdaftar, maka Anda harus membuatnya terlebih dahulu. Jika node virtual yang dipilih memiliki beberapa pendengar, port Target diperlukan.

11. Untuk konfigurasi Match, tentukan:

    Konfigurasi kecocokan tidak tersedia untuk tcp

    • 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 router virtual ini memiliki banyak pendengar.

      • (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.

          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 persis - param 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:

      • Nama layanan - layanan tujuan yang sesuai dengan permintaan.

      • Nama metode - metode tujuan untuk mencocokkan permintaan.

      • (Opsional) Metadata - menentukan Match berdasarkan keberadaan metadata. Semua harus sesuai untuk permintaan yang akan diproses.

12. Pilih Buat rute.

1. aws appmesh create-route \
        --cli-input-json file://create-route-grpc.json

2. Isi contoh create-route-grpc .json

   {
       "meshName" : "meshName",
       "routeName" : "routeName",
       "spec" : {
          "grpcRoute" : {
             "action" : {
                "weightedTargets" : [
                   {
                      "virtualNode" : "nodeName",
                      "weight" : 100
                   }
                ]
             },
             "match" : {
                "metadata" : [
                   {
                      "invert" : false,
                      "match" : {
                         "prefix" : "123"
                      },
                      "name" : "myMetadata"
                   }
                ],
                "methodName" : "nameOfmethod",
                "serviceName" : "serviceA.svc.cluster.local"
             },
             "retryPolicy" : {
                "grpcRetryEvents" : [ "deadline-exceeded" ],
                "httpRetryEvents" : [ "server-error", "gateway-error" ],
                "maxRetries" : 3,
                "perRetryTimeout" : {
                   "unit" : "s",
                   "value" : 15
                },
                "tcpRetryEvents" : [ "connection-error" ]
             }
          },
          "priority" : 100
       },
       "virtualRouterName" : "routerName"
   }

3. Contoh output:

   {
       "route": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualRouter/routerName/route/routeName",
               "createdAt": "2022-04-06T13:48:20.749000-05:00",
               "lastUpdatedAt": "2022-04-06T13:48:20.749000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 1
           },
           "routeName": "routeName",
           "spec": {
               "grpcRoute": {
                   "action": {
                       "weightedTargets": [
                           {
                               "virtualNode": "nodeName",
                               "weight": 100
                           }
                       ]
                   },
                   "match": {
                       "metadata": [
                           {
                               "invert": false,
                               "match": {
                                   "prefix": "123"
                               },
                               "name": "myMetadata"
                           }
                       ],
                       "methodName": "nameOfMehod",
                       "serviceName": "serviceA.svc.cluster.local"
                   },
                   "retryPolicy": {
   "grpcRetryEvents": [
                           "deadline-exceeded"
                       ],
                       "httpRetryEvents": [
                           "server-error",
                           "gateway-error"
                       ],
                       "maxRetries": 3,
                       "perRetryTimeout": {
                           "unit": "s",
                           "value": 15
                       },
                       "tcpRetryEvents": [
                           "connection-error"
                       ]
                   }
               },
               "priority": 100
           },
           "status": {
               "status": "ACTIVE"
           },
           "virtualRouterName": "routerName"
       }
   }

Untuk menghapus rute 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. Semua jerat yang Anda miliki dan yang telah dibagikan dengan Anda terdaftar.

3. Pilih Router virtual di navigasi kiri.

4. Pilih router dari mana Anda ingin menghapus rute.

5. Dalam tabel Rute, pilih rute yang ingin Anda hapus dan pilih Hapus di sudut kanan atas.

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

Untuk menghapus rute menggunakan AWS CLI

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

   aws appmesh delete-route \
        --mesh-name meshName \
        --virtual-router-name routerName \
        --route-name routeName

2. Contoh output:

   {
       "route": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualRouter/routerName/route/routeName",
               "createdAt": "2022-04-06T13:46:54.750000-05:00",
               "lastUpdatedAt": "2022-04-07T10:43:57.152000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 2
           },
           "routeName": "routeName",
           "spec": {
               "grpcRoute": {
                   "action": {
                       "weightedTargets": [
                           {
                               "virtualNode": "nodeName",
                               "weight": 100
                           }
                       ]
                   },
                   "match": {
                       "metadata": [
                           {
                               "invert": false,
                               "match": {
                                   "prefix": "123"
                               },
                               "name": "myMetadata"
                           }
                       ],
                       "methodName": "methodName",
                       "serviceName": "serviceA.svc.cluster.local"
                   },
                   "retryPolicy": {
                       "grpcRetryEvents": [
                           "deadline-exceeded"
                       ],
                       "httpRetryEvents": [
                           "server-error",
                           "gateway-error"
                       ],
                       "maxRetries": 3,
                       "perRetryTimeout": {
                           "unit": "s",
                           "value": 15
                       },
                       "tcpRetryEvents": [
                           "connection-error"
                       ]
                   }
               },
               "priority": 100
           },
           "status": {
               "status": "DELETED"
           },
           "virtualRouterName": "routerName"
       }
   }