OCP使用web console创建和构建应用

文章目录

• 环境
• 登录
• 创建project
• 赋予查看权限
• 部署第一个image
• • 检查pod
  • 扩展应用
• 部署一个Python应用
• 连接数据库
• • 创建secret
  • 加载数据并显示国家公园地图
• 清理
• 参考

环境

• RHEL 9.3
• Red Hat OpenShift Local 2.32

登录

在 crc start 启动crc时，可以看到：

......
The server is accessible via web console at:
  https://console-openshift-console.apps-crc.testing

Log in as administrator:
  Username: kubeadmin
  Password: MSmt7-d8LbI-igtzV-DeJY9

Log in as user:
  Username: developer
  Password: developer

Use the 'oc' command line interface:
  $ eval $(crc oc-env)
  $ oc login -u developer https://api.crc.testing:6443
......

通过 crc console --credentials 也可以查看登录信息：

$ crc console --credentials
To login as a regular user, run 'oc login -u developer -p developer https://api.crc.testing:6443'.
To login as an admin, run 'oc login -u kubeadmin -p MSmt7-d8LbI-igtzV-DeJY9 https://api.crc.testing:6443'

登录web console https://console-openshift-console.apps-crc.testing ：

用 kubeadmin 或者 developer 登录都可以。

比如用 developer 登录，如下：

Web console提供两种视角： Administrator 视角和 Developer 视角。Developer视角提供开发人员用例特有的工作流。

对于非管理员用户，默认视图是Developer视角。对于集群管理员，默认的视图是Administrator视角。如果没有 cluster-admin 权限，则无法在web console中看到Administrator视角。

本例中使用 developer 用户登录（参见上图右上角），该用户有管理员权限，所以默认是Administrator视角（参见上图左上角）。

切换到Developer视角，如下：

创建project

Project使得用户社区可以在隔离中组织和管理其内容。Project是OCP对Kubernetes namespace的扩展。Project具有额外的功能，使得用户能够自我provision（self-provisioning）。

用户需要从管理员处接收project的访问权限。集群管理员可以允许开发人员创建自己的project。多数情况下，用户会自动获得其自己的project的访问权限。

每个project都有自己的一系列对象、策略、约束和service帐户。

点击"+Add" -> "Create a new project"：

• Name：填入 user-getting-started
• Display name：填入 Getting Started with OpenShift

然后点击"Create"按钮，创建project。

赋予查看权限

OCP会在每个project中自动创建一些特殊的service帐户。默认服务帐户会负责运行pod。OCP使用并将此service帐户注入到所启动的每个pod中。

本例为默认的 ServiceAccount 对象创建一个 RoleBinding 对象。Service帐户与 OCP API通信，以了解project中的 pod、service和资源。

切换到Administrator视角。

点击"User Management" -> "RoleBindings" -> "Create binding"

• Name：填入 sa-user-account
• Namespace：搜索并选择 user-getting-started
• Role name：搜索并选择 view
• Subject：选择ServiceAccount
• Subject namespace：搜索并选择 user-getting-started
• Subject name：填入 default

然后，点击"Create"按钮，创建binding。

部署第一个image

在OCP中部署应用的最简单方法是运行已有的容器image。本例部署一个应用的前端组件，名为 national-parks-app 。该web应用显示一个交互式的地图，显示全球主要国家公园的位置。

切换到Devloper视角。

点击"+Add" -> "Container images"：

• Image name from external registry：填入 quay.io/openshiftroadshow/parksmap:latest
• Application：填入 national-parks-app
• Name：填入 parksmap
• Resource type：选择Deployment
• 勾选"Create a route"
• 添加以下label：
  • app=national-parks-app
  • component=parksmap
  • role=frontend

然后，点击"Create"按钮，创建image。

检查pod

OCP使用Kubernetes的pod概念，它是部署在同一主机上的一个或多个容器，也是可被定义、部署和管理的最小计算单元。对于容器来说，pod大致相当于机器实例（物理的或虚拟的）。

通过Overview面板，可以访问 parksmap deployment的许多功能。在Details和Resources页签可以扩展应用pod，检查构建状态、service和route。

在上图中，点击 parksmap deployment：

