必要條件

本頁面將逐步說明 Cortex Framework 部署作業的先決條件。請花點時間設定各項必要條件，再繼續進行示範部署或部署。

要求存取權

Cortex Framework 第 7 版目前為公開預先發布版。 如要要求存取 GitHub 存放區，請參閱「要求存取權」。

準備 Google Cloud 目標專案

部署前，您需要佈建目標專案，以代管 Dataform 存放區和執行環境。

複製存放區

按照本節中的步驟，複製 Google Cloud Cortex Framework 存放區。

1. 使用存取權確認電子郵件中提供的連結，開啟 Cortex Framework GitHub 存放區 (要求存取權後)。

2. 使用下列指令複製原始碼並下載安裝構件：

   # Please ensure that the access request has been processed
   # before executing this command, otherwise it will result in 404 error
   
   git clone LINK_PROVIDED_IN_YOUR_ACCESS_CONFIRMATION_EMAIL
   
   cd DIRECTORY
   

安裝構件

繼續操作前，請確認上一個步驟取得的 Cortex Framework 構件是否位於本機目錄中。

安裝「uv」

uv 是以 Rust 編寫的 Python 套件管理工具，速度極快。Cortex Framework 會使用此功能，確保部署作業一致、獨立且高效能，減少錯誤並加快安裝時間。

1. 安裝 Python 虛擬環境的 uv 管理員套件。請參閱 uv 安裝說明。

2. 執行下列指令，啟用空白的 Python 虛擬環境：

uv sync

設定 Google Cloud SDK 指令列介面

執行部署作業前，請先設定 Google Cloud CLI 環境，指向特定目標專案。

# The ID of your Google Cloud Project
export PROJECT_ID="YOUR_PROJECT_ID"

# Set current project and quota project
gcloud config set project YOUR_PROJECT_ID
gcloud auth application-default set-quota-project YOUR_PROJECT_ID

後續步驟

準備好建構及部署了嗎？請參閱下列指南，瞭解如何部署及執行：

• 部署示範：在幾分鐘內部署範例資料，瞭解 Cortex Framework 的實際運作情形。
• 部署：按照逐步操作說明，為企業資料設定及部署 Cortex Framework。