Here is a basic work flow when you work with Git and a master on GitHub or GitLab.
You have installed Git and you have a existing repo available to play around with.
You are working in a bash terminal.
Lets start with an overview of some basic commands.
| Command | What |
|---|---|
git status |
Do a health check and see how you local changes reflect to the current repo and its master. |
git add <filename> |
Add a specific file to the repo. |
git add . |
Add all files in the current directory. |
git commit -a -m "Message" |
Commit all -a changes to the repo and attach a commit message -m "Message". |
git push |
Push all committed changes to your master. |
git pull |
Update your local repo with and files changed on the master. Useful then updating the repo from several places. |
git tag -a v1.0.0 -m "Message" |
Add a tag to your repo and attach a tag message. |
git push --tags |
Push the tags to your master. |
git remote show origin |
Show details about your remote (GitLab/GitHub). |
The commands are further explained below.
Git is the code versioning tool, it is used to provide version management to software code and equal documents.
GitHub and GitLab are two examples on websites that hosts git repos and provide additional services to work with the repo.
Go to your repo (change directory to your repo).
You can check a status of a repo.
git status
It is sort of a health check on the repo and it compares your local version (your local branch master) with the remote version (your origin/master).
Go to your repo and create a new file test.html.
# Go to your repo
touch test.html
ls -l
You can open the file in your texteditor and add some sample text into it, just for the fun of it.
Use git status to see how it looks.
We shall now add the file to the repo.
git add test.html
The file is added to the repo.
An alternative is git add . which add all files to the repo.
You can now do another git status.
When you are done with all your additions, and changes, then you shall commit them. It is like permanent writing your updates into the repo.
git commit -a -m "First commit"
The switches -a means all files that are changed and -m "First commit" is a commit-message attached to this commit, explaining what the commit was about.
You can also commit only one file at the time.
git commit test.html -m "First commit"
You can the check with git status.
When you are done with all commits you should push them all to your master.
git push
The changes are now uploaded and you can reload your repo page on your website to check that all changes were uploaded.
Check your git status.
You are now up to date with your master.
If there are changes to the master that you have not yet downloaded locally, then do like this.
git pull
Your local repo is then updated to mirror the master.
When you have a certain baseline in your project, you mey want to tag it with a version number. This makes it easier to know tha status of the repo.
git tag -a v1.0.0
git push --tags
You can add a new tag at any stage.
You need to push the tags separately, by adding --tags.