A3.2 Приложение C: Команды Git — Клонирование и создание репозиториев

Клонирование и создание репозиториев

Существует два способа создать Git репозиторий. Первый — клонировать его из существующего репозитория (например, по сети); второй — создать репозиторий в существующем каталоге.

git init

Чтобы превратить обычный каталог в Git репозиторий и начать версионировать файлы в нём, просто запустите git init .

Впервые мы продемонстрировали эту команду в главе Создание Git-репозитория на примере создания нового репозитория для последующей работы с ним.

Мы немного поговорили о смене названия ветки по умолчанию с «master» на что-нибудь другое в главе Удалённые ветки.

Мы использовали эту команду для создания чистого репозитория для работы на стороне сервера в главе Размещение голого репозитория на сервере.

Ну и наконец мы немного покопались во внутренностях этой команды в главе Сантехника и Фарфор.

git clone

На самом деле git clone работает как обёртка над некоторыми другими командами. Она создаёт новый каталог, переходит внутрь и выполняет git init для создания пустого репозитория, затем она добавляет новый удалённый репозиторий ( git remote add ) для указанного URL (по умолчанию он получит имя origin ), выполняет git fetch для этого репозитория и, наконец, извлекает последний коммит в ваш рабочий каталог, используя git checkout .

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

Первоначальное знакомство происходит в главе Клонирование существующего репозитория, где мы даём немного объяснений и приводим несколько примеров.

В главе Установка Git на сервер мы рассмотрели как использовать опцию —bare , чтобы создать копию Git репозитория без рабочей копии.

В главе Создание пакетов мы использовали git clone для распаковки упакованного с помощью git bundle репозитория.

Наконец, в главе Клонирование проекта с подмодулями мы научились использовать опцию —recursive чтобы упростить клонирование репозитория с подмодулями.

И хотя git clone используется во многих других местах в книге, перечисленные выше так или иначе отличаются от других вариантов использования.

Git для начинающих. Урок 2.
Создание и клонирование репозитория

Видеоурок. Часть 1. Практика

Все о репозиториях

• что это такое
• клонирование
• публичные и приватные репозитории
• создаем собственный репозиторий
• Инициализация репозитория
• Генерируем ssh-ключи

• что это такое и зачем они нужны
• генерируем свой ключ

Видеоурок. Часть 2

• Что выбрать: github или bitbucket?
• Копирование ssh-ключей

Конспект урока

Краткое содержание урока, основные инструкции для командной строки, полезные ссылки и советы.

Что такое репозиторий

Это каталог в файловой системе, где хранится информация о проекте:

• файлы и папки проекта
• история проекта
• настройки проекта
• служебная информация

Информация о репозитории хранится в скрытой папке .git в корне проекта.

Можно ли работать с git локально

Да, можно. Но при этом проект находится только на нашей машине и в случае поломки железа или случайной потери данных мы не сможем восстановить проект.

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

Это репозиторий, который хранится на нашей машине, в рабочей папке проекта. Это та самая скрытая папка .git

Удаленный репозиторий, зачем он нужен

Это репозиторий, который хранится в облаке, на сторонних сервисах, специально созданных под работу с проектами git.

Плюсы удаленного репозитория

• выполняет роль резервной копии
• возможность работать в команде
• некоторые дополнительные возможности, которые предоставляет хостинг. Например, визуализация истории или возможность работать над проектом прямо в веб-интерфейсе

Что такое клонирование

Это копирование удаленного репозитория на локальную машину. Обычно это первое действие при работе с проектом. При клонировании на нашу машину копируются файлы и папки проекта и вся его история. То есть мы получаем доступ к истории не с момента начала нашей работы над проектом, а с самого начала проекта.

Как клонировать готовый проект

В первую очередь, нужно получить ссылку на проект. Мы можем найти ее сами или получим готовую, например, на новой работе. Возьмем для примера репозиторий vuejs — https://github.com/vuejs/vue.git

Наберем в командной строке

При этом в текущем каталоге создастся папка vue, в ней окажутся все файлы проекта vue и специальная скрытая папка .git, то есть сам репозиторий, или информация о нем.

Как клонировать проект в другую папку

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

Где vue-new — нужное название папки.

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

Для своих проектов нам понадобится собственный репозиторий. Можно работать и локально, но плюсы удаленного мы уже рассматривали выше. Теперь нужно выбрать хостинг для наших git-проектов.

