本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
OpenSearch UI 應用程式會維持在建立狀態
OpenSearch UI 應用程式通常會在幾分鐘內變成作用中。在某些情況下,它可以保留在建立狀態更長的時間。調查之前,請將經過的時間與下列預期持續時間進行比較。
| 案例 | 預期的建立時間 |
|---|---|
| 具有公有網域的應用程式 | 2-5 分鐘 |
| 具有 VPC 網域的應用程式 | 5-10 分鐘 |
| 具有多個資料來源的應用程式 | 5-15 分鐘 |
| 具有跨帳戶資料來源的應用程式 | 10-20 分鐘 |
| 新 AWS 區域中的第一個應用程式 | 5-10 分鐘 |
如果應用程式處於建立狀態不到 20 分鐘,它可能仍然正常佈建,尤其是在涉及 VPC 網域時。
檢查應用程式狀態
在 主控台中檢查應用程式狀態
-
在導覽功能表中,選擇 OpenSearch UI (儀表板)。
-
在清單中尋找您的應用程式,並檢閱狀態欄。
若要使用 檢查狀態 AWS CLI,請執行下列命令:
aws opensearch get-application \ --id {{application-id}} \ --region {{region}}
檢閱回應中的 status 欄位。
原因:IAM 許可不足
缺少 IAM 許可是最常見的原因。應用程式會維持在建立狀態超過 20 分鐘,主控台不會顯示錯誤訊息,並記錄 AWS CloudTrail AccessDenied事件。
確認建立應用程式的委託人具有下列許可。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "es:CreateApplication", "es:GetApplication", "es:UpdateApplication", "es:ListApplications", "iam:CreateServiceLinkedRole" ], "Resource": "*" } ] }
需要 iam:CreateServiceLinkedRole許可。OpenSearch UI 會在第一次使用時建立服務連結角色,如果缺少此許可,您就無法建立應用程式,而且主控台不會報告錯誤。
原因:服務連結角色的問題
OpenSearch UI 使用AWSServiceRoleForAmazonOpenSearchService服務連結角色代表您管理資源。如果 OpenSearch UI 無法建立該角色,應用程式建立會失敗。這通常會影響 帳戶中的第一個應用程式,並記錄 AWS CloudTrail CreateServiceLinkedRole失敗。
檢查角色是否存在:
aws iam get-role \ --role-name AWSServiceRoleForAmazonOpenSearchService
如果角色不存在,請建立它:
aws iam create-service-linked-role \ --aws-service-name opensearchservice.amazonaws.com
請勿刪除服務連結角色,以重新建立該角色。此角色適用於整個帳戶,帳戶中的每個 Amazon OpenSearch Service 資源都取決於它,包括網域和無伺服器集合。當任何資源仍依賴服務連結角色時,IAM 會拒絕刪除該角色,而刪除該角色可能會中斷使用該角色的其他資源。
如果角色存在但問題仍然存在,請確認您的 IAM 主體有 iam:CreateServiceLinkedRole,然後開啟 AWS 支援案例。
原因:VPC 端點佈建延遲
當應用程式包含 VPC 型資料來源時,OpenSearch UI 必須建立 VPC 端點,這需要比建立公有網域的關聯更長的時間。最多 20 分鐘。
當您等待時,請確認 VPC 端點存取已獲授權:
aws opensearch list-vpc-endpoint-access \ --domain-name {{domain-name}}
同時確認網域的安全群組允許 TCP 連接埠 443 上的傳入流量。如需詳細資訊,請參閱解決 OpenSearch UI 中的 VPC 連線問題。
原因:關聯的網域未處於作用中狀態
如果相關聯的網域本身是建立、處理或升級,應用程式建立可能會在等待時停止。檢查每個相關聯網域的狀態:
aws opensearch describe-domain \ --domain-name {{domain-name}} \ --region {{region}}
請等到所有網域都處於作用中狀態,再建立應用程式。或者,建立不含資料來源的應用程式,並在啟用後新增它們:
aws opensearch create-application \ --name {{application-name}} \ --region {{region}} aws opensearch update-application \ --id {{application-id}} \ --data-sources '[{"dataSourceArn":"arn:aws:es:{{region}}:{{account-id}}:domain/{{domain-name}}"}]'
原因:服務控制政策拒絕請求
AWS Organizations 中的服務控制政策可以拒絕應用程式建立所需的許可,即使 IAM 政策允許也是如此。在這種情況下,IAM 許可看起來正確,應用程式仍然未完成,並記錄 AWS CloudTrail 引用服務控制政策AccessDenied的事件。
檢閱適用於帳戶的服務控制政策,確認它們允許 es:CreateApplication和 iam:CreateServiceLinkedRole,並與您的組織管理員合作,在需要時新增例外狀況。
原因:已達到應用程式配額
每個 AWS 區域都會限制您可以建立的 OpenSearch UI 應用程式數量。檢查有多少應用程式已存在:
aws opensearch list-applications --region {{region}}
如果您已達到配額,請在 Service Quotas 主控台中請求增加配額。如需目前的配額,請參閱 OpenSearch UI 端點和配額。OpenSearch UI 也必須在您建立應用程式的 AWS 區域中提供。
使用診斷檢查清單
-
確認應用程式已處於建立狀態多久。如果少於 20 分鐘,請等待。
-
檢查 AWS CloudTrail
AccessDenied或其他錯誤事件。 -
驗證 IAM 許可,特別是
iam:CreateServiceLinkedRole。 -
確認每個相關聯的網域都處於作用中狀態。
-
如果您使用 VPC 網域,請確認 VPC 端點授權。
-
確認您尚未達到應用程式配額。
-
如果帳戶屬於組織,請檢閱服務控制政策。
如果應用程式已處於建立狀態超過 30 分鐘,且您已檢查每個項目、刪除應用程式、等待五分鐘進行清除、解決您識別的問題,以及建立新的應用程式。刪除從未變成作用中的應用程式不會刪除已儲存的物件或工作區資料,因為未建立任何項目。
aws opensearch delete-application \ --id {{application-id}} \ --region {{region}}