第 3 章 教程:使用 CLI 部署应用程序


要了解如何使用 OpenShift CLI (oc)在 OpenShift Container Platform 上备份应用程序,请按照提供的教程操作。在本教程中,您将部署应用程序所需的服务,这些服务显示全球的国家公园地图。

要完成本教程,您将执行以下步骤:

  1. 为应用创建一个项目。

    此步骤的目录是将您的应用程序与其他集群用户的工作负载隔离。

  2. 授予查看权限。

    此步骤授予 与 OpenShift API 进行交互的 view 权限,以帮助发现项目内运行的服务和其他资源。

  3. 部署前端应用。

    此步骤部署 parksmap 前端应用,将其公开给外部,并将其扩展至两个实例。

  4. 部署后端应用。

    此步骤部署 nationalparks 后端应用程序,并在外部公开。

  5. 部署数据库应用。

    此步骤部署 mongodb-nationalparks MongoDB 数据库,将数据加载到数据库中,并设置访问数据库所需的凭证。

完成这些步骤后,您可以在 Web 浏览器中查看国家公园应用程序。

3.1. 先决条件

在开始本教程前,请确保您满足以下先决条件:

  • 已安装 OpenShift CLI (oc)。
  • 您可以访问一个用于测试目的的 OpenShift Container Platform 集群。

    如果您的机构没有用于测试的集群,您可以请求访问 Developer Sandbox 来试用 OpenShift Container Platform。

  • 您有适当的权限,如 cluster-admin 集群角色,来创建一个项目并在其中创建应用程序。

    如果您没有所需的权限,请联络您的集群管理员。您需要 self-provisioner 角色来创建一个项目,以及项目的 admin 角色,以修改该项目中的资源。

    如果使用 Developer Sandbox,则会为您创建一个具有所需权限的项目。

  • 已使用 OpenShift CLI (oc)登录到集群。

3.2. 创建一个项目

创建一个新项目,使其包含教程的所有所需资源和应用程序组件。

通过项目(project),社区用户可以以一个隔离的方式来组织和管理其内容。项目是 OpenShift Container Platform 对 Kubernetes 命名空间的扩展。项目具有额外的功能,使用户自助配置。每个项目都有自己的一组对象、策略、约束和服务帐户的集合。

集群管理员可以允许开发人员创建自己的项目。在大多数情况下,您可以自动获得对自己的项目的访问权限。管理员可以根据需要授予其他项目的访问权限。

此流程创建一个名为 user-get-started 的新项目。在本教程的其余部分中,您将使用此项目。

重要

如果您使用 Developer Sandbox 完成本教程,请跳过这个过程。已为您创建了一个项目。

先决条件

  • 已登陆到 OpenShift CLI (oc)。

流程

  • 运行以下命令来创建项目:

    $ oc new-project user-getting-started

    输出示例

    Now using project "user-getting-started" on server "https://openshift.example.com:6443".
    ...

3.3. 授权查看权限

配置应用所需的权限,以访问所需的集群资源。

OpenShift Container Platform 会在每个项目中自动创建多个服务帐户。default 服务帐户负责运行 pod。OpenShift Container Platform 使用并将此服务帐户注入到启动的每个 pod 中。

默认情况下,default 服务帐户具有与 OpenShift API 交互的有限权限。

根据应用的要求,您必须将 view 角色分配给 default 服务帐户,以允许它与 OpenShift API 通信,以了解项目中的 pod、服务和资源。

先决条件

  • 有访问 OpenShift Container Platform 集群的权限。
  • 已安装 OpenShift CLI(oc)。
  • 有 cluster-admin 或项目级别的 admin 权限。

流程

  • 运行以下命令,将 view 角色添加到 user-get-started 项目中的 default 服务帐户:

    $ oc adm policy add-role-to-user view -z default -n user-getting-started
    重要

    如果您使用其他项目,请将 user-getting-started 替换为项目的名称。

3.4. 部署前端应用程序

部署前端应用程序,为教程提供面向外部的 Web 组件。

在 OpenShift Container Platform 中部署应用程序的最简单方法是运行一个提供的容器镜像。

以下流程会部署 parksmap,它是 national-parks-app 应用的前端组件。Web 应用显示全球国家公园位置的交互式地图。

先决条件

  • 有访问 OpenShift Container Platform 集群的权限。
  • 已安装 OpenShift CLI(oc)。

