Подключение репозиториев

Подключить нужный репозиторий вы можете в процессе создания нового приложения в разделе «Apps».

Сервис поддерживает подключение репозиториев, созданных в ваших аккаунтах GitLab, GitHub и BitBucket, а также подключение по URL любых репозиториев с внешним адресом, в том числе развернутых в Gitea, self-hosted GitLab, GitHub Enterprise и др.

В настоящее время поддержка Git LFS отсутствует. При размещении проектов, которые содержат большие статичные файлы, рекомендуем использовать внешние хранилища, например, S3.

Подключение репозитория из GitLab, GitHub или BitBucket

Чтобы подключить репозиторий:

1. Перейдите в раздел «Apps» и нажмите «Создать».

2. На шаге «Репозиторий» кликните на иконку нужной платформы.

3. Авторизуйтесь в своем аккаунте.

4. Предоставьте доступ к нужным репозиториям.

5. Выберите в панели репозиторий для деплоя. 

Если вы уже авторизованы в своем аккаунте GitHub, GitLab или Bitbucket, панель автоматически отобразит доступные репозитории. Вам достаточно выбрать нужный.

Если вы авторизованы, но нужного репозитория нет в списке:

1. Кликните «Добавить аккаунт».

2. Выберите платформу.

3. Авторизуйтесь при необходимости.

4. Выберите нужные репозитории и сохраните изменения.

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

Подключение репозитория по ссылке

Вы можете подключить к сервису Apps любой репозиторий, у которого есть внешний HTTP- или HTTPS-адрес, в том числе репозитории из self-hosted GitLab, GitHub Enterprise или репозитории, размещенные у провайдеров, которые мы не поддерживаем напрямую (например, Gitea).

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

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

• Если репозиторий публичный, достаточно указать только URL.
• Если репозиторий приватный, потребуются реквизиты для доступа — логин и пароль от учетной записи или токен, который генерируется в интерфейсе провайдера (GitLab, GitHub и т.д.) в настройках репозитория или аккаунта.

Подключение репозитория

Подключить репозиторий по ссылке можно при создании нового приложения:

1. Перейдите в раздел «Apps» и нажмите «Создать».
2. В пункте «Репозиторий» кликните «Добавить аккаунт» и далее — «Подключите git-репозиторий по URL».

3. Укажите ссылку на репозиторий и реквизиты доступа, если репозиторий приватный. 

4. Нажмите «Подключить».

Подключенный репозиторий и доступные коммиты отобразятся в панели управления.

Получение ссылки

Ссылка для подключения должна быть в формате Git URL, например:

https://github.com/timeweb-cloud/app-example-celery.git

В GitHub можно получить нужную ссылку, кликнув на Code → HTTPS:

Аналогично в GitLab или BitBucket: перейти в нужный репозиторий → клик на Code/Clone → Clone with HTTPS.

Получение токена в BitBucket

В BitBucket есть два способа получения токена и ссылки.

Первый способ:

1. Перейдите в Personal Bitbucket settings > App password.

2. Задайте имя (Label) и права; достаточно прав на чтение (Read).

3. Нажмите Create.
4. Скопируйте пароль и вставьте его в поле Пароль или токен в панели Timeweb Cloud. 
5. Зайдите в репозиторий и нажмите Clone. Скопируйте всё, что идет после git clone, и вставьте в поле URL репозитория.

6. Скопируйте часть ссылки между https:// и @ и вставьте в поле Имя пользователя.

Второй способ:

1. Перейдите в Settings → Repository settings → Access token → Create Repository Access Token.
2. Задайте имя и права (Scopes). Достаточно прав на чтение репозиториев.

3. Скопируйте значение из поля Your Repository Access Token и вставьте его в поле Пароль или токен в панели Timeweb Cloud. 

4. В качестве ссылки на репозиторий используйте URL из поля How to use this token with your Git repositiry. Скопируйте всё, что идет после git clone, и вставьте в поле URL репозитория в панели Timeweb Cloud. 

Получение токена в GitHub

Подключить по ссылке репозиторий GitHub с помощью пароля от учетной записи не получится; для этого необходим именно токен.

Чтобы сгенерировать токен в GitHub:

1. Перейдите в Settings → Developer Settings → Personal access tokens → Tokens → Generate a personal access token.
2. Задайте имя токена, срок действия и разрешения. Для работы с приватными репозиториями нужно выбрать repo.

3. Нажмите Generate token.
4. Скопируйте токен и вставьте его в поле Пароль или токен в панели Timeweb Cloud.

Получение токена в GitLab

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

Чтобы сгенерировать токен:

1. Перейдите в Preferences → Access Tokens.
2. Cоздайте новый токен, указав его имя, срок действия и разрешения. Как минимум, потребуется разрешение на чтение репозиториев.
3. Нажмите Create personal access token.
4. Скопируйте токен и вставьте его в поле Пароль или токен в панели Timeweb Cloud.

Удаление подключенных репозиториев

Любой добавленный репозиторий можно отвязать от панели управления на странице создания нового приложения.

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

1. Перейдите в раздел Apps и нажмите «Добавить».
2. Кликните на выпадающий список репозиториев и нажмите «Удалить» у нужного из них.

3. На следующем шаге подтвердите действие.

Сервис Apps не видит нужный репозиторий

Если ваш аккаунт GitHub, Gitlab или Bitbucket подключен, но в панели управления не отображается нужный репозиторий, причин может быть две:

• Вы авторизовались в свой аккаунт GitHub, Gitlab или Bitbucket в сервисе Apps, а после этого добавили новый репозиторий.

• Вы разрешили подключить только отдельные репозитории, а не все, и нужный репозиторий не выбран.

Чтобы решить проблему:

1. Кликните «Добавить аккаунт».

2. Выберите платформу.

3. Авторизуйтесь, если необходимо.

4. Выберите нужный репозиторий и сохраните изменения.

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