部署前端應用程式

1. 若要部署新的 Code Engine 應用程式，請執行下列指令; 提供服務名稱 frontend 及預先建置的儲存器映像檔作為 --image 旗標的參數。

   ibmcloud code-engine application create --name frontend --image icr.io/solution-tutorials/tutorial-text-analysis-code-engine-frontend
   

   執行此指令後，您應該會看到一些輸出，其中包含您應用程式的 URL。 它應該看起來如下: https://frontend.305atabsd0w.us-south.codeengine.appdomain.cloud。 複製或記下此應用程式 URL，以便進行下一步。 只需這兩項資料（應用程式名稱和影像名稱），Code Engine 就已部署您的應用程式，並會為您處理複雜的設定和管理。

   GitHub 儲存庫 中提供用來建置容器映像檔的應用程式原始碼，供您參考。 如果您想要從原始碼建置容器映像檔，並將映像檔推送至專用 Container Registry，請遵循 這裡的指示。

2. 在瀏覽器中開啟上一步的應用程式 URL，即可看到類似此處的輸出：

   

   執行 ibmcloud code-engine application get -n frontend 指令，以查看應用程式的詳細資料。 您應該會看到一些詳細資訊，例如 ID、專案資訊、應用程式的年齡、存取應用程式的 URL、存取應用程式組態的 Console URL、影像、資源分配，以及應用程式的各種修訂、條件和執行時間。 由於您只有一個修訂，您應該會看到 100% 的資料流量會進入最新修訂。 您也可以檢查實例數及其狀態。

3. 如需疑難排解及 檢查應用程式的日誌，請執行下列指令，將 <INSTANCE_NAME> 取代為 ibmcloud code-engine application get -n frontend 指令中其中一個實例的 名稱。

   如果您沒有看到任何正在執行的實體，請確定再次開啟步驟 2 中的應用程式 URL。

   ibmcloud code-engine application logs --instance <INSTANCE_NAME>
   

   如果應用程式在執行中，您應該會看到 backend URL: undefined 和應用程式在埠 8080 上接聽。 稍後在指導教學中，您將將此前端應用程式連接至我們的後端應用程式

恭喜!! 您剛剛使用簡式指令將 Web 應用程式部署至 Code Engine，而且不需要瞭解 Kubernetes 的複雜性 (例如 Pod、部署、服務及入口)。

調整應用程式

當您使用 application create 指令建立應用程式時，您只會傳入要使用的映像檔及應用程式名稱。 雖然這是要部署應用程式的最小資訊量，但您可以控制 許多其他旋鈕。 此外，您可以設定每個實例可以同時處理的要求數目、應用程式實例的 CPU 數量、應用程式實例的記憶體數量、應用程式的環境變數、可用於此應用程式的實例數目上限及下限，以及應用程式接聽要求的埠。

如果在建立應用程式時未提供任何選項，則大部分這些值都已設定預設值。 因為我們未提供值，所以 Code Engine 已部署我們的應用程式，預設小數位數上限為 10，這表示它只會將我們的應用程式調整為最多 10 個實例。 預設最小比例是零，因此當我們的應用程式不再使用時，它會將自己縮減回零。

1. 若要檢查 Code Engine的自動調整功能，我們可以使用負載產生器對我們的服務執行要求。 下列 Shell Script 會模擬 3000 個要求的基本負載。

   1. 開啟本端終端機視窗 (Shell)。

   2. 為上述步驟中的前端應用程式 URL 建立 shell 變數。

      export APPURL=<frontend-application-url>
      

   3. 執行下列 Script 以產生部分負載。 您可以重複它來建立更多資料流量。

      seq 1 3000 | xargs -n1 -P300  curl -s  $APPURL -o /dev/null
      

2. 在前幾節的 Cloud Shell 階段作業中，執行下列指令以查看實例 (Pod) 計數作為自動調整的一部分增量。

   ibmcloud code-engine application get -n frontend
   

   依預設，每個實例可以同時處理的要求數上限 10 會導致自動調整，且可以搭配使用 --concurrency or -cn 旗標與 application update 指令來變更此值。

