使用 GitHub 自动部署 Data App
TiDB Cloud 提供了一种配置即代码（Configuration as Code，CaC）的方法，使用 JSON 语法将整个 Data App 配置表示为代码。
通过将 Data App 连接到 GitHub，TiDB Cloud 可以使用 CaC 方法，将你的 Data App 配置作为配置文件推送到你指定的 GitHub 仓库和分支。
如果为你的 GitHub 连接启用了自动同步和部署，你还可以通过在 GitHub 上更新配置文件来修改 Data App。将配置文件更改推送到 GitHub 后，新的配置将自动部署到 TiDB Cloud。
本文档介绍如何使用 GitHub 自动部署 Data App 以及如何管理 GitHub 连接。
开始之前
在将 Data App 连接到 GitHub 之前，请确保你具有以下条件：
- GitHub 账户。
- 带有目标分支的 GitHub 仓库。
步骤 1. 将 Data App 连接到 GitHub
你可以在创建 App 时将 Data App 连接到 GitHub。更多信息，请参见创建 Data App。
如果你在创建 App 时没有启用 GitHub 连接，你仍然可以按照以下方式启用它：
导航到项目的 Data Service 页面。
在左侧窗格中，点击目标 Data App 的名称以查看其详细信息。
在设置标签页上，点击连接到 GitHub区域中的连接。将显示连接设置对话框。
在对话框中，执行以下步骤：
点击在 GitHub 上安装，然后按照屏幕上的说明将 TiDB Cloud Data Service 作为应用程序安装在目标仓库上。
点击授权以授权访问 GitHub 上的应用程序。
指定要存储 Data App 配置文件的目标仓库、分支和目录。
要允许在 TiDB Cloud 控制台或 GitHub 中所做的 Data App 更改相互同步，请启用配置自动同步和部署。
- 启用后，在你指定的 GitHub 目录中所做的更改可以自动部署到 TiDB Cloud，在 TiDB Cloud 控制台中所做的更改也可以推送到 GitHub。你可以在 Data App 部署历史记录中找到相应的部署和提交信息。
- 禁用后，在你指定的 GitHub 目录中所做的更改将不会部署到 TiDB Cloud，在 TiDB Cloud 控制台中所做的更改也将不会推送到 GitHub。
点击确认连接。
步骤 2. 将 Data App 配置与 GitHub 同步
如果在创建 Data App 时启用了 GitHub 连接，TiDB Cloud 会在 App 创建后立即将此 Data App 的配置文件推送到 GitHub。
如果在创建 App 后启用了 GitHub 连接，你需要执行部署操作以将 Data App 配置与 GitHub 同步。例如，你可以点击部署标签页，然后为此 Data App 重新部署一个部署。
部署操作后，检查你指定的 GitHub 目录。你会发现 Data App 配置文件已由 tidb-cloud-data-service 提交到该目录，这意味着你的 Data App 已成功连接到 GitHub。目录结构如下：
├── <你在 GitHub 上的 Data App 目录>
│ ├── data_sources
│ │ └── cluster.json # 指定链接的集群。
│ ├── dataapp_config.json # 指定 Data APP ID、名称、类型、版本和描述。
│ ├── http_endpoints
│ │ ├── config.json # 指定端点。
│ │ └── sql # 包含端点的 SQL 文件。
│ │ ├── <method>-<endpoint-path1>.sql
│ │ ├── <method>-<endpoint-path2>.sql
│ │ └── <method>-<endpoint-path3>.sql
步骤 3. 修改 Data App
启用自动同步和部署后，你可以使用 GitHub 或 TiDB Cloud 控制台修改 Data App。
选项 1：通过在 GitHub 上更新文件修改 Data App
更新配置文件时，请注意以下事项：
| 文件目录 | 注意事项 |
|---|---|
data_source/cluster.json | 更新此文件时，请确保你有权访问链接的集群。你可以从集群 URL 获取集群 ID。例如，如果集群 URL 是 https://tidbcloud.com/clusters/1234567891234567890/overview，则集群 ID 是 1234567891234567890。 |
http_endpoints/config.json | 修改端点时，请确保遵循HTTP 端点配置中描述的规则。 |
http_endpoints/sql/method-<endpoint-path>.sql | 要在 http_endpoints/sql 目录中添加或删除 SQL 文件，你还需要更新相应的端点配置。 |
datapp_config.json | 除非你的 dataapp_config.json 文件是从另一个 Data App 复制的，并且你想将其更新为当前 Data App 的 ID，否则不要更改此文件中的 app_id 字段。否则，由此修改触发的部署将失败。 |
有关这些文件中字段配置的更多信息，请参见 Data App 配置文件。
文件更改提交并推送后，TiDB Cloud 将自动使用 GitHub 上的最新更改部署 Data App。你可以在部署历史记录中查看部署状态和提交信息。
选项 2：在 TiDB Cloud 控制台中修改 Data App
在 TiDB Cloud 控制台中修改 Data App 端点（如修改端点）后，你可以按照以下方式审查并将更改部署到 GitHub：
点击右上角的部署。将显示一个对话框，供你审查所做的更改。
根据你的审查，执行以下操作之一：
- 如果你仍想基于当前草稿进行进一步更改，关闭此对话框并进行更改。
- 如果你想将当前更改恢复到上次部署，点击放弃草稿。
- 如果当前更改看起来没问题，写一个更改描述（可选），然后点击部署并推送到 GitHub。部署状态将显示在顶部横幅中。
如果部署成功，在 TiDB Cloud 控制台中所做的更改将自动推送到 GitHub。
导入现有 Data App 的配置
要将现有 Data App 的配置导入到新的 Data App，请执行以下步骤：
将现有 Data App 的配置文件复制到 GitHub 上的新分支或目录。
在项目的 Data Service 页面上，创建一个新的 Data App，不要连接到 GitHub。
启用自动同步和部署，将新的 Data App 连接到 GitHub。为新的 Data App 指定目标仓库、分支和目录时，使用包含复制的配置文件的新路径。
获取新 Data App 的 ID 和名称。你可以在左侧窗格中点击新 Data App 的名称，在右侧窗格的 Data App 属性区域中获取 App ID 和名称。
在 GitHub 上的新路径中，将
datapp_config.json文件中的app_id和app_name更新为你获取的 ID 和名称，然后推送更改。将文件更改推送到 GitHub 后，TiDB Cloud 将自动使用最新更改部署新的 Data App。
要查看从 GitHub 导入的配置，请刷新 TiDB Cloud 控制台的网页。
你还可以在部署历史记录中查看部署状态和提交信息。
编辑 GitHub 连接
如果你想编辑 Data App 的 GitHub 连接（如切换仓库、分支和目录），请执行以下步骤。
导航到项目的 Data Service 页面。
在左侧窗格中，点击目标 Data App 的名称以查看其详细信息。
在连接到 GitHub区域中，点击 。将显示连接设置对话框。
在对话框中，修改 Data App 的仓库、分支和目录。
要允许在 TiDB Cloud 控制台或 GitHub 中所做的 Data App 更改相互同步，请启用配置自动同步和部署。
- 启用后，在你指定的 GitHub 目录中所做的更改可以自动部署到 TiDB Cloud，在 TiDB Cloud 控制台中所做的更改也可以推送到 GitHub。你可以在 Data App 部署历史记录中找到相应的部署和提交信息。
- 禁用后，在你指定的 GitHub 目录中所做的更改将不会部署到 TiDB Cloud，在 TiDB Cloud 控制台中所做的更改也将不会推送到 GitHub。
点击确认连接。
移除 GitHub 连接
如果你不再想将 Data App 连接到 GitHub，请执行以下步骤：
- 导航到项目的 Data Service 页面。
- 在左侧窗格中，点击目标 Data App 的名称以查看其详细信息。
- 在设置标签页上，点击连接到 GitHub区域中的断开连接。
- 点击断开连接以确认断开连接。
断开连接操作后，你的 Data App 配置文件将保留在 GitHub 目录中，但不会再由 tidb-cloud-data-service 同步。