流程

  • 运行以下命令部署 parksmap 应用程序:

    $ oc new-app quay.io/openshiftroadshow/parksmap:latest --name=parksmap -l 'app=national-parks-app,component=parksmap,role=frontend,app.kubernetes.io/part-of=national-parks-app'

    输出示例

    --> Found container image 0c2f55f (4 years old) from quay.io for "quay.io/openshiftroadshow/parksmap:latest"
    
        * An image stream tag will be created as "parksmap:latest" that will track this image
    
    --> Creating resources with label app=national-parks-app,app.kubernetes.io/part-of=national-parks-app,component=parksmap,role=frontend ...
        imagestream.image.openshift.io "parksmap" created
        deployment.apps "parksmap" created
        service "parksmap" created
    --> Success
        Application is not exposed. You can expose services to the outside world by executing one or more of the commands below:
         'oc expose service/parksmap'
        Run 'oc status' to view your app.

3.4.1. 公开前端服务

默认情况下,在 OpenShift Container Platform 上运行的服务无法从外部访问。要公开您的服务,以便外部客户端可以访问该服务,您可以创建一个 路由。

Route 对象是类似于 Kubernetes Ingress 对象的 OpenShift Container Platform 网络资源。默认的 OpenShift Container Platform 路由器(HAProxy)使用传入请求的 HTTP 标头来确定连接的位置。

另外,您可以为路由定义安全性,如 TLS。

先决条件

  • 您已部署了 parksmap 前端应用程序。
  • 有 cluster-admin 或项目级别的 admin 权限。

流程

  • 运行以下命令,创建一个路由来公开 parksmap 前端应用程序:

    $ oc create route edge parksmap --service=parksmap

验证

  • 运行以下命令验证应用程序路由是否已成功创建:

    $ oc get route parksmap

    输出示例

    NAME        HOST/PORT                                                   PATH   SERVICES   PORT       TERMINATION   WILDCARD
    parksmap    parksmap-user-getting-started.apps.cluster.example.com             parksmap   8080-tcp   edge          None

3.4.2. 查看 pod 详情

检索详细的 pod 信息,以确认本教程中应用的运行状态和资源配置。

OpenShift Container Platform 使用 Kubernetes 的 pod 概念,它是共同部署在同一主机上的一个或多个容器,也是可被定义、部署和管理的最小计算单元。对容器而言,Pod 大致相当于一个机器实例(物理或虚拟)。

您可以查看集群中的 pod,并确定这些 pod 和整个集群的健康状态。

先决条件

  • 您已部署了 parksmap 前端应用程序。

流程

  • 运行以下命令,列出当前项目中的所有 pod:

    $ oc get pods

    输出示例

    NAME                       READY   STATUS    RESTARTS   AGE
    parksmap-5f9579955-6sng8   1/1     Running   0          77s

  • 运行以下命令显示 pod 的详情:

    $ oc describe pod parksmap-5f9579955-6sng8

    输出示例

    Name:             parksmap-5f9579955-6sng8
    Namespace:        user-getting-started
    Priority:         0
    Service Account:  default
    Node:             ci-ln-fr1rt92-72292-4fzf9-worker-a-g9g7c/10.0.128.4
    Start Time:       Wed, 26 Mar 2025 14:03:19 -0400
    Labels:           app=national-parks-app
                      app.kubernetes.io/part-of=national-parks-app
                      component=parksmap
                      deployment=parksmap
                      pod-template-hash=848bd4954b
                      role=frontend
    ...

  • 运行以下命令,查看 pod 的日志:

    $ oc logs parksmap-5f9579955-6sng8

    输出示例

    ...
    2025-03-26 18:03:24.774  INFO 1 --- [           main] o.s.m.s.b.SimpleBrokerMessageHandler     : Started.
    2025-03-26 18:03:24.798  INFO 1 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)
    2025-03-26 18:03:24.801  INFO 1 --- [           main] c.o.evg.roadshow.ParksMapApplication     : Started ParksMapApplication in 4.053 seconds (JVM running for 4.46)

3.4.3. 扩展部署

向上扩展或缩减应用部署,以满足工作负载需求。

在 Kubernetes 中,Deployment 对象定义了应用的部署方式。在大多数情况下,当部署应用程序时,OpenShift Container Platform 会为您创建 Pod、Service、ReplicaSet 和 Deployment 资源。

当您部署 parksmap 镜像时,会创建一个部署资源。在本例中,只部署了一个 pod。您可能需要扩展应用程序,以便满足用户需求或确保应用程序始终运行(即使出现一个 pod 停机的情况)。