Где держать репозиторий

Есть множество вариантов, самые известные — это github и bitbucket. Нужно выбирать.

На самом деле не парьтесь. У них схожий функционал, и в начале работы с git мы не заметим разницы. bitbucket мне нравится больше из-за интерфейса, но в уроках выберем github из-за его большей популярности.

Чтобы продолжить уроки, нужно зарегистрироваться на github. Если у вас нет там аккаунта, то форму регистрации увидите сразу на главной странице — https://github.com/

Как создать репозиторий в github

После регистрации создание репозитория доступно с главной страницы github. При создании нужно указать название проекта и тип (публичный или приватный). На остальное пока не обращаем внимания.

Права на репозиторий, публичные и приватные

Есть 2 типа репозиториев:

• публичный (public), открыт всем
• приватный (private), доступен только определенному кругу лиц — в первую очередь, нам самим

Публичные репозитории хороши для opensource-проектов и чтобы показать в резюме. Пока нам это не нужно.

Для себя будем создавать приватные репозитории. Для этого нам понадобятся ssh-ключи.

Что такое ssh-ключи

ssh-ключи используются для идентификации клиента на сервере при подключении по безопасному ssh-протоколу. Другими словами, ssh-ключ нужен для того, чтобы пускать на сервер только определенных клиентов. Только тех, кому разрешен доступ к проекту.

ssh-ключ не имеет прямого отношения к git, но так репозитории находятся на удаленных серверах, то ssh-ключи используются для разграничения доступа к приватным репозиториям.

ssh-ключ состоит из пары ключей: публичного и приватного ключа. Это просто 2 текстовых файла:

• /домашний-каталог/.ssh/id_rsa.pub — публичный
• /домашний-каталог/.ssh/id_rsa — приватный

Публичный ключ передается сторонним серверам, например, github, для открытия доступа на эти сервера. Приватный ключ хранится только на нашей машине и никому не передается. То есть когда у нас просят ssh-ключ, чтобы дать доступ на какой-нибудь сервер, мы отдаем именно публичный ключ, id_rsa.pub

Как сгенерировать ssh-ключ

ssh-ключи сами собой не появляются, но стоит проверить, возможно, они были установлены раньше. Запустим в терминале команды

Если видим файлы id_rsa и id_rsa.pub — отлично, ключи уже есть.

Если этих файлов нет, то нужно сгенерировать ключи утилитой ssh-keygen. В Windows она устанавливается вместе с git, в Linux и MacOS при необходимости установите. В Linux, например, вот так

После этого нужно сгенерировать пару ключей, запустив команду в терминале

Появились файлы id_rsa и id_rsa.pub — значит, ключи успешно сгенерированы.

known_hosts — это файл, в котором ssh прописывает сервера, на которые мы заходим. При первом подключении к github нужно будет разрешить доступ к github.com (напечатать yes в терминале)

Как добавить ssh-ключ в настройках github

Открываем публичный ключ id_rsa.pub и копируем его содержимое. В настройках github ищем раздел «SSH и GPG keys» — https://github.com/settings/keys. Жмем «New SSH key», задаем название ключа, например, имя, и вставляем форму публичный ключ, прямо текстом. Все, теперь у нас есть доступ к нашим приватным репозиториям.

Два способа создания проекта

Первый, когда мы начинаем новый проект. Удобнее будет создать репозиторий на github и склонировать пустой проект на локальную машину.

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

Рассмотрим оба способа.

Пустой проект

Создаем приватный репозиторий на github, назовем его first-site. Я зарегистрировался под именем Webdevkin, моя ссылка для клонирования будет такая — git@github.com:Webdevkin/first-site.git. Ваша зависит от имени пользователя.

Идем в командную строку и запускаем

В текущей папке получим новую папку с названием first-site — это и есть наш проект.

P.S. У вас склонировать этот репозиторий не получится — он закрытый. Создайте свой 🙂

Непустой проект

Допустим, у нас на локальной машине уже есть проект second-site. Создаем в github репозиторий second-site. Заходим в папку проекта и выполняем команды

Все, можно приступать к работе над проектом. Команды add, commit и push мы разберем в следующих уроках.

Это единственный урок, в котором мы разбирались с тонкостями репозиториев. В дальнейшем будем считать, что репозиторий = проект.

Что могу посоветовать

