設定 CI/CD 管道

下頁說明如何配置​Pipeline。 要查看有關管線工作方式的更多概念資訊,請參閱CI/CD管線概述

教學影片

在Cloud Manager中配置管線

CI/CD Production Pipeline配置定義將啟動管線的觸發器、控制生產部署和效能測試參數的參數。

瞭解流

您可以從 ​UI Cloud Manager的「Pipeline Settings 」 (管道設定) 圖格來設定管道。

部署管理器負責設定管道。 執行此操作時,首先從​Git Repository​中選擇一個分支。 管線配置包括:

  • 定義將啟動管線的觸發器。
  • 定義控制生產部署的參數。
  • 配置效能測試參數。

設定管線

注意

在Git儲存庫至少有一個分支且程式設定完成之前,無法設定管線。

開始部署代碼之前,必須從Cloud Manager配置管線設定。

注意

可在初始設定後更改管線設定。

從Cloud Manager配置管線設定

使用Cloud Manager UI設定程式後,您就可以設定管線。

請依照下列步驟來設定管道的行為和偏好設定:

  1. 按一下「設定管線」(Setup Pipeline)「」(<a0/>)以設定和配置管線。

  2. 將顯示​設定管線​螢幕。

    三步嚮導允許您設定​BranchEnvironments​和​Testing​環境。
    選擇Git分支,然後按一下​Next

    注意

    在Git儲存庫中找到的分支會連結至您的程式。

  3. 訪問​環境​頁籤以選擇​Stage​和​Production​選項。

    可定義觸發器以啟動管線:

    • On Git Changes -每當有提交添加到配置的git分支時,啟動CI/CD管線。即使選取此選項,也始終可以手動啟動管線。
    • 手動 -使用UI手動啟動管線。

    在管道設定或編輯期間,當在任何質量門(如代碼質量、安全性測試和效能測試)中遇到重要故障時,部署管理器可以選擇定義管道的行為。

    這對希望實現更自動化流程的客戶非常有用。 可用的選項包括:

  • 每次詢問 -這是預設設定,需要手動干預任何重要故障。

  • 立即失敗 -如果選中此選項,當出現「重要」(Impertient)故障時,管線將被取消。這實際上是模擬使用者手動拒絕每個失敗。

  • 立即繼續 -如果選中此選項,當出現「重要」(Importent)故障時,管線將自動繼續。這實際上是在模擬用戶手動批准每個故障。

    現在,您可以定義控制生產部署的參數。 三種可用選項如下:

  • 使用上線核准 -部署必須由業務擁有者、專案經理或部署經理透過 Cloud Manager UI手動核准。

  • 使用CSE監督 -參與CSE以實際開始部署。在管線設定或啟用CSE監督時編輯期間,部署管理員可以選擇:

    • 任何CSE:是指任何可用的CSE
    • 我的CSE:是指指派給客戶的特定CSE或其備份(如果CSE不在辦公室)
  • 已排程 -此選項可讓使用者啟用已排程的生產部署。

注意

如果選擇了​Scheduled​選項,則可以在​階段部署之後將生產部署計畫到流水線(和​使用GoLive Approval,如果已啟用,則可以)等待計畫設定。 使用者也可以選擇立即執行生產部署。

請參閱​部署您的程式碼,以設定部署排程或立即執行生產。

注意

使用CSE監督​選項不適用於所有客戶。

在階段部署後核准

可在生產管線中配置一個可選步驟​在階段部署後批准
在​管線編輯​螢幕上的新選項中啟用此選項:

然後,在管線執行期間,它會顯示為個別步驟:

注意

在階段部署後 進行核准的功能與在生產部署前進行核准類似,但是會在階段部署步驟(即在測試完成之前)後立即執行,而在生產部署完成之後,則會先進行核准。

Dispatcher Invalidation

身為部署管理員,您有機會在設定或編輯管道時,設定一組內容路徑,這些路徑會從AEM Dispatcher快取中,從無效的​​或​清除的​進行發佈例項。

您可以為「舞台(Stage)」和「生產(Production)」部署設定個別的路徑集。 如果已配置,則這些快取動作將作為部署管線步驟的一部分執行,就在部署任何內容封裝後執行。 這些設定使用標準的AEM Dispatcher行為——無效執行快取失效,類似於從作者啟動內容以進行發佈;flush會執行快取刪除。

一般而言,使用無效動作較為可取,但有時可能需要刷新,尤其是在使用AEM HTML Client Libraries時。

注意

請參閱Dispatcher Overview以獲取有關Dispatcher快取的詳細資訊。

