Git Repository Setup
Task 18 — Git Repository Setup
არქიტექტურა¶
flowchart TD
subgraph WORKING["📁 Working Directory — ~/docker-app"]
F1[".gitignore"]
F2["docker-compose.yml"]
F3["nginx/index.html"]
F4["nginx/nginx.conf"]
F5[".env ❌"]
F6["pgdata/ ❌"]
end
subgraph STAGING["📋 Staging Area — git add"]
S1[".gitignore"]
S2["docker-compose.yml"]
S3["nginx/index.html"]
S4["nginx/nginx.conf"]
end
subgraph REPO["🗄️ Local Repository — git commit"]
C1["b7555e1\nInitial commit"]
end
F1 & F2 & F3 & F4 -->|"git add ."| STAGING
F5 & F6 -.->|".gitignore-ით გამორიცხული"| WORKING
STAGING -->|"git commit -m '...'"| REPO
Git-ის გლობალური კონფიგურაცია¶
ეს პარამეტრები ერთხელ დაყენდება და ყველა რეპოზიტორიაში გამოიყენება:
git config --global user.name "your-name"
git config --global user.email "[email protected]"
git config --global init.defaultBranch main
| პარამეტრი | დანიშნულება |
|---|---|
user.name |
commit-ებში ავტორის სახელი |
user.email |
commit-ებში ავტორის ელფოსტა |
init.defaultBranch main |
ახალი repo-ს default branch იქნება main (არა master) |
💡
init.defaultBranchპარამეტრი Git 2.28-ში დაემატა. თანამედროვე პრაქტიკითmainსახელი სტანდარტია (GitHub, GitLab ორივე ამას იყენებს).
k@devserver:~/docker-app$ git config --global user.name "your-name"
k@devserver:~/docker-app$ git config --global user.email "[email protected]"
k@devserver:~/docker-app$ cd ~/docker-app
k@devserver:~/docker-app$ git init
hint: Using 'master' as the name for the initial branch. This default branch name
hint: is subject to change. To configure the initial branch name to use in all
hint: of your new repositories, which will suppress this warning, call:
hint:
hint: git config --global init.defaultBranch <name>
hint:
hint: Names commonly chosen instead of 'master' are 'main', 'trunk' and
hint: 'development'. The just-created branch can be renamed via this command:
hint:
hint: git branch -m <name>
Initialized empty Git repository in /home/k/docker-app/.git/
git config --global init.defaultBranch main
რეპოზიტორიის ინიციალიზაცია¶
git init ქმნის .git/ დირექტორიას პროექტის ფოლდერში — აქ ინახება Git-ის მთელი ისტორია, branch-ები, კონფიგურაცია. ეს დირექტორია არ უნდა წაიშალოს და არ უნდა შეიცვალოს ხელით.
.gitignore შექმნა¶
ყველა ფაილი არ უნდა მოხვდეს version control-ში. .gitignore განსაზღვრავს რომელი ფაილები/დირექტორიები გამოირიცხოს:
| Pattern | რას გამორიცხავს | რატომ |
|---|---|---|
.env |
Environment variables ფაილი | შეიძლება პაროლები და API key-ები შეიცავდეს |
*.log |
ნებისმიერი .log ფაილი |
ლოგები დროებითი მონაცემებია, repo-ში არ უნდა იყოს |
pgdata/ |
PostgreSQL-ის მონაცემთა დირექტორია | ბინარული მონაცემები, ზომით დიდი, და Docker volume-ით იმართება |
💡
.gitignoreფაილი თავად უნდა იყოს commit-ში — ის პროექტის ნაწილია და გუნდის ყველა წევრს ერთნაირად მოქმედებს.
ფაილების დამატება და Initial Commit¶
Staging (git add)¶
On branch master
No commits yet
Changes to be committed:
new file: .gitignore
new file: docker-compose.yml
new file: nginx/index.html
new file: nginx/nginx.conf
git add . ყველა ფაილს (.gitignore-ით გამორიცხულის გარდა) staging area-ში ამატებს. git status გვიჩვენებს რა ელოდება commit-ს.
Commit¶
[master (root-commit) b7555e1] Initial commit: Nginx + PostgreSQL + Adminer docker-compose app
4 files changed, 147 insertions(+)
create mode 100644 .gitignore
create mode 100644 docker-compose.yml
create mode 100644 nginx/index.html
create mode 100644 nginx/nginx.conf
5. შემოწმება¶
Commit-ის ისტორია¶
commit b7555e19618a377c98b79c7203013bb54095725a (HEAD -> master)
Author: your-name <[email protected]>
Date: Tue Feb 10 19:46:32 2026 +0000
Initial commit: Nginx + PostgreSQL + Adminer docker-compose app
Repo-ში არსებული ფაილები¶
✅ 4 ფაილი —
.env,*.log, დაpgdata/სწორად გამოირიცხა.gitignore-ით.
ფაილების დამატება და initial commit:
bashgit add .
git status
git commit -m "Initial commit: Nginx + PostgreSQL + Adminer docker-compose app"
k@devserver:~/docker-app$ git add .
k@devserver:~/docker-app$ git status
On branch master
No commits yet
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: .gitignore
new file: docker-compose.yml
new file: nginx/index.html
new file: nginx/nginx.conf
k@devserver:~/docker-app$ git commit -m "Initial commit: Nginx + PostgreSQL + Adminer docker-compose app"
[master (root-commit) b7555e1] Initial commit: Nginx + PostgreSQL + Adminer docker-compose app
4 files changed, 147 insertions(+)
create mode 100644 .gitignore
create mode 100644 docker-compose.yml
create mode 100644 nginx/index.html
create mode 100644 nginx/nginx.conf
შემოწმება:
k@devserver:~/docker-app$ git log
commit b7555e19618a377c98b79c7203013bb54095725a (HEAD -> master)
Author: your-name <[email protected]>
Date: Tue Feb 10 19:46:32 2026 +0000
Initial commit: Nginx + PostgreSQL + Adminer docker-compose app
commit abc123... (HEAD -> master)
Author: Kapo <[email protected]>
Date: Tue Feb 10 ...
Initial commit: Nginx + PostgreSQL + Adminer docker-compose app
6. რა ფაილებია repo-ში:
bashgit ls-files
.gitignore
docker-compose.yml
nginx/index.html
nginx/nginx.conf
k@devserver:~/docker-app$ git ls-files
.gitignore
docker-compose.yml
nginx/index.html
nginx/nginx.conf
შედეგები¶
Git-ის სამი ზონა¶
Git-ში ფაილები სამ ზონას შორის მოძრაობს:
Working Directory → git add → Staging Area → git commit → Repository
Working Directory არის ის, რასაც ფაილ სისტემაში ხედავ. git add ამზადებს ცვლილებებს commit-ისთვის (staging). git commit კი საბოლოოდ ინახავს snapshot-ს ისტორიაში.
.gitignore-ის მნიშვნელობა¶
სენსიტიური მონაცემები (პაროლები, API keys), ბინარული ფაილები (database data), და დროებითი ფაილები (logs) არ უნდა მოხვდეს Git-ის ისტორიაში. ერთხელ commit-ში მოხვედრილი პაროლი ისტორიიდან ძალიან ძნელია ამოსაშლელი — ამიტომ .gitignore პროექტის დასაწყისშივე უნდა შეიქმნას.
Commit Messages¶
კარგი commit message მოკლედ და ზუსტად აღწერს რა შეიცვალა. Initial commit-ისთვის პროექტის შემადგენლობის აღწერა სწორი მიდგომაა. მომავალში commit-ები უფრო კონკრეტულ ცვლილებებს უნდა აღწერდეს, მაგალითად: "Add health check endpoint", "Fix adminer proxy path".
განახლებული ვერსია: Git ახალ VM-ზე (myubuntuserver)¶
flowchart TD
A["git config --global<br>name, noreply email, defaultBranch main"] --> B["git init<br>~/docker-app"]
B --> C[".gitignore<br>.env, *.log, *.swp"]
C --> D[".env.example<br>DB_PASSWORD=CHANGE_ME"]
D --> E["git add .<br>git status: .env არ ჩანს"]
E --> F["git commit<br>1e4d26a"]
F --> G["git branch -m main<br>git check-ignore -v .env"]
რა გავაკეთეთ და რატომ¶
| ნაბიჯი | რატომ |
|---|---|
git config --global user.email = GitHub noreply მისამართი |
commit-ის ელფოსტა ისტორიაში სამუდამოდ რჩება და GitHub-ზე გამოქვეყნებისას ყველას ჩანს. noreply მისამართი ნამდვილ ელფოსტას მალავს |
.gitignore git add-მდე |
.env-ში DB_PASSWORD წერია. Git-ში მოხვედრილი პაროლი ისტორიიდან მერეც აღდგება, ფაილის წაშლის შემდეგაც |
.env.example (sed 's/=.*/=CHANGE_ME/' .env) |
გვაჩვენებს, რა ცვლადებია საჭირო, ნამდვილი მნიშვნელობების გარეშე. ახალი ადამიანი კოპირებს .env-ად და ავსებს |
git status commit-მდე |
ვამოწმებთ staged სიას: .env არ ჩანს |
git check-ignore -v .env |
ამოწმებს, რომ .env რეალურად იგნორირდება წესით .gitignore:1:.env და არა შემთხვევით არ დაემატა |
git ls-files |
Git-ის მიერ თვალყურდევნებული ფაილების სია: ხუთი ფაილი, .env გარეშე |
რეალური შედეგები¶
$ git add . && git status
On branch master
No commits yet
Changes to be committed:
new file: .env.example
new file: .gitignore
new file: docker-compose.yml
new file: nginx/index.html
new file: nginx/nginx.conf
$ git commit -m "Initial commit: docker-compose app with nginx proxy"
[master (root-commit) 1e4d26a] Initial commit: docker-compose app with nginx proxy
5 files changed, 75 insertions(+)
$ git branch -m main
$ git check-ignore -v .env
.gitignore:1:.env .env
$ git ls-files
.env.example
.gitignore
docker-compose.yml
nginx/index.html
nginx/nginx.conf
$ git status -sb | head -n 1
## main
პრობლემები, რომლებიც შეგვხვდა¶
| სიმპტომი | მიზეზი | გამოსწორება |
|---|---|---|
Author identity unknown / unable to auto-detect email address |
Git-ს commit-ისთვის სახელი და ელფოსტა სჭირდება და ახალ VM-ზე კონფიგი ჯერ არ იყო | git config --global user.name ... და user.email ..., შემდეგ commit ხელახლა |
ბრენჩი master გამოვიდა main-ის ნაცვლად |
git init გაეშვა init.defaultBranch main-ის დაყენებამდე (კონფიგი მხოლოდ ახალ რეპოებზე მოქმედებს) |
git branch -m main. უმჯობესია git config-ი git init-მდე გაეშვას |
გაკვეთილი
კონფიგურაციის თანმიმდევრობას მნიშვნელობა აქვს: ჯერ git config, მერე git init, მერე .gitignore, მერე git add. პირველი commit-ის შემდეგ ხარვეზის გასწორება (პაროლი, არასწორი ავტორი) გაცილებით ძვირი ჯდება.