本頁說明如何為 SaaS 產品建立部署單元模型並封裝。在 SaaS 執行階段中,部署單元稱為「單元 kind」。
為要獨立管理的 SaaS 產品元件建立一個單元 kind。詳情請參閱下節:判斷 SaaS 產品的模式。
如要建立 SaaS 產品,可以使用單一單元類別。
單元種類是由藍圖定義,藍圖是封裝為 OCI 映像檔的 Terraform 設定。建立單元 kind 之前,您需要為每個單元 kind 建立藍圖。如要瞭解如何建立藍圖,請參閱「建立及上傳藍圖」。
事前準備
- 請確認您已為 SaaS 應用程式定義 SaaS 產品。
- 確認您已建立 Artifact Registry 存放區。
- 確認您擁有具備必要權限的服務帳戶。 詳情請參閱「SaaS 執行階段服務帳戶」。
- 建立每個單元種類時,請確保您有 Terraform 設定,並已準備好藍圖。詳情請參閱下節「判斷 SaaS 產品的模式」。
決定 SaaS 產品的模式
如要建立 SaaS 產品模型,您需要決定要建立多少個單元種類,以及這些單元種類之間的關係。
舉例來說,您可以建立兩種單元類型:一種用於基礎架構 (例如 VM),另一種用於部署到基礎架構的應用程式。如要建立 SaaS 產品,您可以使用單一單元類型。
如要決定如何使用單元 kind 建立 SaaS 產品模型,請考量下列事項:
- 查看 SaaS 產品元件之間的依附元件。舉例來說,如果 SaaS 產品包含部署到共用 Kubernetes 叢集的應用程式,請考慮使用單位種類來模擬這個共用叢集。
- 請考量 SaaS 產品元件的發布和維護週期。如果有多個元件會一起管理 (例如基礎架構),不妨考慮使用一個單元種類為這些元件建模。
決定這個模型後,您需要為每個單元種類建立藍圖。如要這麼做,請按照下列步驟操作:
- 找出要與這個單元 kind 建立關聯的 Terraform 設定。 如要進一步瞭解所需的 Terraform 設定,請參閱「SaaS 執行階段中的藍圖」。
- 請確認 Terraform 設定已封裝為 OCI 映像檔並推送至 Artifact Registry,或位於 zip 封存檔案或 Git 存放區中。詳情請參閱「建立及上傳藍圖」。
有了每種單元 kind 的藍圖後,即可按照本頁的指示建立單元 kind。
建立單元 kind
您可以使用下列方式提供的 Terraform 設定,建立單元種類:
- 以 ZIP 壓縮檔形式。
- 在 Git 存放區中。
- 封裝為 OCI 映像檔。
使用 ZIP 封存建立單元 kind
如要使用 zip 封存檔中的 Terraform 設定建立單元類型,請完成下列操作說明。
如要瞭解如何準備 ZIP 封存檔,請參閱「上傳 ZIP 封存檔」一文。
如要建立單元 kind,請按照下列步驟操作:
在控制台中,依序前往「SaaS Runtime」 >「Unit Kinds」。
選取「建立」。
針對「建立藍圖」,選取「上傳」,上傳含有 Terraform 設定的 ZIP 封存檔。
按一下「瀏覽」,然後找出包含 Terraform 設定的 zip 封存檔,該設定會定義屬於這個單元種類的資源或應用程式。
按一下「下一步:設定藍圖」。
在「儲存藍圖」頁面中:
在「從 Artifact Registry 選取存放區」部分,按一下「瀏覽」,然後選取您建立的存放區。
在「構件映像檔名稱」中,輸入 OCI 映像檔的名稱。
在「Infrastructure Manager Terraform 版本」中,選取要用於部署作業的 Terraform 版本。如需支援的 Terraform 版本清單,請參閱「支援的 Terraform 版本」。
在「Cloud Build service account」(Cloud Build 服務帳戶) 部分,選取具備建構映像檔權限的服務帳戶。詳情請參閱「構件建立服務帳戶」。
按一下「下一步:單元 kind 詳細資料」。
在「設定單元 kind 屬性」頁面中,執行下列操作:
在「Unit kind name」中,輸入單元種類的名稱。名稱只能使用小寫英文字母、數字或連字號。
在「SaaS 產品」中,選取要與這個單元類型建立關聯的 SaaS 產品。
「Dependencies」(依附元件):
如果這是您為 SaaS 產品建立的第一個或唯一單位類型,請勿新增依附元件。
如果您已建立依附於這個單元 kind 的其他單元 kind,請選取「新增依附元件」。
針對「單元 kind」,選取依附於您要建立的單元 kind 的現有單元 kind。
在「別名」中,輸入可用於輸入變數對應的名稱。
按一下 [完成]。
如要定義變數對應,請按照下列步驟操作。如要瞭解變數對應的詳細資料,請參閱「變數對應」。
選取「定義輸入和輸出變數對應」。
「輸入變數對應」:
- 選取「新增輸入變數對應」。
- 在「Variable」(變數) 中,輸入輸入變數的名稱。
- 在「對應類型」部分,選取:
- 從對應至其他單元類型。
- 對應至其他單位類型。
- 在「Dependency」中,選取要對應變數的現有單元類型。
- 在「輸出變數」中,輸入輸出變數的名稱。
- 選取「完成」。
如要新增其他輸入變數,請選取「新增輸入變數對應」,然後重複上述步驟。
如要新增輸出變數對應,請按照下列步驟操作:
- 選取「輸出變數對應」分頁標籤。
- 選取「新增輸出變數對應」,然後重複輸入變數對應的步驟。
按一下「Next: Release configuration」(下一步:版本設定)
在「版本名稱」中,輸入版本名稱。
選用:為要部署的資源新增標籤。 如要進一步瞭解標籤,請參閱「標籤總覽」。
如要新增標籤,請按照下列步驟操作:
在「標籤」下方選取「新增標籤」。
在「Key 1」和「Value 1」中,輸入所需的鍵/值組合。
針對要新增的每個標籤重複執行上述步驟。
點選「建立」。
您已建立單元 kind。如要建立其他單元種類,請重複相同步驟,並使用包含下一個單元種類 Terraform 設定的 ZIP 封存檔。
如果您已為 SaaS 產品建立所有需要的單元類型,即可部署單元例項。
使用 Git 存放區建立單元 kind
如要使用 Git 存放區中的 Terraform 設定建立單元類型,請完成下列操作說明。
如要瞭解如何使用 Git 存放區儲存 Terraform 檔案,請參閱「連線至 Git 存放區」。
在控制台中,依序前往「SaaS Runtime」 >「Unit Kinds」。
選取「建立」。
在「建立藍圖」部分,選取「連結外部存放區」。
在「存放區」中,選取含有 Terraform 設定的 Git 存放區:
如果已連結 Git 存放區,請從清單中選取。
如果存放區未連結,請按一下「連結新的存放區」,使用 Developer Connect 連結存放區。
選取「建立新連線」。
在「Region」(區域) 中,選取 Developer Connect 連線的區域。建議使用與 Artifact Registry 存放區相同的區域。
選用:針對「KMS key」(KMS 金鑰),您可以指定用於加密的 KMS 金鑰。
在「分支版本」中,指定包含要與這個單元種類建立關聯的 Terraform 設定的 Git 分支版本。
在「儲存藍圖」頁面中:
如要「從 Artifact Registry 選取存放區」,請按一下「瀏覽」,然後選取用於 SaaS 產品的 Artifact Registry 存放區。
在「構件映像檔名稱」中,輸入 OCI 映像檔的名稱。
在「Infrastructure Manager Terraform 版本」中,選取要用於部署作業的 Terraform 版本。如需支援的 Terraform 版本清單,請參閱「支援的 Terraform 版本」。
在「Cloud Build service account」(Cloud Build 服務帳戶) 部分,選取具備建構映像檔權限的服務帳戶。詳情請參閱「構件建立服務帳戶」。
按一下「下一步:單元 kind 詳細資料」。
在「設定單元 kind 屬性」頁面中,執行下列操作:
在「Unit kind name」中,輸入單元種類的名稱。名稱只能使用小寫英文字母、數字或連字號。
在「SaaS 產品」中,選取要與這個單元類型建立關聯的 SaaS 產品。
「Dependencies」(依附元件):
如果這是您為 SaaS 產品建立的第一個或唯一單位類型,請勿新增依附元件。
如果您已建立依附於這個單元 kind 的其他單元 kind,請選取「新增依附元件」。
針對「單元 kind」,選取依附於您要建立的單元 kind 的現有單元 kind。
在「別名」中,輸入可用於輸入變數對應的名稱。
按一下 [完成]。
如要定義變數對應,請按照下列步驟操作。如要瞭解變數對應的詳細資料,請參閱「變數對應」。
選取「定義輸入和輸出變數對應」。
「輸入變數對應」:
- 選取「新增輸入變數對應」。
- 在「Variable」(變數) 中,輸入輸入變數的名稱。
- 在「對應類型」部分,選取:
- 從對應至其他單元類型。
- 對應至其他單位類型。
- 在「Dependency」中,選取要對應變數的現有單元類型。
- 在「輸出變數」中,輸入輸出變數的名稱。
- 選取「完成」。
如要新增其他輸入變數,請選取「新增輸入變數對應」,然後重複上述步驟。
如要新增輸出變數對應,請按照下列步驟操作:
- 選取「輸出變數對應」分頁標籤。
- 選取「新增輸出變數對應」,然後重複輸入變數對應的步驟。
按一下「Next: Release configuration」(下一步:版本設定)
在「版本名稱」中,輸入版本名稱。
選用:為要部署的資源新增標籤。 如要進一步瞭解標籤,請參閱「標籤總覽」。
如要新增標籤,請按照下列步驟操作:
在「標籤」下方選取「新增標籤」。
在「Key 1」和「Value 1」中,輸入所需的鍵/值組合。
針對要新增的每個標籤重複執行上述步驟。
點選「建立」。
您已建立單元 kind。如要建立其他單元種類,請重複相同步驟,並使用包含下一個單元種類 Terraform 設定的 Git 存放區。
如果您已為 SaaS 產品建立所有需要的單元類型,即可部署單元例項。
使用現有圖片建立單元 kind
如要使用現有藍圖 (OCI 映像檔) 建立單元種類,請完成下列操作說明。
如要瞭解如何建構 OCI 映像檔,請參閱:
在控制台中,依序前往「SaaS Runtime」 >「Unit Kinds」。
選取「建立」。
在「建立藍圖」中,選取「從 Artifact Registry 中選取現有映像檔」。
按一下「下一步:設定藍圖」
在「儲存藍圖」頁面中:
如要從 Artifact Registry 選取或輸入現有藍圖:
按一下「瀏覽」。
前往包含 Terraform 設定的映像檔。
按一下「選取」。
按一下「下一步:單元 kind 詳細資料」。
在「設定單元 kind 屬性」頁面中,執行下列操作:
在「Unit kind name」中,輸入單元種類的名稱。名稱只能使用小寫英文字母、數字或連字號。
在「SaaS 產品」中,選取要與這個單元類型建立關聯的 SaaS 產品。
「Dependencies」(依附元件):
如果這是您為 SaaS 產品建立的第一個或唯一單位類型,請勿新增依附元件。
如果您已建立依附於這個單元 kind 的其他單元 kind,請選取「新增依附元件」。
針對「單元 kind」,選取依附於您要建立的單元 kind 的現有單元 kind。
在「別名」中,輸入可用於輸入變數對應的名稱。
按一下 [完成]。
如要定義變數對應,請按照下列步驟操作。如要瞭解變數對應的詳細資料,請參閱「變數對應」。
選取「定義輸入和輸出變數對應」。
「輸入變數對應」:
- 選取「新增輸入變數對應」。
- 在「Variable」(變數) 中,輸入輸入變數的名稱。
- 在「對應類型」部分,選取:
- 從對應至其他單元類型。
- 對應至其他單位類型。
- 在「Dependency」中,選取要對應變數的現有單元類型。
- 在「輸出變數」中,輸入輸出變數的名稱。
- 選取「完成」。
如要新增其他輸入變數,請選取「新增輸入變數對應」,然後重複上述步驟。
如要新增輸出變數對應,請按照下列步驟操作:
- 選取「輸出變數對應」分頁標籤。
- 選取「新增輸出變數對應」,然後重複輸入變數對應的步驟。
按一下「Next: Release configuration」(下一步:版本設定)
在「版本名稱」中,輸入版本名稱。
選用:為要部署的資源新增標籤。 如要進一步瞭解標籤,請參閱「標籤總覽」。
如要新增標籤,請按照下列步驟操作:
在「標籤」下方選取「新增標籤」。
在「Key 1」和「Value 1」中,輸入所需的鍵/值組合。
針對要新增的每個標籤重複執行上述步驟。
點選「建立」。
您已建立單元 kind。如要建立其他單元種類,請重複執行相同步驟,並使用包含下一個單元種類 Terraform 設定的 OCI 映像檔。
如果您已為 SaaS 產品建立所有需要的單元類型,即可部署單元例項。
後續步驟
- 建立 SaaS 產品模型後,即可部署單元執行個體。
- 如要進一步瞭解 SaaS 執行階段,請參閱 SaaS 執行階段總覽。
- 如要進一步瞭解使用 SaaS 執行階段時所需的服務帳戶,請參閱服務帳戶。