O‘rnatishdan
birinchi deploy’gacha.

abzctl — Git repozitoriydagi loyihani SSH orqali o‘z VPS serveringizga chiqaradigan CLI. Docker Compose, Dockerfile yoki Railpack orqali ilova build qilinadi. Domen tanlasangiz, Caddy orqali HTTPS sozlanadi.

Qo‘llanmadagi 203.0.113.10, app.example.com va repo manzillari namuna. Ularni o‘z qiymatlaringizga almashtiring.

Terminalni oching. Avval git --version va python3 --version bilan dasturlarni tekshiring. Git bo‘lmasa, distributivingiz paket menejeri orqali o‘rnating.

git clone https://github.com/akbarkhojayev/abzctl.git
cd abzctl
bash install.sh

O‘rnatuvchi ~/.abzctl/venv virtual muhitini yaratadi va ~/.local/bin/abzctl buyrug‘ini tayyorlaydi. Debian/Ubuntu’da Python yoki venv yetishmasa, ularni o‘rnatish uchun sudo so‘ralishi mumkin.

Terminalni yopib qayta oching, so‘ng tekshiring:

abzctl --version
abzctl --help

Git va Python 3.9+ o‘rnatilgan bo‘lsin. Versiyalarni git --version va python3 --version bilan tekshiring. Homebrew ishlatsangiz, yetishmayotgan Python’ni quyidagicha o‘rnatishingiz mumkin:

brew install python

git clone https://github.com/akbarkhojayev/abzctl.git
cd abzctl
bash install.sh

Yangi terminal oynasini oching va abzctl --version bajaring. macOS’da o‘rnatuvchi Python’ni avtomatik o‘rnatmaydi; Python oldindan mavjud bo‘lishi kerak.

Git o‘rnating va PowerShell’ni oching. Repo’ni yuklab, o‘rnatuvchini ishga tushiring:

git clone https://github.com/akbarkhojayev/abzctl.git
cd abzctl
.\install.bat

Yoki yuklab olingan repo ichidagi install.bat faylini ikki marta bosing. Python topilmasa, o‘rnatuvchi winget orqali o‘rnatishga harakat qiladi. winget bo‘lmasa, Python 3.9+ ni o‘zingiz o‘rnating.

Yangi PowerShell oynasini oching:

abzctl --version
abzctl --help

O‘rnatish joyi: %USERPROFILE%\.abzctl\venv. Buyruq yorlig‘i %USERPROFILE%\.abzctl\bin orqali PATH’ga qo‘shiladi.

Serveringizga birinchi marta oddiy SSH orqali ulaning. Ko‘rsatilgan fingerprint’ni server provayderi ma’lumoti bilan solishtiring va tekshirgandan keyin kalitni qabul qiling.

ssh -p 22 root@203.0.113.10

Deploy boshlamasdan server holatini tekshiring:

abzctl check-server -h 203.0.113.10 -u root -p 22

SSH kaliti bilan:

abzctl check-server -h 203.0.113.10 -u deploy --key-file ~/.ssh/id_ed25519

Kalit orqali kirilgan root bo‘lmagan foydalanuvchi uchun provisioning paytida parolsiz sudo kerak bo‘lishi mumkin. Sudo parolini ABZCTL_PASSWORD orqali berish ham mumkin. SSH parollari profilga saqlanmaydi.

Eng oson usul — parametrsiz ishga tushirish:

abzctl

1. Server IP manzili, foydalanuvchi, SSH port va kirish usulini kiriting.
2. GitHub yoki GitLab repo havolasini bering.
3. Kerakli muhit qiymatlarini to‘ldiring; domen ulashni tanlang.
4. Rejani tasdiqlang va build tugashini kuting.

Repo odatda serverdagi /var/www/<loyiha> papkasiga yuklanadi. CLI loyihani tekshiradi, kerakli dasturlarni o‘rnatadi va konteynerlarni ishga tushiradi.

abzctl deploy -h 203.0.113.10 \
  -r https://github.com/user/my-app.git \
  --name my-app -d app.example.com

Mavjud Compose konfiguratsiyasi bo‘lsa, port, servis va restart sozlamalarini unda to‘g‘ri berish sizning zimmangizda. Bir nechta published port topilsa, --app-port bilan asosiy HTTP portni tanlang.

Haqiqiy .env faylini Git’ga yubormang. Repo’da kerakli sozlamalar uchun .env.example namunasini saqlang:

BOT_TOKEN=
SECRET_KEY=
DATABASE_URL=

abzctl namuna va koddagi qo‘llab-quvvatlanadigan muhit chaqiruvlaridan qiymatlarni aniqlashga harakat qiladi. Ayrim maxfiy kalitlar avtomatik yaratiladi; tashqi tokenlarni o‘zingiz kiritasiz. Aniqlanmagan sozlamalarni qo‘lda berish kerak.

abzctl deploy -h 203.0.113.10 \
  -r https://github.com/user/my-app.git \
  --env APP_ENV=production --env DEBUG=false