以下流程将 parksmap 部署扩展到使用两个实例。

先决条件

  • 您已部署了 parksmap 前端应用程序。

流程

  • 运行以下命令,将部署从一个 pod 实例扩展到两个 pod 实例:

    $ oc scale --replicas=2 deployment/parksmap

    输出示例

    deployment.apps/parksmap scaled

验证

  • 运行以下命令验证您的部署是否已正确扩展:

    $ oc get pods

    输出示例

    NAME                       READY   STATUS    RESTARTS   AGE
    parksmap-5f9579955-6sng8   1/1     Running   0          7m39s
    parksmap-5f9579955-8tgft   1/1     Running   0          24s

    验证是否列出了两个 parksmap pod。

    提示

    要将部署缩减为一个 pod 实例,请将 1 传递给 --replicas 选项:

    $ oc scale --replicas=1 deployment/parksmap

3.5. 部署后端应用程序

部署后端服务,它提供查询数据库的服务,以返回应用程序所需的国家 park 数据。

以下流程部署 nationalparks,这是 national-parks-app 应用的后端组件。Python 应用程序针对 MongoDB 数据库执行 2D geo-spatial 查询,以定位和返回世界上的所有国家公园的信息。

先决条件

  • 您已部署了 parksmap 前端应用程序。

流程

  • 运行以下命令来创建 nationalparks 后端应用程序:

    $ oc new-app https://github.com/openshift-roadshow/nationalparks-py.git --name nationalparks -l 'app=national-parks-app,component=nationalparks,role=backend,app.kubernetes.io/part-of=national-parks-app,app.kubernetes.io/name=python' --allow-missing-images=true

    输出示例

    --> Found image 9531750 (2 weeks old) in image stream "openshift/python" under tag "3.11-ubi8" for "python"
    
        Python 3.11
        -----------
    ...
    
    --> Creating resources with label app=national-parks-app,app.kubernetes.io/name=python,app.kubernetes.io/part-of=national-parks-app,component=nationalparks,role=backend ...
        imagestream.image.openshift.io "nationalparks" created
        buildconfig.build.openshift.io "nationalparks" created
        deployment.apps "nationalparks" created
        service "nationalparks" created
    --> Success
        Build scheduled, use 'oc logs -f buildconfig/nationalparks' to track its progress.
        Application is not exposed. You can expose services to the outside world by executing one or more of the commands below:
         'oc expose service/nationalparks'
        Run 'oc status' to view your app.

3.5.1. 公开后端服务

要公开后端服务,使其可以被外部访问,请创建一个路由。

先决条件

  • 您已部署了 nationalparks 后端应用程序。
  • 有 cluster-admin 或项目级别的 admin 权限。

流程

  1. 运行以下命令,创建一个路由来公开 nationalparks 后端应用程序:

    $ oc create route edge nationalparks --service=nationalparks
  2. 运行以下命令标记 nationalparks 路由:

    $ oc label route nationalparks type=parksmap-backend

    应用程序代码预期 nationalparks 路由使用 type=parksmap-backend 进行标记。

3.6. 部署数据库应用程序

部署 MongoDB 数据库应用程序,使其包含应用程序所需的信息。在本教程中,您将部署一个名为 mongodb-nationalparks 的数据库应用程序,其中包含国家公园位置信息。

先决条件

  • 您已部署了 parksmap 前端应用程序。
  • 您已部署了 nationalparks 后端应用程序。

流程

  • 运行以下命令部署 mongodb-nationalparks 数据库应用程序:

    $ oc new-app registry.redhat.io/rhmap47/mongodb --name mongodb-nationalparks -e MONGODB_USER=mongodb -e MONGODB_PASSWORD=mongodb -e MONGODB_DATABASE=mongodb -e MONGODB_ADMIN_PASSWORD=mongodb -l 'app.kubernetes.io/part-of=national-parks-app,app.kubernetes.io/name=mongodb'

    输出示例

    --> Found container image 7a61087 (12 days old) from quay.io for "quay.io/mongodb/mongodb-enterprise-server"
    
        * An image stream tag will be created as "mongodb-nationalparks:latest" that will track this image
    
    --> Creating resources with label app.kubernetes.io/name=mongodb,app.kubernetes.io/part-of=national-parks-app ...
        imagestream.image.openshift.io "mongodb-nationalparks" created
        deployment.apps "mongodb-nationalparks" created
        service "mongodb-nationalparks" created
    --> Success
        Application is not exposed. You can expose services to the outside world by executing one or more of the commands below:
         'oc expose service/mongodb-nationalparks'
        Run 'oc status' to view your app.

