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 "kapanadze"
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 "kapanadze"
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

რეპოზიტორიის ინიციალიზაცია

cd ~/docker-app
git init

Initialized empty Git repository in /home/k/docker-app/.git/

git init ქმნის .git/ დირექტორიას პროექტის ფოლდერში — აქ ინახება Git-ის მთელი ისტორია, branch-ები, კონფიგურაცია. ეს დირექტორია არ უნდა წაიშალოს და არ უნდა შეიცვალოს ხელით.

.gitignore შექმნა

ყველა ფაილი არ უნდა მოხვდეს version control-ში. .gitignore განსაზღვრავს რომელი ფაილები/დირექტორიები გამოირიცხოს:

nano .gitignore

.env
*.log
pgdata/

Pattern	რას გამორიცხავს	რატომ
.env	Environment variables ფაილი	შეიძლება პაროლები და API key-ები შეიცავდეს
*.log	ნებისმიერი .log ფაილი	ლოგები დროებითი მონაცემებია, repo-ში არ უნდა იყოს
pgdata/	PostgreSQL-ის მონაცემთა დირექტორია	ბინარული მონაცემები, ზომით დიდი, და Docker volume-ით იმართება

💡 .gitignore ფაილი თავად უნდა იყოს commit-ში — ის პროექტის ნაწილია და გუნდის ყველა წევრს ერთნაირად მოქმედებს.

ფაილების დამატება და Initial Commit

Staging (git add)

git add .
git status

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

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

---

5. შემოწმება

Commit-ის ისტორია

git log

commit b7555e19618a377c98b79c7203013bb54095725a (HEAD -> master)
Author: kapanadze <[email protected]>
Date:   Tue Feb 10 19:46:32 2026 +0000

    Initial commit: Nginx + PostgreSQL + Adminer docker-compose app

Repo-ში არსებული ფაილები

git ls-files

.gitignore
docker-compose.yml
nginx/index.html
nginx/nginx.conf

✅ 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

შემოწმება:

git log

k@devserver:~/docker-app$ git log
commit b7555e19618a377c98b79c7203013bb54095725a (HEAD -> master)
Author: kapanadze <[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".