Контроль версий Git

Контроль версий Git

Функция контроля версий Git ™ позволяет легко размещать репозитории Git в вашей учетной записи cPanel. Вы можете использовать Git для обслуживания любого набора файлов (например, файлов и ресурсов веб-сайта, проекта разработки программного обеспечения или простых текстовых файлов). Для получения дополнительной информации прочтите руководство по Git — документацию по настройке развертывания и документацию Git .Примечание:

Система добавляет ловушку после получения во все репозитории, управляемые cPanel. Для получения дополнительной информации прочтите документацию Git githooks .

Git в командной строке

Важный:

Без доступа к оболочке вы можете только создавать, клонировать, удалять и просматривать репозитории.

Если ваша учетная запись cPanel включает доступ к оболочке, вы также можете использовать Git из командной строки. Вы должны использовать командную строку для выполнения следующих задач:

Вы можете использовать интерфейс терминала cPanel ( cPanel >> Home >> Advanced >> Terminal ) для доступа к командной строке из интерфейса cPanel.

Репозитории

Примечание:

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

В таблице репозиториев приведена следующая информация для всех репозиториев Git, управляемых cPanel вашей учетной записи:

  • Репозиторий — отображаемое имя репозитория.
  • Путь к репозиторию — каталог репозитория.

Вы также можете выполнить следующие действия:

  • Управление — нажмите, чтобы обновить настройки репозитория, управляемые cPanel, или получить или развернуть изменения.
  • История — щелкните, чтобы открыть интерфейс Gitweb в новой вкладке браузера. Gitweb позволяет вам просматривать репозиторий и просматривать его историю и содержимое.
  • Удалить — нажмите, чтобы удалить управление репозиторием cPanel. Появится подтверждающее сообщение. Еще раз нажмите « Удалить», чтобы удалить репозиторий.Предупреждение:Когда вы удаляете управление репозиторием cPanel, репозиторий больше не будет отображаться в интерфейсе, и вы не сможете использовать cPanel для его развертывания. Однако система не удалит каталог репозитория или его данные. Чтобы полностью удалить данные репозитория, используйте интерфейс диспетчера файлов cPanel ( cPanel >> Главная >> Файлы >> Диспетчер файлов ) или ваш предпочтительный метод удаления файлов вручную.Помнить:Когда вы клонируете репозиторий, системе может потребоваться много времени для завершения. Список репозиториев отключит параметры для репозитория и будет отображать только имя репозитория, путь к репозиторию и сообщение о ходе выполнения клона.

Создать репозиторий

Чтобы создать новый репозиторий, выполните следующие действия:

  1. Щелкните Создать в правом верхнем углу интерфейса. Появится новый интерфейс.
  2. Выберите, следует ли клонировать существующий репозиторий, создать новый или добавить существующий в список репозиториев, управляемых cPanel:
    • Чтобы клонировать существующий репозиторий, убедитесь, что переключатель Клонировать репозиторий включен. Затем введите URL-адрес клонирования для репозитория, который вы хотите клонировать, в текстовое поле « URL-адрес клонирования» .Важный:Чтобы клонировать частные репозитории, необходимо выполнить дополнительные действия. Для получения дополнительной информации прочтите наше Руководство по Git — документация по настройке доступа к частным репозиториям .
    • Чтобы создать новый репозиторий или добавить существующий репозиторий в список репозиториев, управляемых cPanel, установите переключатель « Клонировать репозиторий» в положение «отключено».Важный:
      • Этот URL-адрес не может содержать пару имени пользователя и пароля.
      • Этот URL должен включать в себя http://https://ssh://или git://протоколы или использовать [email protected]/pathформат, в котором userпредставляет собой имя пользователя, example.comпредставляет домен, и pathпредставляет собой хранилище пути.
      • Вы не можете ввести путь к локальному репозиторию.
      • Система выполняет дополнительные проверки URL-адресов клонов, которые используют этот ssh://протокол. Для получения дополнительной информации прочтите раздел проверки ключа хоста SSH ниже.
  3. В текстовом поле «Путь к репозиторию» введите путь к каталогу, в котором будет находиться репозиторий.
    Примечание:
    • Если указанный каталог в настоящее время не существует, система создаст его.
    • Если указанный каталог уже содержит репозиторий, система автоматически добавит его в список репозиториев, управляемых cPanel.
    • Эта функция накладывает несколько ограничений на пути к репозиториям. Для получения дополнительной информации прочтите раздел ограничений пути к репозиторию ниже.
    • Если вы не добавляете в список существующий репозиторий, каталог должен быть пустым. Каталоги поддоменов содержат каталог cgi-bin, а также могут содержать .well-knownкаталог. Вы должны переместить их, прежде чем сможете создать репозиторий.
  4. В текстовом поле Repository Name введите желаемое отображаемое имя репозитория.
  5. Чтобы сразу создать еще один репозиторий, установите флажок « Создать другой» .
  6. Нажмите « Создать» или нажмите « Вернуться в список репозиториев», чтобы вернуться к списку репозиториев.

