> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/docs.edgegap.com-ko/docs/endpoint-storage/upload-files.md).

# 배포에 파일 업로드

{% hint style="info" %}
이 기능은 현재 다음을 통해서만 사용할 수 있습니다 [API](/docs.edgegap.com-ko/docs/api.md).
{% endhint %}

S3 버킷에서 배포로 파일을 업로드할 수 있습니다. 파일은 배포가 생성될 때만 다운로드되므로 버킷의 파일을 수정하고 다음에 생성하는 배포에서 변경 사항을 확인할 수 있습니다.

### 풀 프로필

풀 프로필은 S3 버킷에서 어떤 파일이나 폴더를 다운로드할지와 배포에서 어디에 저장할지를 정의합니다.

풀 프로필을 생성하기 전에 최소한 하나의 [Endpoint Storage](/docs.edgegap.com-ko/docs/endpoint-storage.md) 가 구성되어 있는지 확인하십시오.

그런 다음 이 버킷 내에서 다음 정보를 사용하여 풀 프로필을 생성해야 합니다:

* 해당 **이름** 풀 프로필의 이름: 나중에 풀 프로필을 앱 버전과 연결하는 데 사용되므로 고유하고 설명적이어야 합니다.
* 해당 **소스** 경로: S3 버킷 내의 파일 또는 폴더 경로입니다. 슬래시로 시작해야 하며 루트는 버킷의 루트입니다.
* 해당 **소스\_유형**: 이는 "file" 또는 "folder" 중 하나일 수 있으며 다운로드가 성공하려면 올바르게 설정해야 합니다.
* 해당 **대상** 경로: 파일 또는 폴더가 저장될 배포 내의 경로입니다. 슬래시로 시작해야 하며 루트는 컨테이너 이미지의 루트입니다.

{% 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 문서를 참조하십시오](/docs.edgegap.com-ko/docs/api.md).

### 풀 프로필을 앱 버전에 연결하기

풀 프로필을 생성한 후에는 앱 버전을 풀 프로필에 연결해야 배포가 생성될 때 파일이 다운로드됩니다. 이렇게 하면 단일 앱 버전에 대해 여러 풀 프로필을 사용하고 풀 프로필을 앱 버전 간에 재사용할 수 있습니다.

[API 문서를 참조하십시오](/docs.edgegap.com-ko/docs/api.md)

### 제한 사항

배포로 다운로드되는 파일의 총 크기는 5MB를 초과할 수 없습니다.

이 제한에 도달하면 배포 시 알림을 받아 문제를 신속히 해결할 수 있습니다.


---

# 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:

```
GET https://docs.edgegap.com/docs.edgegap.com-ko/docs/endpoint-storage/upload-files.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.