第 3 章 教程:使用 CLI 部署应用程序
要了解如何使用 OpenShift CLI (oc)在 OpenShift Container Platform 上备份应用程序,请按照提供的教程操作。在本教程中,您将部署应用程序所需的服务,这些服务显示全球的国家公园地图。
要完成本教程,您将执行以下步骤:
完成这些步骤后,您可以在 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验证是否列出了两个
parksmappod。提示要将部署缩减为一个 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权限。
流程
运行以下命令,创建一个路由来公开
nationalparks后端应用程序:$ oc create route edge nationalparks --service=nationalparks运行以下命令标记
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数据库应用程序。
流程
运行以下命令,使用所需的数据库访问信息创建 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运行以下命令,将环境从 secret 导入到
nationalparks工作负载:$ oc set env --from=secret/nationalparks-mongodb-parameters deploy/nationalparks等待
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数据库中。
流程
运行以下命令,获取您的路由信息以检索您的地图应用程序 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-
从上面的输出中,复制
HOST/PORT列中的值。 在复制的值前面添加
https://以获取应用程序 URL。这是必要的,因为路由是一个安全路由。应用程序 URL 示例
https://parksmap-user-getting-started.apps.cluster.example.com将此应用程序 URL 粘贴到您的网页浏览器中。您的浏览器应当显示全球的国家公园地图。
图 3.1. 跨世界的国家公园
如果您允许应用程序访问您的位置信息,则地图会以您的位置为中心。