如何使代码作为 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 连接。 In particular, Code Engine uses Cloud Internet Services (CIS) in IBM Cloud, which is based on CloudFlare, as the intrusion prevention system (IPS) for DNS and DDOS protection on layer 4. 换言之，在 IPS 上建立的 TCP/IP 连接由 Cloudflare 拥有和管理。 有关更多信息，请参阅 Cloudflare 文档。

• 绑定到Code Engine应用程序的互联网连接会自动重定向为使用 HTTPS。

• 应用程序与其他Code Engine应用程序的出站连接会自动受到 TLS 保护。Code Engine会自动管理这种连接，因此使用的协议（或 URL）是 HTTP 而不是 HTTPS。

• 从应用程序到非{{site.{{site.data.keyword.codeengineshort}}应用程序（如互联网）的出站连接使用 HTTP 或 HTTPS，具体取决于应用程序代码或 URL 中指定的协议。

• 批处理任务的外向连接使用任务代码或 URL 中指定的 HTTP 或 HTTPS 协议。 此行为包括从批处理作业到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 服务与服务绑定集成。
• 使用 环境变量，configmaps 和 secret。
• 预订事件生产者。
• 对应用程序进行故障诊断。