Как отправить существующий проект на GitHub
Введение
GitHub — это облачный инструмент управления Git. Git — это распределенный контроль версий. Это означает, что весь репозиторий и история хранятся там, где вы их разместили. Люди склонны использовать GitHub в своем бизнесе или процессе разработки в качестве управляемого хостинга для резервного копирования своих репозиториев. GitHub идет еще дальше, позволяя вам общаться с коллегами, друзьями, организациями и многим другим.
В этом уроке вы узнаете, как взять существующий проект, над которым вы работаете, и опубликовать его, чтобы он также существовал на GitHub.
Как отправить существующий проект на GitHub
- Создайте новый репозиторий GitHub.
- Инициализируйте Git в папке проекта
- Инициализируйте репозиторий Git
Развертывайте свои приложения из GitHub с помощью платформы приложений DigitalOcean. Позвольте DigitalOcean сосредоточиться на масштабировании вашего приложения.
Предварительные условия
Чтобы инициализировать репозиторий и отправить его на GitHub, вам понадобится:
- Бесплатная учетная запись GitHub
git
установлен на вашем локальном компьютере
Шаг 1. Создайте новый репозиторий GitHub.
Войдите в GitHub и создайте новый пустой репозиторий. Вы можете либо инициализировать README, либо нет. На самом деле это не имеет значения, потому что мы все равно просто переопределим все в этом удаленном репозитории.
Внимание! В оставшейся части этого руководства мы будем предполагать, что ваше имя пользователя GitHub — sammy
, а созданный вами репозиторий называется < mark>мой-новый-проект
. Важно заменить эти заполнители своим фактическим именем пользователя и именем репо.
Шаг 2. Инициализируйте Git в папке проекта.
На своем терминале выполните следующие команды после перехода к папке, которую вы хотите добавить.
Шаг 3. Инициализируйте репозиторий Git.
Убедитесь, что вы находитесь в корневом каталоге проекта, который хотите отправить на GitHub, и запустите:
Примечание. Если у вас уже есть инициализированный репозиторий Git, вы можете пропустить эту команду.
git init
На этом этапе в папке вашего проекта создается скрытый каталог .git
, который программное обеспечение git
распознает и использует для хранения всех метаданных и истории версий проекта.
Добавьте файлы в индекс Git
git add -A
Команда git add
используется, чтобы сообщить git, какие файлы включать в коммит, а аргумент -A
(или --all
) означает, что «включить все».
Зафиксировать добавленные файлы
git commit -m 'Added my project'
Команда git commit
создает новый коммит со всеми «добавленными» файлами. -m
(или --message
) устанавливает сообщение, которое будет включено в коммит и будет использоваться для дальнейшего использования для понимания коммита. В этом случае появится сообщение: 'Добавлен мой проект'
.
Добавить новый удаленный источник
git remote add origin git@github.com:sammy/my-new-project.git
Примечание. Помните, что вам нужно будет заменить выделенные части имени пользователя и имени репозитория своим собственным именем пользователя и именем репо.
В git «удаленный» относится к удаленной версии того же репозитория, которая обычно находится где-то на сервере (в данном случае GitHub). «origin» — это имя по умолчанию, которое git дает удаленному серверу (вы можете иметь несколько удаленных устройств), поэтому git Remote add Origin
инструктирует git добавить URL-адрес удаленного сервера по умолчанию сервер для этого репо.
Отправить на GitHub
git push -u -f origin main
Флаг -u
(или --set-upstream
) устанавливает удаленный origin
в качестве ссылки upstream. Это позволит вам позже выполнять команды git push
и git pull
без необходимости указывать origin
, поскольку в этом случае нам всегда нужен GitHub.
Флаг -f
(или --force
) означает force. Это автоматически перезапишет все в удаленном каталоге. Мы используем его здесь, чтобы перезаписать README по умолчанию, который GitHub автоматически инициализировал.
Примечание. Если вы не включили README по умолчанию при создании проекта на GitHub, флаг -f
на самом деле не нужен.
Все вместе
git init
git add -A
git commit -m 'Added my project'
git remote add origin git@github.com:sammy/my-new-project.git
git push -u -f origin main
Развертывание репозитория GitHub в DigitalOcean
Теперь, когда у вас есть репозиторий GitHub, развернуть его и запустить в эксплуатацию с помощью платформы приложений DigitalOcean можно одним щелчком мыши.
Заключение
Теперь все готово для удаленного отслеживания изменений кода на GitHub! В качестве следующего шага используйте серию руководств «Введение в GitHub и проекты с открытым исходным кодом», чтобы освоить Github.
Вы можете использовать шпаргалку Github и сохранить ее в качестве справочника.
Как только вы начнете сотрудничать с другими участниками проекта, вам захочется узнать, как создать запрос на включение.