虛擬閘道

使用 建立虛擬閘道 AWS Management Console

1. 在 開啟 App Mesh 主控台https://console.aws.amazon.com/appmesh/。

2. 選擇您要在其中建立虛擬閘道的網格。會列出您擁有和與您共用的所有網格。

3. 在左側導覽中選擇虛擬閘道。

4. 選擇建立虛擬閘道 。

5. 針對虛擬閘道名稱 ，輸入虛擬閘道的名稱。

6. （選用，但建議使用） 設定用戶端政策預設值 。

   1. （選用） 如果您希望閘道僅使用 Transport Layer Security （） 與虛擬服務通訊，請選取強制執行TLSTLS。

   2. （選用） 針對連接埠 ，指定您要在其中強制執行與虛擬服務TLS通訊的一或多個連接埠。

   3. 針對驗證方法 ，選取下列其中一個選項。您指定的憑證必須已存在且符合特定要求。如需詳細資訊，請參閱憑證需求。

      • AWS Private Certificate Authority 託管 – 選取一或多個現有的憑證。

      • Envoy Secret Discovery Service （SDS） 託管 – 輸入 Envoy 使用 Secret Discovery Service 擷取的秘密名稱。

      • 本機檔案託管 – 在部署 Envoy 的檔案系統上指定憑證鏈檔案的路徑。

   4. （選用） 輸入主體別名 。若要新增其他 SANs，請選取新增 SAN。SANs 必須為 URI FQDN或 格式。

   5. （選用） 選取提供用戶端憑證和下列其中一個選項，以在伺服器請求用戶端憑證並啟用相互TLS身分驗證時提供用戶端憑證。若要進一步了解相互 TLS，請參閱應用程式網格相互TLS身分驗證文件。

      • Envoy Secret Discovery Service （SDS） 託管 – 輸入 Envoy 使用 Secret Discovery Service 擷取的秘密名稱。

      • 本機檔案託管 – 在部署 Envoy 的檔案系統上指定憑證鏈檔案的路徑，以及私有金鑰 。如需完整， end-to-end請參閱使用 檔案提供的TLS憑證TLS在 上設定 ，以使用本機檔案加密的範例應用程式部署網格 GitHub。

7. （選用） 若要設定記錄，請選取記錄 。輸入您希望 Envoy 使用的HTTP存取日誌路徑。我們建議/dev/stdout路徑，以便您可以使用 Docker 日誌驅動程式將 Envoy 日誌匯出至 Amazon CloudWatch Logs 等服務。

   注意

   日誌必須仍然由您的應用程式中的代理程式輸入，並傳送到目的地。這個檔案路徑只是指示 Envoy 將日誌傳送到何處。

   顯示較多顯示較少

