Instalacja za pomocą Skryptu CLI

Dla środowisk zautomatyzowanych (CI/CD, Docker, serwery dedykowane, skrypty orkiestracji) system Ammonly udostępnia szybką instalację konsolową za pośrednictwem wiersza poleceń.

---

Dostępne Narzędzia Konsolowe

W katalogu bin/ oraz w głównym folderze projektu znajdują się skrypty instalacyjne dostosowane do różnych środowisk:

• bin/install (PHP CLI Runner – główny skrypt instalatora)
• install.sh (Skrypt powłoki dla systemów Linux / macOS)
• install.bat (Skrypt wsadowy dla systemów Windows)

---

1. Tryb Interaktywny

W trybie interaktywnym skrypt zadaje pytania w konsoli o parametry bazy danych i konta administratorów:

php bin/install install

Przykładowy przebieg instalacji w konsoli:

==================================================
        Ammonly System Installer v0.0.2
==================================================
Database host [127.0.0.1]: 127.0.0.1
Database port [3306]: 3306
Database name [ammonly_dev]: ammonly_dev
Database user [root]: root
Database password:
Platform Super-Admin email [admin@ammonly.com]: admin@twojadomena.pl
Platform Super-Admin password (leave empty to generate):
Helpdesk Admin email [helpdesk@ammonly.com]: helpdesk@twojadomena.pl
Helpdesk Admin password (leave empty to generate):
CRM User email [user@ammonly.com]: user@twojadomena.pl
CRM User password (leave empty to generate):
Proceed with installation? [y/N]: y

TIP

Jeśli pozostawisz pole hasła puste, skrypt automatycznie wygeneruje silne hasło losowe i wyświetli je w końcowym podsumowaniu w konsoli.

---

2. Tryb Zautomatyzowany (Unattended / CI/CD)

W środowiskach automatycznych można przekazać wszystkie parametry za pomocą flag bez konieczności interakcji:

php bin/install install \
  --unattended \
  --profile=all \
  --db-host=127.0.0.1 \
  --db-port=3306 \
  --db-name=ammonly_dev \
  --db-user=root \
  --db-pass=SecretDb123! \
  --admin-email=admin@ammonly.com \
  --admin-pass=AdminSecret123! \
  --helpdesk-email=helpdesk@ammonly.com \
  --helpdesk-pass=HelpdeskSecret123! \
  --crm-email=user@ammonly.com \
  --crm-pass=CrmSecret123! \
  --shop-email=shop@ammonly.com \
  --shop-pass=ShopSecret123! \
  --with-demo=1

Dostępne Opcje CLI:

Opcja	Opis	Wartość domyślna
--unattended	Uruchomienie bez potwierdzeń interaktywnych	false
--profile	Docelowy profil (all, panel, helpdesk, crm, shop)	all
--db-host	Host serwera MySQL	127.0.0.1
--db-port	Port serwera MySQL	3306
--db-name	Nazwa bazy danych	ammonly_dev
--db-user	Nazwa użytkownika MySQL	root
--db-pass	Hasło użytkownika MySQL	""
--admin-email	E-mail administratora Panelu	admin@ammonly.com
--admin-pass	Hasło administratora Panelu	Losowe (jeśli brak)
--helpdesk-email	E-mail użytkownika Helpdesk	helpdesk@ammonly.com
--helpdesk-pass	Hasło użytkownika Helpdesk	Losowe (jeśli brak)
--crm-email	E-mail użytkownika CRM	user@ammonly.com
--crm-pass	Hasło użytkownika CRM	Losowe (jeśli brak)
--shop-email	E-mail managera Shop	shop@ammonly.com
--shop-pass	Hasło managera Shop	Losowe (jeśli brak)
--with-optional	Załaduj słowniki opcjonalne (kraje, waluty)	0
--with-demo	Załaduj dane demonstracyjne	0

---

3. Skrypty Pomocnicze

Systemy Linux / macOS:

chmod +x install.sh
./install.sh

Systemy Windows:

install.bat

---

Co Dzieje się Podczas Instalacji CLI

1. Weryfikacja środowiska: Sprawdzenie wersji PHP, rozszerzeń i uprawnień katalogów roboczych.
2. Budowa schematu DDL: Import bazowych tabel i widoków SQL z folderów schematów (01_schema, 02_system_core).
3. Inicjalizacja modułów: Zarejestrowanie tabel modułów w rejestrze {tier}_core_module_records (p_, h_, c_, s_) oraz widżetów.
4. Zastosowanie profili: Aplikacja definicji SQL dla profili (profiles/panel, profiles/helpdesk, profiles/crm, profiles/shop).
5. Tworzenie kont użytkowników: Utworzenie rekordów administratorów dla każdego wybranego tieru.
6. Zarządzanie kluczami i tokenami: Wygenerowanie klucza aplikacji w storage/app.key i systemowego tokenu API.
7. Blokada instalatora: Zapisanie pliku storage/installed.lock oraz konfiguracji installer.local.php.