На главную
- Облачные базы данных
- Хранилище S3
- Kubernetes
- Apps
- Обзор
- Принципы работы
- Подключение репозиториев
- Деплой frontend-приложений
- Деплой backend-приложений
- Деплой из Dockerfile
- Управление Apps в панели
- Частые вопросы об Apps
Подключение репозиториев
Подключить нужный репозиторий вы можете в процессе создания нового приложения в разделе «Apps».
Сервис поддерживает подключение репозиториев, созданных в ваших аккаунтах GitLab, GitHub и BitBucket, а также подключение по URL любых репозиториев с внешним адресом, в том числе развернутых в Gitea, self-hosted GitLab, GitHub Enterprise и др.
Подключение репозитория из GitLab, GitHub или BitBucket
Чтобы подключить репозиторий:
- Перейдите в раздел «Apps» и нажмите «Создать».
-
На шаге «Репозиторий» кликните на иконку нужной платформы.
-
Авторизуйтесь в своем аккаунте.
-
Предоставьте доступ к нужным репозиториям.
-
Выберите в панели репозиторий для деплоя.
Если вы уже авторизованы в своем аккаунте GitHub, GitLab или Bitbucket, панель автоматически отобразит доступные репозитории. Вам достаточно выбрать нужный.
Если вы авторизованы, но нужного репозитория нет в списке:
- Кликните «Добавить аккаунт».
-
Выберите платформу.
-
Авторизуйтесь при необходимости.
-
Выберите нужные репозитории и сохраните изменения.
После выберите в панели нужный репозиторий для деплоя.
Подключение репозитория по ссылке
Вы можете подключить к сервису Apps любой репозиторий, у которого есть внешний HTTP- или HTTPS-адрес, в том числе репозитории из self-hosted GitLab, GitHub Enterprise или репозитории, размещенные у провайдеров, которые мы не поддерживаем напрямую (например, Gitea).
Также опцию можно использовать в целях безопасности: если вы не хотите выдавать доступ ко всему Git-аккаунту целиком, с помощью ссылки можно подключить только отдельный репозиторий.
Обратите внимание, что для репозиториев, подключенных по ссылке, будет недоступен автодеплой — после внесения изменений в код потребуется запустить деплой приложения вручную, выбрав нужный коммит.
- Если репозиторий публичный, достаточно указать только URL.
- Если репозиторий приватный, потребуются реквизиты для доступа — логин и пароль от учетной записи или токен, который генерируется в интерфейсе провайдера (GitLab, GitHub и т.д.) в настройках репозитория или аккаунта.
Подключение репозитория
Подключить репозиторий по ссылке можно при создании нового приложения:
- Перейдите в раздел «Apps» и нажмите «Создать».
- В пункте «Репозиторий» кликните «Добавить аккаунт» и далее — «Подключите git-репозиторий по URL».
- Укажите ссылку на репозиторий и реквизиты доступа, если репозиторий приватный.
- Нажмите «Подключить».
Подключенный репозиторий и доступные коммиты отобразятся в панели управления.
Получение ссылки
Ссылка для подключения должна быть в формате Git URL, например:
https://github.com/timeweb-cloud/app-example-celery.git
В GitHub можно получить нужную ссылку, кликнув на Code → HTTPS:
Аналогично в GitLab или BitBucket: перейти в нужный репозиторий → клик на Code/Clone → Clone with HTTPS.
Получение ссылки и токена в BitBucket
В BitBucket есть два способа получения токена и ссылки.
Первый способ:
- Перейдите в Personal Bitbucket settings > App password.
- Задайте имя (Label) и права; достаточно прав на чтение (Read).
- Нажмите Create.
- Скопируйте пароль и вставьте его в поле Пароль или токен в панели Timeweb Cloud.
- Зайдите в репозиторий и нажмите Clone. Скопируйте всё, что идет после
git clone
, и вставьте в поле URL репозитория.
- Скопируйте часть ссылки между
https://
и@
и вставьте в поле Имя пользователя.
Второй способ:
- Перейдите в Settings → Repository settings → Access token → Create Repository Access Token.
- Задайте имя и права (Scopes). Достаточно прав на чтение репозиториев.
- Скопируйте значение из поля Your Repository Access Token и вставьте его в поле Пароль или токен в панели Timeweb Cloud.
- В качестве ссылки на репозиторий используйте URL из поля How to use this token with your Git repositiry. Скопируйте всё, что идет после
git clone
, и вставьте в поле URL репозитория в панели Timeweb Cloud.
Получение токена в GitHub
Подключить репозиторий GitHub с помощью пароля от учетной записи не получится; для этого необходим именно токен.
Чтобы сгенерировать токен в GitHub:
- Перейдите в Settings → Developer Settings → Personal access tokens → Tokens → Generate a personal access token.
- Задайте имя токена, срок действия и разрешения. Для работы с приватными репозиториями нужно выбрать repo.
- Нажмите Generate token.
- Скопируйте токен и вставьте его в поле Пароль или токен в панели Timeweb Cloud.
Получение токена в GitLab
Для подключения репозиториев GitLab можно использовать пароль от учетной записи или токен, сгенерированный в настройках вашего аккаунта GitLab.
- Перейдите в Preferences → Access Tokens.
- Cоздайте новый токен, указав его имя, срок действия и разрешения. Как минимум, потребуется разрешение на чтение репозиториев.
- Нажмите Create personal access token.
- Скопируйте токен и вставьте его в поле Пароль или токен в панели Timeweb Cloud.
Удаление подключенных репозиториев
Любой добавленный репозиторий можно отвязать от панели управления на странице создания нового приложения.
При отключении репозитория любые деплои (как автоматические, так и ручные) всех приложений, созданных из этого репозитория, станут невозможны.
- Перейдите в раздел Apps и нажмите «Добавить».
- Кликните на выпадающий список репозиториев и нажмите «Удалить» у нужного из них.
- На следующем шаге подтвердите действие.
Сервис Apps не видит нужный репозиторий
Если ваш аккаунт GitHub, Gitlab или Bitbucket подключен, но в панели управления не отображается нужный репозиторий, причин может быть две:
-
Вы авторизовались в свой аккаунт GitHub, Gitlab или Bitbucket в сервисе Apps, а после этого добавили новый репозиторий.
-
Вы разрешили подключить только отдельные репозитории, а не все, и нужный репозиторий не выбран.
Чтобы решить проблему:
-
Кликните «Добавить аккаунт».
-
Выберите платформу.
-
Авторизуйтесь, если необходимо.
-
Выберите нужный репозиторий и сохраните изменения.
Подключенные репозитории отобразятся в панели управления, и вы сможете выбрать нужный.
Была ли статья полезна?