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

В этом руководстве описан полный процесс настройки: подключение вашей учетной записи 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.