可以看到其详细信息：

包括Details、Resources、Observe三个页签。

扩展应用

在Kubernetes中， Deployment 对象定义了如何部署应用。多数情况下，用户会把pod、service、ReplicaSets、deployment资源一起使用。在大多数情况下，OCP会创建这些资源。

在部署 national-parks-app image时，会创建一个deployment资源。本例只部署了一个pod。

把应用从一个pod实例扩展到两个pod实例：

在上图中，切换到"Details"页签，然后点击上箭头，扩容到两个pod：

同理，可用下剪头将其缩容回一个pod。

部署一个Python应用

本例为 parksmap 应用部署后端service。Python应用在MongoDB数据库执行2D地理空间（ geo-spatial）查询，以定位和返回世界上所有国家公园的地图坐标。

部署的后端service是 nationalparks 。

点击"+Add" -> "Import from Git"：

• Git Repo URL：填入 https://github.com/openshift-roadshow/nationalparks-py.git
• Application：搜索并选择 national-parks-app
• Name：填入 nationalparks
• Resource type：选择Deployment
• 勾选"Create a route"
• 添加如下label：
  • app=national-parks-app
  • component=nationalparks
  • role=backend
  • type=parksmap-backend

点击"Create"按钮，创建deployment。

点击"nationalparks" deployment，可见正在构建：

大约一两分钟后，构建完成。

连接数据库

接下来，部署并连接一个MongoDB数据库， national -parks-app 应用将会存储位置信息于该数据库。一旦把 national-parks-app 应用标记为地图可视化工具的后端， parksmap deployment会使用OCP发现机制来自动显示地图。

点击"+Add" -> "Container images"：

• Image Name：填入 quay.io/centos7/mongodb-36-centos7
• Runtime icon：搜索并选择 mongodb
• Application：搜索并选择 national-parks-app
• Name：填入 mongodb-nationalparks
• Resource type：选择Deployment
• 不勾选"Create a route"
• 在最下面，点击"Deployment"，添加以下环境变量：
  • MONGODB_USER ： mongodb
  • MONGODB_PASSWORD ： mongodb
  • MONGODB_DATABASE ： mongodb
  • MONGODB_ADMIN_PASSWORD ： mongodb

点击"Create"按钮，创建deployment。

创建secret

Secret 对象提供了一种机制来保存敏感信息，如密码、OCP客户端配置文件、私有源仓库凭证等。Secret把敏感内容与pod解耦。可以通过volume插件把secret mount到容器中，系统也可以为pod而使用secret执行操作。本例添加secret nationalparks-mongodb-parameters ，并将它mount到 nationalparks 工作负载中。

点击"Secrets" -> "Create" -> "Key/value secret"：

添加以下key/value：

• MONGODB_USER ： mongodb
• DATABASE_SERVICE_NAME ： mongodb-nationalparks
• MONGODB_PASSWORD ： mongodb
• MONGODB_DATABASE ： mongodb
• MONGODB_ADMIN_PASSWORD ： mongodb

然后，点击"Create"按钮，创建secret。最后，点击"Add Secret to workload"按钮，在弹出的对话框中，选择"nationalparks"，然后点击"Save"按钮：

该配置变化会触发 nationalparks deployment 做一次滚动（rollout）更新，并注入环境变量。

加载数据并显示国家公园地图

目前已经部署了 parksmap 和 Nationalparks 应用，然后部署了 mongodb-nationalparks 数据库。但是，还没有把数据加载到数据库中。在加载数据前，将正确的label添加到 mongodb-nationalparks 和 nationalparks deployment中。

点击"Topology" -> "nationalparks" -> "Resources" -> "Routes"，找到URL：

本例中，URL是 https://nationalparks-user-getting-started.apps-crc.testing/ 。

打开浏览器，访问该URL：

访问 https://nationalparks-user-getting-started.apps-crc.testing/ws/data/load ：

点击"Topology" -> "parksmap" -> "Resources" -> "Routes"，找到URL：

打开浏览器，访问该URL：

清理

crc delete -f

参考

• https://access.redhat.com/documentation/en-us/openshift_container_platform/4.14/html-single/getting_started/index#openshift-web-console