模型和套件部署單元

本頁說明如何為 SaaS 產品建立部署單元模型並封裝。在 SaaS 執行階段中,部署單元稱為「單元 kind」

為要獨立管理的 SaaS 產品元件建立一個單元 kind。詳情請參閱下節:判斷 SaaS 產品的模式

如要建立 SaaS 產品,可以使用單一單元類別。

單元種類是由藍圖定義,藍圖是封裝為 OCI 映像檔的 Terraform 設定。建立單元 kind 之前,您需要為每個單元 kind 建立藍圖。如要瞭解如何建立藍圖,請參閱「建立及上傳藍圖」。

事前準備

  1. 請確認您已為 SaaS 應用程式定義 SaaS 產品
  2. 確認您已建立 Artifact Registry 存放區
  3. 確認您擁有具備必要權限的服務帳戶。 詳情請參閱「SaaS 執行階段服務帳戶」。
  4. 建立每個單元種類時,請確保您有 Terraform 設定,並已準備好藍圖。詳情請參閱下節「判斷 SaaS 產品的模式」。

決定 SaaS 產品的模式

如要建立 SaaS 產品模型,您需要決定要建立多少個單元種類,以及這些單元種類之間的關係。

舉例來說,您可以建立兩種單元類型:一種用於基礎架構 (例如 VM),另一種用於部署到基礎架構的應用程式。如要建立 SaaS 產品,您可以使用單一單元類型。

如要決定如何使用單元 kind 建立 SaaS 產品模型,請考量下列事項:

  • 查看 SaaS 產品元件之間的依附元件。舉例來說,如果 SaaS 產品包含部署到共用 Kubernetes 叢集的應用程式,請考慮使用單位種類來模擬這個共用叢集。
  • 請考量 SaaS 產品元件的發布和維護週期。如果有多個元件會一起管理 (例如基礎架構),不妨考慮使用一個單元種類為這些元件建模。

決定這個模型後,您需要為每個單元種類建立藍圖。如要這麼做,請按照下列步驟操作:

  1. 找出要與這個單元 kind 建立關聯的 Terraform 設定。 如要進一步瞭解所需的 Terraform 設定,請參閱「SaaS 執行階段中的藍圖」。
  2. 請確認 Terraform 設定已封裝為 OCI 映像檔並推送至 Artifact Registry,或位於 zip 封存檔案或 Git 存放區中。詳情請參閱「建立及上傳藍圖」。

有了每種單元 kind 的藍圖後,即可按照本頁的指示建立單元 kind。

建立單元 kind

您可以使用下列方式提供的 Terraform 設定,建立單元種類:

  • 以 ZIP 壓縮檔形式。
  • 在 Git 存放區中。
  • 封裝為 OCI 映像檔。

使用 ZIP 封存建立單元 kind

如要使用 zip 封存檔中的 Terraform 設定建立單元類型,請完成下列操作說明。

如要瞭解如何準備 ZIP 封存檔,請參閱「上傳 ZIP 封存檔」一文。

如要建立單元 kind,請按照下列步驟操作:

  1. 在控制台中,依序前往「SaaS Runtime」 >「Unit Kinds」

    前往「單位種類」

  2. 選取「建立」

  3. 針對「建立藍圖」,選取「上傳」,上傳含有 Terraform 設定的 ZIP 封存檔。

    1. 按一下「瀏覽」,然後找出包含 Terraform 設定的 zip 封存檔,該設定會定義屬於這個單元種類的資源或應用程式。

    2. 按一下「下一步:設定藍圖」

  4. 在「儲存藍圖」頁面中:

    1. 在「從 Artifact Registry 選取存放區」部分,按一下「瀏覽」,然後選取您建立的存放區。

    2. 在「構件映像檔名稱」中,輸入 OCI 映像檔的名稱。

    3. 在「Infrastructure Manager Terraform 版本」中,選取要用於部署作業的 Terraform 版本。如需支援的 Terraform 版本清單,請參閱「支援的 Terraform 版本」。

    4. 在「Cloud Build service account」(Cloud Build 服務帳戶) 部分,選取具備建構映像檔權限的服務帳戶。詳情請參閱「構件建立服務帳戶」。

    5. 按一下「下一步:單元 kind 詳細資料」

  5. 在「設定單元 kind 屬性」頁面中,執行下列操作:

    1. 在「Unit kind name」中,輸入單元種類的名稱。名稱只能使用小寫英文字母、數字或連字號。

    2. 在「SaaS 產品」中,選取要與這個單元類型建立關聯的 SaaS 產品。

    3. 「Dependencies」(依附元件):

      • 如果這是您為 SaaS 產品建立的第一個或唯一單位類型,請勿新增依附元件。

      • 如果您已建立依附於這個單元 kind 的其他單元 kind,請選取「新增依附元件」

        1. 針對「單元 kind」,選取依附於您要建立的單元 kind 的現有單元 kind。

        2. 在「別名」中,輸入可用於輸入變數對應的名稱。

        3. 按一下 [完成]

        4. 如要定義變數對應,請按照下列步驟操作。如要瞭解變數對應的詳細資料,請參閱「變數對應」。

          1. 選取「定義輸入和輸出變數對應」

          2. 「輸入變數對應」

            1. 選取「新增輸入變數對應」
            2. 在「Variable」(變數) 中,輸入輸入變數的名稱。
            3. 在「對應類型」部分,選取:
              • 對應至其他單元類型。
              • 對應至其他單位類型。
            4. 在「Dependency」中,選取要對應變數的現有單元類型。
            5. 在「輸出變數」中,輸入輸出變數的名稱。
            6. 選取「完成」
          3. 如要新增其他輸入變數,請選取「新增輸入變數對應」,然後重複上述步驟。

          4. 如要新增輸出變數對應,請按照下列步驟操作:

            1. 選取「輸出變數對應」分頁標籤。
            2. 選取「新增輸出變數對應」,然後重複輸入變數對應的步驟。
  6. 按一下「Next: Release configuration」(下一步:版本設定)

  7. 在「版本名稱」中,輸入版本名稱。

  8. 選用:為要部署的資源新增標籤。 如要進一步瞭解標籤,請參閱「標籤總覽」。

    如要新增標籤,請按照下列步驟操作:

    1. 在「標籤」下方選取「新增標籤」

    2. 在「Key 1」和「Value 1」中,輸入所需的鍵/值組合。

    3. 針對要新增的每個標籤重複執行上述步驟。

  9. 點選「建立」

