第 3 章 创建应用程序

流程

1. 在 +Add 视图中，点 Samples 标题查看 Samples 页面。
2. 在 Samples 页面中，选择一个可用的示例应用程序来查看 Create Sample Application 表单。

3. 在 Create Sample Application Form 中：

   • 在 Name 字段中，部署名称会被默认显示。您可以根据需要修改此名称。
   • 在 Builder Image Version 中，会默认选择一个构建器镜像。您可以使用 Builder Image Version 下拉列表修改此镜像版本。
   • 默认添加 Git 存储库 URL 示例。
4. 点 Create 创建示例应用程序。示例应用程序的构建状态显示在 Topology 视图中。创建示例应用程序后，您可以看到添加到应用程序的部署。

流程

1. 在 +Add 视图中，点 Getting Started resources Build with guided documentation View all quick start 链接来查看 Quick Starts 页面。
2. 在 Quick Starts 页面中，点您要使用的快速启动的标题。
3. 点 Start 开始快速启动。
4. 执行显示的步骤。

流程

1. 在 +Add 视图中，点 Git Repository 标题中的 From Git 来查看 Import from git 表单。
2. 在 Git 部分中，输入您要用来创建应用程序的代码库的 Git 存储库 URL。例如，输入此示例 Node.js 应用程序的 URL https://github.com/sclorg/nodejs-ex。这个 URL 随后会被验证。

3. 可选：点 Show Advanced Git Options 来添加详情，例如：

   • git Reference，指向特定的分支、标签或提交中的代码，以用于构建应用程序。
   • Context Dir，指定要用来构建应用程序的应用程序源代码的子目录。
   • Source Secret，创建一个具有用来从私有存储库拉取源代码的凭证的 Secret Name。

4. 可选：您可以通过 Git 存储库导入 Devfile、Dockerfile、构建器镜像或 Serverless 函数，以进一步自定义部署。

   • 如果您的 Git 存储库包含 Devfile、Dockerfile、构建器镜像 或 func.yaml，则会自动检测并填充到相应的路径字段中。
   • 如果同一存储库中检测到 Devfile、Dockerfile 或构建器镜像，则默认选择 Devfile。
   • 如果在 Git 存储库中检测到 func.yaml，Import Strategy 会更改为 Serverless Function。
   • 另外，您可以使用 Git 存储库 URL 在 +Add 视图中点 Create Serverless function 来创建无服务器函数。
   • 若要编辑文件导入类型并选择不同的策略，请单击 Edit import strategy 选项。
   • 如果检测到多个 Devfiles、Dockerfile 或构建器镜像，要导入一个特定的实例，请指定相对于上下文目录的对应路径。

5. 在验证 Git URL 后，会选择建议的构建器镜像并标记为星号。如果构建器镜像没有自动探测到，请选择一个构建器镜像。对于 https://github.com/sclorg/nodejs-ex Git URL，默认选择了 Node.js 构建器镜像。

   1. 可选： 使用 Builder Image Version 下拉菜单指定版本。
   2. 可选： 使用 Edit import 策略来选择不同的策略。
   3. 可选： 对于 Node.js 构建器镜像，请使用 Run command 字段覆盖运行应用程序的命令。

6. 在 General 部分中：

   1. 在 Application 字段中输入应用程序组别的唯一名称，例如 myapp。确保应用程序名称在命名空间中具有唯一性。

   2. 系统会基于 Git 存储库的 URL 自动填充 Name 字段，以标识为此应用程序创建的资源（如果没有存在的应用程序）。如果已有应用程序，可以选择将组件部署到现有应用程序中，创建一个新应用程序，或保持该组件没有被分配。

      注意

      资源名称必须在命名空间中具有唯一性。如果遇到错误，请修改资源名称。

7. 在 Resources 部分，选择：

   • Deployment，以纯 Kubernetes 风格方式创建应用程序。
   • Deployment Config，创建 OpenShift Container Platform 风格的应用程序。

   • Serverless Deployment，创建 Knative 服务。

     注意

     要设置导入应用程序的默认资源首选项，请转至 User Preferences Applications Resource type 字段。只有集群中安装了 OpenShift Serverless Operator 时，Import from Git 表单中才会显示 Serverless Deployment 选项。在创建无服务器函数时，Resources 部分不可用。如需了解更多详细信息，请参阅 OpenShift Serverless 文档。

