Подключение GitHub

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

Как работает подключение

Подключение GitHub состоит из 2 этапов:

1. Подключите свою учетную запись GitHub. Это дает Atoms разрешение работать с GitHub от вашего имени.
2. Создайте репозиторий для своего проекта. Репозиторий — это приватное пространство в GitHub, где хранятся код вашего проекта и история изменений.

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

Перед началом

Перед подключением вашего проекта к GitHub убедитесь, что:

• Ваш тариф Atoms включает подключение GitHub. Если вы используете тариф Free, выбор GitHub перенаправит вас на страницу Plans.
• Только владелец рабочего пространства может подключать или отключать GitHub. Если вы редактор, попросите владельца рабочего пространства выполнить этот шаг.
• У вас есть учетная запись GitHub или вы готовы создать ее во время настройки.
• Ваш браузер разрешает всплывающие окна от Atoms.
• В данный момент над вашим проектом не работают Agents.

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

Подключите свою учетную запись GitHub

Откройте коннектор GitHub

1. Откройте проект, который хотите подключить.
2. Нажмите на название проекта в правом верхнем углу панели чата.
3. Выберите Connectors в появившемся раскрывающемся меню.
4. Найдите Github в списке доступных коннекторов и нажмите connect.

Вы также можете открыть Settings → Connectors → GitHub и выбрать Connect.

Откройте Settings → Connectors и выберите Connect для GitHub.

Авторизуйте Atoms в GitHub

Если в поле Connected Account уже отображается нужная вам учетная запись GitHub, значит, она уже авторизована. Вы можете перейти к разделу Create a private repository.

1. Atoms откроет окно авторизации GitHub. Войдите в учетную запись GitHub, которую хотите подключить, или при необходимости создайте новую учетную запись.
2. Убедитесь, что вы вошли в правильную учетную запись GitHub.
3. Просмотрите разрешения, запрашиваемые Atoms. Если вы согласны, выберите Authorize Atoms-Agents.
4. Вернитесь в Atoms и дождитесь сообщения Connect success.
5. В Atoms откройте Connectors и убедитесь, что ваша учетная запись GitHub отображается как подключенная.

Atoms запрашивает OAuth-разрешения repo, read:user и workflow. Они позволяют Atoms читать и записывать публичные и приватные репозитории, к которым имеет доступ подключенная учетная запись, читать базовую информацию профиля, а также добавлять или обновлять файлы workflow для GitHub Actions.

Эта авторизация применяется к подключенной учетной записи GitHub и не ограничивается репозиторием, созданным для текущего проекта Atoms. Atoms не может получить доступ к репозиториям, к которым сама подключенная учетная запись не имеет доступа, а политики организации могут накладывать дополнительные ограничения.

Просмотрите разрешения GitHub и выберите Authorize Atoms-Agents.

Создайте приватный репозиторий

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

1. В разделе Connected Account убедитесь, что отображаемое имя пользователя соответствует учетной записи GitHub, которую вы хотите использовать.
2. В разделе Create New Repository введите имя репозитория. Имя должно:
   • содержать от 1 до 100 символов;
   • использовать только буквы, цифры, дефисы (-), подчеркивания (_) или точки (.).
3. Выберите Create.
4. Дождитесь сообщения GitHub repository connected successfully!.

Atoms создает новый приватный репозиторий в личной учетной записи GitHub подключенного пользователя, связывает его с текущим проектом Atoms, а затем пытается загрузить текущие файлы проекта в GitHub.

Введите имя и создайте новый приватный репозиторий.

Проверьте, что подключение работает

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

1. В Atoms убедитесь, что Repository Status показывает Connected.
2. В разделе Branches убедитесь, что у одной ветки стоит галочка. Это ветка, которая в данный момент подключена к вашему проекту Atoms. Если вы новичок в GitHub, оставьте выбранной эту ветку.
3. Выберите View on GitHub.
4. В GitHub убедитесь, что репозиторий:
   • принадлежит правильной учетной записи GitHub;
   • помечен как Private;
   • содержит ожидаемые файлы проекта; и
   • имеет как минимум один commit.

Если репозиторий пуст и в Atoms доступна кнопка Push Changes, выберите ее и дождитесь завершения операции. Затем обновите страницу репозитория в GitHub и убедитесь, что файлы проекта теперь отображаются.

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

Проверьте приватный репозиторий и файлы проекта в GitHub.

Поддерживайте синхронизацию Atoms и GitHub

