本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 故障診斷 AWS OpsWorks for Chef Automate
**重要**
AWS OpsWorks for Chef Automate 已於 2024 年 5 月 5 日結束生命週期，並已針對新客戶和現有客戶停用。我們建議現有客戶遷移至 Chef SaaS 或替代解決方案。如果您有任何問題，可以在 [AWS re：Post](https://repost.aws/) 或透過 [AWS Premium Support](https://aws.amazon.com/support) 聯絡 AWS 支援 團隊。
本主題包含一些常見問題 AWS OpsWorks for Chef Automate ，以及這些問題的建議解決方案。
**Topics**
+ [一般疑難排解秘訣](#w2ab1b9c52b9)
+ [針對特定錯誤進行故障診斷](#tshooterrors-chef)
+ [其他協助及支援](#tshooterrors-chef-support)
## 一般疑難排解秘訣
若您無法建立或使用 Chef 伺服器，您可以檢視錯誤訊息或日誌，來協助您故障診斷問題。以下任務說明在您故障診斷 Chef 伺服器問題時一般開始著手的位置。如需特定錯誤和解決方案的資訊，請參閱本主題的[針對特定錯誤進行故障診斷](#tshooterrors-chef)一節。
+ 如果 Chef 伺服器無法啟動，請使用 AWS OpsWorks for Chef Automate 主控台檢視錯誤訊息。在 Chef 伺服器詳細資訊頁面上，與啟動和執行伺服器相關的錯誤訊息會顯示在頁面的頂端。錯誤可能來自用來建立 Chef 伺服器的服務 AWS OpsWorks for Chef Automate CloudFormation，或 Amazon EC2。在詳細資訊頁面上，您也可以檢視在執行中伺服器上發生的事件，其中也可能包含故障事件訊息。
+ 為協助解決 EC2 問題，請使用 SSH 連線到您伺服器的執行個體並檢視日誌。EC2 執行個體日誌存放在 `/var/log/aws/opsworks-cm` 目錄。這些日誌會在 AWS OpsWorks for Chef Automate 啟動 Chef 伺服器時擷取命令輸出。
## 針對特定錯誤進行故障診斷
**Topics**
+ [伺服器處於**連線中斷**狀態](#tshooterrors-chef-connection-lost)
+ [受管節點顯示在 Chef Automate 儀表板中的 Missing (遺失) 資料行內](#w2ab1b9c52c11b6)
+ [無法建立 Chef 保存庫。`knife vault` 命令失敗並顯示錯誤](#w2ab1b9c52c11b8)
+ [伺服器建立失敗，並顯示 "requested configuration is currently not supported" 訊息](#w2ab1b9c52c11c10)
+ [Chef 伺服器無法辨識在 Chef Automate 儀表板中新增的組織名稱](#w2ab1b9c52c11c12)
+ [無法建立伺服器的 Amazon EC2 執行個體](#w2ab1b9c52c11c14)
+ [服務角色錯誤導致伺服器無法建立](#w2ab1b9c52c11c16)
+ [超過彈性 IP 地址限制](#w2ab1b9c52c11c18)
+ [無法登入 Chef Automate 儀表板](#w2ab1b9c52c11c20)
+ [自動節點關聯失敗](#w2ab1b9c52c11c22)
+ [系統維護失敗](#tshooterrors-chef-maintenance-fails)
### 伺服器處於**連線中斷**狀態
**問題：**伺服器的狀態顯示為**連線中斷**。
**原因：**當 外部的實體 OpsWorks 變更 AWS OpsWorks for Chef Automate 伺服器或其支援的資源時，這最常發生。 OpsWorks 無法連線到**連線中斷**狀態的 Chef Automate 伺服器，以處理維護任務，例如建立備份、套用作業系統修補程式或更新 Chef Automate。因此，您的伺服器可能缺少重要的更新、容易發生安全問題，或無法如預期運作。
**解決方案：**請嘗試下列步驟來還原伺服器的連線。
1. 請確定您的服務角色具有所有必要的許可。
1. 在伺服器的**設定**頁面的網路**和安全性**中，選擇伺服器正在使用之服務角色的連結。這會開啟要在 IAM 主控台中檢視的服務角色。
1. 在**許可**索引標籤上，確認 `AWSOpsWorksCMServiceRole` 位於**許可政策**清單中。如果未列出，請手動將 `AWSOpsWorksCMServiceRole`受管政策新增至角色。
1. 在**信任關係**索引標籤上，確認服務角色具有信任政策，信任`opsworks-cm.amazonaws.com`服務代表您擔任角色。如需如何搭配角色使用信任政策的詳細資訊，請參閱[修改角色 （主控台）](https://docs.aws.amazon.com/IAM/latest/UserGuide/roles-managingrole-editing-console.html) 或 AWS 安全部落格文章：[如何搭配 IAM 角色使用信任政策](https://aws.amazon.com/blogs/security/how-to-use-trust-policies-with-iam-roles/)。
1. 請確定您的執行個體描述檔具有所有必要的許可。
1. 在伺服器的**設定**頁面上，於**網路和安全性**中，選擇伺服器正在使用之執行個體描述檔的連結。這會開啟執行個體描述檔，以便在 IAM 主控台中檢視。
1. 在**許可**索引標籤上，確認 `AmazonEC2RoleforSSM`和 `AWSOpsWorksCMInstanceProfileRole` 都位於**許可政策**清單中。如果未列出其中一個或兩者，請手動將這些受管政策新增至角色。
1. 在**信任關係**索引標籤上，確認服務角色具有信任政策，信任`ec2.amazonaws.com`服務代表您擔任角色。如需如何搭配角色使用信任政策的詳細資訊，請參閱[修改角色 （主控台）](https://docs.aws.amazon.com/IAM/latest/UserGuide/roles-managingrole-editing-console.html) 或 AWS 安全部落格文章：[如何搭配 IAM 角色使用信任政策](https://aws.amazon.com/blogs/security/how-to-use-trust-policies-with-iam-roles/)。
1. 在 Amazon EC2 主控台中，請確定您位於與伺服器區域相同的區域，然後重新啟動伺服器正在使用的 AWS OpsWorks for Chef Automate EC2 執行個體。
1. 選擇名為 `aws-opsworks-cm-instance-`*server-name* 的 EC2 執行個體。
1. 在**執行個體狀態**功能表中，選擇**重新啟動執行個體**。
1. 最多需要 15 分鐘的時間，伺服器才能重新啟動並完全上線。
1. 在 AWS OpsWorks for Chef Automate 主控台的伺服器詳細資訊頁面上，確認伺服器狀態現在**正常運作**。
如果執行上述步驟後，伺服器狀態仍為**連線遺失**，請嘗試下列其中一項。
+ 透過[建立新的](gettingstarted-opscm-create.md)伺服器並[刪除原始](opscm-delete-server.md)伺服器來取代伺服器。如果目前伺服器上的資料對您很重要，[請從最近的備份還原伺服器](opscm-chef-restore.md)，並在[刪除原始、無回應的伺服器](opscm-delete-server.md)之前驗證資料是最新的。
+ [聯絡 AWS 支援](#tshooterrors-chef-support)。
### 受管節點顯示在 Chef Automate 儀表板中的 Missing (遺失) 資料行內
**問題：**受管節點顯示在 Chef Automate 儀表板中的 **Missing (遺失)** 資料行內。
**原因：**當節點沒有連線至 Chef Automate 伺服器超過 12 小時，且 `chef-client` 無法在節點上執行時，節點會從 12 小時前的狀態變更，並移動到 Chef Automate 儀表板的 **Missing (遺失)** 資料行。
**解決方案：**驗證節點處於線上狀態。嘗試執行 `knife node show node_name --run-list` 以查看 `chef-client` 是否能在節點上執行，或是 `knife node show -l node_name` 以顯示節點的所有相關資訊。節點可能處於離線狀態，或並未與網路連線。
### 無法建立 Chef 保存庫。`knife vault` 命令失敗並顯示錯誤
**問題：**您嘗試透過執行 `knife vault` 命令，在您的 Chef Automate 伺服器 (例如存放網域連接 Windows 式節點登入資料的保存庫) 建立保存庫。命令傳回類似以下內容的錯誤訊息。
```
WARN: Auto inflation of JSON data is deprecated. Please pass in the class to inflate or use #edit_hash (CHEF-1)
at /opt/chefdk/embedded/lib/ruby/2.3.0/forwardable.rb:189:in `edit_data'.Please see https://docs.chef.io/deprecations_json_auto_inflate.html
for further details and information on how to correct this problem.
WARNING: pivotal not found in users, trying clients.
ERROR: ChefVault::Exceptions::AdminNotFound: FATAL: Could not find pivotal in users or clients!
```
樞紐使用者並未在您遠端執行 `knife user list` 傳回，但當您在您的 Chef Automate 伺服器上本機執行 `chef-server-ctl user-show` 命令時，卻又能在結果中看到樞紐使用者。換句話說，您的 `knife vault` 無法找到樞紐使用者，但您知道它存在。
**原因：**雖然樞紐使用者在 Chef 中被視為超級使用者，因此具備完整許可，但它並非任何組織的成員，包括在 AWS OpsWorks for Chef Automate中使用的 `default` 組織。`knife user list` 命令會傳回所有您 Chef 組態中目前組織內的使用者。`chef-server-ctl user-show` 命令則會傳回所有使用者 (包含樞紐使用者)，而與組織無關。
**解決方案：**若要修正此問題，請透過執行 `knife opc`，將樞紐使用者新增至預設組織。
首先，您需要安裝 [knife-opc](https://github.com/chef/knife-opc) 外掛程式。
```
chef gem install knife-opc
```
在您安裝外掛程式之後，執行下列命令以將樞紐使用者新增至預設組織。
```
knife opc org user add default pivotal
```
您可以透過再次執行 `knife user list`，來驗證樞紐使用者是否已是預設組織的一部分。結果中應會列出 `pivotal`。然後，請再次嘗試執行 `knife vault`。
### 伺服器建立失敗，並顯示 "requested configuration is currently not supported" 訊息
**問題：**您嘗試建立 Chef Automate 伺服器，但伺服器建立失敗並顯示類似下列錯誤訊息："The requested configuration is currently not supported. Please check the documentation for supported configurations."
**原因：**Chef Automate 伺服器可能指定了不支援的執行個體類型。若您選擇在擁有非預設租用的 VPC (例如一個[專用執行個體](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/dedicated-instance.html)) 中建立 Chef Automate 伺服器，所有指定 VPC 中的執行個體也都必須是專用或主控租用。因為有些執行個體類型 (例如 t2) 僅能使用預設租用，指定 VPC 便可能無法支援 Chef Automate 伺服器執行個體類型，因此導致伺服器建立失敗。
**解決方案：**若您選擇具有非預設租用的 VPC，請使用支援專用租用的 m4 執行個體類型。
### Chef 伺服器無法辨識在 Chef Automate 儀表板中新增的組織名稱
**問題：**您已在 Chef Automate 儀表板中新增工作流程組織名稱，或在[全自動節點關聯指令碼](opscm-unattend-assoc.md)`"default"`中指定 以外的`CHEF_AUTOMATE_ORGANIZATION`值，但節點關聯失敗。您的 AWS OpsWorks for Chef Automate 伺服器無法識別新的組織名稱。
**原因：**工作流程組織名稱和 Chef 伺服器的組織名稱不相同。您可以在 web 式的 Chef Automate 儀表板中建立新的工作流程組織，但無法建立 Chef 伺服器組織名稱。您只能使用 Chef Automate 儀表板檢視現有的 Chef 伺服器組織。您在 Chef Automate 儀表板中建立的新組織為工作流程組織，Chef 伺服器無法識別。您無法透過在節點關聯指令碼中指定他們，來建立新的組織名稱。在組織並未新增到 Chef 伺服器時於節點關聯指令碼中參考組織名稱，便會導致節點關聯失敗。
**解決方案：**若要建立在 Chef 伺服器上可識別的新組織，請使用 [https://docs.chef.io/plugin_knife_opc.html#opc-org-create](https://docs.chef.io/plugin_knife_opc.html#opc-org-create) 命令，或執行 [https://docs.chef.io/ctl_chef_server.html#organization-management](https://docs.chef.io/ctl_chef_server.html#organization-management)。
### 無法建立伺服器的 Amazon EC2 執行個體
**問題：**伺服器建立失敗，並顯示與下列內容相似的錯誤訊息："The following resource(s) failed to create: [EC2Instance]. Failed to receive 1 resource signal(s) within the specified duration."
**原因：**這最有可能是因為 EC2 執行個體沒有網路存取。
**解決方案：**確保執行個體具有傳出網際網路存取，且 AWS 服務代理程式能夠發出命令。確認您的 VPC (使用單一公有子網路的 VPC) 已啟用 **DNS resolution (DNS 解析)**，並且您的子網路也已啟用 **Auto-assign Public IP (自動指派公有 IP)** 設定。
### 服務角色錯誤導致伺服器無法建立
**問題：**伺服器建立失敗，並顯示下列錯誤訊息："Not authorized to perform sts:AssumeRole."
**原因：**這可能會在您使用的服務角色缺少適當的許可，無法建立新伺服器時發生。
**解決方案：**開啟 AWS OpsWorks for Chef Automate 主控台；使用 主控台來產生新的服務角色和執行個體描述檔角色。若您偏好使用您自己的服務角色，請將 **AWSOpsWorksCMServiceRole** 政策連接到角色。確認 **opsworks-cm.amazonaws.com** 已列在角色**信任關係**中的服務之間。確認與 Chef 伺服器相關聯的服務角色已連接 **AWSOpsWorksCMServiceRole** 受管政策。
### 超過彈性 IP 地址限制
**問題：**伺服器建立失敗，並顯示下列錯誤訊息："The following resource(s) failed to create: [EIP, EC2Instance]. Resource creation cancelled, the maximum number of addresses has been reached."
**原因：**當您的帳戶使用的彈性 IP (EIP) 地址數超過最大值時，便可能發生此情況。預設 EIP 地址限制為 5 個。
**解決方案：**您可以釋出現有的 EIP 地址或刪除帳戶未主動使用的 EIP 地址，也可以聯絡 AWS 客戶支援來提高與您的帳戶相關聯的 EIP 地址限制。
### 無法登入 Chef Automate 儀表板
**問題：**Chef Automate 儀表板顯示類似下列內容的錯誤："Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at https://myserver-name.region.opsworks-cm.io/api/v0/e/default/verify-token. (Reason: CORS header 'Access-Control-Allow-Origin' missing)". 錯誤也可能類似 "The User Id / Password combination entered is incorrect."。
**原因：**Chef Automate 儀表板明確設定 FQDN，不接受相對 URL。此時，您無法使用 Chef 伺服器的 IP 地址登入。您只能使用伺服器的 DNS 名稱登入。
**解決方案：**只使用 Chef 伺服器的 DNS 名稱項目登入 Chef Automate 儀表板，而非 IP 地址。您也可以透過執行 AWS CLI 命令嘗試重設 Chef Automate 儀表板登入資料，如[重設 Chef Automate 儀表板登入資料](opscm-resetchefcreds.md)中所述。
### 自動節點關聯失敗
**問題：**新 Amazon EC2 節點的自動或全自動關聯失敗。應新增到 Chef 伺服器的節點並未在 Chef Automate 儀表板中出現，也沒有在 `knife client show` 或 `knife node show` 命令的結果中列出。
**原因：**這可能會在您沒有將 IAM 角色設為允許 `opsworks-cm` API 呼叫，以和新的 EC2 執行個體通訊的執行個體描述檔時發生。
**解決方案：**將政策連接到您的 EC2 執行個體描述檔，以允許 `AssociateNode` 和 `DescribeNodeAssociationStatus` API 呼叫使用 EC2，如[在 中自動新增節點 AWS OpsWorks for Chef Automate](opscm-unattend-assoc.md)中所述。
### 系統維護失敗
AWS OpsWorks CM 會執行每週系統維護，以確保 Chef Server 和 Chef Automate Server 的最新次要版本，包括安全性更新，一律在 AWS OpsWorks for Chef Automate 伺服器上執行。如果系統維護因任何原因失敗， 會 AWS OpsWorks CM 通知您失敗。如需系統維護的詳細資訊，請參閱 [中的系統維護 AWS OpsWorks for Chef Automate](opscm-maintenance.md)。
本節說明失敗的可能原因，並建議解決方案。
**Topics**
+ [服務角色或執行個體描述檔錯誤導致系統無法維護](#w2ab1b9c52c11c24b8)
#### 服務角色或執行個體描述檔錯誤導致系統無法維護
**問題：**系統維護失敗，並顯示錯誤訊息：「未獲授權執行 sts：AssumeRole」或有關許可的類似錯誤訊息。
**原因：**當您使用的服務角色或執行個體描述檔缺少在伺服器上執行系統維護的足夠許可時，可能會發生這種情況。
**解決方案：**確保您的服務角色和執行個體描述檔具有所有必要的許可。
1. 請確定您的服務角色具有所有必要的許可。
1. 在伺服器的**設定**頁面上的網路**和安全性**中，選擇伺服器正在使用之服務角色的連結。這會開啟要在 IAM 主控台中檢視的服務角色。
1. 在**許可**索引標籤上，確認 `AWSOpsWorksCMServiceRole` 已連接至服務角色。如果`AWSOpsWorksCMServiceRole`未列出 ，請將此政策新增至角色。
1. 確認 **opsworks-cm.amazonaws.com** 已列在角色**信任關係**中的服務之間。如需如何搭配角色使用信任政策的詳細資訊，請參閱[修改角色 （主控台）](https://docs.aws.amazon.com/IAM/latest/UserGuide/roles-managingrole-editing-console.html) 或 AWS 安全部落格文章：[如何搭配 IAM 角色使用信任政策](https://aws.amazon.com/blogs/security/how-to-use-trust-policies-with-iam-roles/)。
1. 請確定您的執行個體描述檔具有所有必要的許可。
1. 在伺服器的**設定**頁面**的網路和安全性**中，選擇伺服器使用的執行個體描述檔連結。這會開啟執行個體描述檔，以便在 IAM 主控台中檢視。
1. 在**許可**索引標籤上，確認 `AmazonEC2RoleforSSM`和 `AWSOpsWorksCMInstanceProfileRole` 都位於**許可政策**清單中。如果未列出其中一個或兩者，請手動將這些受管政策新增至角色。
1. 在**信任關係**索引標籤上，確認服務角色具有信任政策，信任`ec2.amazonaws.com`服務代表您擔任角色。如需如何搭配角色使用信任政策的詳細資訊，請參閱[修改角色 （主控台）](https://docs.aws.amazon.com/IAM/latest/UserGuide/roles-managingrole-editing-console.html) 或 AWS 安全部落格文章：[如何搭配 IAM 角色使用信任政策](https://aws.amazon.com/blogs/security/how-to-use-trust-policies-with-iam-roles/)。
## 其他協助及支援
若您在本主題中沒有看到您的特定問題，或是您已嘗試本主題中的建議，但仍然發生問題，請造訪 [OpsWorks 論壇](https://forums.aws.amazon.com/forum.jspa?forumID=153&start=0)。
您也可以前往 [AWS Support 中心](https://console.aws.amazon.com/support/home#/)。 AWS 支援中心是建立和管理 AWS 支援案例的中樞。 AWS 支援中心也包含其他實用資源的連結，例如論壇、技術FAQs、服務運作狀態和 AWS Trusted Advisor。