建立「部署至 IBM Cloud」按鈕

「部署至 IBM Cloud」按鈕可讓您有效率地共用您的公用 Git 來源應用程式，讓其他人能夠試用程式碼，並使用工具鏈將其部署至 IBM Cloud。此按鈕需要的配置最少，而且您可以將其插入到任何支援標記的地方。按一下此按鈕的任何人都會在新的 Git 儲存庫中建立程式碼的複製副本，因此原始應用程式不受影響。

當有人按一下您的按鈕時，就會進行下列動作：

如果該人員沒有作用中的 IBM Cloud 帳戶，則必須建立帳戶。他們可以建立試用帳戶或實際帳戶。
使用者可點擊「Delivery Pipeline」圖示，選擇區域、資源群組及應用程式名稱。建議的應用程式名稱會與工具鏈名稱相同，而工具鏈名稱是建構自原始 Git 儲存庫的名稱及時間。您也可以編輯工具鏈名稱。
即會建立工具鏈，其中包括 Git 儲存庫的新專用複本、用於建置及部署程式碼變更的管線，以及問題追蹤器。

如果 .bluemix 目錄包含 toolchain.yml 檔案，則會使用此檔案來指定工具鏈的工具整合。有關 toolchain.yml 檔案的更多資訊，請參閱《建立自訂工具鏈範本》。
如果應用程式需要建置檔，則會自動偵測建置檔，並建置應用程式。
如果針對建置及部署處理程序配置管線，則會使用 pipeline.yml 檔案來部署應用程式。
如果應用程式需要容器，則會使用定義 IBM Cloud Kubernetes Service 的 pipeline.yml 檔案以及定義映像檔的 Dockerfile，在 IBM Cloud Kubernetes Service 中部署應用程式。
應用程式會部署至該人員所選取的 IBM Cloud 組織。

按鈕的範例

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

請參閱公用 Git Repos and Issue Tracking 儲存庫的應用程式按鈕範例：

請參閱公用 GitHub 儲存庫的應用程式按鈕範例：

建立按鈕

若要建立「部署至 IBM Cloud」按鈕，請複製並修改下列其中一個 Snippet 範本。請在 URL 中指定 Git 儲存庫及分支。

以 HTML 建立按鈕

若要以 HTML 建立按鈕，請複製此 Snippet，並插入公用 Git 儲存庫 URL 及分支。

<a href="https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>"><img src="https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg" alt="Deploy to IBM Cloud" target="_blank"></a>

如果您未在 Snippet 的儲存庫 URL 中包括 branch 參數，則「部署至 IBM Cloud」按鈕會預設為儲存庫的主要分支。

以 Markdown 建立按鈕

若要以 Markdown 建立按鈕，請複製此 Snippet，並插入公用 Git 儲存庫 URL 及分支。

[![Deploy to IBM Cloud button](https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg)](https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>)

如果您未在 Snippet 的儲存庫 URL 中包括 branch 參數，則「部署至 IBM Cloud」按鈕會預設為儲存庫的主要分支。

使用按鈕 Snippet

在您建立「部署至 IBM Cloud」按鈕 Snippet 之後，可以將它插入至部落格、文章、Wiki、Readme 檔，或您要推銷應用程式的任何其他位置。

當您自訂「部署至 IBM Cloud」按鈕的程式片段時，請注意這兩種範本皆使用預設路徑，指向一個以 SVG 格式儲存且標示為英文的外部按鈕圖片。如果您偏好在本端儲存影像，則可以下載影像，並將它儲存在 Git 儲存庫中。請調整路徑來使用影像的相對位置。

儲存庫考量

請針對「部署至 IBM Cloud」按鈕中所使用的儲存庫，檢閱這些考量。

建置檔需求

如果必須先建置應用程式，才能進行部署，您必須在儲存庫中包括建置檔。如果在儲存庫的根目錄中偵測到建置 Script 檔，則會在部署之前觸發自動建置程式碼。

支援的建置器包括：

Ant： build.xml，此指令會將建置結果輸出至 ./output/ 資料夾
Gradle: /build.gradle，用於建置 . 資料夾的輸出
Grunt： /Gruntfile.js，其建置結果會輸出至 . 資料夾
Maven： /pom.xml，其建置結果會輸出至 ./target/ 資料夾

管線檔需求

若要在 .bluemix 目錄中配置工具鏈的管線，請包括 pipeline.yml 檔案。針對該目錄中的每一個 pipeline.yml 檔案，會在實例化工具鏈時建立管線。

若要建立管線檔案，請參閱《建立自訂工具鏈範本》文件中的範例檔案。就像當您在 Web 介面中定義管線時，會建立階段及工作、設定輸入及環境變數，以及新增 Script，以文字定義管線。您還可以在這個示範專案中看到一些較複雜的管線檔案。

容器 Dockerfile 需求

若要使用 IBM Cloud Kubernetes Service 在容器中部署應用程式，您必須在儲存庫的根目錄中包含 Dockerfile，並在 .bluemix 目錄中包含 pipeline.yml 檔案。

Dockerfile 用來作為應用程式的一種建置 Script。如果在儲存庫中偵測到 Dockerfile，會先將應用程式自動建置成映像檔，再部署在容器中。如果必須先建置應用程式本身，再將應用程式建置成映像檔，請包含應用程式的建置 Script 以及 Dockerfile。

如需進一步了解如何建立 Dockerfile，請參閱 Docker 上的文件。若要進一步瞭解 Kubernetes，請參閱 IBM Cloud Kuberenetes 服務。

若要手動建立專用於容器的 pipeline.yml，請參閱 GitHub 中的範例。