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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Получение ссылки в GitHub, GitLab или BitBucket

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

    

      

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

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

Получение ссылки на репозиторий в интерфейсе GitHub

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

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

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

Получение ссылки на репозиторий в интерфейсе Sourcecraft

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

Перейдите на главную страницу вашего репозитория. Нажмите на кнопку «Код» и скопируйте ссылку из вкладки «HTTPS».

Получение ссылки на репозиторий в интерфейсе GitFlic

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

Перейдите на главную страницу вашего репозитория. Нажмите на кнопку «Код» и скопируйте ссылку из вкладки «HTTPS».

Получение ссылки на репозиторий в интерфейсе GitVerse

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

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

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

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

Раздел «Settings» в интерфейсе Bitbucket

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

Раздел «App passwords» в интерфейсе Bitbucket

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

Окно «Clone this repository» в интерфейсе Bitbucket

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

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

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

Раздел «Create Repository Access Token» в интерфейсе Bitbucket

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

Окно с токеном в интерфейсе Bitbucket

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

Окно с токеном в интерфейсе Bitbucket

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

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

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

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

Создание нового токена в интерфейсе GitHub

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

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

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

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

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

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

1. Перейдите на главную страницу панели управления.

2. В левом меню перейдите в раздел «Доступ» → «Персональные токены доступа».

Раздел «Персональные токены доступа» в интерфейсе Sourcecraft

3. Нажмите кнопку «Создать новый токен».

4. Укажите имя токена и время жизни, а также выберите репозиторий, к которому нужен доступ, или выберите пункт «Все репозитории». В пункте «Роль» достаточно выбрать минимальные права — «Просмотр репозитория».

5. Скопируйте полученный токен и вставьте его в поле «Пароль или токен». В поле «Имя пользователя» укажите логин вашего аккаунта Sourcecraft.

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

1. Нажмите на иконку пользователя в правом верхнем углу и в открывшемся меню выберите «Настройки».

2. В правом меню перейдите в раздел API токены.

3. Нажмите кнопку «Создать».

4. Укажите название токена и выберите дату окончания его действия. Если ничего не указывать, токен будет бессрочным.

5. Для токена достаточно выдать минимальные права — на чтение.

6. Нажмите кнопку «Создать токен».

7. Скопируйте полученный токен и вставьте его в поле «Пароль или токен». В поле «Имя пользователя» укажите логин вашего аккаунта GitFlic.

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

1. Нажмите на иконку пользователя в правом верхнем углу и в открывшемся меню выберите «Настройки».

2. Перейдите в раздел Управление токенами.

3. Укажите имя токена и срок его действия.

4. В разделе «Функциональность» достаточно выбрать минимальные права — чтение для репозиториев.

5. Нажмите кнопку «Генерировать токен».

6. Скопируйте полученный токен и вставьте его в поле «Пароль или токен». Для подключения репозитория GitVerse достаточно указать токен и ссылку на репозиторий.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Окно «Repository access» в интерфейсе GitHub

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