3. 如果您不想要容許建立多達 10 個實例，則可以將最大小數位數調整為較低的數字。 雖然您的無伺服器應用程式可以輕鬆擴增，但您可能依賴下游服務 (例如只能處理有限數目連線的 SQL DB 或另一個速率受限 API)。 讓我們嘗試限制此前端應用程式的實例數。

   ibmcloud code-engine application update --name frontend --max-scale 5
   

4. 一旦停止產生負載，請等待幾分鐘，以看到實例終止，最後縮減到零個實例。

5. 在具有負載產生器指令的本端視窗中，重新執行 Script 以針對應用程式建立要求。 在 Cloud Shell 階段作業中，執行 ibmcloud code-engine application get -n frontend 指令以查看實例計數增加至 5。

   預期輸出：

   Name                                        Revision        Running  Status   Restarts  Age
   frontend-00002-deployment-77d5fbfb5d-7zpfl  frontend-00002  3/3      Running  0         70s
   frontend-00002-deployment-77d5fbfb5d-kv6rn  frontend-00002  3/3      Running  0         69s
   frontend-00002-deployment-77d5fbfb5d-mhlwn  frontend-00002  3/3      Running  0         68s
   frontend-00002-deployment-77d5fbfb5d-qkjmd  frontend-00002  3/3      Running  0         67s
   frontend-00002-deployment-77d5fbfb5d-zpr9n  frontend-00002  3/3      Running  0         85s
   

部署後端應用程式並測試連線

1. 若要部署新的後端應用程式以將文字檔儲存至 IBM Cloud Object Storage，請執行下列指令:

   ibmcloud code-engine application create --name backend --image icr.io/solution-tutorials/tutorial-text-analysis-code-engine-backend --cluster-local
   

   --cluster-local 旗標會指示 Code Engine 將此應用程式的端點保持為專用，這表示它只能從專案內使用。 這通常用於安全目的。 在此情況下，沒有理由公開具有公用端點的後端應用程式，因為不會從叢集外部存取它。

2. 複製並儲存輸出中的內部端點 URL )，以便在下一個指令中使用。 它看起來像這樣：

   BACKEND_PRIVATE_URL=http://backend.xxxxxx
   

   您可以執行 ibmcloud code-engine application get -n backend 指令來檢查後端應用程式的狀態和詳細資訊，其中包括 URL。

3. 前端應用程式使用環境變數 (BACKEND_URL) 來瞭解後端應用程式的管理位置。 您現在需要更新前端應用程式，以將此值設為指向後端應用程式的端點。

   ibmcloud code-engine application update --name frontend --env BACKEND_URL=$BACKEND_PRIVATE_URL
   

   如果您需要設定多個環境變數，--env 旗標可以顯示任意次數。 如果您當時知道前端應用程式的值，也可以在 ibmcloud code-engine application create 指令上使用此選項。 請閱讀 使用環境變數 文件主題，以進一步瞭解。

4. 在瀏覽器上硬刷新前端 URL，以測試與後端應用程式的連線。 您應該會看到一個頁面，其中有上傳文字檔案(.txt)的選項，同時也會看到後端應用程式的錯誤訊息，因為後端仍未連接所需的 IBM Cloud 服務來儲存和處理文字檔案。 按一下 上傳文字檔 也應該會顯示類似的錯誤訊息。

佈建 Object Storage 及 Natural Language Understanding 服務

1. 建立 Object Storage 的實例

   1. 如果帳戶中已有 Object Storage 服務實例，請選取精簡方案或標準方案。
   2. 將 服務名稱 設為 your-initials-code-engine-cos。
   3. 選取您在其中建立 Code Engine 專案的資源群組。
   4. 按一下建立。
   5. 擷取 Shell 變數中的服務名稱:

      COS_INSTANCE_NAME=your-initials-code-engine-cos
      

