版本：v1.3

本地试运行

如果你是一个 DevOps 用户或者运维管理员，并且对 Kubernetes 有所了解，为了保证一个应用部署计划在 Kubernetes 运行时集群的表现符合期望，在开发调试阶段，你也可以通过下面的试运行功能提前确认这个部署计划背后的逻辑是否正确。

KubeVela 提供了本地试运行（Dry-run）的功能，来满足你的这个需求。

我们将以一个应用部署计划的示例，来进行讲解。

首先编写如下的 YAML 文件：

  1. # app.yaml
  2. apiVersion: core.oam.dev/v1beta1
  3. kind: Application
  4. metadata:
  5.   name: vela-app
  6. spec:
  7.   components:
  8.     - name: express-server
  9.       type: webservice
  10.       properties:
  11.         image: oamdev/hello-world
  12.         port: 8000
  13.       traits:
  14.         - type: ingress
  15.           properties:
  16.             domain: testsvc.example.com
  17.             http:
  18.               "/": 8000

可以看到，我们的期望是交付一个 Web Service 的组件，使用来自 oamdev/hello-world 的镜像，并最终提供一个可供对外访问的网关，地址域名为 testsvc.example.com，端口号 8000。

然后打开本地试运行模式，使用如下命令：

  1. vela dry-run -f app.yaml
  1. ---
  2. # Application(vela-app) -- Comopnent(express-server)
  3. ---
  5. apiVersion: apps/v1
  6. kind: Deployment
  7. metadata:
  8.   labels:
  9.     app.oam.dev/appRevision: ""
  10.     app.oam.dev/component: express-server
  11.     app.oam.dev/name: vela-app
  12.     workload.oam.dev/type: webservice
  13. spec:
  14.   selector:
  15.     matchLabels:
  16.       app.oam.dev/component: express-server
  17.   template:
  18.     metadata:
  19.       labels:
  20.         app.oam.dev/component: express-server
  21.     spec:
  22.       containers:
  23.       - image: oamdev/hello-world
  24.         name: express-server
  25.         ports:
  26.         - containerPort: 8000
  28. ---
  29. apiVersion: v1
  30. kind: Service
  31. metadata:
  32.   labels:
  33.     app.oam.dev/appRevision: ""
  34.     app.oam.dev/component: express-server
  35.     app.oam.dev/name: vela-app
  36.     trait.oam.dev/resource: service
  37.     trait.oam.dev/type: ingress
  38.   name: express-server
  39. spec:
  40.   ports:
  41.   - port: 8000
  42.     targetPort: 8000
  43.   selector:
  44.     app.oam.dev/component: express-server
  46. ---
  47. apiVersion: networking.k8s.io/v1beta1
  48. kind: Ingress
  49. metadata:
  50.   labels:
  51.     app.oam.dev/appRevision: ""
  52.     app.oam.dev/component: express-server
  53.     app.oam.dev/name: vela-app
  54.     trait.oam.dev/resource: ingress
  55.     trait.oam.dev/type: ingress
  56.   name: express-server
  57. spec:
  58.   rules:
  59.   - host: testsvc.example.com
  60.     http:
  61.       paths:
  62.       - backend:
  63.           serviceName: express-server
  64.           servicePort: 8000
  65.         path: /
  67. ---

查看本地试运行模式给出的信息，我们可以进行确认：

  1. Kubernetes 集群内部 Service 和我们期望的 kind: Deployment 部署，在相关的镜像地址、域名端口上，是否能匹配。
  2. 最终对外的 Ingress 网关，与 Kubernetes 集群内部的 Service，在相关的镜像地址、域名端口上，是否能匹配。

在完成上述信息确认之后，我们就能进行后续的开发调试步骤了。

最后，你还可以通过 vela dry-run -h 来查看更多可用的本地试运行模式：

  1. Dry Run an application, and output the K8s resources as result to stdout, only CUE template supported for now
  3. Usage:
  4.   vela dry-run
  6. Examples:
  7. vela dry-run
  9. Flags:
  10.   -d, --definition string   specify a definition file or directory, it will only be used in dry-run rather than applied to K8s cluster
  11.   -f, --file string         application file name (default "./app.yaml")
  12.   -h, --help                help for dry-run
  14. Global Flags:
  15.   -e, --env string   specify environment name for application

Last updated on 2022年11月1日 by Tianxin Dong