文档中心

容器服务

请输入

快速入门

通过 kubectl 使用 VCI

本文介绍通过 VKE 控制台创建 VCI 业务相关集群后，使用 kubectl 命令行工具部署基于 VCI 实例运行应用的操作步骤及参数配置，帮助您快速了解和使用 VKE 产品。

背景信息

本文以在 VPC-CNI 网络模型集群中快速部署 Nginx 应用为例，为你介绍 VCI 的使用流程。Flannel 网络模型集群中使用 VCI 的方法，请参见在 Flannel 网络模型集群中使用 VCI。

步骤一：创建 VKE 集群

详细的操作步骤和参数说明，请参见通过 VKE 控制台使用 VCI 中的步骤一：创建 VKE 集群内容。

说明

若使用已有的集群，请确保已开启 API Server 公网访问。

步骤二：连接集群

您可以通过 kubectl 客户端连接到已创建的集群。

下载安装最新版本的 kubectl 工具到本地。

请从 Kubernetes 官方页面下载安装最新的 kubectl 客户端工具。具体安装指导，请参见安装和设置 kubectl。

在容器服务控制台的集群页面，找到本文上方步骤一中创建的集群，单击集群名称。

在集群基本信息页面，单击连接信息页签。

选择公网访问 Config 页签，单击生成 Kubeconfig，设置有效期（本示例设置有效期为 365 天），获取集群访问凭证。

将获取到的集群访问凭证复制到安装 kubectl 后生成的本地$HOME/.kube/config文件中。

注意

$HOME/.kube/config文件是您在本地环境中正确安装 kubectl 客户端后生成的文件，$HOME表示变量，由您本地环境的操作系统（macOS/Linux/Windows 等）、安装 kubectl 客户端的路径决定。

在您的 kubectl 客户端执行如下命令，查询集群下的 namespace 状态，验证是否连接成功。

kubectl get namespace

返回类似如下信息，表示 kubectl 已连接集群。

NAME STATUS AGE
default Active 3h22m
kube-flannel Active 3h22m
kube-node-lease Active 3h22m
kube-public Active 3h22m
kube-system Active 3h22m

步骤三：部署应用

完成集群和 kubectl 的连接后，您可以通过 kubectl 客户端创建基于 VCI 运行的无状态负载。

在您的本地计算机$home目录下，新建nginx.yaml应用文件，并复制如下内容到该文件。

说明

请根据代码示例中的注释信息，更改参数值。

apiVersion: apps/v1
kind: Deployment
metadata:
name: doc-deployment-vci # 替换为您的应用名称
namespace: default # 命名空间名称
spec:
replicas: 1 # Pod 实例个数
selector:
matchLabels:
app: doc-deployment-vci # 需要和后续创建的服务中 selector 的 app 参数取值一致
template:
metadata:
annotations:
vke.volcengine.com/burst-to-vci: enforce # 固定使用该值，表示强制使用 VCI
labels:
app: doc-deployment-vci # 替换为您的应用名称
spec:
containers:
- image: doc-cn-beijing.cr.volces.com/vke/nginx-demo:v1.0 # 替换为您的镜像地址
name: doc-deployment-vci-container # 替换为您的容器名称
ports:
- containerPort: 80
protocol: TCP

执行如下命令，部署应用。

kubectl apply -f nginx.yaml

执行如下命令，查看应用部署状态。

kubectl get deployment ${your_deployment_name}

说明

请将${your_deployment_name}替换为您设置的工作负载名称，例如doc-deployment-vci，则完整的命令为：

返回类似如下信息，表示应用部署成功。

NAME READY UP-TO-DATE AVAILABLE AGE
doc-deployment-vci 1/1 1 1 63s

在您的本地计算机$home目录下，新建ngixn-svc.yaml服务文件，并复制如下内容到该文件。

说明

请根据代码示例中的注释信息，按需更改参数值。更多说明，请参见通过 kubectl 创建 CLB 负载均衡服务。

apiVersion: v1
kind: Service
metadata:
name: nginx-svc # 服务名称
namespace: default # 命名空间名称
spec:
ports:
- name: doc-vci-port # 端口映射名称
port: 80 # Service 对外提供服务的端口
protocol: TCP # 端口协议
targetPort: 80 # 容器端口，即工作负载对外提供服务的端口号或端口名称，例如：Nginx 开放的默认端口号为 80
selector:
app: doc-deployment-vci # 需要和之前创建应用中 matchLabels 的 app 参数取值一致
type: LoadBalancer # 服务的类型，包括：Nodeport、ClusterIP 和 LoadBalancer

执行如下命令，创建服务。

kubectl apply -f ngixn-svc.yaml

预期返回结果如下所示：

service/nginx-svc created

执行如下命令，查看服务状态。

kubectl get svc ${your_service_name}

说明

请将${your_service_name}替换为您设置的服务名称，例如nginx-svc，则完整的命令为：

返回类似如下信息，表示应用部署成功。

NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
nginx-svc LoadBalancer 172.**.**.** 124.**.**.** 80:31647/TCP 17s

在浏览器中输入上一步获取到的 EXTERNAL-IP 值，访问 Nginx 的欢迎页面。

步骤四：（可选）监控应用

完成应用部署后，可通过云原生观测能力实现对应用的运行状态、资源使用量（包括 CPU 用量、内存用量等）的监控，协助后续的运维工作。相关说明，请参见使用托管 Prometheus 监控 VCI。

释放资源

完成 VCI 快速入门后，如果无需使用 VCI 实例部署的应用，请参考管理工作负载中的指引，删除无状态负载；如果无需使用 VKE 集群，请参考删除集群中的指引，删除集群及其关联资源。如果需要继续使用 VKE 集群以及集群内通过 VCI 实例部署的应用，请确保您的火山引擎账户余额（含代金券）不低于 100 元人民币，且除去代金券后账户余额不为零。

持续使用 VKE 集群以及集群内通过 VCI 实例部署的应用，会有如下几种费用，详细的计费信息，请参见产品计费：

集群托管费用：由 VKE 收费。

VCI 实例费用：由 VCI 收费。

云基础资源费用：集群中使用的 NAT 网关、CLB、公网 IP、云盘等其他火山引擎云产品费用，由其他云产品收费。

最近更新时间：2026.08.19 11:21:41

这个页面对您有帮助吗？

有用

无用