2. 在 建立儲存區 下按一下 建立儲存區，然後在 建立自訂儲存區 下選取 建立。

   當您建立儲存區或新增物件時，請務必避免使用「個人識別資訊 (PII)」。附註 :PII 是可依名稱、位置或任何其他方法識別任何使用者 (自然人) 的資訊。

   1. 輸入 唯一儲存區名稱，例如 <your-initials>-bucket-code-engine。
   2. 選取您在其中建立 Code Engine 專案的 位置。
   3. 選取 智慧型層級 儲存類別。
   4. 按一下建立儲存區。
   5. 擷取 Shell 變數中的儲存區名稱:

      COS_BUCKETNAME=your-initials-bucket-code-engine
      

3. 在儲存區頁面上。

   1. 按一下組態索引標籤
   2. Direct 端點將保留 IBM Cloud內的資料。 擷取 Shell 變數中的直接端點。 在美國南部達拉斯地區，可能是：

      COS_ENDPOINT=s3.direct.us-south.cloud-object-storage.appdomain.cloud
      

4. 建立 Natural Language Understanding 的實例

   1. 選取位置並選取 精簡 方案。
   2. 將 服務名稱 設為 code-engine-nlu，並選取您在其中建立 Code Engine 專案的資源群組。
   3. 閱讀授權合約，然後勾選 我已閱讀並同意下列授權合約:。
   4. 按一下建立。
   5. 擷取 Shell 變數中的服務名稱:

      NLU_INSTANCE_NAME=YourServiceName
      

將 Object Storage 服務綁定至後端應用程式

現在，您需要將您剛建立之 IBM Cloud Object Storage 實例的認證傳入後端應用程式。 作法是將 Object Storage 服務 連結 至應用程式，這會自動將服務的認證新增至應用程式或工作的環境變數。

1. 使用字首 COS 建立 Object Storage 服務的連結，以方便在應用程式中使用。 bind 指令會在服務實例中建立服務認證，並使用認證來起始設定應用程式的環境變數。 您可以使用 --prefix 旗標，將每一個服務連結配置成使用自訂環境變數字首。

   ibmcloud code-engine application bind --name backend --service-instance $COS_INSTANCE_NAME --role Writer --prefix COS
   

2. 您還需要為應用程式提供您要在其中儲存文字檔的儲存區名稱，以及 COS 端點。 這兩個都在先前的步驟中定義。 us-south 的 智慧型層級 端點為 s3.direct.us-south.cloud-object-storage.appdomain.cloud。

   定義配置對映 以保留儲存區名稱及端點，因為資訊不敏感。 ConfigMaps 是一個 Kubernetes 物件，可讓您取消配置構件與映像檔內容的連結，以保持儲存器化應用程式的可攜性。 您可以從檔案或鍵值組建立此 configmap -- 目前我們將使用具有 --from-literal 旗標的鍵值組。 驗證您先前已擷取這些，並建立 configmap:

   echo bucket $COS_BUCKETNAME endpoint $COS_ENDPOINT
   

   ibmcloud code-engine configmap create --name backend-configuration --from-literal=COS_BUCKETNAME=$COS_BUCKETNAME --from-literal=COS_ENDPOINT=$COS_ENDPOINT
   

3. 定義了 configmap 之後，您現在可以透過要求 Code Engine 在應用程式執行時期根據 configmap 中的值設定環境變數，來更新後端應用程式。 使用下列指令更新後端應用程式

   ibmcloud code-engine application update --name backend --env-from-configmap backend-configuration
   

   若要建立密鑰，您需要使用 --env-from-secret 旗標。 密鑰和 configmap 都是 "maps"; 因此環境變數集將具有與那些對映中每一個項目的 "key" 相對應的名稱，且環境變數值將是該 "key" 的值。

4. 驗證是否已使用連結及 configmap 來更新後端應用程式。 您可以執行下列指令，並在輸出中尋找 Service Bindings 和 Environment Variables 區段

   ibmcloud code-engine application get --name backend
   

