====== Установка 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 }}