Удаленный репозиторий

Страница в процессе разработки.

Удаленный репозиторий на платформах для хостинга репозиториев, таких как GitLab, GitHub и Bitbucket, представляет собой хранилище, доступное через интернет для всех пользователей. Эти платформы обеспечивают централизованное место для хранения и управления проектами на основе системы контроля версий Git.

Engee имеет собственный удаленный репозиторий на хостинге GitLab по ссылке. Все пользователи, зарегистрированные в Engee, по умолчанию имеют доступ к удаленному репозиторию под логином/паролем учетной записи Engee.

Примеры интерфейса взяты с GitLab. Если вы используйте другой хостинг для работы с системой контроля версий — обратитесь к официальной документации соответствующего хостинга.

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

Удаленный репозиторий Engee

Зайдите на сайт удаленного репозитория Engee под логином/паролем от вашей учетной записи Engee. Откроется стартовое меню создания собственного проекта или присоединения к уже существующим:

Рассмотрим создание собственного проекта:

Выберите Create a project. Это откроет меню создания проекта. Будет предложен один из трех вариантов:
- Create blank project — создайте пустой проект для хранения файлов, планирования работы и совместной работы над кодом и/или для других целей.
- Create from template — создайте проект, предварительно заполненный необходимыми файлами, чтобы быстро приступить к работе. На выбор представлен ряд встроенных шаблонов под конкретные языки программирования и оболочки.
- Import project — перенесите данные из внешнего источника, например GitHub, Bitbucket или другого экземпляра (хостинга) GitLab.
Создайте пустой проект (blank project), указав имя, видимость (доступ другим пользователям), конфигурацию (создаст README-файл) и индикатор (slug) при необходимости:

Созданный проект выглядит так:

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

SSH-ключ генерируется автоматически при регистрации аккаунта Engee. Для работы с другими удаленными репозиториями (вне GitLab Engee) вам придется создавать ключ самостоятельно.

Для работы с удаленным репозиторием Engee используйте именно SSH-ссылку.

Рассмотрим подключение к чужим проектам.

Выберите Explore public projects в главном меню GitLab если еще не создавали собственный проект:

или выберите Explore projects из меню созданных проектов:

Оба варианта откроют раздел поиска проектов:

Перейдите в одну из вкладок: All (все проекты), Most starred (самые популярные) или воспользуйтесь фильтром по имени (Filter by name). Далее выберите нужный проект с пометкой Public (публичный доступ).

Вы можете клонировать все репозитории со знаком Public

(для публичного использования). Репозитории со знаком Internal

(для внутреннего пользования) по умолчанию закрыты для других пользователей. Вы можете запросить доступ к такому репозиторию через команду Request Access на странице репозитория.

На странице выбранного проекта клонируйте его с помощью SSH-ключа. Вы также можете клонировать репозиторий с помощью HTTPS, но это потребует ввода логина/пароля при каждом взаимодействии с репозиторием (если они не были сохранены в кэше):

Другие удаленные репозитории

Для работы с другими удаленными репозиториями (вне GitLab Engee) необходимо самостоятельно добавить SSH-ключ. Команды для добавления ключа вводятся в Git-терминал на персональном компьютере. Для этого необходимо добавить SSH-ключ по инструкции провайдера удаленного репозитория. Ниже рассмотрено на примере хостинга GitLab:

Сгенерируйте ключ с помощью команды ssh-keygen, введя ее в терминал Git:
```
ssh-keygen -C "<comment>"
```
Генератор предложит сохранить получившийся ключ. Менять директорию, куда сохраняется ключ, необязательно. Можно просто нажать Enter. По умолчанию ключ будет сохранен в директории /home/user/.ssh/id_rsa. Папка .ssh может быть скрыта в вашей ОС.
```
Generating public/private rsa key pair.
Enter file in which to save the key (/home/user/.ssh/id_rsa):
```
Затем утилита попросит ввести пароль. Ввод пароля необязателен. Далее нажмите Enter.
```
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
```
В указанной на втором этапе папке (/home/user/.ssh/id_rsa) появится файл с ключом в формате .pub. Откройте его как текст и скопируйте ключ.
```
cat ~/.ssh/id_rsa.pub
```
Вернитесь на хостинг GitLab. Нажмите на аватар пользователя и выберите в контекстном меню пункт Edit profile.
Откройте раздел SSH-keys, вставьте ранее скопированный ключ в специально отведенное для этого поле и нажмите на кнопку Add key:

Ключ имеет ограниченное время действия, которое можно продлить в разделе SSH-keys. Получив ключ, вы можете клонировать удаленные репозитории с GitLab для работы локально на компьютере и в Engee.

Для работы с ключами в среде Engee необходимо указать, какой именно ключ и с какого хостинга будет использован. Для этого применяется консольный текстовый редактор nano в командной строке img 41 1 2 :

Переключите командную строку в режим оболочки shell с помощью точки с запятой ; — командная строка сменит вид с engee> на shell>.
Введите команду открытия файла конфигурации SSH с помощью текстового редактора nano:
```
nano ~/.ssh/config
```
В окне редактора задайте адрес хостинга и путь до сгенерированного в нем ключа как в выделенном примере:
- Host — адрес хостинга.
- IdentityKey — путь до сгенерированного ключа.
Нажмите Ctrl+X, чтобы сохранить изменения (появится нижняя строка с запросом "Save modified buffer?"):

Нажмите Y для сохранения изменений и подтвердите сохранение в директорию клавишей Enter. После сохранения редактор nano закроется автоматически.
Теперь вы можете клонировать удаленный репозиторий в Engee.