Installer PostGIS pour AlloyDB Omni

Sélectionnez une version de la documentation :

Cette page explique comment ajouter manuellement l'extension PostGIS à une installation AlloyDB Omni existante. L'extension PostGIS permet de stocker, d'indexer et d'interroger des données géospatiales.

Vous pouvez installer PostGIS à l'aide de l'une des méthodes suivantes :

  • Utilisez les options Debian dans la CLI Docker ou Podman. Docker s'appuie sur un daemon et nécessite des droits racine pour la plupart des opérations, tandis que Podman est sans daemon et sans racine.
  • Utilisez les images de base universelles (UBI) Red Hat. Les images de système d'exploitation de base de conteneur UBI sont créées à partir de composants de Red Hat Enterprise Linux (RHEL).

Avant de commencer

Installez AlloyDB Omni sur votre système.

Ajouter PostGIS à votre installation AlloyDB Omni

Pour ajouter l'extension PostGIS à votre installation AlloyDB Omni, procédez comme suit :

  1. Recherchez les libellés de la version d'AlloyDB Omni que vous avez installée :

    Docker

    docker run --rm -it  google/alloydbomni cat VERSION.txt

    Podman

    podman run --rm -it  google/alloydbomni cat VERSION.txt

    Le résultat ressemble à ce qui suit :

    AlloyDB Omni version: 16.8.0

    Notez le numéro de version d'AlloyDB Omni, car vous en aurez besoin à l'étape suivante.

  2. Définissez la variable d'environnement OMNI_VERSION :

    OMNI_VERSION=VERSION

    Remplacez VERSION par la version complète du serveur de base de données de l'étape précédente, par exemple 16.8.0.

  3. Créez un conteneur AlloyDB Omni incluant PostGIS :

    Linux 

    mkdir ~/alloydb-omni-postgis

tee -a ~/alloydb-omni-postgis/Dockerfile << EOF
ARG OMNI_VERSION
  FROM google/alloydbomni:OMNI_VERSION
  RUN apt-get update && \
        apt-get install -y --no-install-recommends \
        postgresql-16-postgis-3 && \
        apt-get purge -y --auto-remove && \
        rm -rf /var/lib/apt/lists/*
 EOF

 cd ~/alloydb-omni-postgis

 sudo docker build --build-arg OMNI_VERSION=$OMNI_VERSION --tag google/alloydbomni-with-postgis:OMNI_VERSION .

    MacOS 

    mkdir ~/alloydb-omni-postgis

tee -a ~/alloydb-omni-postgis/Dockerfile << EOF
ARG OMNI_VERSION
FROM google/alloydbomni:OMNI_VERSION
RUN apt-get update && \
      apt-get install -y --no-install-recommends \
      postgresql-16-postgis-3 && \
      apt-get purge -y --auto-remove && \
      rm -rf /var/lib/apt/lists/*
 EOF

 cd ~/alloydb-omni-postgis

 sudo docker build --build-arg OMNI_VERSION=$OMNI_VERSION --tag google/alloydbomni-with-postgis:$OMNI_VERSION .
 ```

  4. Créez un conteneur avec AlloyDB Omni nommé my-omni-postgis :

    Docker 

    docker build -t google/alloydbomni-with-postgis:latest
docker run --name my-omni-postgis  -e POSTGRES_PASSWORD=NEW_PASSWORD  -d google/alloydbomni-with-postgis:OMNI_VERSION

    Podman 

    podman run --name my-omni-postgis  -e POSTGRES_PASSWORD=NEW_PASSWORD  -d google/alloydbomni-with-postgis:OMNI_VERSION

  5. Connectez-vous à votre base de données avec l'extension PostGIS :

    docker exec -it my-omni-postgis psql -h localhost -U postgres

  6. Activer PostGIS :

    CREATE EXTENSION IF NOT EXISTS POSTGIS;
SELECT postgis_full_version();

    La sortie ressemble à ceci :

    postgres=# SELECT postgis_full_version();
postgis_full_version
--------------------------------------------------------------------------------------------------------------------------------
POSTGIS="3.3.2 4975da8" [EXTENSION] PGSQL="150" GEOS="3.11.1-CAPI-1.17.1" PROJ="9.1.1" LIBXML="2.9.14" LIBJSON="0.16" LIBPROTOBUF="1.4.1" WAGYU="0.5.0 (Internal)"
(1 row)