3.6.1. 通过创建 secret 提供对数据库的访问

创建 Secret 资源,安全地为后端应用提供敏感数据库连接凭据。

nationalparks 应用程序需要信息,如数据库名称、用户名和密码来访问 MongoDB 数据库。但是,由于此信息是敏感的,因此不应将这些信息直接存储在 pod 中。

您可以使用 secret 存储敏感信息,并与工作负载共享该 secret。

Secret 对象提供了一种机制来保存敏感信息,如密码、OpenShift Container Platform 客户端配置文件和私有源存储库凭证等。secret 将敏感内容与 Pod 分离。您可以使用卷插件或作为环境变量传递 secret 来将 secret 挂载到容器中。然后,系统可以使用 secret 为 pod 提供敏感信息。

以下流程创建 nationalparks-mongodb-parameters secret,并将其挂载到 nationalparks 工作负载。

先决条件

  • 您已部署了 nationalparks 后端应用程序。
  • 您已部署了 mongodb-nationalparks 数据库应用程序。

流程

  1. 运行以下命令,使用所需的数据库访问信息创建 secret:

    $ oc create secret generic nationalparks-mongodb-parameters --from-literal=DATABASE_SERVICE_NAME=mongodb-nationalparks --from-literal=MONGODB_USER=mongodb --from-literal=MONGODB_PASSWORD=mongodb --from-literal=MONGODB_DATABASE=mongodb --from-literal=MONGODB_ADMIN_PASSWORD=mongodb
  2. 运行以下命令,将环境从 secret 导入到 nationalparks 工作负载:

    $ oc set env --from=secret/nationalparks-mongodb-parameters deploy/nationalparks
  3. 等待 nationalparks 部署推出带有此环境信息的新修订版本。运行以下命令,检查 nationalparks 部署的状态:

    $ oc rollout status deployment nationalparks

    输出示例

    deployment "nationalparks" successfully rolled out

3.6.2. 将数据加载到数据库中

部署 mongodb-nationalparks 数据库应用程序后,将国家 park 位置信息加载到数据库中。

先决条件

  • 您已部署了 nationalparks 后端应用程序。
  • 您已部署了 mongodb-nationalparks 数据库应用程序。

流程

  • 运行以下命令载入国家公园数据:

    $ oc exec $(oc get pods -l component=nationalparks | tail -n 1 | awk '{print $1;}') -- curl -s http://localhost:8080/ws/data/load

    输出示例

    "Items inserted in database: 2893"

验证

  • 运行以下命令验证地图数据是否已正确载入:

    $ oc exec $(oc get pods -l component=nationalparks | tail -n 1 | awk '{print $1;}') -- curl -s http://localhost:8080/ws/data/all

    输出示例(修剪)

    ...
    , {"id": "Great Zimbabwe", "latitude": "-20.2674635", "longitude": "30.9337986", "name": "Great Zimbabwe"}]

3.7. 在网页浏览器中查看应用程序

部署必要的应用程序并将数据加载到数据库后,您现在可以通过浏览器查看应用程序。您可以通过检索前端应用的路由信息来获取应用的 URL。

先决条件

  • 您已部署了 parksmap 前端应用程序。
  • 您已部署了 nationalparks 后端应用程序。
  • 您已部署了 mongodb-nationalparks 数据库应用程序。
  • 您已将数据加载到 mongodb-nationalparks 数据库中。

流程

  1. 运行以下命令,获取您的路由信息以检索您的地图应用程序 URL:

    $ oc get route parksmap

    输出示例

    NAME       HOST/PORT                                                  PATH   SERVICES    PORT       TERMINATION   WILDCARD
    parksmap   parksmap-user-getting-started.apps.cluster.example.com            parksmap    8080-tcp   edge          None

  2. 从上面的输出中,复制 HOST/PORT 列中的值。
  3. 在复制的值前面添加 https:// 以获取应用程序 URL。这是必要的,因为路由是一个安全路由。

    应用程序 URL 示例

    https://parksmap-user-getting-started.apps.cluster.example.com

  4. 将此应用程序 URL 粘贴到您的网页浏览器中。您的浏览器应当显示全球的国家公园地图。

    图 3.1. 跨世界的国家公园

    跨世界的国家公园地图

    如果您允许应用程序访问您的位置信息,则地图会以您的位置为中心。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部