founder
9d2d2bc0c2
Добавлен package-режим в tools/build.sh: --package, --dist-dir, --version. Реализована сборка Debian-пакета, metadata/control, postinst/postrm и SHA256SUMS. Установочные пути унифицированы под /usr/sbin и /lib/systemd/system для production-модели.
74 lines
1.9 KiB
Markdown
74 lines
1.9 KiB
Markdown
# Installation
|
||
|
||
## Deployment contract
|
||
|
||
- Build выполняется на отдельной Debian 13 amd64 build-machine.
|
||
- Production-хост получает готовый Debian-пакет.
|
||
- На production-хосте не требуются Rust/cargo/source tree.
|
||
- Amnezia должна быть уже установлена и работать через Docker.
|
||
- Production-конфиг создаётся вручную; [`config.example.toml`](../config.example.toml) не копируется автоматически как боевой конфиг.
|
||
|
||
## A. Build machine
|
||
|
||
### A1. Подготовка build environment
|
||
|
||
```bash
|
||
./tools/build.sh --prepare-build-env --bootstrap-rust --yes
|
||
```
|
||
|
||
### A2. Build и тесты
|
||
|
||
```bash
|
||
./tools/build.sh --build
|
||
```
|
||
|
||
### A3. Сборка пакета
|
||
|
||
```bash
|
||
./tools/build.sh --package
|
||
sha256sum -c dist/SHA256SUMS
|
||
```
|
||
|
||
## B. Transfer artifacts
|
||
|
||
```bash
|
||
scp dist/awg2-harness_*_amd64.deb root@vpn-host:/root/
|
||
scp config.toml root@vpn-host:/root/awg2-harness.config.toml
|
||
```
|
||
|
||
## C. Production host
|
||
|
||
### C1. Install package
|
||
|
||
```bash
|
||
apt install ./awg2-harness_*_amd64.deb
|
||
```
|
||
|
||
### C2. Install config
|
||
|
||
```bash
|
||
install -d -m 0755 /etc/awg2-harness
|
||
install -m 0644 /root/awg2-harness.config.toml /etc/awg2-harness/config.toml
|
||
```
|
||
|
||
### C3. Validate and apply
|
||
|
||
```bash
|
||
awg2-harness validate-config --config /etc/awg2-harness/config.toml
|
||
awg2-harness apply-limits --config /etc/awg2-harness/config.toml
|
||
awg2-harness apply-firewall --config /etc/awg2-harness/config.toml
|
||
awg2-harness status --config /etc/awg2-harness/config.toml
|
||
```
|
||
|
||
### C4. Enable daemon
|
||
|
||
```bash
|
||
systemctl enable --now awg2-harness.service
|
||
```
|
||
|
||
## D. Manual source-tree install (staging/debug only)
|
||
|
||
Режим [`./tools/build.sh --install`](../tools/build.sh) предназначен для staging/debug с checkout-репозиторием.
|
||
|
||
Это **не** основной production deployment path.
|