Обновить README.md

This commit is contained in:
2026-03-25 10:10:26 +00:00
parent 37f3a94994
commit 4b65beff56

View File

@@ -1,10 +1,13 @@
# Установка PostgreSQL for 1C 18 на Debian 13 одним запуском # Установка PostgreSQL for 1C 18 на Debian 13 одним запуском
В комплекте: В комплекте:
- `install_pg1c.sh` — основной установочный скрипт - `install_pg1c.sh` — основной установочный скрипт
- `env.example` — пример файла `.env` со всеми настройками и пояснениями на русском - `env.example` — пример файла `.env` со всеми настройками и пояснениями на русском
- `.env` — минимальный рабочий вариант без комментариев
Скрипт автоматизирует официальный процесс установки Postgres Pro for 1C 18 по вашей инструкции:
Скрипт автоматизирует официальный процесс установки Postgres Pro для 1С 18 по вашей инструкции:
- добавляет репозиторий через vendor-скрипт `pgpro-repo-add.sh` - добавляет репозиторий через vendor-скрипт `pgpro-repo-add.sh`
- ставит пакет в режиме `standalone` или `parallel` - ставит пакет в режиме `standalone` или `parallel`
- включает и запускает systemd-сервис - включает и запускает systemd-сервис
@@ -17,25 +20,69 @@
- Debian 13 - Debian 13
- доступ `root` - доступ `root`
- интернет-доступ до репозитория Postgres Pro - интернет-доступ до репозитория Postgres Pro
- `git`, если хотите сначала стянуть готовые файлы из открытого репозитория
## Быстрый запуск ## Вариант 1. Быстрый запуск из локальных файлов
```bash ```bash
cp env.example .env
nano .env
chmod +x install_pg1c.sh chmod +x install_pg1c.sh
sudo ./install_pg1c.sh sudo ./install_pg1c.sh
``` ```
## Вариант 2. Стянуть готовый комплект из открытого репозитория
Открытый репозиторий с файлами проекта:
```text
https://git.ext.flamy.studio/flamy_preview/pg18-1C_for_deb13
```
На странице репозитория доступны файлы `env`, `env.example`, `install_pg1c.sh` и `README.md`, а также стандартные варианты скачивания архива (`ZIP`, `TAR.GZ`, `BUNDLE`). Репозиторий опубликован в Gitea, ветка `main`, и в нем сейчас 1 commit. citeturn437110view0
### Стянуть через git
```bash
git clone https://git.ext.flamy.studio/flamy_preview/pg18-1C_for_deb13.git
cd pg18-1C_for_deb13
chmod +x install_pg1c.sh
sudo ./install_pg1c.sh
```
### Или скачать архивом
Можно скачать архив с той же страницы репозитория кнопкой `Download ZIP` или `Download TAR.GZ`, распаковать и запустить `install_pg1c.sh`. Эти варианты скачивания присутствуют на странице репозитория. citeturn437110view0
## Подготовка `.env`
### Если нужен полный шаблон с пояснениями
```bash
cp env.example .env
nano .env
```
### Если нужен минимальный рабочий `.env` без комментариев
```bash
cp .env .env.local
nano .env.local
mv .env.local .env
```
Либо просто используйте уже готовый `.env`, если значения вам подходят.
## Что настроить в `.env` ## Что настроить в `.env`
Обязательно проверьте: Обязательно проверьте:
- `INSTALL_MODE` - `INSTALL_MODE`
- `PG_ADMIN_USER` - `PG_ADMIN_USER`
- `PG_ADMIN_PASSWORD` - `PG_ADMIN_PASSWORD`
- `PG_CREATE_DB` - `PG_CREATE_DB`
- `PG_DB_NAME` - `PG_DB_NAME`
- `ENFORCE_PASSWORD_AUTH` - `ENFORCE_PASSWORD_AUTH`
- `PGPRO_REPO_ADD_URL`
- `PGPRO_REPO_SCRIPT_NAME`
## Режимы установки ## Режимы установки
@@ -46,6 +93,7 @@ INSTALL_MODE=standalone
``` ```
Ставится пакет: Ставится пакет:
```text ```text
postgrespro-1c-18 postgrespro-1c-18
``` ```
@@ -57,6 +105,7 @@ INSTALL_MODE=parallel
``` ```
Ставится пакет: Ставится пакет:
```text ```text
postgrespro-1c-18-contrib postgrespro-1c-18-contrib
``` ```
@@ -74,6 +123,7 @@ ENFORCE_PASSWORD_AUTH=true
``` ```
Тогда скрипт: Тогда скрипт:
- определяет фактический путь к `pg_hba.conf` - определяет фактический путь к `pg_hba.conf`
- делает резервную копию - делает резервную копию
- заменяет `peer` / `ident` на нужный метод (`scram-sha-256` по умолчанию) - заменяет `peer` / `ident` на нужный метод (`scram-sha-256` по умолчанию)
@@ -97,13 +147,13 @@ systemctl status postgrespro-1c-18
Список ролей: Список ролей:
```bash ```bash
sudo -u postgres /opt/pgpro/1c-18/bin/psql -h /var/run/postgresql -d postgres -c "\du" sudo -u postgres /opt/pgpro/1c-18/bin/psql -h /var/run/postgresql -d postgres -c "\\du"
``` ```
Список баз: Список баз:
```bash ```bash
sudo -u postgres /opt/pgpro/1c-18/bin/psql -h /var/run/postgresql -d postgres -c "\l" sudo -u postgres /opt/pgpro/1c-18/bin/psql -h /var/run/postgresql -d postgres -c "\\l"
``` ```
Подключение под созданным пользователем: Подключение под созданным пользователем:
@@ -115,6 +165,7 @@ sudo -u postgres /opt/pgpro/1c-18/bin/psql -h /var/run/postgresql -d postgres -c
## Что делает скрипт безопасно ## Что делает скрипт безопасно
Скрипт старается быть идемпотентным: Скрипт старается быть идемпотентным:
- если репозиторий уже добавлен, повторно не ломает конфигурацию - если репозиторий уже добавлен, повторно не ломает конфигурацию
- если роль уже существует, обновляет пароль и атрибуты - если роль уже существует, обновляет пароль и атрибуты
- если база уже существует, повторно не создает ее - если база уже существует, повторно не создает ее
@@ -123,8 +174,9 @@ sudo -u postgres /opt/pgpro/1c-18/bin/psql -h /var/run/postgresql -d postgres -c
## Важно ## Важно
- Скрипт рассчитан именно на Debian 13. - Скрипт рассчитан именно на Debian 13.
- Он использует официальный vendor-скрипт добавления репозитория, а не самодельную схему репозиториев. - Он использует официальный vendor-скрипт добавления репозитория, а не самодельную схему репозиториев.
- Если доступ к репозиторию требует логин/пароль, это обрабатывает сам vendor-скрипт Postgres Pro. В текущей версии ссылки вынесены в `.env`, но учетные данные доступа к репозиторию не дублируются вручную без явной необходимости. - Если доступ к репозиторию требует логин/пароль, это обрабатывает сам vendor-скрипт Postgres Pro.
- В открытом репозитории сейчас лежат `env`, `env.example`, `install_pg1c.sh` и `README.md`, так что его можно использовать как точку входа для развертывания или передачи готового комплекта. citeturn437110view0
## Рекомендуемый порядок файлов в проекте ## Рекомендуемый порядок файлов в проекте