Ejecuta AlloyDB Omni y conéctate a él con RPM

Selecciona una versión de la documentación:

En esta página, se describe cómo ejecutar AlloyDB Omni y conectarse a él después de instalarlo en tu propia máquina.

Antes de comenzar

Instala AlloyDB Omni en tu sistema.

Ejecuta AlloyDB Omni

Usa la información de las siguientes secciones para iniciar, verificar el estado y detener AlloyDB Omni.

Opcional: Actualiza las políticas de SELinux

Si SELinux está habilitado en tu sistema y modificas ciertos parámetros de configuración unificada general (GUC) en el archivo postgresql.conf, debes actualizar tus políticas de SELinux antes de iniciar el servicio de AlloyDB Omni. La actualización de estas políticas evita las denegaciones de acceso a los recursos que pueden hacer que el servidor de la base de datos no esté disponible o interrumpir operaciones como las copias de seguridad.

Para ejecutar los comandos semanage y restorecon, se requiere el paquete policycoreutils-python-utils.

En la siguiente tabla, se enumeran los parámetros de GUC que requieren actualizaciones de la política de SELinux cuando los cambias de sus valores predeterminados:

Parámetro de GUC Tipo de recurso Impacto si no se actualiza la política de SELinux Solución
port Puerto El servidor de la base de datos no se inicia y deja de estar disponible. Asigna la etiqueta postgresql_port_t al puerto TCP personalizado.
external_pid_file Archivo El servidor de la base de datos sigue disponible, pero SELinux deniega el acceso para crear el archivo PID externo fuera de /var/run/postgresql/. Asigna la etiqueta postgresql_db_t al directorio de archivos PID personalizado.
unix_socket_directories Archivo El servidor de la base de datos no puede crear el archivo de socket y deja de estar disponible. Asigna la etiqueta postgresql_db_t al directorio de sockets de Unix personalizado.
log_directory Archivo El servidor de la base de datos no puede escribir registros y deja de estar disponible. Asigna la etiqueta postgresql_db_t al directorio de registro personalizado.
archive_command Archivo El servidor de la base de datos sigue disponible, pero SELinux deniega el acceso de escritura al directorio de destino, lo que puede interrumpir el archivado y las copias de seguridad del registro de escritura anticipada (WAL). Asigna la etiqueta postgresql_db_t al directorio de archivo personalizado.

Actualiza la política de SELinux para un puerto personalizado

Si cambias el parámetro port en el archivo postgresql.conf, ejecuta los siguientes comandos para permitir que AlloyDB Omni se vincule al puerto TCP personalizado:

  1. Agrega la etiqueta postgresql_port_t al puerto personalizado:

    sudo /usr/sbin/semanage port -a -t postgresql_port_t -p tcp PORT_NUMBER

    Reemplaza PORT_NUMBER por el número de puerto TCP personalizado, por ejemplo, 5433.

  2. Confirma que se haya actualizado la política de puertos:

    sudo /usr/sbin/semanage port -l | grep postgresql_port_t

Actualiza la política de SELinux para un directorio personalizado

Si cambias el parámetro external_pid_file, unix_socket_directories, log_directory o archive_command en el archivo postgresql.conf para usar un directorio personalizado, ejecuta los siguientes comandos para aplicar el contexto de postgresql_db_t a ese directorio:

sudo /usr/sbin/semanage fcontext -a -t postgresql_db_t "DIRECTORY_PATH(/.*)?"
sudo /sbin/restorecon -R -F DIRECTORY_PATH

Reemplaza DIRECTORY_PATH por la ruta de acceso completa al directorio del archivo PID personalizado, el directorio del socket de Unix, el directorio de registros o el directorio de archivos WAL.

Inicia AlloyDB Omni

  sudo systemctl start alloydbomni18

Opcional: Habilita el reinicio automático de servicios

Para habilitar el reinicio automático del servicio de AlloyDB Omni, haz lo siguiente:

  1. Agrega la siguiente configuración al archivo /etc/systemd/system/alloydbomni18.service.d/override.conf.

      [Service]
    Restart=on-failure

  2. Vuelve a cargar la configuración del administrador de systemd y reinicia el servicio de alloydbomni18 para que se apliquen los cambios.

    sudo systemctl daemon-reload
sudo systemctl restart alloydbomni18

Verifica el estado de AlloyDB Omni

   sudo systemctl status alloydbomni18

Detén AlloyDB Omni

  sudo systemctl stop alloydbomni18

Conéctate a AlloyDB Omni

El paquete RPM de AlloyDB Omni también incluye el cliente psql que te permite abrir una sesión interactiva de shell de SQL con el servidor de la base de datos.

También puedes conectarte a AlloyDB Omni con el software compatible con PostgreSQL que elijas.

Conéctate con psql empaquetado

  /usr/lib/postgresql/18/bin/psql -h localhost -U postgres

Este comando te conecta al servidor como el rol de usuario postgres y muestra un símbolo del sistema postgres=#. Ahora puedes ejecutar comandos de psql y consultas en SQL.

Para salir de psql, ejecuta el comando \q.

Conéctate con tus propias aplicaciones

Cualquier aplicación cliente que funcione con PostgreSQL también puede funcionar con AlloyDB Omni, sin necesidad de realizar modificaciones.

Usa cualquier cliente o biblioteca de código compatible con PostgreSQL para conectarte a AlloyDB Omni.

Después de conectarte al servidor de la base de datos, puedes definir, consultar y modificar tus bases de datos enviando consultas de DML y SQL a través de protocolos de comunicación estándar de PostgreSQL.

Debido a que AlloyDB Omni se ejecuta en tu propio entorno, puedes controlar cómo te conectas a AlloyDB Omni. Puedes permitir o restringir el acceso de red a AlloyDB Omni según las necesidades de tu aplicación, tal como lo harías con un servidor de PostgreSQL común.

¿Qué sigue?