← Cloudflare Pages / pages / get-started

Direct Upload

Direct Upload позволяет вам загружать готовые ресурсы в Pages и развертывать их в глобальной сети Cloudflare. Выбирайте Direct Upload вместо интеграции с Git, если вы хотите интегрировать собственную платформу сборки или загрузите файл с локального компьютера.

Это руководство расскажет, как загрузить ресурсы с помощью Wrangler или методом перетаскивания.

Перед развёртыванием проекта с помощью Direct Upload выполните соответствующую команда сборки чтобы собрать проект.

Когда предварительно собранные ресурсы готовы, загрузить их можно двумя способами:

• Wrangler.
• Перетаскивание.

Ниже перечислены поддерживаемые типы файлов для каждого из способов Direct Upload:

• Wrangler: одна папка с ресурсами. (ZIP-файлы не поддерживаются.)
• Перетаскивание: zip файл или отдельная папка с ресурсами.

Для начала установите npm ↗. Затем установите Wrangler, интерфейс командной строки платформы разработчика.

Войдите в Wrangler с помощью wrangler login команда. Затем выполните pages project create команда:

npx wrangler pages project create

Затем будет предложено указать имя проекта. Проект будет доступен по адресу <PROJECT_NAME>.pages.dev (или имя вашего проекта плюс несколько случайных символов, если такое имя уже занято). Также вам будет предложено указать продакшен-ветку.

Последующие развёртывания будут использовать оба этих значения (сохранённые в вашем node_modules/.cache/wrangler папка).

Теперь у вас есть пустой проект, и вы можете развернуть свои ресурсы для первого и всех последующих развёртываний в рабочей среде. Для этого выполните wrangler pages deploy команда:

npx wrangler pages deploy <BUILD_OUTPUT_DIRECTORY>

Найдите подходящий каталог выходных файлов сборки для вашего проекта в Директория сборки в разделе Framework presets.

Продакшен-развёртывание будет доступно по адресу <PROJECT_NAME>.pages.dev.

Чтобы развернуть ресурсы в preview-окружении, выполните:

npx wrangler pages deploy <OUTPUT_DIRECTORY> --branch=<BRANCH_NAME>

Для каждой созданной ветки вам будет доступен алиас ветки по адресу <BRANCH_NAME>.<PROJECT_NAME>.pages.dev.

Если вы хотите упростить процесс создания проекта и развертывания ресурсов, можно также использовать команду deploy, которая одновременно создает проект и развертывает ресурсы. При первом выполнении этой команды вам всё равно будет предложено указать имя проекта и ветку production. Как указано выше, эти значения будут кешированы для последующих развертываний. Если кеш уже существует, а вы хотите создать новый проект, вам потребуется выполнить create команда.

Если вы хотите получить с помощью Wrangler список всех доступных проектов для Direct Upload, используйте pages project list:

npx wrangler pages project list

Чтобы получить вывод в формате JSON для программной обработки или использования в скриптах, используйте --json флаг:

npx wrangler pages project list --json

Если вы хотите получить с помощью Wrangler список всех уникальных preview URL для конкретного проекта, используйте pages deployment list:

npx wrangler pages deployment list

Пошаговые инструкции по использованию Wrangler вместе с инструментами непрерывной интеграции, такими как GitHub Actions, Circle CI и Travis CI, для непрерывного развёртывания см. в Использование Direct Upload с непрерывной интеграцией.

Чтобы развернуть проект с помощью перетаскивания:

1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

   Перейдите в Workers & Pages ↗

2. Выберите Создать приложение > Начало работы > Перетащите ваши файлы.

3. Введите название проекта в соответствующее поле и перетащите файлы в область загрузки.

4. Выберите Развернуть сайт.

Проект будет обслуживаться с <PROJECT_NAME>.pages.dev. Затем перетащите каталог со сборкой в область загрузки. После успешной загрузки файлов выберите Save and Deploy и перейдите к вашему новому развёрнутому проекту.

После того как проект будет создан, выберите Создайте новое развёртывание чтобы начать создание новой версии сайта. Затем выберите, куда будет выполнено новое развертывание: в рабочую или превью-среду. Если вы выбрали превью-среду, можно создать новую ветку развертывания или указать уже существующую.

При использовании метода перетаскивания рядом с ресурсом появится красный значок предупреждения, если он слишком большой и поэтому не был загружен. В этом случае вы можете удалить такой ресурс, но не можете его заменить. Чтобы заменить его, нужно загрузить весь проект заново.

Если ваш проект представляет собой Direct Upload проекте у вас не будет возможности настроить управление production branch. Чтобы изменить production branch, потребуется вручную вызвать Update Project конечная точка в API.

curl --request PATCH \
"https://api.cloudflare.com/client/v4/accounts/{account_id}/pages/projects/{project_name}" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data "{\"production_branch\": \"main\"}"

Развертывания с помощью перетаскивания, выполненные из панели управления Cloudflare, в настоящее время не поддерживают компиляцию functions папка внутри Pages Functions. Чтобы развернуть functions папка, вам необходимо использовать Wrangler. При развёртывании проекта с помощью Wrangler, если functions папка существует в том месте, где выполняется команда, то functions папка будет загружена вместе с проектом.

Однако учтите, что _worker.js файл поддерживается как при развёртывании через Wrangler, так и при развёртывании перетаскиванием файлов из дашборда.