Одна из самых распространенных систем управления версиями – Git. Ее ядро добавляет в систему ряд консольных команд, предназначенных для управления репозиториями. В самих же репозиториях хранятся важные каталоги, конфигурационные файлы, журналы и прочие связанные элементы.
Далее я расскажу, как создать, клонировать и удалить эти репозитории.
Следующие инструкции предназначены для тех, кто уже установил Git на свой сервер. Если вы еще не сделали этого, используйте руководство с GitHub, которое поможет разобраться с выполнением поставленной задачи.
Подробнее: How to install Git
Создание Git-репозитория
Сначала рассмотрим создание репозитория. Представим, что у вас уже есть папка для хранения файлов, но она еще не находится под контролем Git.
Откройте «Командную строку» (Windows) или Терминал (Linux/macOS) и перейдите по пути данной папки.
В Linux выполните команду:
cd /home/user/directory
В macOS:
cd /Users/user/directory
В Windows:
cd C:/Users/user/directory
Остается только ввести нижеуказанную команду, чтобы завершить первый этап.
Благодаря этой команде создается структура подкаталога со всеми необходимыми файлами. Кстати, все они расположены в подпапке с названием .git. Пока что проект не находится под контролем учета версий, поскольку в него добавлены только нужные элементы для работы Git. Для добавления файлов в репозиторий будем использовать git add. Команда git commit является заключительной:
git add git commit -m 'initial project version'
Теперь у вас есть Git-репозиторий со всеми необходимыми составляющими и отслеживаемыми файлами.
Комьюнити теперь в Телеграм
Подпишитесь и будьте в курсе последних IT-новостей
Подписаться
Клонирование существующего репозитория
Второй вариант создания директории для контроля версий – копирование существующего проекта с другого сервера. Это актуально, когда осуществляется доработка готового проекта или вы желаете внедрить его компоненты в свой. В этом поможет команда git clone, о которой и пойдет речь далее.
При использовании упомянутой команды вы получаете клоны всех версий файлов, а значит, можете использовать любые из них, если что-то пойдет не так. Это же пригождается, когда требуется вернуть предыдущую версию проекта, что осуществимо благодаря файлам, помещенным под версионный контроль.
Для клонирования существующего репозитория понадобится ввести git clone <url>. Пример такой команды вы видите ниже:
git clone https://github.com/rep/rep
Данная команда позволила вам получить клон всех версий указанного репозитория (в качестве примера было взято название rep). Теперь на вашем сервере создана директория с указанным названием. К ней подключена поддержка контроля версий, то есть появилась папка .git.
При использовании вышеуказанной команды репозиторий клонируется с текущим названием. Если же оно должно отличаться, используйте следующую вариацию команды:
git clone https://github.com/rep/rep myrep
Завершим этот раздел статьи описанием содержимого, которое появляется в консоли при выполнении команды. Данный вывод соответствует успешному клонированию:
Cloning into 'Git'... remote: Counting objects: 46, done. remote: Compressing objects: 100% (25/25), done. remote: Total 46 (delta 7), reused 43 (delta 4), pack-reused 0 Unpacking objects: 100% (46/46), done. Checking connectivity... done.
Удаление локального Git-репозитория
Если с созданием и клонированием репозиториев все понятно, то как быть, когда папка с проектом уже существует, но в нее нужно поместить новые данные, удалив предыдущие, или когда Git-репозиторий на сервере больше не нужен. В таком случае осуществляется стандартное удаление.
В корне каталога с проектом необходимо избавиться от папки .git, о которой уже шла речь выше. Так вы удаляете только ту информацию, которая связана с Git, но сам проект остается. В Linux через Терминал вы должны перейти к каталогу с проектом и ввести следующую команду:
Еще один вариант – удаление .gitignore и .gitmodules в случае их наличия. Тогда команда меняет свой вид на:
Остается только убедиться в отсутствии скрытой папки, которая может помешать инсталляции новой. Для этого существует простая команда ls -lah, выполнить которую необходимо с указанием того же каталога.
Только что мы разобрались с основами создания, клонирования и удаления Git-репозитория. Удачи!
Table of Contents
- Removing a repository locally
- Conclusion
When you use the git init command, it will initialize a brand new Git repository in the same folder that the command was run in.
It will initialize in a folder called .git in the root directory, and it will contain all the information about the repository.
In this post, we’ll learn how you can effectively undo this, and delete the repository locally.
Removing a repository locally
You can remove a Git repository created locally by git init by simply removing the resulting .git folder.
When this folder is removed, it will no longer be a valid Git repository, as that is what Git uses to identify a repository.
You can simply use your operating system’s file manager to remove the .git folder by right-clicking on it and selecting Delete.
Windows
If you’re on Windows, you can use the following command to remove the .git folder:
BASH
rmdir .git
macOS
If you’re running macOS, you can use the following command to remove the .git folder:
BASH
rm -rf .git
Linux
If you’re on Linux, you can use the following command to remove the .git folder:
BASH
rm -rf .git
Regardless of your operating system, once the folder is gone, the repository will no longer be a valid Git repository.
Conclusion
In this post, we learned how to remove a Git repository locally, effectively reversing what git init does.
Simply get rid of the resulting .git folder, and the repository will no longer exist on your computer.
Thanks for reading!
To learn more about web development, founding a start-up, and bootstrapping a SaaS, follow me on X!
There are times when you may need to delete a local repository—whether to start over, to clean up space, or to remove an obsolete project. This guide will take you through the process of deleting a local repository in Git, explain the difference between local and remote repositories, and provide various methods to accomplish this task.
Understanding local and remote repositories
Before deleting a repository, it’s important to understand how Git actually structures its file storage, particularly the difference between local and remote repositories:
Stop wrestling with Git commands
The Graphite CLI takes all the pain out of Git, allowing you to ship faster and stop googling Git commands.
Local repositories
A local repository in Git refers to the version of your repository that resides on your local machine. It includes all of your commits and Git history that have been saved locally, allowing you to work on your project, make commits, and use Git’s version control capabilities even when offline.
Remote repository
A remote repository is hosted on the internet or on a network server. This can be on platforms like GitHub, GitLab, or Bitbucket. Remote repositories allow multiple developers to collaborate on the same project by pushing to and pulling from the remote repository. The remote repository acts as the central source of truth for all of the other distributed versions of the codebase.
How to delete a local repository in git
Deleting a local repository involves removing the directory on your computer where the repository is stored. It’s a straightforward process and can be reversed by cloning the remote repository again.
Step 1: Ensure you have everything backed up
Before deleting anything, make sure that all important changes are either backed up or pushed to a remote repository. Losing data can be quite frustrating and detrimental to your project.
Step 2: Delete the local repository directory
Using the command line
To delete a local repository, you simply remove the repository’s directory using your operating system’s command line tools:
For Windows:
rmdir /s /q "C:\path\to\repository"
This command forcefully removes the directory and all of its contents without asking for confirmation.
For macOS and Linux:
rm -rf /path/to/repository
This command recursively deletes the directory and all of its contents.
The best engineers use Graphite to simplify Git
Engineers at Vercel, Snowflake & The Browser Company are shipping faster and staying unblocked with Graphite.
Using Git Tools
GitHub Desktop
To remove a repository in GitHub Desktop, follow these steps:
- Open GitHub Desktop and select the repository from the repository list.
- Click on
Repositoryin the menu bar. - Choose
Remove...from the dropdown menu. - You will be given the option to also move the repository to the Recycle Bin. Select as needed and confirm.
Git GUI
If you use Git GUI, the process is similarly straightforward:
- Open Git GUI and select the repository.
- Go to the
Repositorymenu. - Choose
Delete Repository. - Confirm the deletion.
Step 3: Clone Again If Necessary
If you need to retrieve the repository again, and it exists on a remote server, you can easily clone it back to your local machine:
git clone https://github.com/username/repository.git
Replace the URL with the actual URL of your remote repository.
Note: All of the above methods only remove the repository for you locally. If the remote repository still exists, all of the files previously committed to it will still be intact. In the case you committed sensitive information like an API key or other credentials, deleting your local repository is not enough to mitigate the leak. In the case of such a leak, follow this guide on removing sensitive data from Git.
Delete Git repo locally
There’s not trick in terms of how to delete a Git repo locally from your computer. You just need to delete all of the content from the folder in which the Git repo was either cloned or initialized. That’s it.
Okay, maybe there is a bit of a trick. Every Git repo has a hidden folder named .git in which the DVCS tool stores all of its configuration data. If your computer hasn’t been configured to show hidden files and folders, attempts to locally delete a Git repo will fail, because the hidden .git folder will remain. Configure your computer to show local folders, delete the .git folder using your operating system’s File Explorer, the the local Git repository is removed.
Steps to delete a local Git repo
To delete a Git repository locally, follow these steps:
- Open the the local Git repo’s root folder
- Delete all of the files and folder in the Git repo’s root folder
- Delete the hidden .git folder with File Explorer or through the command line
- Run a git status command. A fatal: not a git repository error verifies that the Git repo is deleted
Command line Git repository delete
If you’re familiar with the terminal window or the DOS prompt, you can easily perform a command line Git repository delete. Just run the rm command with the -f and -r switch to recursively remove the .git folder and all of the files and folders it contains.
This Git repo remove command also allows you to delete the Git repo while allowing all of the other files and folder to remain untouched.
delete@git-repo /c/remove/repository (main-branch) $ rm -fr .git
Verify Git repo is removed
If you use the Git BASH terminal window to remove the Git repository, you will notice the name of the current Git branch is no longer listed once the Git removal command is issued.
delete@git-repo /c/remove/repository $ git status fatal: not a git repository (or any of the parent directories): .git
Furthermore, any git commands you issue will return with a fatal: not a git repository error. While errors aren’t typically the way we seek confirmation in the software development work, in this case, seeing this fatal error is proof that the local Git repository delete operation ran successfully.
The way to delete a Git repo locally is to simply remove the hidden .git folder.
Delete a Git Repository
Whether you’re tidying up old projects, or need to address a mistake, it’s essential to know how to properly delete both local and remote Git repositories repositories.
You probably either want to:
- Delete a local repository on Windows, Linux, OSX, or using VS Code.
- Delete a remote repository on GitHub, GitLab, or Gitea.
Deleting a Local Repository
If you simply wish to delete a Git repository from your local machine, you’re essentially looking to delete the .git folder present in your repository.
On Windows:
Using the Command Prompt or PowerShell:
rmdir .git
If you have .gitignore and .gitmodules files you want to get rid of too:
del .git*
Of course you can also use Explorer to delete the .git folder.
To view hidden files and folders in Windows:
- Open File Explorer from the taskbar.
- Select View > Show > Hidden items.
On Linux and Mac OSX:
Using the Terminal:
rm -rf .git
To delete .gitignore and .gitmodules as well:
rm -rf .git*
Mac OS X Hidden Files:
To view hidden folders in Finder (Mac OS X), execute these commands in your terminal window:
defaults write com.apple.finder AppleShowAllFiles TRUE
killall Finder
Delete a Git repository using VS Code
If you’re using Visual Studio Code, simply navigate to the repository’s location and delete the .git folder to remove the Git repository.
Deleting a Remote Repository
Deleting a GitHub repository:
- Navigate to the main page of the repository on GitHub.
- Under your repository name, click Settings. If you cannot see the «Settings» tab, select the dropdown menu, then click Settings.
- Scroll down to the «Danger Zone» section, and click Delete this repository.
- Read the warnings carefully.
- To verify you’re deleting the correct repository, in the text box, type the name of the repository you wish to delete.
- Click I understand the consequences, delete this repository.
Warnings for GitHub:
- Deleting a public repository will not delete any forks of the repository.
- Deleting a private repository will delete all forks of the repository.
- Some deleted repositories can be restored within 90 days of deletion.
Deleting a GitLab repository:
(Note: The exact steps can vary depending on GitLab’s version and customizations.)
- Navigate to the main page of the repository on GitLab.com.
- Go to Settings > General.
- Scroll to the «Advanced» section and then choose Remove project.
- Follow the prompts to confirm the deletion.
Deleting a Gitea repository:
- Go to Settings of the repository.
- Navigate to the Dangerous Zone.
- Click Delete this repository.
Conclusion
It’s crucial to approach the process of deleting repositories with caution. Always make sure to backup any essential data or code before deletion. Remember, while some platforms offer a grace period for restoring deleted repositories, not all actions are reversible.