⍟ HSHHHHH'S BLOGGG^^^

Деплой статического блога через ssh и git --bare

Эпиграф

Когда у меня будет депрессивная фаза я никому не скажу, но будут признаки.

Начало

Вы уже прочитали первый пост и второй пост про как и зачем мы git --bare и всё ещё не понимаете зачем.

Давайте представим что у нас есть статический сайт и мы хотим его деплоить с локального устройство на серверное устройство. Мы всё тоже самое можем сделать через гитхаб, но мы можем и без!

Я вам расскажу как без, но это вряд ли оптимальный способ жить:
+ весело
+ независимо
– если у вас много картинок, то блог будет занимать x2 или даже сильно хуже
– гитхаб даст третью точку для бекапа

Но нам нужно весело поэтому давайте веселиться! Но вы можете всё тоже самое сделать и через гитхаб, просто не тоже самое!

Подготавливаемся

1. делаем ssh

Допустим у нас есть блог hshhhhh.name, на сервере пользователь тоже hshhhhh.name и мы уже можем подключиться к нему по ssh.

Теперь мы добавим в ~/ssh/config:

Host hshhhhh.name
    HostName 159.223.250.0
    IdentityFile ~/.ssh/keys/hshhhhh.name
    User hshhhhh.name

Теперь работает так:

$ ssh hshhhhh.name

2. подготавливаем сервер

Мы будем направлять nginx на директорию /home/hshhhhh.name/public_html/ потому что мы чтим традиции и уважаем чтение традиций. Поэтому мы создадим на сервере один git --bare и один нормальный, нормальный будет получать апдейты из git --bare, а потом нгинкс через симлинк будет ходить в нормальный.

Или на локальном устройстве, или на удалённом устройстве:

$ ssh hshhhhh.name "git init --bare ~/.git--bare"
$ ssh hshhhhh.name "mkdir ~/git/"

3. делаем блог

Внутри нашего репозитория тоже будет /public_html/ директория куда мы будем складывать результат. Всякое остальное на ваш выбор.

На локальном устройстве:

$ mkdir -p /tmp/hshhhhh.name/public_html/
$ cd /tmp/hshhhhh.name/
$ date > public_html/index.html
$ git init .
$ git config --local user.name "hshhhhh"
$ git config --local user.email "email"
$ git add public_html/
$ git commit -m "initial commit"

