如何讓我的程式碼以 Code Engine 應用程式元件身分執行?

無論您的程式碼是作為本端檔案或 Git 儲存庫中的來源存在，還是您的程式碼是存在於公用或專用登錄中的容器映像檔，Code Engine 都為您提供以應用程式形式執行程式碼的簡化方式。

• 如果您具有容器映像檔，則根據 Open Container Initiative(OCI)標準，您只需要提供映像檔的參照，這會在您建立及部署應用程式時指向容器登錄的位置。 您可以使用 公用登錄 或 專用登錄 中的映像檔來部署應用程式。

• 如果您是從位於 Git 儲存庫中的原始碼開始，則可以選擇讓 Code Engine 負責從您的來源建置映像檔，並使用 單一 作業來部署應用程式。 在此實務範例中，Code Engine 會將映像檔上傳至 IBM Cloud® Container Registry。 若要進一步瞭解，請參閱 從儲存庫原始碼部署應用程式。 如果您想要進一步控制映像檔的建置，則可以選擇先使用 Code Engine 來 建置映像檔，然後再建立並部署應用程式。

• 如果您是從位於本端工作站上的原始碼開始，則可以選擇讓 Code Engine 負責從來源建置映像檔，並使用 單一 CLI 指令來部署應用程式。 在此實務範例中，Code Engine 會將映像檔上傳至 IBM Cloud® Container Registry。 若要進一步瞭解，請參閱 使用 CLI 從本端原始碼部署應用程式。 如果您想要進一步控制映像檔的建置，則可以選擇先使用 Code Engine 來 建置映像檔，然後再建立並部署應用程式。

部署應用程式之後，您也可以使用 任何 上述方式來 更新已部署的應用程式，與您建立或先前更新應用程式的方式無關。

當您部署應用程式時，除非為映像檔指定標籤，否則會下載並部署所參照容器映像檔的最新版本。 如果為映像檔指定了標籤，則會將已標記的映像檔用於部署。

與特定應用程式修訂版相關聯的映像具有唯一的容器註冊摘要，Code Engine 在應用程式修訂版的生命週期中使用此摘要。 如果您使用與原始映像檔相同的標籤來建立較新版本的映像檔，則會改寫容器登錄中的原始映像檔，並變成無標籤。 會標記較新的映像檔，且此較新的映像檔具有不同的摘要。 您的 Code Engine 應用程式不會使用這個更新的影像，因為更新的影像與應用程式修訂版所引用的影像有不同的摘要。只要原本引用的未標記影像仍然存在，Code Engine 仍然可以建立應用程式修訂版的新實體。 如需詳細資訊，請參閱 為何 Code Engine 無法拉取影像？

應用程式的預設 URL 格式為 https://<appname>.<uuid>.<region>.codeengine.appdomain.cloud，其中 appname 是您應用程式的名稱，uuid 是自動產生的唯一識別碼，region 是您 Code Engine 專案所在的區域。 URL 應用程式的 UUID 部分格式為 aaaabbbbccc。 自動產生的應用程式 URL 會在您應用程式的專案生命週期中持續存在。

如需依地區存取應用程式之端點的相關資訊，請參閱 Code Engine 端點。

我需要瞭解 Code Engine中應用程式埠的相關資訊嗎?

依預設，Code Engine 會假設應用程式在埠 8080 上接聽送入的連線。 此外，Code Engine 會將 PORT 環境變數設為應用程式預期要接聽的埠值。 如果您的應用程式需要在埠 8080 以外的埠上接聽，請從主控台部署應用程式並指定正確的埠，或在 app create 指令上使用 --port 選項。 如需 Code Engine所設定環境變數的相關資訊，請參閱 自動注入環境變數。 下列埠由 Code Engine保留: 8022、8008、8012、9090、9091 及 15090。 只有一個埠可以公開為接聽埠。

透過網際網路 HTTP 連線至 Code Engine 時，使用 80 連接埠。 透過網際網路 HTTPS 連線至 Code Engine 的入站連線使用連接埠 443

