Skip to main content
版本:v1.4

图形化界面操作

本文档将介绍如何通过图形化界面操作应用。

创建应用

判断你的应用类别

我们大致把应用分为三种类型,普通业务应用、中间件(第三方开源应用)、云服务。对于普通业务应用,我们建议你采用 webservice 部署类型或你的自定义类型。对于中间件或第三方复杂应用建议直接采用 helm 部署类型,对于比较简单且直接提供了 Docker 镜像的第三方开源应用,比如 wordpress,也可以直接采用 webservice 类型。

设置应用基础信息

进入 Applications 页面,点击 New Application 按钮,进入应用基础信息设置页面。设置应用名称等基础信息,根据上一步判断的应用类型选择类型,根据你的实际情况选择部署的环境。设置完成后直接进入下一步。

设置应用部署参数

应用部署参数对于不同的类型差异较大,可根据 UI 提示的帮助信息进行信息输入。比如对于 webservice 类型的应用,他的输入参数如下图:

create-app

完成创建

根据提示完成部署参数的设置后,点击提交按钮即可完成应用创建。成功创建后进入应用管理页面,应用处于未部署状态。

绑定应用到环境

应用在创建完成后,需要绑定到 1 个或多个环境才能正式发布。

你可以绑定到开发环境做测试,然后在测试完成后绑定到生产环境做发布,不同的环境之间彼此隔离、互不影响。

创建完成应用后,在应用管理页面点击 Bind Environment就会出现如下弹窗:

bind-new-env

在弹窗中选择需要发布的环境。如果环境还没创建,可点击下方的 Create new environment 创建新的环境。

点击确认即完成绑定,Baseline Config 右侧环境选项区域出现新的环境,且在工作流管理页面将自动生成新环境的部署工作流。切换到新环境视图下点击 Deploy 即可将应用发布到该环境。

部署应用

应用创建完成后,需要分别执行环境对应的工作流完成环境的部署,每个环节的对应工作流会自动生成。

首次部署

从应用列表点击指定应用进入应用详细页面,在 Baseline Config 右侧即为所有已绑定的环境列表。选择你需要部署的环境,点击环境名称进入环境页面。

app-not-deploy

环境处于未部署状态时将显示部署按钮,点击按钮即可开始执行当前环境的部署工作流。工作流执行状态显示在页面的右上方。如果你设置了审核的步骤,到达该步骤时页面中将弹出审核窗口。

workflow-suspend

如果部署步骤出现故障,该步骤显示为红色,鼠标移动到该步骤上将显示故障原因。

workflow-error

更新

应用详情页面的右上方有一个常驻的 Deploy 按钮,点击该按钮执行默认工作流。按钮右边三点按钮为选择不同的环境工作流,鼠标移动到其上方即可显示多个工作流选项。

select-workflow

更新部署可以在任意状态下进行,选择执行某一个流水线后,将使用最新的应用配置进行部署。如果该环境正在执行部署,UI 将提示你是否强制进行新的部署。

管理工作流

工作流与应用发布的环境绑定,即应用的每一个环境都有独立的工作流。

工作流与应用版本的关系

应用进行部署的动作则为执行某一个工作流发布一个版本,版本状态跟随工作流的执行状态,也就是说工作流执行完成,则代表该版本处于完成发布的状态。

Application Revision List

对接 CI 系统后,版本可以与 Code Commit 关联,实现版本可追溯。在版本操作中后续会实现版本回退功能,你可在任何时候选择将某个环境回退到指定版本。

编辑工作流

进入应用工作流管理页面,选择一个环境的工作流点击 Edit 按钮进入编辑状态。我们以使用 notification 步骤为例。

workflow-edit

选择左侧的 notification 类型的步骤拖入右侧画布,页面将自动弹出工作流步骤编辑窗口,在设置窗口中,你可以根据需要设置参数。

配置完成点击 Submit 保存步骤配置,这时需要规划通知步骤的位置,默认它将添加到最后,如果你希望将其放置到中间步骤,需要断开原有步骤直接的连线,然后将通知步骤进行连线放置在中间。

工作流配置完成后注意点击工作流窗口右上方的 Save 按钮保存所有变更。保存完成后可以点击页面右上方的 Deploy 或右边的选择按钮选择执行该工作流,验证是否可以收到消息通知。

