Клонирование и использование репозитория GitHub в Visual Studio Code
Сведения о клонировании общедоступного репозитория из GitHub на локальный компьютер с помощью Visual Studio Code.
Клонировать репозиторий
Действие клонирования репозитория GitHub означает перенос облачного исходного кода в локальную среду разработки.
- Панель действий
- Строка состояния
- Палитра команд
- Встроенный терминал
Это действие недоступно из этой функции. Выберите другую вкладку.
Это действие недоступно из этой функции. Выберите другую вкладку.
- Откройте палитру команд с сочетанием клавиш CTRL SHIFT + + P.
- В командной строке палитры введите gitcl , выберите команду Git: Клонировать , а затем выберите «Клонировать» из GitHub и нажмите клавишу ВВОД.
- Если появится запрос на ввод URL-адреса репозитория, выберите параметр клонирования из GitHub и нажмите клавишу ВВОД.
- Если вам будет предложено войти в GitHub, завершите процесс входа.
- Введите azure-samples/js-e2e-express-server в поле URL-адрес репозитория.
- Выберите (или создайте) локальный каталог, в который нужно клонировать проект, а затем выберите » Выбрать в качестве назначения репозитория».
- Когда появится уведомление с вопросом, нужно ли открыть клонированный репозиторий, выберите вариант Открыть.
git clone https://github.com/YOUR-NAME-OR-ORGANIZATION/YOUR-REPO-NAME
cd YOUR-REPO-NAME
code .
Инициализация нового репозитория
Если у вас еще нет репозитория GitHub, но вы хотите запустить проект локально, инициализируйте папку с помощью Git.
- Панель действий
- Строка состояния
- Палитра команд
- Встроенный терминал
- Выберите элемент управления версиями на панели действий или используйте сочетание клавиш CTRL + SHIFT + G.
- Выберите репозиторий Initialize.
Это действие недоступно из этой функции. Выберите другую вкладку.
- Откройте палитру команд с сочетанием клавиш CTRL SHIFT + + P.
- Отфильтруйте с Git помощью , а затем выберите Initialize repository .
- Выберите папку, чтобы выбрать в качестве корневого каталога репозитория.
git init
Создание ветви для изменений
- Панель действий
- Строка состояния
- Палитра команд
- Встроенный терминал
- Выберите элемент управления версиями на панели действий.
- Выберите многоточие (. ) рядом с элементом управления версиями.
- Выберите «Ветвь ->Создать ветвь«.
- Выберите имя ветви в строке состояния. Откроется палитра команд. Строка состояния находится в нижней части Visual Studio Code.
- Выберите в палитре команд элемент Создание ветви.
- Введите имя для новой ветви.
- Введите имя для новой ветви. Экран «Отображение имени ветви в строке состояния».
- Откройте палитру команд с сочетанием клавиш CTRL SHIFT + + P.
- Найдите элемент git branch и выберите Git: Create Branch .
- Введите новое имя ветви, например test .
- Экран «Отображение имени ветви в строке состояния».
- Откройте интегрированный терминал из терминала —> новый терминал.
- Создайте новую ветвь с помощью MY-BRANCH следующей команды Git:
git checkout -b MY-BRANCH
Фиксация изменений локально
После внесения изменений в ветвь зафиксируйте изменения.
- Панель действий
- Строка состояния
- Палитра команд
- Встроенный терминал
- Выберите элемент управления версиями на панели действий.
- Введите сообщение о фиксации, а затем нажмите кнопку «Зафиксировать«.
Это действие недоступно из этой функции. Выберите другую вкладку.
- Откройте палитру команд с сочетанием клавиш CTRL SHIFT + + P.
- В палитре команд фильтруйте с Git помощью выбора Commit .
- Введите сообщение фиксации, а затем нажмите клавишу ВВОД .
git commit -m "YOUR COMMIT MESSAGE"
Отправка локальной ветви в GitHub
- Панель действий
- Строка состояния
- Палитра команд
- Встроенный терминал
- Щелкните значок «Система управления версиями» на панели действий.
- Выберите «Опубликовать ветвь«. Если репозиторий не существует на GitHub, он создает репозиторий для вас.
- В строке состояния Visual Studio Code выберите значок отправки справа от имени ветви.
- Выберите имя удаленного расположения во всплывающем окне. Если вы имеете только одно удаленное расположение, вам не будет предложено выбрать имя такого расположения.
- Откройте палитру команд с сочетанием клавиш CTRL SHIFT + + P.
- В палитре команд фильтруйте с Git помощью выбора Push .
- Если у вас несколько вышестоящий удаленных, выберите удаленный, а затем нажмите клавишу ВВОД .
- Откройте интегрированный терминал из терминала —> новый терминал.
- Создайте новую ветвь с помощью MY-BRANCH следующей команды Git:
git push
Просмотр выходных данных Git
Вы можете просмотреть команды Git, выполняемые при использовании расширения системы управления версиями. Это помогает отладить при сбое команды.
- Щелкните значок «Система управления версиями» на панели действий.
- Щелкните многоточие (. ) и выберите элемент Показать выходные данные Git.
Инструменты Visual Studio Code для работы с Git и GitHub
При работе в Visual Studio Code с репозиторием необходимо использовать отдельные средства.
Icon Информация Доступ из Команды Git в палитре команд F1 Расширение системы управления версиями Панель действий Расширение запросов на вытягивание и сообщений о проблемах на GitHub Панель действий Расширение репозиториев GitHub Вы можете быстро и без труда открыть репозиторий GitHub. Для этого можно выполнить поиск репозиториев GitHub и выбрать команду «Открыть репозиторий» в палитре команд, нажать клавишу F1 или выбрать команду Open GitHub Repository. (Открыть репозиторий GitHub) из удаленного индикатора (зеленая кнопка слева в нижнем углу строки состояния). Следующие шаги
- Узнайте о развертывании веб-приложения
- Работа с GitHub в Visual Studio Code
- Использование Visual Studio Code с другими поставщиками систем управления версиями
Как клонировать репозиторий на GitHub
Одно из самых базовых действий на GitHub — клонирование репозитория.
Время чтения: меньше 5 мин
Открыть/закрыть навигацию по статье
Обновлено 16 апреля 2024
Задача
Скопировать ссылку «Задача» Скопировано
Клонировать репозиторий на локальный компьютер.
Готовое решение
Скопировать ссылку «Готовое решение» Скопировано
Чтобы клонировать репозиторий, нужно установить на компьютер Git CLI. Как это сделать описано в статьях «Системы управления версиями» и «Git CLI».
Выполните в терминале команду:
git clone
git clone ссылка на репозиторий>
Чтобы найти ссылку на репозиторий, выберите вкладку «<> Code» в репозитории на GitHub. Когда переходите к нужному проекту, эта вкладка открывается по умолчанию. Найдите в основной части вкладки аккордеон, который тоже называется «<> Code» и разверните его. В развернувшейся панели по умолчанию будет выбрана «Local». В ней выберите формат ссылки.
Первые «HTTPS» и «SSH» — это ссылки на репозиторий, использование которых подходит для стандартной команды клонирования, описанной выше. SSH ссылка будет работать в том случае, если настроили доступ по SSH. Для этого надо установить публичный ключ в настройках профиля на GitHub. Подробнее в рецепте «Как настроить доступ по SSH на GitHub». Третий формат — «GitHub CLI». Он набран в виде команды, которая будет работать, если у вас установлен GitHub CLI.
После выбора скопируйте из поля нужную ссылку или команду. Поле расположено после типов ссылок.
После выполнения команды git clone в вашей текущей папке появится папка с тем же именем, что и сам репозиторий. Если хотите указать другую папку для репозитория, укажите в конце команды для клонирования её название:
git clone
git clone ссылка на репозиторий> папка>
A3.2 Приложение C: Команды Git - Клонирование и создание репозиториев
Существует два способа создать Git репозиторий. Первый — клонировать его из существующего репозитория (например, по сети); второй — создать репозиторий в существующем каталоге.
git init
Чтобы превратить обычный каталог в Git репозиторий и начать версионировать файлы в нём, просто запустите git init .
Впервые мы продемонстрировали эту команду в разделе Создание Git-репозитория главы 2 на примере создания нового репозитория для последующей работы с ним.
Мы немного поговорили о смене названия ветки по умолчанию с «master» на что-нибудь другое в разделе Удалённые ветки главы 3.
Мы использовали эту команду для создания чистого репозитория для работы на стороне сервера в разделе Размещение голого репозитория на сервере главы 4.
Ну и наконец мы немного покопались во внутренностях этой команды в разделе Сантехника и Фарфор главы 10.
git clone
На самом деле git clone работает как обёртка над некоторыми другими командами. Она создаёт новый каталог, переходит внутрь и выполняет git init для создания пустого репозитория, затем она добавляет новый удалённый репозиторий ( git remote add ) для указанного URL (по умолчанию он получит имя origin ), выполняет git fetch для этого репозитория и, наконец, извлекает последний коммит в ваш рабочий каталог, используя git checkout .
Команда git clone используется в десятке различных мест в этой книге, но мы перечислим наиболее интересные упоминания.
Первоначальное знакомство происходит в разделе Клонирование существующего репозитория главы 2, где мы даём немного объяснений и приводим несколько примеров.
В разделе Установка Git на сервер главы 4 мы рассмотрели как использовать опцию --bare , чтобы создать копию Git репозитория без рабочей копии.
В разделе Создание пакетов главы 7 мы использовали git clone для распаковки упакованного с помощью git bundle репозитория.
Наконец, в разделе Клонирование проекта с подмодулями главы 7 мы научились использовать опцию --recursive чтобы упростить клонирование репозитория с подмодулями.
И хотя git clone используется во многих других местах в книге, перечисленные выше так или иначе отличаются от других вариантов использования.
Git: работа с gitHUB
GitHUB — это удаленный хостинг репозиториев git. То есть это коммерческий сервис для размещения git-репозиториев и управления ими, своего рода Dropbox для хранения картинок или Google Диск для хранения файлов. Для небольших команд gitHUB бесплатный и его функций хватит для разработки небольших публичных проектов, однако, если вы хотите разрабатывать серьезные коммерческие продукты в большой команде и вам нужна приватность — придется раскошелиться. GitHUB обладает множеством полезных функций, которые сильно облегчают разработку и продакшн проектов:
- Система безопасной авторизации по токенам;
- Инструменты тестирования и анализа кода;
- Сервисы деплоя проектов — gitHUB actions.
Надо сказать, что у gitHUB немало конкурентов: gitLab, BitBucket, SourceForge, Launchpad, Apache Allura и многие другие сервисы. Такое большое обилие сервисов обосновано тем, что само ядро git-сервера, на котором работает gitHUB и его конкуренты — бесплатное и никто не запрещает вам самому создать собственный git-сервис со своими уникальными фишками.
Скачивание удаленного репозитория
Репозитории, размещенные на gitHUB могут быть публичными — открытыми для скачивания всем желающим и приватными — доступными для скачивания только авторизованным пользователям, которым администратор репозитория выдал права. Для того, чтобы скачать репозиторий на локальную машину — нужно определить директорию, куда будет скачан проект и выполнить команду git clone [url] , где url — это ссылка на удаленный репозиторий.
Найти ссылку на репозиторий можно во вкладке Code:
Просто скопируйте путь, воспользовавшись кнопкой быстрого копирования в виде двух квадратов и вставьте ссылку в терминал:
Скачанный репозиторий будет иметь не только файлы проекта, но и директорию .git, где будут храниться все git-объекты, а значит вы можете также перемещаться по веткам и коммитам скачанного репозитория. Единственное, чтобы увидеть все удаленные ветки репозитория — необходимо применить команду git branch -r .
При скачивании удаленного репозитория git автоматически устанавливает связь между скачанным репозиторием и его удаленной версией поэтому обновлять локальный репозиторий теперь можно командой git pull , находясь в main ветке. Вы также можете загружать изменения внесенные в локальный репозиторий на удаленный сервер, если у вас есть соответствующие права.
Давайте, перейдём теперь на gitHUB и поработаем с ним поплотнее — создадим удаленный репозиторий, свяжем его с локальным репозиторием и загрузим в него изменения.
Создание удаленного репозитория и загрузка в него кода проекта
Войдите на gitHUB и через иконку своего аккаунта перейдите в раздел «репозитории», там через кнопку «New» создайте новый репозиторий:
На следующем шаге необходимо задать имя репозиторию, указать его тип (публичный или приватный) и задать описание репозиторию:
После успешного создания репозитория, вы увидите приветственную страницу с краткими, но очень полезными инструкциями. В них описано как синхронизировать удаленный и локальный репозитории. Давайте это и сделаем.
Подробную инструкцию по созданию репозитория мы приводили в первой части цикла статей, сейчас приведем её вкратце:
- Создадим директорию для проекта командой mkdir;
- Инициализируем репозиторий командой git init;
- Cоздадим файл readme.md и запишем в него несколько строк;
- Отправим все изменения в индекс командой git add .;
- Создадим первый коммит командой git commit -m «First commit»;
- Переименуем основную ветку в main — git branch -M main;
Теперь нам нужно связать локальный и удаленный репозитории командой git remote add origin https://[gitHUB_ACCESS_TOKEN]@gitHUB.com/[User name]/[repo name].git . Origin в этой конструкции — это стандартное наименование удаленного репозитория на локальном компьютере, оно может быть любым, но исторически его называют origin, а [gitHUB_ACCESS_TOKEN] — это токен, который можно сгенерировать тут, затем нужно повторить команду, только указать git remote set-url origin, остальная часть без изменений.
В нашем случае команда синхронизации будет выглядеть так: git remote add origin https://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@gitHUB.com/Pseudolukian/my_test_repo.git и git remote set-url origin … После синхронизации можно выполнять команду загрузки локальных изменений в удаленный репозиторий с помощью команды git push -u origin main . Дальше для загрузки изменений можно просто использовать команду git push :
В выводе команды git push отражено: количество передаваемых объектов, их размер и ветка локального и удаленного репозитория. Скачать файлы с удаленного репозитория в локальный, если он общий — можно командой git pull. Теперь мы умеем работать с локальным и удаленным репозиториями, настало время подвести итог.
Собираем воедино все новые знания о git и gitHUB
Git — это одна из самых популярных систем версионирования, разработанная Линусом Торвальдсом для совместной работы над Linux-ядром. Git позволяет:
- Сохранять различные версии файлов и перемещаться между ними;
- Вести разработку разного функционала проекта в различных ветках;
- Загружать локальные репозитории на удаленные git-хостинги.
Git поставляется со многими Linux-репозиториями, например, он включен во все версии Ubuntu, начиная с 16 версии. Также git доступен для Windows и macOS, но для этих ОС его нужно устанавливать вручную. Проверить установлен ли git в вашем Linux можно командой git --version . О том, как установить последнюю версию git можно узнать отсюда.
Все действия в git осуществляются через команды, если вы работаете в терминале, если же вы используете какое-нибудь современное IDE, например, VScode, то в нём есть плагин для работы с git, который предоставляет довольно удобное, но при этом мало информативное GUI. Список основных команд git находится здесь.
Общая схема работы с локальным git-репозиторием такая:
- Создается директория и структура проекта с помощью команд mkdir и touch;
- В корне проекта инициализируется репозиторий командой git init;
- Вносятся изменения в файлы проекта и они загружаются в индекс репозитория с помощью команды git add .;
- Подготовленные изменения загружаются в репозиторий командой git commit -m «Текст коммита».
Если у вас большой проект, состоящий из нескольких логических блоков, требующих индивидуальной и независимой проработки — целесообразно вести разработку в разных ветках. Например, работу над Django-проектом можно вести в двух ветках: backend и frontend. Потом слить ветви в одну ветку main.
Конечно, хранить репозиторий на локальной машине или сервере для разработки — опасно, можно потерять данные. Для безопасного и удаленного хранения репозиториев существуют различные git-хостинги. Один из наиболее популярных среди них — это gitHUB.
GitHUB — это условно бесплатный хостинг, куда можно загружать репозитории, делиться ими, вести совместную приватную разработку и автоматизировать процесс тестирования и деплоймента. Многие фишки и функции gitHUB бесплатны или условно бесплатные до исчерпания определенного лимита бесплатных ресурсов.
Локальный и удаленный репозиторий связываются между собой, и вы можете выгружать обновления своего локального репозитория буквально в одну команду. Если вы работаете в команде, то также удобно получать обновления общего удаленного репозитория и работать с новыми данными локально.
GitHUB имеет множество уникальных и очень полезных функций. Например, с помощью gitHUB Actions вы можете настроить автоматическое тестирование вашего проекта и его доставку на продакшн сервер. О том, как это сделать и что такое gitHUB Actions мы поговорим в следующей статье, а пока рекомендуем ознакомиться с предыдущими статьями, чтобы у вас сложилось более полное представление о том, что такое git и как с ним работать.
Git: установка, настройка, инициализация репозитория
Разбираемся с основами git: устанавливаем git на Linux, создаем репозиторий и делаем первые коммиты.