Alibaba Cloud DevOps：主機部署

方案概覽

1. 接入新主機：建立主機群組並接入新主機。

2. 添加主機部署任務：建立或添加主機部署任務到流水線中。

3. 配置主機部署任務：設定主機部署任務的相關參數。

4. 管理主機部署任務：查看部署詳情和部署歷史復原。

接入新主機

1. 在流水線 Flow首頁，單擊全域設定，然後單擊主機群組管理。

2. 在主機群組管理頁面，選擇目標主機群組，然後在目標主機群組頁面，單擊添加新主機，流水線 Flow支援通過以下方式接入主機。

   如果還未建立主機群組，請參見建立主機群組。

   手動安裝Runner

   說明

   此方式適用於接入所有類型的主機，包括阿里雲 ECS 和其他非阿里雲主機。

   1. 在接入新主機頁面，添加方式選擇手動安裝Runner。

   2. 複製 Runner 安裝命令並在需要添加的主機（該主機必須要能訪問公網）上執行。選擇作業系統類型為Linux，在接入主機地區，複製安裝命令並在待接入主機上執行。該命令包含Runner版本、Token、AccessKey等參數，且有到期時間限制，請在有效期間內完成執行。執行完成後單擊我知道了。

      主機終端列印以下資訊即表示接入成功。

      INFO[2025-04-29T13:34:12+08:00] service type linux-systemd, user , realUser root 
      INFO[2025-04-29T13:34:12+08:00] Aliyun yunxiao runner-v0.3.1-be-d5zh**** service started 
      INFO[2025-04-29T13:34:12+08:00] Aliyun yunxiao runner-v0.3.1-be-d5zh**** service status running 

   3. Runner 安裝成功後，新機器就會自動添加至當前主機群組，請重新整理主機列表後查看。

   說明

   • 將應用部署到自有主機（非阿里雲 ECS）不需要企業版，標準版即可使用。自有主機通過手動安裝Runner方式接入，建立流水線時選擇包含主機部署的模板（如 Java · 測試、構建、部署到阿里雲ECS/自有主機）。

   • 如果需要在遠程主機上免密執行命令，請使用主機部署步驟（需預先安裝 Runner），而非執行Shell步驟——執行Shell不支援直接免密串連 ECS。

添加主機部署任務

可以通過兩種方式添加主機部署任務。

配置主機部署任務

本文以部署Java 範例程式碼為例，為您講述如何配置部署任務。其中Java 測試構建階段的配置請參見測試構建，注意在配置構建物上傳時，將倉庫中deploy.sh檔案一起上傳到製品倉庫，後續部署 Java 專案時需要用到。

1. 選擇部署時下載製品。預設已勾選，注意不要取消。

2. 選擇製品名稱。

3. 選擇需要部署的主機群組。如果還未建立，您可單擊建立主機群組建立，詳情請參見主機群組管理。

   重要

   主機群組用於管理部署的資源和配置。主機群組中的主機必須安裝 Java 運行環境。

4. 部署配置。

   配置項	說明
   下載路徑	將製品下載到你的主機上的路徑，
   執行使用者	配置執行命令的使用者，如root。
   部署指令碼	在目標主機上執行的 Shell 部署指令碼。該欄位為非必填項：若不填寫，部署時僅將製品下載到指定的下載路徑，不會執行任何額外操作（不報錯）。您需要自行編寫解壓、配置及啟動邏輯，才能完成實際部署。 內聯指令碼存在字元數量限制，若指令碼較長，建議將完整的 Shell 指令檔上傳至 Git 程式碼程式庫或提前放置在目標伺服器上，在部署指令碼輸入框中通過命令調用執行，例如 sh /home/admin/deploy.sh。以下為基礎樣本： mkdir -p /home/admin/application tar zxvf /home/admin/app/package.tgz -C /home/admin/application/ sh /home/admin/application/deploy.sh restart 其中 deploy.sh 是一個啟動 Jar 包的 Shell 指令碼，實際使用時請替換為您的部署指令碼。

   重要

   Flow 在部署過程中，會下發部分以rdc_deploy_command_開頭的部署進程，請勿在部署指令碼中對此類部署進程進行操作，否則可能會導致部署失敗。

   多服務獨立部署

   當一台伺服器上需要部署多個服務且各服務需獨立發布時，建議為每個服務建立獨立的主機群組（可包含同一台伺服器），並在流水線中為每個服務配置獨立的主機部署任務。通過指定不同的下載路徑和部署指令碼，實現各服務之間的隔離部署。

   並存執行指令碼

   若需在同一台主機上並存執行多個指令碼任務，可在流水線中添加一個額外的主機部署組件，取消勾選部署時下載製品，直接在部署指令碼中編寫指令碼命令。由於不下載製品，該組件可與其他部署任務並行運行，適用於需要同時執行輔助操作（如日誌清理、配置重新整理）的情境。

5. 配置部署策略。

   如果您需要一次發布多台主機，Flow 支援分批發布，您可在主機部署任務中指定對應的部署策略。假如您有 4 台主機，選擇分 2 批發布，則每一批自動發布 2 台主機。

   暫停方式	說明
   第一批暫停	第一批發布完成後，您可先進行驗證，點擊繼續後可執行後續發布。
   不暫停	每一批發布完成後，自動執行後續批次的發布。
   每批暫停	每一批發布完後，都需要手動確認是否繼續發布。

   分批數量：指定主機分批的數量，指定分批發布的數量，會按照相應的數量進行分批部署。

整體配置參考以上各項參數說明。

mkdir -p /usr/share/nginx/html
tar zxvf /home/admin/app/package.tgz -C /usr/share/nginx/html/

mkdir -p /app/jar/zh
tar zxvf /home/admin/app/package.tgz -C /app/jar/zh/
cd /app/jar/zh && sh start.sh

# 解壓製品到部署目錄
mkdir -p /home/admin/app
tar zxvf /home/admin/app/package.tgz -C /home/admin/app/

# 進入專案目錄並啟動服務
cd /home/admin/app
docker-compose up -d

管理主機部署任務