查看应用实例

查看应用运行实例信息是掌握应用运行状态的直接方式。

pod list

如上图所示,应用的运行实例页面处在应用环境视图下。切换不同的环境即可查询不同环境下部署的实例。

默认情况下,实例列表显示该应用在当前环境下的所有实例。通过实例列表上方的交付目标筛选,可以查询不同交付目标的实例列表。在实例列表中显示版本、状态等信息。

对于交付的 Kubernetes 集群的应用,用户可以点击实例行前方的 + 号展开一个实例的详情,即 Pod 详情,包括了容器状态及资源消耗情况,如果实例的拉起故障,可以从事件列表中查看到详细信息。

对于交付的 云服务 应用,用户可通过点击实例名称跳转到云服务商管理页面。

rds-instances

查看日志

通过 UI 查看应用日志

pod log

如上图所示,交付到 Kubernetes 集群的应用支持查询容器运行日志,切换到指定环境视图下,选择日志页面,即可通过组件/实例/容器的筛选查看对应的运行日志。

日志查询页面默认为每 5 秒自动刷新,查看最新的日志。若你的应用日志中没有时间信息,可点击 Show timestamps 展示日志记录时间。

通过 CLI 查看应用日志

$ vela logs <app_name> -n <namespace>

使用实际的应用名称,命名空间参数执行上述命令,在交互中选择你需要查询的工作负载即可查询应用日志。

访问应用

设置应用访问方式

交付的 Kubernetes 集群的应用需要设置访问方式即可生成访问地址,常见支持的方式如下:

  1. 设置 Service 的暴露类型,比如 LoadBalancerNodePort。适用于所有应用协议。
  2. 设置 Ingress 策略,仅适用于 HTTP/HTTPs 协议。

webservice 类型的应用

在部署参数中可以修改 ExposeType 字段参数来设置其暴露方式,同时在 Service Ports 中设置应用的监听端口,并将 Expose 设置为 True。

webservice

如果你的集群中存在 Ingress Controller,在应用 Baseline Config 页面中,新增 gateway 运维特征来设置访问域名。

trait

如上图所示,在 Domain 中配置你的域名,注意请将该域名 DNS 解析到目标集群的网关 IP 之上。在 Http 模块下配置路由规则,默认你需要设置 /:80,根据你的应用监听端口设置。

其他部署类型的应用,一般存在对应的部署参数设置选项,根据部署参数设置即可。

获取访问地址

设置完应用访问方式后,执行应用部署,然后切换到环境视图下即可看到 Service Endpoint 按钮,鼠标移动到上方即可显示该应用的访问地址。

service endpoint

查看应用部署的资源列表

如果你希望查询应用在各集群部署了哪些资源,可通过下述操作方式查询。

通过 UI 查询

进入应用部署环境视图,默认进入状态展示页面,在该页面中即可查询到应用实际分发的资源列表,如果应用在更新过程中,资源列表会包括历史和当前版本。

app-resources

在该页面中同时展示了组件状态和整体的交付状态。

通过 CLI 查询

$ vela status <app_name> -n <namespace> --tree

基于如上命令可以查询应用部署的资源清单。

查看应用部署版本

应用每执行一次部署即可生成一个版本,通过应用 Baseline Config 视图下的 Revisions 页面展示应用的历史部署版本。

app-revision

通过 Webhook Trigger 触发部署的版本,如果携带了代码信息,版本号可与代码 Commit 信息进行关联。

回收应用部署的环境

当你需要将应用在某个环境的部署资源回收,即关闭应用时,参考下述操作。

pod list

如上图所示,完成部署的环境视图下回出现 Recycle 按钮,点击该按钮确认后即可将该环境部署的资源进行回收删除。

请注意,回收意味着对应的资源将删除,对于需要有状态存储的应用,该操作会导致数据丢失。纯无状态应用可通过重新部署后恢复。

删除应用和环境的绑定关系

应用如果成功从该环境回收后,操作区域将存在 Delete 按钮,点击该按钮即可删除应用与环境的绑定关系。

删除应用

应用需要完成所有环境的资源回收,完成后即可进行删除操作。

delete application

如上图所示,回到应用列表页面,鼠标移动到应用名称右侧的操作图标上,点击 Remove 选项即可完成应用的删除操作。