按照以下步驟配置Dispatcher Invalidations:

  1. 按一下「Dispatcher Configuration」標題下的​Configure

  2. 輸入路徑,從​Type​中選擇操作,然後按一下​Add。 每個環境最多可以指定100個路徑。 添加路徑後,按一下​應用

  3. 回到​管線設定​頁面後,您將會看到選項的更新摘要。

    按一下​保存​以保存此配置。

  4. 訪問​Testing​頁籤,以定義程式的測試標準。

    現在,您可以設定效能測試參數。

    您可以設定​AEM Sites​和​AEM Assets​效能測試,視您擁有的授權產品而定。

    AEM Sites:

    Cloud Manager會在階段發佈伺服器上要求頁面(依預設為未驗證的使用者)達30分鐘的測試期間,並測量每個頁面的回應時間以及各種系統層級度量,以執行AEM Sites程式的效能測試。 這些請求是從一組已知的專用地址發出的。 您可向客戶成功工程師或Adobe代表取得地址範圍。

    在30分鐘測試期開始之前,Cloud Manager將使用客戶成功工程師配置的一組或多個​seed URL來編目Stage環境。 從這些URL開始,會檢查每個頁面的HTML,並以寬度優先的方式瀏覽連結。 此編目程式最多限制為5000頁。 來自Crawler的請求有10秒的固定逾時。

    頁面由三個​頁面集​選擇;您可以選擇從一組到三組的任意位置。 流量的分配是根據選擇的集數,即如果全部三個都被選中,則33%的頁面檢視會放入每個集;如果選取2個,則每組50%;如果選取其中一個,則100%的流量會移至該集合。

    例如,假設「熱門即時頁面」和「新頁面」集(在此範例中,未使用其他即時頁面)之間有50%/50%的分割,而「新頁面」集包含3000個頁面。 每分鐘頁面檢視次數KPI設定為200。 在30分鐘的測試期間:

    • 「熱門即時頁面」集中的25個頁面,每個頁面將被點擊240次-((200 * 0.5)/ 25)* 30 = 120

    • 「新頁面」集中的3000個頁面中,每個頁面都會點擊一次-((200 * 0.5)/ 3000)* 30 = 1

    如需詳細資訊,請參閱已驗證的效能測試

    AEM Assets:

    Cloud Manager會重複上傳資產30分鐘的測試期間,並測量每個資產的處理時間以及各種系統層級的度量,以執行AEM Assets程式的效能測試。 此功能可上傳影像和PDF檔案。 每分鐘上載的每種類型的資產數量分佈在「管線設定」或「編輯」螢幕中設定。

    例如,如果使用70/30分割,如下圖所示。 每分鐘上傳10個資產,每分鐘上傳7個影像和3個檔案。

    注意

    有預設影像和PDF檔案,但在大多數情況下,客戶會想要上傳自己的資產。 這可從「管線設定」(Pipeline Setup)或「編輯」(Edit)螢幕中完成。 Photoshop、Illustrator和Postscript檔案支援常見的影像格式,例如JPEG、PNG、GIF和BMP。

  5. 按一下​保存​以完成管線進程的設定。

    注意

    此外,在設定管線後,您仍可使用Cloud Manager UI的​**「生產管線設定」(Production Pipeline Settings)**​圖格來編輯相同的設定。

已驗證的效能測試

具有已驗證網站的AMS客戶可以指定Cloud Manager在Sites效能測試期間用來存取網站的使用者名稱和密碼。

用戶名和口令被指定為管線變數,名稱為CM_PERF_TEST_BASIC_USERNAMECM_PERF_TEST_BASIC_PASSWORD

雖然並非嚴格要求,但建議使用字串變數類型做為username,並建議使用secretString變數類型作為密碼。 如果同時指定了這兩者,則效能測試Crawler和測試虛擬用戶的每個請求都將包含這些憑據作為HTTP Basic身份驗證。

要使用Cloud Manager CLI設定這些變數,請運行:

$ aio cloudmanager:set-pipeline-variables <pipeline id> --variable CM_PERF_TEST_BASIC_USERNAME <username> --secret CM_PERF_TEST_BASIC_PASSWORD <password>

非生產和代碼純質量管道

除了部署到生產階段的主管道外,客戶還可以設定額外的管道,稱為​非生產管道。 這些管線始終執行構建和代碼質量步驟。 他們也可以選擇性地部署至Adobe Managed Services環境。

教學影片

Cloud Manager非生產和僅代碼質量管道

CI/CD非生產管道分為代碼質量管道和部署管道兩類。 程式碼品質會從Git分支輸入所有程式碼,以根據Cloud Manager的程式碼品質掃描來建立和評估。

在主螢幕上,新卡中列出了以下管線:

  1. 從Cloud Manager主螢幕訪問​非生產管線​表徵圖。

  2. 按一下「添加」(Add)按鈕,指定「管線名稱」(Pipeline Name)、「管線類型」(Pipeline Type)和「Git分支」(Git Branch)。

    此外,還可以從Pipeline Options中設定部署觸發器和重要故障行為。

  3. 按一下​Save ,主螢幕上的卡上將顯示管線,並執行以下三個操作:

    • 編輯 -允許編輯管線設定
    • Detail —— 顯示上次管線執行(如果有)
    • Build —— 導航到執行頁,可從中執行管線

    注意

    在管線運行時,將顯示當前步驟,並且僅提供​Details​操作。

後續步驟

在設定管道後,您需要部署程式碼。

如需詳細資訊,請參閱部署您的程式碼

本頁內容