使用 Cloud Build 自動執行建構作業

建立範例 GitHub 存放區分支並加以複製

1. 如果您尚未建立帳戶，請前往 GitHub 建立帳戶。

2. 如果您已在 GitHub 中設定雙重驗證功能，請透過指令列建立個人存取權杖來取代 GitHub 密碼。

3. 建立 cloud-build-samples 存放區分支，並新增至您的 GitHub 帳戶：

   1. 前往 Cloud Build 中的 cloud-build-samples 存放區。

   2. 按一下頁面右上角的「分支」圖示。

   3. 按一下要建立存放區分支的目標 GitHub 使用者帳戶。

      系統會自動將您重新導向至含有 cloud-build-samples 存放區分支版本的頁面。

4. 在本機環境中開啟終端機。

5. 執行下列指令來複製存放區的分支版本，其中 GITHUB_USERNAME 為您的 GitHub 帳戶使用者名稱：

   git clone https://github.com/GITHUB_USERNAME/cloud-build-samples.git

將 Cloud Build 連結至存放區

1. 在 Google Cloud 控制台導覽選單中，依序點選「Cloud Build」>「Triggers」(觸發條件)。

   開啟「觸發條件」頁面

2. 選取您的專案，然後按一下「Open」。

3. 按一下「Connect repository」(連結存放區)。

4. 選取「Select source」(選取來源) 下方的 「GitHub (Cloud Build GitHub App)」(GitHub (Cloud Build GitHub 應用程式))。

5. 按一下「Continue」(繼續)。

6. 驗證 GitHub 帳戶。

7. 在「Select repostory」(選取存放區) 專區中，選取「GitHub account」(GitHub 帳戶) 的使用者名稱。如果清單中未顯示您的使用者名稱，請按照下列指示操作：

   1. 按一下「GitHub account」(GitHub 帳戶) 清單中的「+Add」(+新增)。

      畫面中會顯示彈出式視窗，方便您安裝 Cloud Build GitHub 應用程式。

   2. 按一下您的 GitHub 使用者名稱。

   3. 按一下「Only certain repositories」(僅限特定存放區)，在特定存放區中安裝 Cloud Build GitHub 應用程式。

   4. 在下拉式選單中選取「GITHUB_USERNAME/cloud-build-samples」，其中 GITHUB_USERNAME 是您的 GitHub 帳戶使用者名稱。

   5. 按一下 [安裝]。

      在繼續操作之前，系統可能會要求您輸入與 GitHub 帳戶相關聯的密碼。

   6. 安裝 Cloud Build GitHub 應用程式之後，您就能在「GitHub account」(GitHub 帳戶) 欄位的下拉式選單中看見自己的使用者名稱。選取您的使用者名稱。

8. 選取「Repository」(存放區) 下方的「GITHUB_USERNAME/cloud-build-samples」這個存放區。

9. 按一下勾號來同意觸發條件連線的條款及細則。

10. 按一下「Connect」(連結)。

11. 按一下「Done」(完成)。

建立觸發條件

1. 在 Google Cloud 控制台中開啟「Triggers」頁面：

   開啟「觸發條件」頁面

2. 在頁面頂端的專案選取器下拉式選單中選取專案。

3. 按一下「開啟」。

4. 按一下「Triggers」(觸發條件) 頁面中的「Create trigger」(建立觸發條件)。

5. 在「Create trigger」(建立觸發條件) 頁面中輸入下列設定：

   • 「Name」(名稱)：輸入 hello-world-trigger 來當做觸發條件的名稱。

   • 「Event」(事件)：選取「Push to a branch」(推送至分支版本) 來當做叫用觸發條件的存放區事件。

   • 「Source」(來源)：選取「cloud-build-samples」存放區來當做來源，當中包含原始碼和建構設定檔。

   • 「Build Configuration」(建構設定)：選取「Cloud Build configuration file」(Cloud Build 設定檔) 來當做建構設定檔。

   • 「Cloud Build configuration file location」(Cloud Build 設定檔位置)：將 Cloud Build 設定檔的路徑指定為 quickstart-automate/cloudbuild.yaml。

6. 按一下「Create」(建立) 來儲存自動建構觸發條件。

修訂變更

在本節中，您將在自己的 GitHub 帳戶中，將變更提交至複製的 cloud-build-samples 存放區。

1. 在終端機中前往 quickstart-automate 目錄：

   cd cloud-build-samples/quickstart-automate

2. 開啟 main.go 檔案，並更新包含「Hello, world!」的程式碼行。改為「Hello, universe!」

     package main
   
     import (
         "fmt"
     )
   
     func main() {
         fmt.Println("Hello, universe!")
     }
     

3. 查看 cloudbuild.yaml，這是 Cloud Build 使用的建構設定檔。透過觸發條件叫用建構作業時，這個檔案中的建構步驟會指示 Cloud Build 使用 Docker Hub 中的 golang 映像檔來建立及執行 main.go 檔案。

      steps:
      - name: golang
        script: go run quickstart-automate/main.go
      

4. 返回存放區的根目錄：

      cd ..

5. 執行下列指令來修訂 GitHub 變更：

       
       git add quickstart-automate/main.go
       git commit -m "update text"
       git push

   將程式碼推送至存放區時，系統可能會提示您輸入憑證。如果系統顯示提示訊息，請輸入您的使用者名稱和密碼或驗證權杖。

您已成功將變更推送至存放區，接著觸發條件會自動執行建構作業。

查看建構作業詳細資料

1. 在 Google Cloud 控制台導覽選單中，依序點選「Cloud Build」>「History」(記錄)。

   開啟 Cloud Build 頁面

2. 選取您的專案並按一下 [Open] (開啟)。

   畫面會顯示「Build history」(建構歷史記錄) 頁面：

   

3. 在「Build」(建構作業) 欄中，按一下建構作業的名稱。

4. 按一下「Build details」(建構作業詳細資料) 頁面中的「Build Artifacts」(建構作業構件)。

   畫面會顯示類似以下的輸出：

   

5. 如要查看建構作業的記錄檔，請點選「下載」圖示並瀏覽下載的檔案。

您已成功使用觸發條件叫用 Cloud Build 建構作業，並查看建構作業的詳細資料。