--env mavjud server .env faylidagi tegishli qiymatni ham yangilaydi. Boshqa qiymatlar saqlanadi. Maxfiy qiymatni argumentga yozmaslik uchun lokal muhit o‘zgaruvchisidan foydalanish mumkin:

export ABZCTL_ENV_BOT_TOKEN='YOUR_BOT_TOKEN'
abzctl deploy -h 203.0.113.10 -r https://github.com/user/bot.git -y
unset ABZCTL_ENV_BOT_TOKEN

Serverdagi .env va .abzctl/services.json fayllari 600 ruxsat bilan yoziladi. Server, zaxira nusxalar va ularga kirish huquqlarini o‘zingiz boshqarasiz.

1. Domen provayderingizda A-rekord yarating: app.example.com → SERVER_IP.
2. Server va bulut provayderi firewall’ida TCP 80 va 443 portlarini oching.
3. Deploy’da domenni bering yoki interaktiv so‘rovda kiriting.

abzctl deploy -h 203.0.113.10 \
  -r https://github.com/user/my-app.git \
  -d app.example.com

Caddy domenni lokal ilova portiga yo‘naltiradi va sertifikatni avtomatik olishga harakat qiladi. DNS hali yangilanmagan bo‘lsa, HTTPS darhol ochilmasligi mumkin.

Generatsiya qilinadigan loyihalarda aiogram, telebot, telegraf, grammy kabi qo‘llab-quvvatlanadigan kutubxonalar topilsa, loyiha worker sifatida ishlatiladi. Bunda HTTP port va domen talab qilinmaydi.

abzctl deploy -h 203.0.113.10 \
  -r https://github.com/user/my-bot.git --name my-bot

Token so‘ralganda kiriting. Python botda requirements.txt bo‘lmasa, importlardan kutubxonalarni aniqlashga harakat qilinadi. Ishonchli natija uchun requirements.txt ni o‘zingiz saqlang.

O‘z Compose faylingiz bo‘lsa, bot aniqlash va generatsiya qilingan worker oqimi avtomatik qo‘llanmaydi; Compose servislaringizni o‘zingiz sozlang.

Generatsiya qilinadigan loyihalarda kutubxonalar va konfiguratsiyaga qarab kerakli servislar taklif qilinadi. Mavjud Compose bo‘lsa, uning bazalarini o‘zingiz boshqarasiz.

Kerakli parollar avtomatik yaratiladi. Servis rekvizitlari /var/www/<loyiha>/.abzctl/services.json ichida saqlanadi. abzctl yaratgan baza ulanish qiymatlari generatsiya qilingan konteyner muhitida ustun turadi.

Ilova kodini yangilash

Kodingizni Git’ga push qiling va terminalda yana abzctl bajaring. Oxirgi muvaffaqiyatli deploy’ni yangilash taklif qilinadi.

abzctl

abzctl’ning o‘zini yangilash

abzctl klonlangan lokal papkada yangi kodni olib, o‘rnatuvchini qayta bajaring:

cd /path/to/abzctl
git pull --ff-only
bash install.sh

cd C:\path\to\abzctl
git pull --ff-only
.\install.bat

Private repozitoriy

Deploy qilinadigan serverda Git hosting uchun SSH deploy key va hostning known_hosts yozuvini sozlang. Git amallari lokal kompyuteringizdan emas, serverdan bajariladi.

abzctl deploy -h 203.0.113.10 \
  -r git@github.com:user/private-app.git --branch main

Barcha parametrlarni terminaldan ko‘ring:

abzctl --help
abzctl deploy --help
abzctl check-server --help

CI / skript uchun namuna

SSH kaliti va tekshirilgan known_hosts yozuvini CI muhitida tayyorlang. Maxfiy qiymatlarni CI’ning secrets mexanizmi orqali muhitga uzating.

abzctl deploy -h 203.0.113.10 \
  -r https://github.com/user/my-app.git \
  --key-file ~/.ssh/id_ed25519 \
  --name my-app -d app.example.com -y

Majburiy qiymat yetishmasa yoki deploy tekshiruvi muvaffaqiyatsiz bo‘lsa, buyruq xato kodi bilan tugaydi. -y rejimida yetishmayotgan token so‘ralmaydi.

abzctl check-server -h 203.0.113.10
abzctl deploy -h 203.0.113.10 -r https://github.com/user/my-app.git -v

Serverda loglarni ko‘rish

Quyidagi buyruq abzctl yaratgan Compose uchun. Loyiha nomini almashtiring:

ssh root@203.0.113.10
cd /var/www/my-app
sudo docker compose -p my-app -f .abzctl/compose.yaml logs --tail 100 -f

O‘z Compose faylingiz bo‘lsa, -f qiymatini unga moslang, masalan -f compose.yaml. Loglarda maxfiy qiymatlar bo‘lishi mumkin; ulashishdan oldin tekshiring.