Cloud Composer 3 | Cloud Composer 2 | Cloud Composer�
本頁面提供疑難排解資訊，協助解決更新或升級 Cloud Composer 環境時可能遇到的問題。
如需建立環境的疑難排解資訊，請參閱「解決建立環境的相關問題」。
更新 Cloud Composer 環境時，大多數問題都是由下列原因造成：
- 服務帳戶權限問題
- PyPI 依附元件問題
- Airflow 資料庫大小
權限不足，無法更新或升級環境
如果權限不足，導致 Cloud Composer 無法更新或升級環境，系統會輸出下列錯誤訊息：
ERROR: (gcloud.composer.environments.update) PERMISSION_DENIED: The caller does not have permission
解決方法：如「存取權控管」一文所述，將角色指派給您的帳戶和環境的服務帳戶。
環境的服務帳戶權限不足
建立 Cloud Composer 環境時，您會指定服務帳戶，該帳戶會執行環境的大部分作業。如果這個服務帳戶沒有足夠的權限執行要求作業，Cloud Composer 會輸出錯誤：
UPDATE operation on this environment failed 3 minutes ago with the
following error message:
Composer Backend timed out. Currently running tasks are [stage:
CP_COMPOSER_AGENT_RUNNING
description: "No agent response published."
response_timestamp {
seconds: 1618203503
nanos: 291000000
}
].
解決方法：如「存取權控管」一文所述，將角色指派給 Google 帳戶和環境的服務帳戶。
Airflow 資料庫過大，無法執行作業
如果 Airflow 資料庫過大，升級作業可能會失敗。
如果 Airflow 資料庫大小超過 16 GB，Cloud Composer 會輸出下列錯誤：
Airflow database uses more than 16 GB. Please clean the database before upgrading.
解決方案：按照「清除 Airflow 資料庫」一文的說明，清除 Airflow 資料庫。
由於 PyPI 套件衝突，升級至新版 Cloud Composer 失敗
升級已安裝自訂 PyPI 套件的環境時，可能會遇到與 PyPI 套件衝突相關的錯誤。這是因為新的 Cloud Composer 映像檔包含較新版本的預先安裝套件。這可能會導致依附元件與您在環境中安裝的 PyPI 套件發生衝突。
解決方法：
- 如要取得套件衝突的詳細資訊，請執行升級檢查。
- 放寬已安裝自訂 PyPI 套件的版本限制。舉例來說，請將版本指定為
>=1.0.1，而不是==1.0.1。 - 如要進一步瞭解如何變更版本需求，解決依附元件衝突問題，請參閱 pip 說明文件。
無法將環境升級至仍受支援的版本
Cloud Composer 環境只能升級至幾個最新和先前的版本。
建立新環境和升級現有環境的版本限制不同。建立新環境時選擇的 Cloud Composer 版本，可能無法用於升級現有環境。
您可以使用 Google Cloud CLI、API 或 Terraform 執行升級作業。在 Google Cloud 控制台中，只有最新版本可供升級。
環境不正常 (存活檢查失敗)
只有在環境狀態回報為良好時，才能升級環境。
環境元件接近設定的資源限制，並持續以最大負載運作，是導致健康狀態不佳最常見的原因之一。由於部分環境元件無法回報狀態，因此活性檢查 DAG 會將環境狀態回報為不正常。
為解決這個問題，建議您提高資源上限。雖然我們建議您隨時避免環境接近限制，但您也可以只在環境升級期間這麼做。
如果無法連線至 DNS，升級或更新時可能會發生問題
這類連線問題可能會導致記錄項目如下所示：
WARNING - Compute Engine Metadata server unavailable attempt 1 of 5. Reason: [Errno -3] Temporary failure in name resolution Error
這通常表示沒有 DNS 的路徑，因此請確保 metadata.google.internal DNS 名稱可從叢集、Pod 和服務網路內解析為 IP 位址。檢查您建立環境的 VPC (位於主專案或服務專案中) 是否已開啟私人 Google 存取權。