INTEGRITY Документация

← Cloudflare Pages / pages / get-started

Интеграция с Git

В этом руководстве вы познакомитесь с Cloudflare Pages и развернете свой первый сайт на платформе Pages с помощью Git-интеграции. Git-интеграция обеспечивает автоматическую сборку и развертывание при каждом push изменений в подключенный GitHub или GitLab репозиторий.

Подключите ваш Git провайдер к Pages

Pages поддерживает GitHub ↗ и GitLab ↗. Чтобы создать свой первый проект Pages:

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

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

  2. Выберите Создать приложение > Pages > Подключение к Git.

Появится запрос на вход через предпочитаемого провайдера Git. Это позволит Cloudflare Pages развёртывать ваши проекты и обновлять PR развёртывания предпросмотра.

Выберите репозиторий GitHub

Можно выбрать проект GitHub из личного аккаунта или организации, которой предоставлен доступ к Pages. Это позволяет выбрать репозиторий GitHub для развёртывания через Pages. Поддерживаются как приватные, так и публичные репозитории.

Выберите репозиторий GitLab

При использовании GitLab вы можете выбрать проект из личного аккаунта или из группы GitLab, в которую входите. Это позволяет выбрать репозиторий GitLab для развертывания через Pages. Поддерживаются как приватные, так и публичные репозитории.

Настройте развёртывание

После выбора репозитория Git выберите Установка и авторизация и Начало настройки. После этого вы можете настроить деплой в Настройка сборок и деплоев.

Ваш имя проекта будет использовано для генерации имени хоста вашего проекта. По умолчанию оно совпадает с именем проекта Git.

Продакшен-ветка указывает ветку, которую Cloudflare Pages должен использовать для развёртывания продакшен-версии вашего сайта. Для большинства проектов это main или master ветка. Все остальные ветки, не являющиеся вашей production-веткой, будут использоваться для развёртывания предпросмотра.

Страница настройки сборок и деплоев с заполненными полями Project name и Production branch

Настройте параметры сборки

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

В дашборде доступен ряд пресетов для конкретных фреймворков. Эти пресеты задают значения команды сборки и каталога вывода сборки по умолчанию для выбранного фреймворка. Если вы не уверены, какие значения указать в этом разделе, см. Конфигурация сборки. Если этап сборки не нужен, оставьте Команда сборки поле пустым.

Поля настроек сборки, которые необходимо заполнить

Cloudflare Pages начинает работу из корневого каталога вашего репозитория. Именно оттуда стартует весь процесс сборки, включая этапы установки. Если вы хотите это изменить, укажите новый путь к корневому каталогу через Root directory (advanced) > Путь поле.

Заполненное поле Root directory

Основные сведения о конфигурации сборки

Команда сборки задаётся используемым фреймворком. Например, фреймворк Gatsby использует gatsby build в качестве команды сборки. Если вы работаете без фреймворка, оставьте Команда сборки поле пустым.

Каталог вывода сборки создаётся командой сборки. Каждый фреймворк имеет собственное соглашение об именовании, например, каталог вывода сборки называется /public для многих фреймворков.

Корневой каталог представляет собой место, где хранится содержимое вашего сайта. Если он не указан, Cloudflare считает корневым каталогом подключённый Git-репозиторий. Корневой каталог необходимо указывать в таких случаях, как монорепозитории, где в одном репозитории может находиться несколько проектов.

См. Конфигурация сборки, где это описано подробнее.

Переменные окружения

Переменные окружения представляют собой распространённый способ передать конфигурацию процессу сборки. При настройке проекта вы можете указать набор пар ключ-значение в качестве переменных окружения. После завершения первой сборки проекта их можно будет донастроить.

См. руководство по фреймворку Hexo чтобы узнать, как настроить переменную окружения с версией Node.js.

После того как вы выберете Framework preset либо оставили это поле пустым, если работали без фреймворка, настроили Root directory (advanced), и настроили ваш Переменные окружения (необязательно), вы готовы к развёртыванию.

Ваше первое развёртывание

После того как вы завершите настройку конфигурации сборки, выберите Save and Deploy. Логи сборки проекта будут выводиться по мере того, как Cloudflare Pages устанавливает зависимости проекта, собирает его и развертывает в глобальной сети Cloudflare.

Сведения о развертывании в панели управления Cloudflare

После завершения развёртывания проекта вы получите уникальный URL-адрес для просмотра развёрнутого сайта.

Управление сайтом

После первого деплоя выберите Перейти к проекту чтобы увидеть конфигурацию проекта в панели управления Cloudflare Pages. На этой странице отображаются текущий статус развертывания проекта, рабочий URL-адрес и связанный с ним коммит, а также все прошлые развертывания.

Панель управления сайтом с отображением сред и развёртываний

Удалите проект

Чтобы удалить проект Pages:

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

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

  2. Выберите проект Pages > Настройки > Удалить проект.

Расширенные настройки проекта

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