如果埠掃描顯示更多開啟的埠，請參閱 為何我的埠掃描顯示比預期更多開啟的埠?

HTTP 處理的注意事項

當您使用應用程式（或工作）時，瞭解 Code Engine 中的基本 HTTP 處理方式會很有幫助。

• 對於使用 HTTP 的傳入應用程式連線，傳輸層安全性 (TLS) 方面由 Code Engine 在應用程式碼之外自動管理。 應用程式的 HTTP Server 只需要關心 HTTP 連線，而不需要 HTTPS 連線。 尤其是，Code Engine 在 IBM Cloud 中使用 Cloud Internet Services (CIS)，它是以 CloudFlare, 為基礎，作為第 4 層 DNS 和 DDOS 保護的入侵防禦系統 (IPS)。 在 IPS 上建立的 TCP/IP 連線由 Cloudflare 擁有和管理。 如需相關資訊，請參閱 Cloudflare 說明文件。

• 與 Code Engine 應用程式綁定的網際網路連線會自動重定向至使用 HTTPS。

• 從應用程式到其他 Code Engine 應用程式的向外連線會自動受到 TLS 保護。Code Engine 會自動管理此連線，因此使用的通訊協定 (或 URL ) 是 HTTP，而不是 HTTPS。

• 從應用程式到非 Code Engine 應用程式 (例如網際網路) 的向外連線使用 HTTP 或 HTTPS，視應用程式碼中指定的通訊協定或 URL 而定。

• 批次作業的向外連線使用作業代碼中指定的 HTTP 或 HTTPS 通訊協定，或 URL。 此行為包括從批次作業到 Code Engine 應用程式的連線。

Code Engine 應用程式的可見性選項

有了 Code Engine，您可以透過定義可接收請求的端點或系統網域對應，來為您的應用程式決定適當的可視性層級。

每個應用程式都有一個內部系統網域映射，同一個 Code Engine 專案內的所有元件都可以看到這個映射，但在專案外則看不到。 除了內部系統網域對映之外，您還選擇讓應用程式對 公用 網際網路或 IBM Cloud 專用 網路可見。

對於公開或私人可見性，應用程式會暴露在 HTTPS 端點上。 有關使用的 TLS 憑證的詳細資訊，請參閱 Code Engine 專案的 TLS 憑證。

您可以使用下列可見性層次來部署應用程式:

您可以在建立及部署或更新應用程式時，從主控台或使用 CLI 來設定應用程式可見性的端點設定。

用於部署 Code Engine 應用程式的選項

瞭解部署應用程式時可以指定的選項。 請注意，主控台與 CLI 之間的選項可能有所不同。

ibmcloud ce app create --name myapp --image icr.io/codeengine/hello --cmd /myapp --arg --debug

應用程式配額的考量

當您使用應用程式、函數及批次工作時，這些資源會在 Code Engine 專案的環境定義內執行。 資源配額是根據每個專案來定義，且限制適用於應用程式、功能及批次工作。

如需 Code Engine 限制的相關資訊，請參閱 Code Engine的限制和配額。

下一步

現在您已熟悉使用 Code Engine 應用程式的主要概念，您準備好部署並使用應用程式了嗎? 請參閱：

• 從公用登錄中的映像檔部署應用程式工作負載。
• 在 IBM Cloud Container Registry 中從映像檔部署應用程式工作負載。
• 從專用登錄中的映像檔部署應用程式工作負載。
• 從儲存庫原始碼部署應用程式。
• 從本端原始碼部署應用程式。

有關使用應用程式的詳細資訊，請參閱

• 應用程式工作量。
• 配置應用程式調整大小。
• 配置應用程式的自訂網域對映。
• 整合 IBM Cloud 服務與服務連結。
• 使用 環境變數、configmap 及 secret。
• 訂閱事件生產者。
• 應用程式疑難排解。