8. 在 Pipelines 部分，选择 Add Pipeline，然后点 Show Pipeline Visualization 来查看应用程序的管道。选择了默认管道，但您可以从应用程序的可用管道列表中选择所需的管道。

   注意

   选中 Add pipeline 复选框，如果满足以下条件，则默认选择 Configure PAC ：

   • 已安装 Pipeline operator
   • 启用了 Pipelines-as-code
   • 在 Git 存储库中检测到 .tekton 目录

9. 在您的存储库中添加 webhook。如果选择了 Configure PAC 并且设置了 GitHub 应用程序，您可以看到 Use GitHub App 和 Setup a webhook 选项。如果没有设置 GitHub App，则只能看到 Setup a webhook 选项：

   1. 进入 Settings Webhooks 并点 Add webhook。
   2. 将 Payload URL 设置为 Pipelines as Code 的公共 URL。
   3. 将内容类型选为 application/json。
   4. 添加 webhook secret 并在另一个位置记录它。在本地机器上安装 openssl 后，生成一个随机 secret。
   5. 点 Let me select individual events 并选择这些事件：Commit comments, Issue comments, Pull request, 和 Pushes.
   6. 点击 Add webhook。

10. 可选： 在 Advanced Options 部分中，默认选择 Target port 和 Create a route to the application，以便您可以使用公开的 URL 访问应用程序。

    如果您的应用程序没有在默认公共端口（80）上公开其数据，请清除复选框，并设置您想要公开的目标端口号。

11. 可选：可以使用以下高级选项进一步自定义应用程序：

    路由

    点击 Routing 链接，您可以执行以下操作：

    • 自定义路由的主机名。
    • 指定路由器监控的路径。
    • 从下拉列表中选择流量的目标端口。

    • 选中 Secure Route 复选框来保护您的路由。从相应的下拉列表中，选择所需的 TLS 终止类型，并设置非安全流量的策略。

      注意

      对于无服务器应用程序，Knative 服务管理上述所有路由选项。但在需要时，您可以自定义流量的目标端口。如果不指定目标端口，则使用默认端口 8080。

    域映射

    如果要创建 Serverless Deployment，您可以在创建过程中添加自定义域映射到 Knative 服务。

    • 在 Advanced options 部分中，点 Show advanced Routing options。

      • 如果要映射到该服务的域映射 CR 已存在，您可以从 Domain mapping 下拉菜单中选择它。
      • 如果要创建新域映射 CR，在框中输入域名，然后选择 Create 选项。例如，如果您在 example.com 中 键入，则 Create 选项为 Create "example.com"。

    健康检查

    点击 Health Checks 链接为您的应用程序添加就绪（Readiness）、存活（Liveness）和启动（Startup）探测。所有探测都预先填充默认数据; 您可以使用默认数据添加探测或根据需要进行自定义。

    自定义健康探测：

    • 点 Add Readiness Probe，在需要的情况下修改参数来检查容器是否准备好处理请求，然后选择要添加的探测。
    • 点 Add Liveness Probe，在需要的情况下修改参数来检查容器是否仍在运行，选择要添加的探测。

    • 点 Add Startup Probe，在需要的情况下修改参数来检查容器内的应用程序是否已启动，选择要添加的探测。

      对于每个探测，您可以从下拉列表中指定请求类型 - HTTP GET、Container Command 或 TCP Socket。表单会根据所选请求类型进行更改。然后您可以修改其它参数的默认值，如探测成功和失败的阈值、在容器启动后执行第一个探测前的秒数、探测的频率以及超时值。

    构建配置和部署

    点 Build Configuration 和 Deployment Configuration 链接来查看对应的配置选项。一些选项会被默认选中；您可以通过添加必要的触发器和环境变量来进一步自定义。

    对于无服务器应用程序，Deployment 选项不会显示，因为 Knative 配置资源为您的部署维护所需的状态，而不是由 DeploymentConfig 资源来维护。

    扩展

    点击 Scaling 链接，以定义您要初始部署的应用程序的 pod 数或实例数。

    如果要创建无服务器部署，也可以配置以下设置：

    • 最小 Pod 决定 Knative 服务在任意给定时间运行的 pod 数量较低限制。这也被称为 minScale 设置。
    • 最大 Pod 决定了 Knative 服务可在任意给定时间运行的 pod 数量上限。这也被称为 maxScale 设置。
    • 并发目标 决定了给定时间每个应用程序实例所需的并发请求数。
    • 并发限制 决定了给定时间允许每个应用程序的并发请求数的限值。
    • 并发利用率 决定了在 Knative 扩展额外 pod 前必须满足并发请求限制的百分比，以处理额外的流量。
    • 自动扩展窗口定义了平均时间窗口，以便在自动扩展器不处于 panic 模式时提供缩放决策的输入。如果在此窗口中没有收到任何请求，服务将缩减为零。autoscale 窗口的默认持续时间为 60s。这也被称为 stable 窗口。

    资源限值

    点击 Resource Limit 链接，设置容器在运行时保证或允许使用的 CPU 和 Memory 资源的数量。

    标签

    点击 Labels 链接，为您的应用程序添加自定义标签。