• github или bitbucket? Для личных проектов неважно, оба сервиса разрешают бесплатно создавать приватные репозитории. Для open source или резюме — github
• не увлекайтесь клонированием в папку со своим названием. Есть шанс запутаться, самому или коллегам
• не путайте публичный и приватный ключи. Отдаем вовне только публичный ключ id_rsa.pub
• при смене рабочей машины можно не генерировать ssh-ключи заново, а скопировать их со старой машины. Тогда не придется заново прописывать новые ключи на серверах

Немного подробнее о копировании ssh-ключей

Как скопировать ssh-ключи с одной машины на другую

Хочу немного затронуть эту тему отдельно. Генерировать ключ на новой машине не обязательно. Но нужно выполнить такие действия

• Скопировать id_rsa и id_rsa.pub со старой машины на новую
• Посмотреть права на файлы, возможно, ключи окажутся слишком «открытыми» для записи и потребуется сменить им права доступа — sudo chmod 700

/.ssh/*

Выполнить команду ssh-add

Ссылки, которые могут пригодиться

• github — https://github.com/
• bitbucket — https://bitbucket.org/
• подробнее об ssh-ключах (en) — connecting-to-github-with-ssh

На этом все. В следующем уроке мы сделаем первые изменения в проекте и начнем понимать, в чем заключается прелесть git.

Клонирование и использование репозитория GitHub в Visual Studio Code Clone and use a GitHub repository in Visual Studio Code

Сведения о клонировании общедоступного репозитория из GitHub на локальный компьютер с помощью Visual Studio Code. Learn the steps to clone a public repository from GitHub to your local computer using Visual Studio Code.

При работе в Visual Studio Code с репозиторием необходимо использовать отдельные средства: Working in Visual Studio Code with a repository uses separate tools:

Значок Icon	Сведения Information	Доступ из Access from
Git CLI Git CLI	палитра команд — F1 command palette — F1
	Расширение системы управления версиями Source control extension	Панель действий Activity bar
	Расширение GitHub GitHub extension	Панель действий Activity bar

В следующих процедурах будут использованы именованные частипользовательского интерфейса Visual Studio Code. The following procedures use the named parts of the Visual Studio Code user interface.

Использование палитры команд для клонирования репозитория Use command palette to clone repository

Чтобы приступить к работе, скачайте пример проекта, как описано ниже. To get started, download the sample project using the following steps:

Нажмите клавишу F1, чтобы отобразить палитру команд. Press F1 to display the command palette.

В строке палитры команд введите gitcl , выберите команду Git: клонировать и нажмите клавишу ВВОД. At the command palette prompt, enter gitcl , select the Git: Clone command, and press Enter.

Если появится запрос, введите URL-адрес репозитория GitHub, а затем нажмите клавишу ВВОД. When prompted for the Repository URL, enter a GitHub repository url, then press Enter.

Выберите (или создайте) локальный каталог, в который нужно клонировать проект. Select (or create) the local directory into which you want to clone the project.

Создание ветви для изменений с помощью Git CLI Create a branch for changes with Git CL

Используйте Git в палитре команд, чтобы создать ветвь. Use Git in the command palette to create a new branch.

Нажмите клавишу F1, чтобы отобразить палитру команд. Press F1 to display the command palette.

Найдите элемент git branch и выберите Git: Create Branch . Search for git branch and select Git: Create Branch .

Введите имя для новой ветви. Enter a new branch name. Имя ветви будет отображатся в строке состояния. The branch name is visible in the status bar.

Создание ветви из строки состояния Create a branch from status bar

Выберите имя ветви в строке состояния. Select the branch name in the status bar.

Строка состояния обычно находится в нижней части Visual Studio code. The status bar is usually found at the bottom of Visual Studio code.

Выберите в палитре команд Создание новой ветви. In the command palette, select ++Create a new branch.

Введите имя для новой ветви. Enter your new branch name.

Введите имя для новой ветви. Enter a new branch name. Имя ветви будет отображатся в строке состояния. The branch name is visible in the status bar.

Фиксация изменений с помощью Git Commit changes with Git

Изменив ветвь, зафиксируйте изменения. Once you have made changes on your branch, commit the changes

Перейдите на панель действий и выберите значок Git. Switch to the activity bar and select the Git icon.

В поле Сообщение введите сообщение фиксации и нажмите клавиши Ctrl+ВВОД или установите флажок на панели управления версиями. In the Message box, enter a commit message, and press Ctrl+Enter, or select the check mark in the Source Control bar.