Atoms и GitHub не синхронизируются автоматически. Когда изменения были внесены на одной из сторон, используйте элементы управления синхронизацией, чтобы перенести эти изменения на другую сторону.

Действие	Когда использовать	Что происходит
Push Changes	Вы внесли изменения в Atoms и хотите отправить их в GitHub.	Atoms отправляет текущие файлы проекта в выбранную ветку GitHub.
Pull Updates	В выбранную ветку GitHub были внесены изменения, и вы хотите перенести их в Atoms.	Atoms обновляет проект последними изменениями из GitHub.

Перед отправкой или получением изменений дождитесь, пока Agent завершит работу, и убедитесь, что вы просматриваете последнюю версию проекта в Chat. Если вы открыли более старую версию из History, вернитесь к карточке последней версии внизу Chat, затем снова откройте GitHub.

Если вы не находитесь в последней версии, Atoms покажет сообщение You must be on the latest version to pull updates or push changes.

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

Если и в Atoms, и в GitHub есть изменения, которые необходимо сохранить, пока не синхронизируйте их. Сначала сохраните копию важной работы или попросите кого-то, кто хорошо знаком с GitHub, сохранить изменения в отдельной ветке.

Если Repository Status показывает Upstream Changes Available, это означает, что в GitHub есть изменения, которых еще нет в Atoms. Просмотрите репозиторий, прежде чем выбирать действие.

Используйте Pull Updates и Push Changes для выбранной ветки.

Отправка изменений из Atoms в GitHub

1. Завершите внесение изменений в Atoms и дождитесь, пока Agent прекратит работу.
2. Убедитесь, что вы просматриваете последнюю версию проекта.
3. Откройте Settings → Connectors → GitHub и убедитесь, что выбрана правильная ветка.
4. Выберите Push Changes.
5. Не закрывайте страницу, пока изменения отправляются.
6. Когда появится сообщение Changes pushed successfully, выберите View on GitHub и убедитесь, что там находятся последние файлы проекта.

Push Changes доступно только тогда, когда в Atoms есть изменения, которые еще не были отправлены в GitHub. Эта функция недоступна, пока работает Agent или когда вы просматриваете старую версию проекта.

После выбора Push Changes изменения немедленно отправляются в GitHub без запроса подтверждения. Если один и тот же файл был изменен и в Atoms, и в GitHub, приоритет имеет версия из Atoms и она перезапишет версию, которая в данный момент хранится в GitHub.

Получение обновлений из GitHub в Atoms

В отличие от отправки, получение изменений сначала требует подтверждения. Если один и тот же файл был изменен и в GitHub, и в Atoms, приоритет имеет версия GitHub и она перезапишет текущую версию в Atoms.

1. Откройте Settings → Connectors → GitHub.
2. Убедитесь, что Repository Status показывает новые изменения из GitHub и что выбрана правильная ветка.
3. Выберите Pull Updates.
4. Прочитайте предупреждение Pull May Affect Project. Если вы хотите перенести изменения из GitHub в текущий проект Atoms, выберите Confirm.
5. Не закрывайте страницу, пока изменения загружаются.
6. Когда появится сообщение Changes pulled successfully, откройте Просмотр приложений и протестируйте части проекта, затронутые изменениями, чтобы убедиться, что все по-прежнему работает как ожидается.

Pull Updates доступно только тогда, когда выбранная ветка GitHub содержит изменения, которые еще не были перенесены в Atoms.

Отключение GitHub

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

Авторизация GitHub применяется к подключенной учетной записи. Отзыв доступа отключает каждый проект Atoms, использующий эту учетную запись GitHub, поэтому перед продолжением проверьте другие свои проекты.

1. Откройте Settings → Connectors → GitHub.
2. Выберите Disconnect.
3. В окне подтверждения Disconnect GitHub снова выберите Disconnect.
4. GitHub должен автоматически открыть соответствующую страницу авторизации. Если этого не произошло, в GitHub перейдите в Settings → Applications → Authorized OAuth Apps.
5. Найдите Atoms, выберите ... справа в его строке, затем выберите Revoke. Не выбирайте Revoke all; это действие удаляет доступ для всех авторизованных OAuth-приложений, перечисленных на странице.
6. Выполните все необходимые шаги подтверждения в Github.
7. Вернитесь в Atoms и снова откройте коннектор GitHub, чтобы убедиться, что учетная запись больше не подключена.

Выберите Disconnect в коннекторе GitHub.

Отзовите только OAuth-приложение Atoms в GitHub.