И посылаем это на удалённое устройство (если в урле есть : то это относительный путь, а если нет — абсолютный (но тогда должно начинаться с ssh://)):

$ git remote add hosting "hshhhhh.name:.git--bare/"
$ git push hosting

4. деплоим

Сначала мы git pull в локальный нормальный репозиторий, потом мы симлинкаем и как-нибудь там перезапускаем nginx если он вдруг не оценит подмену директории на симлинк.

Или на локальном устройстве, или на удалённом устройстве:

$ ssh hshhhhh.name "git clone ~/.git--bare ~/git/"
$ ssh hshhhhh.name "git -C ~/git/ pull"
$ ssh hshhhhh.name "cat ~/git/public_html/index.html"

Делаем симлинк и проверяем в браузере (при создании симлинка в конце не должно быть слеша):

$ ssh hshhhhh.name "mv ~/public_html/ ~/public_html_backup/"
$ ssh hshhhhh.name "ln -s ~/git/public_html/ ~/public_html"
$ curl --location https://hshhhhh.name/

4. деплоим обновление

На локальном устройстве:

$ cd /tmp/hshhhhh.name/
$ date >> public_html/index.html
$ git add public_html/index.html
$ git commit -m "second commit"
$ git push hosting
$ ssh hshhhhh.name "git -C ~/git/ pull"
$ curl --location https://hshhhhh.name/

Конец

Потрясающе, вы прямо хакер такие чудеса делаете может быть вам бы уже завести себе бложик и делиться вашими исследованиями?

#linux #howto #man #git #deploy

2025.11.10 04:05

Как точка файлы

Начало

В прошлом посте вы узнали про git --bare, а в этом вы узнаете зачем вы про это узнали.

В какой-то момент вашей жизни вам вдруг хочется чтобы одни и те же конфиги были на разных компьютерах и для этого вам их нужно с чем-то синхронизировать. Все как-то договорились что это делается через репозиторий с именем dotfiles.

В посте на реддите люди называют три способа.

1. gnu stow + git

Этот stow просто хранит всё в какой-то дирректории, а потом указывает туда симлинками, например:

 ~/.config/nvim/ > ~/.stow/.config/nvim/

Мне просто не нравится.

2. yadm: Yet Another Dotfiles Manager

Сложно!

3. git --blame

Можно случайно добавить самого себя, но можно и не добавлять.

Делаем ~/.dotfiles/

В том же посте рассказывают как всё делать и есть даже ссылка на блог (в котором нет rss!).

Я делаю всё так же как в этом блоге, но кладу гит на +1 уровень вложенности в ~/.dotfiles/git--bare/ и это даёт мне возможность добавить файл ~/.dotfiles/readme.md в котором я напишу как этим пользоваться.

Просто когда я это настраиваю в первый раз — мне несложно, а как потом этим пользоваться на втором устройстве? Я неумный, я не могу запомнить, мне нужно записать все шаги.

0. далёкий репозиторий

Создайте у себя в гитхабе приватный dotfiles репозиторий и найстройте ssh чтобы всё работало.

1. первый коммит

Создаём репозиторий, можете переименовывать всё как угодно

$ cd ~
$ mkdir -p ~/.dotfiles/git--blame/
$ git init --bare ~/.dotfiles/git--bare/
$ echo 'hello world' > ~/.dotfiles/readme.md

Делаем первый коммит, проверяем что всё работает

$ git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" add ~/.dotfiles/readme.md
$ git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" config set --local user.name "hello"
$ git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" config set --local user.name "mail@example.com"
$ git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" commit -m 'initial commit'
$ git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" log

Если коммит случился — мы радуемся.

Но радуемся несильно потому что это больно и глупо. Создаём в рыбе функцию (ну или алиасьте там как умеете я не осуждаю):

  
$ cat ~/.config/fish/functions/dotfiles.fish

function dotfiles
    command git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" $argv
end

Теперь у нас есть функция, её мы проверяем:

$ dotfiles status

Если вам стало неприятно от моего совета, то это хорошо! Теперь вызывая dotfiles мы как бы вызываем git, но со странными параметрами.

Теперь мы можем отключить показ недобавленных файлов:

$ dotfiles status
$ dotfiles config --local status.showUntrackedFiles not  
$ dotfiles status

2. синхронизация

$ dotfiles remote add github <url>
$ dotfiles push

3. безумие время

$ dotfiles add ~/.config/fish/
$ dotfiles commit -m '`~/.config/fish/`'
$ dotfiles push

Эмулируем второе устройство

Что выполнять на настоящем втором устройстве вы найдёте ниже, а тут мы проверим что всё работает на этом же устройстве. И убедимся что мы понимаем как это работает,
потому что если мы не понимаем мы могли бы пользоваться yadm например.

$ mkdir /tmp/dotfiles-sandbox/
$ cd /tmp/dotfiles-sandbox/
$ git clone --bare <url> /tmp/dotfiles-sandbox/.dotfiles/git--bare/
$ git --git-dir="/tmp/dotfiles-sandbox/.dotfiles/git--bare/" --work-tree="/tmp/dotfiles-sandbox/" reset --hard
$ ls

Если файлы внезапно появились, то мы всё сделали правильно. Теперь делаем коммит:

$ git --git-dir="/tmp/dotfiles-sandbox/.dotfiles/git--bare/" --work-tree="/tmp/dotfiles-sandbox/" config --local status.showUntrackedFiles no;
$ git --git-dir="/tmp/dotfiles-sandbox/.dotfiles/git--bare/" --work-tree="/tmp/dotfiles-sandbox/" config set user.name "temp"
$ git --git-dir="/tmp/dotfiles-sandbox/.dotfiles/git--bare/" --work-tree="/tmp/dotfiles-sandbox/" config set user.email "temp"

$ date >> /tmp/dotfiles-sandbox/.dotfiles/readme.md
$ git --git-dir="/tmp/dotfiles-sandbox/.dotfiles/git--bare/" --work-tree="/tmp/dotfiles-sandbox/" add /tmp/dotfiles-sandbox/.dotfiles/readme.md
$ git --git-dir="/tmp/dotfiles-sandbox/.dotfiles/git--bare/" --work-tree="/tmp/dotfiles-sandbox/" commit -m '`.dotfiles/readme.md`'  
$ git --git-dir="/tmp/dotfiles-sandbox/.dotfiles/git--bare/" --work-tree="/tmp/dotfiles-sandbox/" push

Если всё работает то всё работает.

$ rm -Rf /tmp/dotfiles-sandbox/

мы завтрашние

Вам может быть непонятно зачем это если на втором устройстве ничего не настроено, но:
1. вы можете посмотреть это файл прямо в гитхабе
2. вы всё равно должны как-то передать урл на второе устройство и настроить там ssh

А если у вас там всё это работает, то вы всегда можете сделать:

$ git clone <url> /tmp/dotfiles-temp/
$ cat /tmp/dotfiles-temp/.dotfiles/readme.md
$ rm -Rf /tmp/dotfiles-temp/

Вот вам содержимое ~/.dotfiles/readme.md, вы его поменяйте, поменяйте, сохраните и запушьте сами.

```
### init, first machine

$ mkdir -p ~/.dotfiles/git--blame/
$ git init --bare ~/./dotfiles/git--bare/
$ echo 'hello world' > ~/.dotfiles/readme.md

$ git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" add ~/.dotfiles/readme.md
$ git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" config set --local user.name "hello"
$ git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" config set --local user.name "mail@example.com"
$ git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" commit -m 'initial commit'
$ git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" log

# fish function / alias

$ cat ~/.config/fish/functions/dotfiles.fish

function dotfiles
    command git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" $argv
end

# check function / alias and hide new files notifications

$ dotfiles status
$ dotfiles config --local status.showUntrackedFiles not
$ dotfiles status

# add remote

$ dotfiles remote add github <url>
$ dotfiles push

# add first config

$ dotfiles add ~/.config/fish/
$ dotfiles commit -m '`~/.config/fish/`'
$ dotfiles push
```

```
### second machine

# be smart, create fish function / alias first

$ cat ~/.config/fish/functions/dotfiles.fish

function dotfiles
    command git --git-dir="$HOME/.dotfiles/git--bare/" --work-tree="$HOME" $argv
end


# deploy, but be careful: you can ruin existing files. Handle it somehow, I won't fight your internal coflicts!

$ git clone --bare <url> ~/.dotfiles/git--bare/
$ dotfiles status
$ dotfiles config --local status.showUntrackedFiles not
$ dotfiles status
$ dotfiles config set --local user.name "hello 2nd machine"
$ dotfiles config set --local user.name "mail@example.com"
```

Конец

Поздравляшки, теперь вы нерд!

#linux #howto #man #dotfiles #git

2025.11.10 00:31

git vs git --bare

Ваш гит репозиторий может существовать в двух вариантах: обычный и --bare. Обычный это ~гит-клиент, а необычный это ~гит-сервер. Ну то есть как бы нет, но --bare существует чтобы его как remote использовали обычные репозитории. И в нём ещё нет файлов.

Вы можете на своём впс создать --bare репозиторий и через ssh в него синхронизироваться не используя никаких сервисов вроде гитхаба. И каждый у кого будет ssh доступ тоже сможет его использовать как remote.

Почему-то когда создаёшь обычный, то он для себя создаёт отдельную директорию /.git, а когда --bare то он указанный путь использует как .git.

> git init  ./git-normal/
    Initialized empty Git repository in /tmp/.dotfiles/git-normal/.git/
> git init --bare ./git-bare/
    Initialized empty Git repository in /tmp/.dotfiles/git-bare/

> ls -lah git-normal/
    .git/
> ls -lah git-bare/
    hooks/
    info/
    objects/
    refs/
    HEAD
    config
    description

Смешная шутка: если вы положите --bare в ./.git/, то оно будет выглядеть как будто бы ./ тут есть гит, и он даже есть, но его нет!

fatal: this operation must be run in a work tree

#linux #howto #man #git

2025.11.09 20:36