View a markdown version of this page

解決 OpenSearch UI 中的 VPC 連線問題 - Amazon OpenSearch Service

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

解決 OpenSearch UI 中的 VPC 連線問題

當 OpenSearch UI 應用程式無法到達 VPC 中的網域時,原因通常是缺少 VPC 端點授權、封鎖連接埠 443 的安全群組,或在 VPC 上關閉的 DNS 屬性。下表列出 VPC 連線問題的症狀和可能原因,讓您可以識別從何處開始。

徵狀 可能原因
資料來源報告無法使用 未授權 VPC 端點存取
資料來源報告其運作狀態不佳 安全群組封鎖流量
應用程式無法連線到網域 VPC 上未啟用 DNS 解析
連線間歇性運作 網域正在處理變更,或端點正在重新佈建

授權 VPC 端點存取

最常見的 VPC 問題是 OpenSearch UI 服務未獲授權存取 VPC 端點。檢查授權是否存在:

aws opensearch list-vpc-endpoint-access \ --domain-name {{domain-name}} \ --region {{region}}

如果回應不包含 application.opensearchservice.amazonaws.com,請授權它:

aws opensearch authorize-vpc-endpoint-access \ --domain-name {{domain-name}} \ --service application.opensearchservice.amazonaws.com \ --region {{region}}

等待 5 到 10 分鐘讓授權傳播,然後檢查應用程式中的資料來源運作狀態。

無伺服器集合使用網路政策,而非端點授權。政策必須列出 中的 OpenSearch UI 服務SourceServices。若要檢閱存在的政策,請執行 aws opensearchserverless list-security-policies --type network。

允許透過安全群組的流量

即使端點存取獲得授權,網域的安全群組也必須允許 TCP 連接埠 443 上的傳入流量。下列命令會尋找安全群組並檢閱其傳入規則。將預留位置值取代為您自己的資訊:

aws opensearch describe-domain \ --domain-name {{domain-name}} \ --region {{region}} \ --query 'DomainStatus.VPCOptions.SecurityGroupIds' aws ec2 describe-security-groups \ --group-ids {{security-group-id}} \ --region {{region}} \ --query 'SecurityGroups[0].IpPermissions'

若要新增傳入規則,請指定您的 VPC CIDR 區塊,或為更緊密的控制,將 VPC 端點的安全群組指定為來源:

aws ec2 authorize-security-group-ingress \ --group-id {{security-group-id}} \ --protocol tcp \ --port 443 \ --source-group {{endpoint-security-group-id}} \ --region {{region}}

下表列出常見的安全群組錯誤。

錯誤 為何失敗 Resolution
僅允許連接埠 9200 OpenSearch UI 在連接埠 443 上使用 HTTPS 新增 TCP 443 的傳入規則
將來源限制為特定 IP 地址 VPC 端點的 IP 地址可能會變更 使用 CIDR 區塊,或參考安全群組
無傳出規則 回應無法到達端點 允許傳出流量
錯誤的 VPC CIDR 區塊 來源範圍與端點子網路不相符 使用存放端點之 VPC 的 CIDR 區塊

啟用 DNS 解析

VPC 端點依賴 DNS 來路由流量。enableDnsSupport 和 enableDnsHostnames 必須位於 VPC true上。下列命令會檢查每個屬性,並視需要啟用它。將預留位置值取代為您自己的資訊:

aws ec2 describe-vpc-attribute \ --vpc-id {{vpc-id}} \ --attribute enableDnsSupport \ --region {{region}} aws ec2 modify-vpc-attribute \ --vpc-id {{vpc-id}} \ --enable-dns-support '{"Value": true}' \ --region {{region}} aws ec2 describe-vpc-attribute \ --vpc-id {{vpc-id}} \ --attribute enableDnsHostnames \ --region {{region}} aws ec2 modify-vpc-attribute \ --vpc-id {{vpc-id}} \ --enable-dns-hostnames '{"Value": true}' \ --region {{region}}

如果您使用 Route 53 私有託管區域,請確認它們不會覆寫 VPC 端點的 DNS 項目。自訂 DNS 組態可能會干擾 VPC 端點所依賴的解析度。

解決間歇性 OpenSearch UI VPC 連線

間歇性連線通常會反映暫時性條件,而不是組態錯誤。常見原因包括下列項目:

  • 正在處理組態變更的網域。

  • 某人修改的安全群組。

  • OpenSearch UI 在網域變更後重新佈建的 VPC 端點。

  • 網域上的資源壓力。

檢查網域是否正在處理變更:

aws opensearch describe-domain \ --domain-name {{domain-name}} \ --query 'DomainStatus.Processing'

如果值為 true,請等待變更完成。您也可以在 CPUUtilization Amazon CloudWatch 中檢閱網域的指標。

檢查 VPC 連線需求

  • 已授權 存取 VPC 端點application.opensearchservice.amazonaws.com。

  • 安全群組允許傳入 TCP 443,並允許傳出流量。

  • VPC 已啟用 DNS 支援和 DNS 主機名稱。

  • 網域處於作用中狀態,且不會處理變更。

  • 網域的存取政策允許 OpenSearch UI 服務主體。

  • 對於無伺服器集合,網路政策會列出 中的服務SourceServices,而資料存取政策會授予讀取許可。

  • 沒有任何衝突的 Route 53 私有託管區域會覆寫端點 DNS。