Работа с Git

Перед началом работыПеред началом работы

Откройте проект DataSphere:

1. Выберите нужный проект в своем сообществе или на главной странице DataSphere во вкладке Недавние проекты.

2. Нажмите кнопку Открыть проект в JupyterLab и дождитесь окончания загрузки.
3. Откройте вкладку с ноутбуком.

Клонировать публичный репозиторий GitHubКлонировать публичный репозиторий GitHub

Чтобы клонировать существующий публичный репозиторий:

1. В левом навигационном меню в разделе File Browser создайте или выберите папку, в которой вы хотите создать клон репозитория, и перейдите в нее.
2. В верхнем меню нажмите Git и выберите Clone a Repository.
3. В открывшемся окне введите URI репозитория и нажмите кнопку Clone.

Папка клонированного репозитория появится в разделе File Browser.

Клонировать приватный репозиторий GitHubКлонировать приватный репозиторий GitHub

Для работы с приватным репозиторием вам потребуется персональный токен доступа к GitHub.

Клонируйте существующий приватный репозиторий:

1. В левом навигационном меню, в разделе File Browser, создайте или выберите папку, в которой вы хотите создать клон репозитория, и перейдите в нее.
2. В верхнем меню нажмите Git и выберите Clone a Repository.
3. В открывшемся окне введите URI репозитория и нажмите кнопку Clone.
4. В новом окне введите имя пользователя и токен доступа к GitHub. Нажмите Submit.

Папка клонированного репозитория появится в разделе File Browser.

Создать локальный репозиторийСоздать локальный репозиторий

Чтобы начать работу с локальным репозиторием:

1. В левом навигационном меню, в разделе File Browser, создайте или выберите папку, в которой вы хотите создать клон репозитория, и перейдите в нее.

2. В верхнем меню нажмите Git и выберите Initialize a Repository.

3. В открывшемся окне нажмите кнопку Yes.

4. Создайте в папке репозитория файл ноутбука.

5. Добавьте файл ноутбука под версионный контроль:

   1. Перейдите в блок Git.
   2. На вкладке Change в выпадающем списке Untracked найдите файл проекта.
   3. Справа от имени файла нажмите .

6. Сделайте начальный коммит:

   1. В поле Summary введите имя коммита.
   2. В поле Description введите описание коммита.
   3. Нажмите кнопку Commit.
   4. В открывшемся окне введите имя и адрес электронной почты автора коммита.
   5. Нажмите кнопку Ok.

Локальный репозиторий готов к работе.

Создать новую веткуСоздать новую ветку

1. В левом навигационном меню, в разделе File Browser, создайте или выберите папку, в которой вы хотите создать клон репозитория, и перейдите в нее.

2. В разделе Git раскройте выпадающий список Current Branch.

3. Нажмите кнопку New Branch.

4. В открывшемся окне:

   1. В поле Name введите имя новой ветки.
   2. В списке выберите ветку, на основе которой будет создана новая. Для быстрого поиска нужной ветки воспользуйтесь фильтром.
   3. Нажмите кнопку Create branch.

Созданная ветка отобразится в списке и станет текущей.

Записать изменения в локальный репозиторийЗаписать изменения в локальный репозиторий

Чтобы отредактировать данные и записать изменения в репозиторий:

1. Измените файлы, находящиеся под версионным контролем.

2. В верхнем меню нажмите File и выберите Save All, чтобы сохранить изменения.

3. В левом навигационном меню перейдите в раздел Git.

4. На вкладке Changes, в списке Changes, отобразятся отредактированные файлы. Буква M справа от имени файла указывает на то, что в файле есть изменения.

5. Справа от имени файла нажмите . Изменения проиндексируются, файл переместится в список Staged.

6. Чтобы зафиксировать изменения:

   1. В поле Summary введите имя коммита.
   2. В поле Description введите описание коммита.
   3. Нажмите кнопку Commit.
   4. В открывшемся окне введите имя и адрес электронной почты автора коммита.
   5. Нажмите кнопку Ok.

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

Отправить изменения в удаленный репозиторий на GitHubОтправить изменения в удаленный репозиторий на GitHub

Для работы с приватным репозиторием вам потребуется персональный токен доступа к GitHub.

Чтобы отправить в удаленный репозиторий сохраненные изменения:

1. В левом навигационном меню перейдите в раздел Git.

2. Нажмите кнопку Push committed changes.

3. В открывшемся окне:

   1. Введите имя пользователя с правом записи в удаленный репозиторий.
   2. Введите персональный токен доступа к GitHub.

4. Нажмите кнопку Ok.

5. Дождитесь появления надписи Successfully pushed.

   Изменения отправлены в удаленный репозиторий.

Получить изменения из удаленного репозиторияПолучить изменения из удаленного репозитория

1. Перейдите в блок Git.

2. Нажмите кнопку Pull latest changes.

3. Дождитесь появления надписи Successfully pulled.

   Изменения из удаленного репозитория получены.

Сохранить результаты в GitHubСохранить результаты в GitHub

Для работы с приватным репозиторием вам потребуется персональный токен доступа к GitHub.

Чтобы сохранить код проекта в новый репозиторий на GitHub:

1. Создайте новый пустой репозиторий на GitHub. Вы сможете добавить файлы README, license и gitignore позднее.

2. В проекте DataSphere создайте локальный репозиторий:

   1. В левом навигационном меню, в разделе File Browser, создайте или выберите папку, в которой вы хотите создать клон репозитория, и перейдите в нее.
   2. В верхнем меню нажмите Git и выберите Initialize a Repository.
   3. В открывшемся окне нажмите кнопку Yes.

3. Сопоставьте локальный репозиторий с удаленным репозиторием GitHub:

   1. В верхнем меню нажмите Git и выберите Manage Remote Repositories.
   2. В открывшемся окне введите имя и адрес удаленного репозитория и нажмите Add.
   3. Закройте окно добавления удаленных репозиториев.

4. Добавьте все нужные файлы под версионный контроль:

   1. Перейдите в блок Git.
   2. На вкладке Change, в выпадающем списке Untracked, найдите файл проекта.
   3. Справа от имени файла нажмите .

5. Сделайте начальный коммит:

   1. В поле Summary введите имя коммита.
   2. В поле Description введите описание коммита.
   3. Нажмите кнопку Commit.
   4. В открывшемся окне введите имя и адрес электронной почты автора коммита.
   5. Нажмите кнопку Ok.

6. Отправьте изменения в удаленный репозиторий:

   1. В верхнем меню нажмите Git и выберите Push to Remote.
   2. В открывшемся окне введите логин пользователя GitHub, от имени которого вы будете работать, и токен доступа к GitHub.

В репозитории на GitHub появятся файлы, которые вы добавили под версионный контроль.