# 将文件上传到部署

{% hint style="info" %}
此功能当前仅可通过 [如果您希望使用 A/B 策略执行迁移，只需启动一个新的匹配器。它将在新集群上并具有新 URL。在您将游戏客户端中的 URL 替换后，删除旧的即可。此方法可将潜在中断降至最低并确保无缝过渡。](https://docs.edgegap.com/zh/docs/api).
{% endhint %}

可以将您 S3 存储桶中的文件上传到部署。由于文件仅在创建部署时下载，您可以在存储桶中修改文件，并在下一次创建的部署中看到更改。

### 拉取配置文件

拉取配置文件定义了应从您的 S3 存储桶下载哪些文件或文件夹以及将它们保存到部署中的何处。

在创建拉取配置文件之前，请确保您至少有一个 [端点存储](https://docs.edgegap.com/zh/docs/endpoint-storage) 已配置。

然后您需要在此存储桶中创建一个拉取配置文件，包含以下信息：

* 该 **name** 拉取配置文件的名称：此名称将用于稍后将拉取配置文件关联到您的应用版本，因此应具有唯一性和描述性。
* 该 **源** path：S3 存储桶中要下载的文件或文件夹的路径。它应以斜杠开头，其根是存储桶的根目录。
* 该 **source\_type**：此项可以是“file”或“folder”，必须正确设置才能成功下载。
* 该 **目标** path：文件或文件夹将在部署中保存的路径。它应以斜杠开头，其根是容器镜像的根目录。

{% hint style="warning" %}
请确保避免使用受保护的目标位置，例如 `/etc/`，因为这将阻止文件被复制到您的部署并导致部署失败。确保普通用户可以向目标文件夹写入。
{% endhint %}

例如，如果您想将存储桶中的文件 `some-file.txt`，复制到您部署中的 `custom-folder` 文件夹，且两种文件结构如下所示：

```
s3://my-bucket/
├─ some-folder/
│  ├─ some-file.txt
├─ some-other-folder/
│  ├─ some-other-file.jpg
```

```
/
├─ app/
│  ├─ entrypoint.sh
│  ├─ custom-folder/

```

您将使用以下信息创建拉取配置文件：

```json
{
  "name": "some-file-pull-profile",
  "source": "/some-folder/some-file.txt",
  "source_type": "file",
  "destination": "/app/custom-folder/"
}
```

有关更多详细信息， [请参阅 API 文档](https://docs.edgegap.com/zh/docs/api).

### 将拉取配置文件链接到应用版本

创建拉取配置文件后，您必须将一个应用版本链接到它，以便在创建部署时下载这些文件。这样，您可以为单个应用版本使用多个拉取配置文件，并在应用版本之间重用拉取配置文件。

[参见 API 文档](https://docs.edgegap.com/zh/docs/api)

### 限制

下载到部署的文件总大小不能超过 5 MB。

如果达到此限制，部署时会收到通知，以便您及时解决该问题。