12. 单击 Create 以创建应用程序，会显示一个成功通知。您可以在 Topology 视图中查看应用程序的构建状态。

流程

1. 在 +Add 视图中，点 Container images 查看 Deploy Images 页面。

2. 在 Image 部分：

   1. 选择 Image name from external registry 部署来自一个公共或私有 registry 的镜像，或者选择 Image stream tag from internal registry 部署来自内部 registry 的镜像。
   2. 在 Runtime icon 选项卡中为您的镜像选择一个图标。

3. 在 General 部分中：

   1. 在 Application name 字段中输入应用程序分组的唯一名称。
   2. 在 Name 字段中输入唯一名称，以标识为此组件创建的资源。

4. 在 Resource type 部分中，选择要生成的资源类型：

   1. 选择 Deployment 来为 Pod 和 ReplicaSet 对象启用声明性更新。
   2. 选择 DeploymentConfig 来为 Pod 对象定义模板，并管理部署新镜像和配置源。
   3. 选择 Serverless Deployment 在闲置时启用缩减为零。
5. 点 Create。您可以在 Topology 视图中查看应用程序的构建状态。

流程

1. 在 Topology 视图中，右键点任何位置来查看 Add to Project 菜单。
2. 将鼠标悬停在 Add to Project 菜单上，以查看菜单选项，然后选择 Upload JAR 文件选项以查看 Upload JAR 文件表单。或者，您可以将 JAR 文件拖到 Topology 视图中。
3. 在 JAR 文件字段中，浏览本地计算机上所需的 JAR 文件并上传该文件。或者，您可以将 JAR 文件拖到字段。如果将不兼容的文件类型拖到 Topology 视图中，则右上角会显示一个警报。如果上传表单的字段中丢弃了不兼容的文件类型，则会显示字段错误。
4. 默认选择运行时图标和构建器镜像。如果构建器镜像没有自动探测到，请选择一个构建器镜像。如果需要，您可以使用 Builder Image Version 下拉列表来更改版本。
5. 可选：在 Application Name 字段中输入应用程序的唯一名称，用于资源标记。
6. 在 Name 字段中输入相关资源的唯一组件名称。
7. 可选： 使用 Resource type 下拉列表更改资源类型。
8. 在 Advanced options 菜单中，点 Create a Route to the Application 配置您部署的应用程序的公共 URL。
9. 点 Create 以部署应用。显示有提示通知，以通知您 JAR 文件正在上传。相关通知还包括用于查看构建日志的链接。

流程

1. 进入 Developer 视角 +Add Developer Catalog All Services。此时会显示 Developer Catalog 中所有可用服务的列表。
2. 在 Type 下，点 Devfiles 浏览支持特定语言或框架的 devfile。另外，您可以使用 keyword 过滤器使用其名称、标签或描述搜索特定 devfile。
3. 点击您要用来创建应用程序的 devfile。devfile 标题显示 devfile 的详情，包括 devfile 的名称、描述、供应商和 devfile 文档。
4. 点 Create 创建一个应用程序，并在 Topology 视图中查看应用程序。

流程

1. 在 Developer 视角中，导航到 +Add 视图，从 Developer Catalog 标题中点击 All Services 来查看 Developer Catalog 中的所有可用服务。
2. 在 All Services 下，选择服务类型或您需要添加到项目的组件。在本例中，选择 Databases 以列出所有数据库服务，然后点击 MariaDB 查看该服务的详情。

3. 点 Instantiate Template 查看带有 MariaDB 服务详情的自动填充的模板，然后点 Create 在 Topology 视图中创建并查看 MariaDB 服务的信息。

   图 3.1. Topology 中的 MariaDB