您已建立單元 kind。如要建立其他單元種類,請重複相同步驟,並使用包含下一個單元種類 Terraform 設定的 ZIP 封存檔。

如果您已為 SaaS 產品建立所有需要的單元類型,即可部署單元例項

使用 Git 存放區建立單元 kind

如要使用 Git 存放區中的 Terraform 設定建立單元類型,請完成下列操作說明。

如要瞭解如何使用 Git 存放區儲存 Terraform 檔案,請參閱「連線至 Git 存放區」。

  1. 在控制台中,依序前往「SaaS Runtime」 >「Unit Kinds」

    前往「單位種類」

  2. 選取「建立」

  3. 在「建立藍圖」部分,選取「連結外部存放區」

  4. 在「存放區」中,選取含有 Terraform 設定的 Git 存放區:

    1. 如果已連結 Git 存放區,請從清單中選取。

    2. 如果存放區未連結,請按一下「連結新的存放區」,使用 Developer Connect 連結存放區。

      1. 選取「建立新連線」

      2. 在「Region」(區域) 中,選取 Developer Connect 連線的區域。建議使用與 Artifact Registry 存放區相同的區域。

      3. 選用:針對「KMS key」(KMS 金鑰),您可以指定用於加密的 KMS 金鑰。

      4. 在「分支版本」中,指定包含要與這個單元種類建立關聯的 Terraform 設定的 Git 分支版本。

  5. 在「儲存藍圖」頁面中:

    1. 如要「從 Artifact Registry 選取存放區」,請按一下「瀏覽」,然後選取用於 SaaS 產品的 Artifact Registry 存放區

    2. 在「構件映像檔名稱」中,輸入 OCI 映像檔的名稱。

    3. 在「Infrastructure Manager Terraform 版本」中,選取要用於部署作業的 Terraform 版本。如需支援的 Terraform 版本清單,請參閱「支援的 Terraform 版本」。

    4. 在「Cloud Build service account」(Cloud Build 服務帳戶) 部分,選取具備建構映像檔權限的服務帳戶。詳情請參閱「構件建立服務帳戶」。

    5. 按一下「下一步:單元 kind 詳細資料」

  6. 在「設定單元 kind 屬性」頁面中,執行下列操作:

    1. 在「Unit kind name」中,輸入單元種類的名稱。名稱只能使用小寫英文字母、數字或連字號。

    2. 在「SaaS 產品」中,選取要與這個單元類型建立關聯的 SaaS 產品。

    3. 「Dependencies」(依附元件):

      • 如果這是您為 SaaS 產品建立的第一個或唯一單位類型,請勿新增依附元件。

      • 如果您已建立依附於這個單元 kind 的其他單元 kind,請選取「新增依附元件」

        1. 針對「單元 kind」,選取依附於您要建立的單元 kind 的現有單元 kind。

        2. 在「別名」中,輸入可用於輸入變數對應的名稱。

        3. 按一下 [完成]

        4. 如要定義變數對應,請按照下列步驟操作。如要瞭解變數對應的詳細資料,請參閱「變數對應」。

          1. 選取「定義輸入和輸出變數對應」

          2. 「輸入變數對應」

            1. 選取「新增輸入變數對應」
            2. 在「Variable」(變數) 中,輸入輸入變數的名稱。
            3. 在「對應類型」部分,選取:
              • 對應至其他單元類型。
              • 對應至其他單位類型。
            4. 在「Dependency」中,選取要對應變數的現有單元類型。
            5. 在「輸出變數」中,輸入輸出變數的名稱。
            6. 選取「完成」
          3. 如要新增其他輸入變數,請選取「新增輸入變數對應」,然後重複上述步驟。

          4. 如要新增輸出變數對應,請按照下列步驟操作:

            1. 選取「輸出變數對應」分頁標籤。
            2. 選取「新增輸出變數對應」,然後重複輸入變數對應的步驟。
  7. 按一下「Next: Release configuration」(下一步:版本設定)

  8. 在「版本名稱」中,輸入版本名稱。

  9. 選用:為要部署的資源新增標籤。 如要進一步瞭解標籤,請參閱「標籤總覽」。

    如要新增標籤,請按照下列步驟操作:

    1. 在「標籤」下方選取「新增標籤」

    2. 在「Key 1」和「Value 1」中,輸入所需的鍵/值組合。

    3. 針對要新增的每個標籤重複執行上述步驟。

  10. 點選「建立」

