第 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 视图中，点 View all quick starts 链接来查看 Quick Starts 页面。
2. 在 Quick Starts 页面中，点您要使用的快速启动的标题。
3. 点 Start 开始快速启动。

流程

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 或构建器镜像来进一步自定义部署。

   • 如果您的 Git 存储库包含 devfile、Dockerfile 或构建器镜像，它会被自动检测并填充到相应的路径字段中。如果同一存储库中检测到 devfile、Dockerfile 和构建器镜像，则默认选择 devfile。
   • 若要编辑文件导入类型并选择不同的策略，请单击 Edit import strategy 选项。
   • 如果检测到多个 devfile、Dockerfile 或构建器镜像，以导入特定的 devfile、Dockerfile 或构建器镜像，请指定与上下文目录相关的相应路径。

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

   1. 可选：使用 Builder Image Version 下拉菜单指定版本。
   2. 可选：使用 Edit import 策略来选择不同的策略。

6. 在 General 部分中：

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

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

      注意

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

7. 在 Resources 部分，选择：

   • Deployment，以纯 Kubernetes 风格方式创建应用程序。
   • Deployment Config，创建 OpenShift Container Platform 风格的应用程序。
   • Knative Service，创建微服务。
   注意

   只有集群中安装了 Serverless Operator 时，Import from git 表单中才会显示 Knative Service 部分。如需进一步了解详细信息，请参阅有关安装 OpenShift Serverless 的文档。

8. 在 Pipelines 部分，选择 Add Pipeline，然后点 Show Pipeline Visualization 来查看应用程序的管道。
9. Advanced Options 部分中默认选中 Create a route to the application，以便您可以使用公开的 URL 访问应用程序。如果不想通过公共路由公开您的应用程序，可以清除此复选框。
10. 可选：可以使用以下高级选项进一步自定义应用程序：

流程

1. 在 Topology 视图中，右键单击 Topology 视图中的任意位置，以查看 Add to Project 菜单。
2. 将鼠标悬停在 Add to Project 菜单上，以查看菜单选项，然后选择 Upload JAR 文件选项以查看 Upload JAR 文件表单。或者，您可以在 Topology 视图中拖放 JAR 文件。
3. 在 JAR 文件字段中，浏览本地计算机上所需的 JAR 文件并上传该文件。或者，您可以将 JAR 文件拖放到字段。如果将不兼容的文件类型拖放到 Topology 视图中，则右上角会显示一个警报。如果上传表单的字段中丢弃了不兼容的文件类型，则会显示字段错误。
4. 您可以进一步指定可选的 Java 命令来自定义部署的应用程序。默认选择 Runtime Icon 和 Builder Image。如果没有自动探测到构建器镜像，请选择一个构建器镜像。如果需要，您可以使用 Builder Image Version 下拉列表来更改版本。
5. 在可选的 Application Name 字段中输入应用程序的唯一名称作为资源标记。
6. 在 Name 字段中输入唯一组件名称来命名关联的资源。
7. 在 Resources 字段中，为您的应用程序选择资源类型。
8. 在 Advanced options 中，点 Create a Route to the Application 配置您部署的应用程序的公共 URL。

9. 单击 Create 以部署应用。用户会看到一个切换通知，通知 JAR 文件正在上传，这个过程会花费一段时间。相关通知还包括用于查看构建日志的链接。

   注意

   如果用户尝试在构建运行时关闭浏览器标签页，系统会显示一个 Web 警报，询问用户是否真正想离开页面。

流程

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