建置及部署

DevOps Insights 將於 2026 年 8 月 31 日結束服務並停止運作。Continuous Delivery 將於 2027 年 2 月 12 日在以下地區停止運作:au-sydca-torus-east。 Code Risk Analyzer 也將於該日於所有地區停止服務。 若某個區域未實際使用這些功能,該區域中的功能可能會提前停用,並停止接受新的實例。 了解更多

IBM Cloud® Continuous Delivery 包括 Delivery Pipeline,以用來實作可重複的持續整合及持續交付程序。

請完成下列作業來配置管線。

新增階段

  1. 在「管線」頁面上,按一下新增階段。 即會開啟「階段配置」頁面。

  2. 配置階段。

    a. 在輸入標籤上,選取階段的輸入。 針對「建置」階段,輸入標籤包括分支欄位,以指定儲存庫中要用於輸入的分支。

    b. 在工作標籤上,新增及配置至少一個工作。 第一個階段通常至少會有一個建置工作。

  3. 按一下儲存

將工作新增至階段

  1. 在階段上,按一下階段配置圖示,然後按一下配置階段
  2. 按一下工作標籤。
  3. 按一下新增工作。 選取要新增的工作類型。
  4. 配置工作。
  5. 按一下儲存

將作業新增至階段
將作業新增至階段

執行階段

按一下「管線」頁面上的執行階段圖示,即可手動執行階段。

點擊舞台上的「運行舞台」圖示
運行舞台

您也可以使用下列兩種方法的其中一種,從建置歷程頁面中要求依需求建置及部署:

  • 將建置拖曳至所配置階段下的方框。
  • 在「最近的執行結果」區段中,點擊「傳送至」圖示,然後選擇要部署到的空間。

帶有此建置圖示的執行階段
部署階段

若要取消執行中階段,請在階段上按一下檢視日誌及歷程。 在工作清單中,按一下執行中工作的號碼,然後按一下取消。 您也可以按一下工作、再按取消,或是按一下工作階段的停止圖示,來個別取消工作。

部署應用程式

只要執行工作,適當配置的部署工作就會將應用程式部署至目標。 若要手動執行部署工作,請按一下工作所在階段的執行階段圖示。

輸入修訂

當您手動執行階段時,或者它是在階段完成之前執行,則執行中階段會選取其輸入修訂。 輸入修訂通常是建置號碼。 為了選取輸入修訂,階段會遵循這些條件:

  • 如果已選取特定修訂,便會使用它。
  • 如果未指定特定修訂,則會搜尋先前的階段,直到找到使用相同輸入的階段。 尋找並使用該輸入的最後順利執行修訂。
  • 如果未指定特定修訂,而且沒有其他階段使用所指定的來源作為輸入,則會使用輸入的最新修訂。

您可以部署前一個建置。 在包含建置的階段上,按一下檢視日誌及歷程。 在開啟的頁面上,按一下以展開執行號碼,然後按一下建置工作。 按一下傳送至,然後選取目標。

將服務新增至應用程式

您可以從 IBM Cloud 儀表板新增服務至應用程式並管理那些服務。 如需新增服務的相關資訊,請參閱將服務連接至外部應用程式

檢視日誌

您可以在「階段歷程」頁面上檢視工作的日誌,以及檢視其執行的階段。

  1. 若要檢視工作的日誌,請按一下工作。 或者,在階段上按一下檢視日誌及歷程

  2. 若要檢視所部署應用程式的運行環境日誌,請按一下檢視運行環境日誌

    除了工作日誌之外,您還可以檢視任何建置工作的單元測試結果、所產生的構件,以及程式碼變更。

    您也可以從「階段歷程」頁面中執行、重新部署、取消或配置階段。 按一下執行以執行階段、重新部署以在它是部署工作時重新部署,或配置以配置階段。 在階段執行時,按一下執行號碼,然後按一下取消,即可予以取消。

從 Script 下載日誌

您可以從 Script 下載管線工作的日誌檔,並儲存管線工作執行時所提供的 PIPELINE_LOG_URL。 下列範例顯示將管線工作日誌檔上傳至不同系統的步驟。

  1. 設定階段的 JOB_LOG 環境內容。

  2. 在管線工作中,儲存 PIPELINE_LOG_URL

    export JOB_LOG="$PIPELINE_LOG_URL"
    
  3. 在相同階段的後面工作中使用 PIPELINE_LOG_URL 來下載日誌檔,以將它匯出至不同的系統。 使用 IBM Cloud 持有人記號來存取日誌檔。

    ibmcloud login -a cloud.ibm.com \
      --apikey <INSERT API KEY HERE>
    BEARER=$( ibmcloud iam oauth-tokens | grep "IAM token" | sed 's/^.*Bearer //g' )
    curl -H "Authorization: Bearer $BEARER"  \
      -H "Accept: text/plain" \
      -D /tmp/headers.txt \
      -o job_log.txt \
      "$JOB_LOG"
    
  4. 檢查 X-More-Data 標頭。 如果標頭設為 true,則會產生或處理日誌檔。 如果標頭設為 false,則日誌檔已備妥可供使用。

    grep X-More-Data /tmp/headers.txt
    X-More-Data: false
    
  5. 將日誌檔上傳至系統。

    scp job_log.txt user@example.org:/job1/logs
    

從 Script 下載構件

您可以從 Script 下載管線「建置」工作的構件,並儲存管線工作執行時所提供的 PIPELINE_ARTIFACT_URL。 下列範例顯示將管線工作構件上傳至不同系統的步驟。

  1. 設定階段的 JOB_ARTIFACT 環境內容。

  2. 在管線工作中,儲存 PIPELINE_ARTIFACT_URL

    export JOB_ARTIFACT="$PIPELINE_ARTIFACT_URL"
    
  3. 在相同階段的後面工作中使用 PIPELINE_ARTIFACT_URL 來下載構件,以將它們匯出至不同的系統。 使用 IBM Cloud 持有人記號來存取構件。

    ibmcloud login -a cloud.ibm.com \
      --apikey <INSERT API KEY HERE>
    BEARER=$( ibmcloud iam oauth-tokens | grep "IAM token" | sed 's/^.*Bearer //g' )
    DOWNLOAD_URL=$( curl -H "Authorization: Bearer $BEARER"  \
      "$JOB_ARTIFACT" )
    curl -O  "$DOWNLOAD_URL"
    
  4. 將構件上傳至系統。

    scp $(basename "$DOWNLOAD_URL") user@example.org:/job1/artifacts