您已建立單元 kind。如要建立其他單元種類,請重複相同步驟,並使用包含下一個單元種類 Terraform 設定的 Git 存放區。

如果您已為 SaaS 產品建立所有需要的單元類型,即可部署單元例項

使用現有圖片建立單元 kind

如要使用現有藍圖 (OCI 映像檔) 建立單元種類,請完成下列操作說明。

如要瞭解如何建構 OCI 映像檔,請參閱:

  1. 在控制台中,依序前往「SaaS Runtime」 >「Unit Kinds」

    前往「單位種類」

  2. 選取「建立」

  3. 在「建立藍圖」中,選取「從 Artifact Registry 中選取現有映像檔」

  4. 按一下「下一步:設定藍圖」

  5. 在「儲存藍圖」頁面中:

    1. 如要從 Artifact Registry 選取或輸入現有藍圖

      1. 按一下「瀏覽」

      2. 前往包含 Terraform 設定的映像檔。

      3. 按一下「選取」

    2. 按一下「下一步:單元 kind 詳細資料」

  6. 在「設定單元 kind 屬性」頁面中,執行下列操作:

    1. 在「Unit kind name」中,輸入單元種類的名稱。名稱只能使用小寫英文字母、數字或連字號。

    2. 在「SaaS 產品」中,選取要與這個單元類型建立關聯的 SaaS 產品。

    3. 「Dependencies」(依附元件):

      • 如果這是您為 SaaS 產品建立的第一個或唯一單位類型,請勿新增依附元件。

      • 如果您已建立依附於這個單元 kind 的其他單元 kind,請選取「新增依附元件」

        1. 針對「單元 kind」,選取依附於您要建立的單元 kind 的現有單元 kind。

        2. 在「別名」中,輸入可用於輸入變數對應的名稱。

        3. 按一下 [完成]

        4. 如要定義變數對應,請按照下列步驟操作。如要瞭解變數對應的詳細資料,請參閱「變數對應」。

          1. 選取「定義輸入和輸出變數對應」

          2. 「輸入變數對應」

            1. 選取「新增輸入變數對應」
            2. 在「Variable」(變數) 中,輸入輸入變數的名稱。
            3. 在「對應類型」部分,選取:
              • 對應至其他單元類型。
              • 對應至其他單位類型。
            4. 在「Dependency」中,選取要對應變數的現有單元類型。
            5. 在「輸出變數」中,輸入輸出變數的名稱。
            6. 選取「完成」
          3. 如要新增其他輸入變數,請選取「新增輸入變數對應」,然後重複上述步驟。

          4. 如要新增輸出變數對應,請按照下列步驟操作:

            1. 選取「輸出變數對應」分頁標籤。
            2. 選取「新增輸出變數對應」,然後重複輸入變數對應的步驟。
  7. 按一下「Next: Release configuration」(下一步:版本設定)

  8. 在「版本名稱」中,輸入版本名稱。

  9. 選用:為要部署的資源新增標籤。 如要進一步瞭解標籤,請參閱「標籤總覽」。

    如要新增標籤,請按照下列步驟操作:

    1. 在「標籤」下方選取「新增標籤」

    2. 在「Key 1」和「Value 1」中,輸入所需的鍵/值組合。

    3. 針對要新增的每個標籤重複執行上述步驟。

  10. 點選「建立」

您已建立單元 kind。如要建立其他單元種類,請重複執行相同步驟,並使用包含下一個單元種類 Terraform 設定的 OCI 映像檔。

如果您已為 SaaS 產品建立所有需要的單元類型,即可部署單元例項

後續步驟