Проверка ключа хоста SSH

Если вы ввели URL-адрес клона SSH, при нажатии кнопки « Создать» система автоматически проверит наличие общедоступного ключа хоста SSH удаленного сервера. Система хранит этот ключ в /home/user/.ssh/known_hostsфайле, где userпредставляет ваше имя пользователя.

  • Если удаленный хост не зарегистрирован в системе, нажмите « Сохранить и продолжить», чтобы добавить его в файл (зарегистрировать). Вы можете нажать Показать информацию об идентификации хоста, чтобы просмотреть алгоритм хоста и отпечатки SHA-256 и MD5.
  • Если удаленный хост уже зарегистрирован, система создаст репозиторий.
  • Если открытый ключ удаленного хоста изменился, система отобразит предупреждение.
    • Для сторонних удаленных хостов проверьте объявления об обновлениях открытых ключей. Большинство компаний, размещающих репозитории, объявляют об этих изменениях.
    • Для удаленных хостов, которыми вы управляете, подумайте, не привели ли недавние события в вашей системе к изменению открытого ключа, или обратитесь к системному администратору.

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

Если вы не можете проверить действительность изменения, будьте осторожны, особенно если ваш репозиторий включает конфиденциальный контент. Измененный ключ SSH может указывать на атаку «злоумышленник посередине».

Ограничения пути к репозиторию

Эта функция накладывает несколько ограничений на пути к репозиториям.

Каталог .git

Предупреждение:

Не изменяйте и не удаляйте .gitкаталог репозитория или его содержимое. Изменение этих данных может безвозвратно вывести репозиторий из строя.

Система глобально запрещает публичный доступ к репозиториям ». gitкаталоги.

Ограничения персонажей

Вы не можете создавать, удалять или просматривать репозитории с путями, которые включают пробелы или любой из следующих символов

\ * | " ' < > & @ ` $ { } [ ] ( ) ; ? : = % #`

каталоги, управляемые cPanel

Вы не можете создавать, удалять или просматривать репозитории в следующих каталогах:Нажмите, чтобы просмотреть …

Управляйте репозиториями

Нажмите « Управление», чтобы изменить или развернуть репозитории. Щелкните Основная информация, чтобы просмотреть информацию о репозитории, или щелкните Извлечь или Развернуть, чтобы получить или развернуть изменения.

  • Путь к репозиторию — каталог репозитория. Щелкните, чтобы открыть каталог репозитория в интерфейсе диспетчера файлов cPanel ( cPanel >> Главная >> Файлы >> Диспетчер файлов ) на новой вкладке браузера.
  • Имя репозитория — отображаемое имя репозитория. Чтобы изменить это имя, введите новое имя и нажмите « Обновить» .
  • Выделенная ветвь — текущая извлеченная ветвь. Чтобы проверить другую ветку, выберите нужную ветку и нажмите « Обновить» .
    • Если вы выберете другую ветку, система автоматически получит изменения из удаленного репозитория при проверке этой ветки.
    • Если репозиторий является пустым репозиторием, система не будет отображать эту информацию.
  • В настоящее время извлеченная ветвь — текущая извлеченная локальная ветка. Щелкните, чтобы открыть интерфейс Gitweb в новой вкладке браузера.
  • Фиксация HEAD — в этом разделе интерфейса отображается информация о фиксации HEAD активной ветки (самой последней фиксации в ветке). Если репозиторий не включает никаких коммитов для текущей ветки или является пустым репозиторием, система не будет отображать какую-либо информацию о фиксации HEAD . Щелкните История, чтобы открыть интерфейс Gitweb в новой вкладке браузера.
    • Фиксация — значение SHA-1 для фиксации HEAD.
    • Автор — автор коммита HEAD.
    • Дата — дата коммита HEAD.
    • Сообщение фиксации для фиксации HEAD.
    • Удаленный URL-адрес — URL-адрес удаленного репозитория репозитория.
    • URL-адрес клонирования — URL-адрес, используемый для клонирования репозитория в другое место (например, на ваш локальный компьютер, другую учетную запись cPanel или учетную запись GitHub). Щелкните Копировать, чтобы скопировать этот URL-адрес в буфер обмена.
Git — Развертывание Git — Настройка доступа к частным репозиториям