118 lines
4.4 KiB
Markdown
118 lines
4.4 KiB
Markdown
# F7 Office — файлы для Git и развёртывания
|
||
|
||
Краткая сводка путей и шагов, чтобы выложить кастомизацию в Git и ставить на новую машину через `git clone`.
|
||
|
||
---
|
||
|
||
## Пути из службы coolwsd (куда смотрит сервис)
|
||
|
||
- **Конфиг:** `/etc/coolwsd/coolwsd.xml`
|
||
- **Корень статики:** `/usr/share/coolwsd` (в конфиге: `file_server_root_path = browser/../`)
|
||
- **Клиент по URL:** `/browser/` → каталог `/usr/share/coolwsd/browser/`
|
||
- **Apache (пример):** `/etc/apache2/sites-available/collabora-le-ssl.conf` — прокси на `http://127.0.0.1:9980/browser` и Alias на `dist/f7cloud`
|
||
|
||
---
|
||
|
||
## Список изменённых файлов для репозитория
|
||
|
||
В репозиторий имеет смысл положить только эти файлы (в структуре каталогов как на сервере):
|
||
|
||
```
|
||
etc/
|
||
coolwsd/
|
||
coolwsd.xml
|
||
apache2/
|
||
sites-available/
|
||
collabora-le-ssl.conf
|
||
|
||
usr/share/coolwsd/browser/dist/
|
||
branding.js
|
||
branding.css
|
||
branding-mobile.css
|
||
branding-tablet.css
|
||
cool.html
|
||
wasm.html
|
||
welcome/
|
||
welcome.html
|
||
src/
|
||
layer/
|
||
tile/
|
||
CanvasTileUtils.js
|
||
TileWorker.js
|
||
f7cloud/
|
||
branding.js
|
||
branding.css
|
||
branding-desktop.css
|
||
branding-mobile.css
|
||
branding-tablet.css
|
||
loading-preview.html
|
||
images/ # при необходимости — только если меняли картинки
|
||
```
|
||
|
||
Остальное (bundle.js, l10n, admin, тысячи ресурсов) ставится пакетами **coolwsd** и **code-brand** и в Git не нужно.
|
||
|
||
---
|
||
|
||
## Как выложить в Git (на текущей машине)
|
||
|
||
1. Создать репозиторий на https://git.f7cloud.ru/ (например, `f7office-deploy`).
|
||
2. Создать каталог проекта и структуру:
|
||
|
||
```bash
|
||
mkdir -p f7office-deploy/{etc/coolwsd,etc/apache2/sites-available,usr/share/coolwsd/browser/dist/{welcome,src/layer/tile,f7cloud}}
|
||
```
|
||
|
||
3. Скопировать файлы с сервера в эту структуру:
|
||
|
||
```bash
|
||
cd f7office-deploy
|
||
cp /usr/share/coolwsd/browser/dist/branding.js usr/share/coolwsd/browser/dist/
|
||
cp /usr/share/coolwsd/browser/dist/branding.css usr/share/coolwsd/browser/dist/
|
||
cp /usr/share/coolwsd/browser/dist/branding-mobile.css usr/share/coolwsd/browser/dist/
|
||
cp /usr/share/coolwsd/browser/dist/branding-tablet.css usr/share/coolwsd/browser/dist/
|
||
cp /usr/share/coolwsd/browser/dist/cool.html usr/share/coolwsd/browser/dist/
|
||
cp /usr/share/coolwsd/browser/dist/wasm.html usr/share/coolwsd/browser/dist/
|
||
cp /usr/share/coolwsd/browser/dist/welcome/welcome.html usr/share/coolwsd/browser/dist/welcome/
|
||
cp /usr/share/coolwsd/browser/dist/src/layer/tile/CanvasTileUtils.js usr/share/coolwsd/browser/dist/src/layer/tile/
|
||
cp /usr/share/coolwsd/browser/dist/src/layer/tile/TileWorker.js usr/share/coolwsd/browser/dist/src/layer/tile/
|
||
cp -r /usr/share/coolwsd/browser/dist/f7cloud usr/share/coolwsd/browser/dist/
|
||
cp /etc/coolwsd/coolwsd.xml etc/coolwsd/
|
||
cp /etc/apache2/sites-available/collabora-le-ssl.conf etc/apache2/sites-available/
|
||
```
|
||
|
||
4. Положить в корень репозитория: `DEPLOY.md`, `install-f7office.sh`, этот `README-GIT.md`.
|
||
5. Инициализировать Git и отправить:
|
||
|
||
```bash
|
||
git init
|
||
git add .
|
||
git commit -m "F7 Office customizations and configs"
|
||
git remote add origin https://git.f7cloud.ru/.../f7office-deploy.git
|
||
git push -u origin main
|
||
```
|
||
|
||
---
|
||
|
||
## Установка на новую машину (git clone)
|
||
|
||
1. Установить Collabora/coolwsd и брендинг:
|
||
|
||
```bash
|
||
# репозиторий CODE-ubuntu2204 и пакеты coolwsd, code-brand
|
||
sudo apt-get update && sudo apt-get install -y coolwsd code-brand
|
||
```
|
||
|
||
2. Клонировать репозиторий и установить файлы:
|
||
|
||
```bash
|
||
git clone https://git.f7cloud.ru/.../f7office-deploy.git
|
||
cd f7office-deploy
|
||
# Адаптировать install-f7office.sh под структуру репо (usr/ и etc/ в корне)
|
||
chmod +x install-f7office.sh
|
||
sudo ./install-f7office.sh
|
||
```
|
||
|
||
3. При необходимости разложить конфиги Apache и coolwsd вручную и перезапустить сервисы.
|
||
|
||
Подробные шаги и предупреждения — в **DEPLOY.md**.
|