定義及使用自訂目標類型

準備 Skaffold 設定

Cloud Deploy 會使用 Skaffold 提供詳細資訊，說明要部署哪些內容，以及如何將這些內容部署至目標。

在本快速入門導覽課程中，您將建立 skaffold.yaml 檔案，其中定義了代表自訂目標類型的轉譯和部署作業的自訂動作。

請注意，這個快速入門手冊中提供的自訂動作實際上並不會將任何應用程式部署至執行階段。轉譯和部署動作都會將結果檔案上傳至 Cloud Storage，以履行 Cloud Deploy 與使用者定義的轉譯和部署作業之間的客製目標合約。

1. 開啟終端機視窗。

2. 建立新目錄並前往該目錄。

   mkdir custom-target-quickstart
   cd custom-target-quickstart
   

3. 建立名為 skaffold.yaml 的檔案，並在當中加入下列內容：

   apiVersion: skaffold/v4beta7
   kind: Config
   customActions:
   - name: custom-render
     containers:
     - name: render
       image: gcr.io/google.com/cloudsdktool/google-cloud-cli@sha256:484e8266c1cfc84b283bc6d4eec1f6b61223115178cce76fb59f77b223f26e8e
       command: ['/bin/bash']
       args:
         - '-c'
         - |-
           echo "Sample manifest rendered content" > manifest.txt
           gcloud storage cp manifest.txt $CLOUD_DEPLOY_OUTPUT_GCS_PATH/manifest.txt
           echo {\"resultStatus\": \"SUCCEEDED\", \"manifestFile\": \"$CLOUD_DEPLOY_OUTPUT_GCS_PATH/manifest.txt\"} > results.json
           gcloud storage cp results.json $CLOUD_DEPLOY_OUTPUT_GCS_PATH/results.json
   - name: custom-deploy
     containers:
     - name: deploy
       image: gcr.io/google.com/cloudsdktool/google-cloud-cli@sha256:484e8266c1cfc84b283bc6d4eec1f6b61223115178cce76fb59f77b223f26e8e
       command: ['/bin/bash']
       args:
         - '-c'
         - |-
           echo {\"resultStatus\": \"SUCCEEDED\"} > results.json
           gcloud storage cp results.json $CLOUD_DEPLOY_OUTPUT_GCS_PATH/results.json
   

   這個檔案包含 customActions: 節，定義自訂轉譯動作和自訂部署動作。每個自訂動作都會參照要執行的容器映像檔，以及要在該容器中執行的指令。

   如要進一步瞭解這個設定檔，請參閱 skaffold.yaml 參考資料。

建立推送管道、自訂目標類型和目標

您可以在單一檔案或個別檔案中定義提交管道、自訂目標類型和目標。在本快速入門導覽課程中，您會建立包含所有這三種內容的單一檔案。

1. 在 custom-target-quickstart 目錄中，建立名為 clouddeploy.yaml 的新檔案，並在其中加入下列內容：

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: custom-targets-pipeline
   serialPipeline:
     stages:
     - targetId: sample-env
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: sample-env
   customTarget:
     customTargetType: basic-custom-target
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: CustomTargetType
   metadata:
     name: basic-custom-target
   customActions:
     renderAction: custom-render
     deployAction: custom-deploy
   

2. 使用 Cloud Deploy 服務註冊管道和目標：

   gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
   

   您現在有一個含有一個目標的推送管道。這是使用自訂目標類型的目標，而且這個管道不會將應用程式部署至執行階段。

3. 確認管道和目標：

   在 Google Cloud 控制台中，前往 Cloud Deploy 的「Delivery pipelines」(推送管道) 頁面，查看可用的推送管道清單。

   開啟「Delivery pipelines」頁面

   系統會顯示您剛建立的推送管道，並在「目標」欄中列出一個目標。

   

建立版本

版本是代表待部署變更的集中式 Cloud Deploy 資源。發布管道會定義該版本的生命週期。如要進一步瞭解這個生命週期，請參閱 Cloud Deploy 服務架構。

從 custom-target-quickstart 目錄執行下列指令，建立代表要部署的自訂動作的 release 資源：

gcloud deploy releases create test-release-001 \
  --project=PROJECT_ID \
  --region=us-central1 \
  --delivery-pipeline=custom-targets-pipeline

如同所有版本 (除非包含 --disable-initial-rollout)，Cloud Deploy 也會自動建立rollout 資源。並執行該推播作業的所有階段，包括算繪和部署。

在 Google Cloud 控制台中查看結果

幾分鐘後，部署作業就會完成。在本例中，由於這兩個自訂動作是用來將字串回應至檔案，並將檔案上傳至 Cloud Storage 的指令，因此不會將任何內容部署至任何目標執行階段。

不過，您可以查看該檔案和檔案中的字串：

1. 在 Google Cloud 控制台中，前往 Cloud Deploy 的「Delivery pipelines」(推送管道) 頁面，查看推送管道 (custom-targets-pipeline)。

   開啟「Delivery pipelines」頁面

2. 按一下推送管道名稱 (custom-targets-pipeline)。

   管道示意圖會顯示應用程式的部署狀態。由於管道中只有一個階段，因此視覺化資訊只會顯示一個節點。

   

   你的版本會列在「發布管道詳細資料」下方的「版本」分頁中。

3. 按一下版本名稱。

   系統會顯示「Release details」(發布詳細資料) 頁面。

4. 按一下「Artifacts」分頁標籤。

5. 在「目標構件」下方，按一下「查看構件」連結。

   系統會顯示已轉譯的資訊清單檔案。在這種情況下，檔案是您在 skaffold.yaml 設定檔中定義的自訂轉譯動作輸出內容，其中包含「Sample manifest rendered content」字串。

   

6. 找出這個版本建立的 Cloud Storage 值區。

   開啟 Cloud Storage 瀏覽器頁面

   系統會顯示「Buckets」頁面，其中列出為此版本建立的兩個值區。一個值區包含提交管道設定檔和轉譯的 skaffold.yaml。另一個則包含自訂動作設定為建立的輸出檔案。

7. 按一下名稱開頭為 us-central1.deploy-artifacts 的值區...

   

8. 按一下名稱開頭為 custom-targets-pipeline- 的資料夾，然後按一下 test-release-001 資料夾。

9. 按一下名稱為您所選推播名稱的資料夾，該資料夾應為 test-release-001-to-sample-env-0001。

10. 按一下顯示的資料夾 (即 UUID)，然後點選 custom-output 資料夾。

11. 按一下 results.json，然後點選「Authenticated URL」欄位中的超連結網址。

    這個檔案包含您在 skaffold.yaml 中，將做為 custom-deploy 動作輸出的字串：