> For the complete documentation index, see [llms.txt](https://tccli-agent.gitbook.io/tccli/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tccli-agent.gitbook.io/tccli/v2/tke-rong-qi-fu-wu/index-7.md).

# 应用发布

> 用 Helm Release 在 TKE 集群内部署应用。Release 是 TKE 封装的 Helm 部署实例，管理应用从部署到卸载的完整生命周期。
>
> 官方文档：[组件与应用概述](https://cloud.tencent.com/document/product/457/81234)

## 是什么

Release 把 Helm Chart 部署成一个集群内可管理的实例：创建（部署 Chart）→ 升级（改版本/Values）→ 回滚（退历史版本）→ 卸载（移除）。一个 Release = 一个 Chart 的某次部署。

| 概念      | 含义                      |
| ------- | ----------------------- |
| Chart   | Helm 包，含 K8s 资源模板 + 默认值 |
| Release | Chart 的一次部署实例，有独立版本历史   |
| Values  | 覆盖 Chart 默认值的配置         |

> Release 属 **TKE 2018-05-25**（新版无应用发布 Action）。

## 何时阅读

* 你要把某个 Helm Chart 部署成集群内可管理的实例（带版本历史）— `CreateClusterRelease`，见 [管理应用发布](/tccli/v2/tke-rong-qi-fu-wu/index-7/manage.md)
* 你要升级已部署 Release 的 Chart 版本或改 Values，或退回历史版本 — `UpgradeClusterRelease`/`RollbackClusterRelease`，见 [管理应用发布](/tccli/v2/tke-rong-qi-fu-wu/index-7/manage.md)
* 你要查 Release 部署状态或修订历史（创建/升级后轮询是否 `deployed`）— `DescribeClusterReleases`/`DescribeClusterReleaseHistory`
* 你要按节点标签分批次灰度发布（控制升级节奏）— `RollOutSequence` 系列，见 [管理应用发布 — 灰度发布序列](https://tccli-agent.gitbook.io/tccli/v2/tke-rong-qi-fu-wu/pages/dvVGerAJSUvvmUpIVusY#灰度发布序列rolloutsequence)
* 你不确定 Chart 来源选 TKE 内置还是外部仓库 — 看 [管理应用发布 — Chart 来源决策](https://tccli-agent.gitbook.io/tccli/v2/tke-rong-qi-fu-wu/pages/dvVGerAJSUvvmUpIVusY#chart-来源决策)

## 何时用

| 场景                          | 用 Release？                   |
| --------------------------- | ---------------------------- |
| 部署带版本管理的复杂应用（如 Redis、MySQL） | ✅ Release 管理升级/回滚            |
| 一次性部署简单 YAML                | 可直接 kubectl apply，无需 Release |
| CI/CD 流水线部署                 | ✅ Release 配合流水线升级            |

## 何时不用

* 只用 kubectl 管理 K8s 原生资源 → 用 kubectl，不走 Release
* 用 ArgoCD/Flux 等 GitOps 工具 → 用对应工具，Release 是 TKE 内置方案

## 快速检查

```bash
tccli tke DescribeClusterReleases --region <REGION> --ClusterId "<CLUSTER_ID>"
# expected: 返回 ReleaseSet，含已部署 Release 列表
```

## 文档

* [管理应用发布](/tccli/v2/tke-rong-qi-fu-wu/index-7/manage.md) — 创建/升级/回滚/卸载 Release 完整闭环

## 下一步

* [管理应用发布](/tccli/v2/tke-rong-qi-fu-wu/index-7/manage.md) — 部署第一个 Release
* [插件管理](/tccli/v2/tke-rong-qi-fu-wu/index-6/manage.md) — 部署前装必要插件（如 cbs-csi 存储）


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://tccli-agent.gitbook.io/tccli/v2/tke-rong-qi-fu-wu/index-7.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.