5. 跳至前端使用者介面及 上傳文字檔 以進行文字分析。 您應該會看到上傳的檔案，其中含有 Not analyzed 標籤。

建立工作

工作 與回應傳入 HTTP 請求的應用程式不同，它是用來執行容器映像的，這些映像包含一個可執行檔，目的是執行一次後就退出。 建立 job 時，您可以指定每次執行工作時使用的工作量配置資訊。 您可以從主控台或 CLI 建立工作。

此工作會從 IBM Cloud Object Storage讀取文字檔，然後使用 Natural Language Understanding 服務來分析它們。 它將需要存取這兩個服務的服務認證。

1. 執行下列指令以建立工作、

   ibmcloud code-engine job create --name backend-job --image icr.io/solution-tutorials/tutorial-text-analysis-code-engine-backend-job --env-from-configmap backend-configuration
   

   您可以使用 --env 旗標來設定 Natural Language Understanding 服務的版本。 對於版本化，請勾選此 鏈結

將 IBM Cloud 服務連結至工作

1. 讓我們為 Object Storage 服務建立一個字首為 COS_JOB 的連結，以與工作搭配使用來讀取上傳的檔案並儲存結果，

   ibmcloud code-engine job bind --name backend-job --service-instance $COS_INSTANCE_NAME --role Writer --prefix COS_JOB
   

2. 同樣地，讓我們以字首 NLU_JOB 來連結 Natural Language Understanding 服務，以分析上傳的文字檔，

   ibmcloud code-engine job bind --name backend-job --service-instance $NLU_INSTANCE_NAME --role Writer --prefix NLU_JOB
   

3. 驗證是否使用連結及 configmap 來更新工作。 您可以執行下列指令，並在輸出中尋找 Service Bindings 和 Environment Variables 區段

   ibmcloud code-engine job get --name backend-job
   

執行工作

1. 若要使用上述建立的配置來 執行工作，請使用 jobrun submit 指令，

   ibmcloud code-engine jobrun submit --name backend-jobrun --job backend-job
   

   當您執行工作時，可以置換您在工作配置中設定的許多變數。 若要檢查變數，請執行 ibmcloud code-engine jobrun submit --help。

2. 若要檢查 jobrun 的狀態，請執行下列指令

   ibmcloud code-engine jobrun get --name backend-jobrun
   

3. 可以顯示日誌:

   ibmcloud code-engine jobrun logs --follow --name backend
   

4. 在前端使用者介面中，按一下 重新整理 按鈕 (在上傳文字檔旁邊)，以查看每一個已上傳文字檔的 關鍵字 及 JSON。 每一個檔案上的標籤現在應該會變更為 Analyzed。

5. 按一下 刪除 圖示，以上傳新檔案或刪除個別檔案，然後使用下列指令重新提交 jobrun，並按 重新整理 按鈕以查看結果。

   ibmcloud code-engine jobrun resubmit --jobrun backend-jobrun
   

自動化工作執行

您可以建立 IBM Cloud Object Storage 訂閱來接聽 Object Storage 儲存區的變更，以自動執行工作，而不是手動執行工作。 當您建立儲存區的 訂閱 時，您的工作會收到該儲存區每一個成功變更的個別事件。

1. 您必須先將 Notifications Manager 角色指派給 Code Engine，才能建立 Object Storage 訂閱。 作為通知管理程式，Code Engine 可以檢視、修改及刪除 Object Storage 儲存區的通知。 遵循這裡的指示，將通知管理員角色指派給 Code Engine 專案。
2. 執行下列指令，以將 backend-job 連接至 IBM Cloud Object Storage 事件生產者。 執行指令之前，請先檢查並更新 bucket name

   ibmcloud code-engine subscription cos create --name backend-job-cos-event --destination-type job --destination backend-job --bucket $COS_BUCKETNAME --prefix files --event-type write
   

3. 現在，只要上傳新檔案並按 重新整理 按鈕即可查看結果。 展望未來，您不需要重新提交 jobrun，因為訂閱會照顧它。