Различия

Показаны различия между двумя версиями страницы.

--- linux:postgresql:pgagent [2023/01/20 05:44] – создано dx
+++ linux:postgresql:pgagent [2023/05/21 14:23] (текущий) – dx
@@ Строка 1: / Строка 1: @@
+====== Установка pgAgent в Debian 11 ======
+К сожалению PostgreSQL в отличие от [[microsoft:mssql:index|MSSQL]] или [[linux:mysql:index|MySQL]] не имеет встроенных средств планировщика.
+[[https://severalnines.com/blog/overview-job-scheduling-tools-postgresql/|Здесь]] описаны различные варианты планировщика для PostgreSQL. Это обычный Linux cron(tab), pg_cron и pgAgent. О последнем и пойдет речь.
+Установку и настройку pgagent в документации нельзя назвать исчерпывающей из-за чего собственно и появилась эта заметка. Тем не менее ссылки на документацию оставлю
+  * [[https://www.pgadmin.org/docs/pgadmin4/development/pgagent_install.html|Installing pgAgent]]
+  * [[https://get.enterprisedb.com/docs/Tutorial_All_PP_pgAgent.pdf|How to Set Up pgAgent for Postgres Plus]] в формате PDF и локальная {{ :linux:postgresql:tutorial_all_pp_pgagent.pdf |копия PDF файла}}.
+===== apt install =====
+<code bash>
+apt-get update
+apt-get install pgagent
+</code>
+===== Файл pgpass =====
+Чтобы избежать неприятностей и быть в безопасности [[https://www.pgadmin.org/docs/pgadmin4/development/using_pgagent.html#security-concerns|следуем рекомендациям сайта pgadmin]] и создаём файл **pgpass**.
+Отдельно про файл pgpass я [[linux:postgresql:pgpass|уже создал заметку]], так что не буду повторяться.
+По-умолчанию используется пользователь ''postgres'' с домашней директорией ''/var/lib/postgresql''
+<code bash>
+su - postgres
+echo localhost:5432:*:pgagent:password1337 >> ~/.pgpass
+chmod 600 ~/.pgpass
+chown postgres:postgres /var/lib/postgresql/.pgpass
+</code>
+===== Логи =====
+Создаём директорию для логов и выставляем права
+<code bash>
+mkdir /var/log/pgagent
+chown -R postgres:postgres /var/log/pgagent
+chmod g+w /var/log/pgagent
+</code>
+===== PostgreSQL =====
+Создаём в базе **postgres** новое [[https://postgrespro.ru/docs/postgresql/15/sql-createextension|расширение]], пользователя pgagent
+<code sql>
+CREATE EXTENSION pgagent;
+CREATE USER "pgagent" WITH
+  LOGIN
+  NOSUPERUSER
+  INHERIT
+  NOCREATEDB
+  NOCREATEROLE
+  NOREPLICATION
+  encrypted password 'password1337';
+GRANT USAGE ON SCHEMA pgagent TO pgagent;
+GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA pgagent TO pgagent;
+GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA pgagent TO pgagent;
+</code>
+Проверяем соединение (журнал Postgres в файле ''/var/log/postgresql/postgresql-1{X}-main.log'')
+**psql**
+<code bash>psql -h localhost -d postgres -U pgagent</code>
+**pgAgent**
+<code bash>
+su - postgres
+/usr/bin/pgagent -f -l 2 host=localhost port=5432 user=pgagent dbname=postgres
+</code>
+===== pgagent.conf =====
+Создаём файл ''/etc/pgagent.conf''
+<code bash>
+DBNAME=postgres
+DBUSER=pgagent
+DBHOST=localhost
+DBPORT=5432
+# ERROR=0, WARNING=1, DEBUG=2
+LOGLEVEL=1
+LOGFILE="/var/log/pgagent/pgagent.log"
+</code>
+===== systemd сервис =====
+Создаём файл ''/etc/systemd/system/pgagent.service''
+<code bash>
+[Unit]
+Description=pgAgent for PostgreSQL
+After=syslog.target
+After=network.target
+[Service]
+Type=forking
+User=postgres
+Group=postgres
+# Location of the configuration file
+EnvironmentFile=/etc/pgagent.conf
+# Where to send early-startup messages from the server (before the logging
+# options of pgagent.conf take effect)
+# This is normally controlled by the global default set by systemd
+# StandardOutput=syslog
+# Disable OOM kill on the postmaster
+OOMScoreAdjust=-1000
+ExecStart=/usr/bin/pgagent -s ${LOGFILE}  -l ${LOGLEVEL} host=${DBHOST} dbname=${DBNAME} user=${DBUSER} port=${DBPORT}
+KillMode=mixed
+KillSignal=SIGINT
+Restart=on-failure
+# Give a reasonable amount of time for the server to start up/shut down
+TimeoutSec=300
+[Install]
+WantedBy=multi-user.target
+</code>
+Для удобства можно изменить расположение конфигурационного файла
+<code bash>EnvironmentFile=/etc/systemd/system/pgagent.env</code>
+Запускаем наш systemd сервис
+<code bash>
+systemctl daemon-reload
+systemctl enable pgagent
+systemctl start pgagent
+</code>
+===== Logrotate =====
+Теперь нужно настроить **logrotate** о чём мы все с вами обычно забываем.
+Создаём файл ''/etc/logrotate.d/pgagent''
+<code bash>
+/var/log/pgagent/*.log {
+       weekly
+       rotate 14
+       copytruncate
+       delaycompress
+       compress
+       notifempty
+       missingok
+       su root root
+}
+</code>
+Проверка logrotate
+<code bash>logrotate -f /etc/logrotate.d/pgagent</code>
+EOM
+{{tag>postgresql pgagent linux debian }}