文档中心

容器服务

请输入

快速入门

通过 kubectl 使用容器服务

本文介绍通过容器服务（VKE）控制台创建集群后，使用 kubectl 命令行工具部署应用的操作步骤及参数配置，帮助您快速了解和使用 VKE 产品。

步骤一：创建集群

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

说明

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

步骤二：连接集群

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

在本地环境中下载安装最新版本的 kubectl 工具。

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

在容器服务控制台的集群页面，找到已创建的 demo-cluster 集群，单击集群名称。

在集群总览页面，单击连接信息页签。

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

在本地环境中打开$HOME/.kube/config文件，直接将获取到的集群访问凭证直接粘贴到$HOME/.kube/config文件中。

注意

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

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

kubectl get node

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

NAME STATUS ROLES AGE VERSION
192.168.0.6 Ready <none> 4h15m v1.26.10-vke.11

步骤三：部署应用

完成集群和 kubectl 的连接后，您可以通过 kubectl 客户端创建无状态负载，部署应用。

在您的本地环境中，新建nginx.yaml应用文件并复制如下内容到该文件。

说明

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

apiVersion: apps/v1
kind: Deployment
metadata:
name: doc-deployment # 无状态工作负载名称
namespace: default # 命名空间名称
spec:
replicas: 1 # Pod 实例个数
selector:
matchLabels:
app: doc-deployment
template:
metadata:
labels: # 需要与后续创建的服务(Service )文件中 selector 的参数值保持一致
app: doc-deployment
spec:
containers:
- name: doc-deployment-container # 容器名称
image: doc-cn-beijing.cr.volces.com/vke/nginx-demo:v1.0 # 可以替换为您自己的镜像地址，也可以直接使用该示例镜像地址
ports:
- containerPort: 80 # 容器开放的端口号
protocol: TCP # 网络协议

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

kubectl apply -f nginx.yaml

预期返回结果如下所示：

deployment.apps/doc-deployment created

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

kubectl get deployment ${your_deployment_name}

说明

请将${your_deployment_name}替换为您设置的无状态负载名称。例如doc-deployment，那么完整的命令为：

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

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

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

说明

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

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

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

kubectl apply -f nginx-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.**.**.** 180.**.**.** 80:31709/TCP 65s

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

步骤四：监控应用

完成应用部署后，可以通过云原生观测能力，监控应用的运行状态，包括 CPU 用量、内存用量等，协助后续的运维工作。相关说明，请参见开启观测。

释放资源

完成快速入门后，如果无需使用集群，请参考删除集群中的指引，删除集群及其关联资源；如果需要继续使用集群，请确保您的火山引擎账户余额（含代金券）不低于 100 元人民币，且除去代金券后账户余额不为零。

持续使用容器服务集群会有如下两类费用，详细的计费信息，请参见产品计费：

集群托管费用：由容器服务收费。

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

最近更新时间：2026.03.26 11:04:18

这个页面对您有帮助吗？

有用

无用