8. 設定接聽程式 。

   1. 選取通訊協定，並指定 Envoy 接聽流量的連接埠。http 接聽程式允許連線至 Websocket。您可以按一下新增接聽程式來新增多個接聽程式。移除按鈕會移除該接聽程式。

   2. （選用） 啟用連線集區

      連線集區會限制 Virtual Gateway Envoy 可同時建立的連線數量。其目的是保護您的 Envoy 執行個體不會因為連線而不堪負荷，並可讓您調整流量形狀，以符合應用程式的需求。

      您可以設定虛擬閘道接聽程式的目的地連線集區設定。App Mesh 預設會將用戶端連線集區設定設定為無限，簡化網格組態。

      注意

      connectionPool 和 connectionPoolportMapping 通訊協定必須相同。如果您的接聽程式通訊協定為 grpc或 http2，maxRequests請僅指定 。如果您的接聽程式通訊協定為 http，您可以同時指定 maxConnections和 maxPendingRequests。

      • 針對最大連線數 ，指定傳出連線數的上限。

      • 針對請求上限 ，指定可以使用 Virtual Gateway Envoy 建立的平行請求數目上限。

      • （選用） 針對最大待處理請求 ，指定 Envoy 佇列的最大連線數之後的溢位請求數。預設值為 2147483647。

      顯示較多顯示較少

   3. （選用） 如果您要為接聽程式設定運作狀態檢查，請選取啟用運作狀態檢查 。

      運作狀態檢查政策是選用的，但如果您指定運作狀態政策的任何值，則必須指定運作狀態閾值 、運作狀態檢查間隔 、運作狀態檢查協定 、逾時期間 和運作狀態不佳閾值 的值。

      • 針對運作狀態檢查通訊協定 ，選擇通訊協定。如果您選擇 grpc ，則您的服務必須符合GRPC運作狀態檢查通訊協定 。

      • 對於 Health check port (運作狀態檢查連接埠)，指定應執行運作狀態檢查的連接埠。

      • 對於 Healthy threshold (運作良好閾值)，指定在宣告接聽程式運作良好之前，必須達到的運作狀態檢查連續成功次數。

      • 對於 Health check interval (運作狀態檢查間隔)，指定每次運作狀態檢查執行之間的時間間隔 (以毫秒為單位)。

      • 對於 Path (路徑)，指定運作狀態檢查請求的目的地路徑。只有在運作狀態檢查通訊協定為 http或 時，才會使用此值http2。其他通訊協定會忽略該值。

      • 對於逾時期間 ，請指定從運作狀態檢查收到回應時等待的時間，以毫秒為單位。

      • 對於 Unhealthy threshold (運作不良閾值)，指定在宣告接聽程式運作不良之前，必須達到的運作狀態檢查連續失敗次數。

      顯示較多顯示較少

   4. （選用） 如果您想要指定用戶端是否使用 與此虛擬閘道通訊TLS，請選取啟用TLS終止 。

      • 對於模式 ，選取TLS您想要在接聽程式上設定 的模式。

      • 針對憑證方法 ，選取下列其中一個選項。憑證必須符合特定要求。如需詳細資訊，請參閱憑證需求。

        • AWS Certificate Manager 託管 – 選取現有的憑證 。

        • Envoy Secret Discovery Service （SDS） 託管 – 輸入 Envoy 使用 Secret Discovery Service 擷取的秘密名稱。

        • 本機檔案託管 – 在部署 Envoy 的檔案系統上指定憑證鏈和私有金鑰檔案的路徑。

      • （選用） 選取需要用戶端憑證和下列其中一個選項，以便在用戶端提供憑證時啟用相互TLS身分驗證。若要進一步了解相互 TLS，請參閱應用程式網格相互TLS身分驗證文件。

        • Envoy Secret Discovery Service （SDS） 託管 – 輸入 Envoy 使用 Secret Discovery Service 擷取的秘密名稱。

        • 本機檔案託管 – 在部署 Envoy 的檔案系統上指定憑證鏈檔案的路徑。

      • （選用） 輸入主體別名 。若要新增其他 SANs，請選取新增 SAN。SANs 必須為 URI FQDN或 格式。

      顯示較多顯示較少

9. 選擇建立虛擬閘道以完成。

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

2. 範例 create-virtual-gateway.json 的內容：

   {
       "spec": {
         "listeners": [
           {
             "portMapping": {
               "port": 9080,
               "protocol": "http"
             }
           }
         ]
       }
   }

3. 輸出範例：

   {
       "virtualGateway": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/meshName/virtualGateway/virtualGatewayName",
               "createdAt": "2022-04-06T10:42:42.015000-05:00",
               "lastUpdatedAt": "2022-04-06T10:42:42.015000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "123456789012",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 1
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 9080,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "ACTIVE"
           },
           "virtualGatewayName": "virtualGatewayName"
       }
   }
   

使用 刪除虛擬閘道 AWS Management Console

1. 在 開啟 App Mesh 主控台https://console.aws.amazon.com/appmesh/。

2. 選擇您想要從中刪除虛擬閘道的網格。會列出您擁有和已與您共用的所有網格。

3. 在左側導覽中選擇虛擬閘道。

4. 選擇您要刪除的虛擬閘道，然後選擇刪除 。如果虛擬閘道具有任何相關聯的閘道路由，則無法刪除它。您必須先刪除任何相關聯的閘道路由。您只能刪除將帳戶列為資源擁有者 的虛擬閘道。

5. 在確認方塊中，輸入 delete，然後選擇刪除 。

使用 刪除虛擬閘道 AWS CLI

1. 使用下列命令刪除您的虛擬閘道 （取代 red 您自己的值）：

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

2. 輸出範例：

   {
       "virtualGateway": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/meshName/virtualGateway/virtualGatewayName",
               "createdAt": "2022-04-06T10:42:42.015000-05:00",
               "lastUpdatedAt": "2022-04-07T10:57:22.638000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "123456789012",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 2
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 9080,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "DELETED"
           },
           "virtualGatewayName": "virtualGatewayName"
       }
   }