Instala PostGIS para AlloyDB Omni

Selecciona una versión de la documentación:

Para almacenar, indexar y consultar datos geoespaciales en AlloyDB Omni, puedes agregar de forma manual la extensión de PostGIS a tu instalación.

Puedes instalar PostGIS con cualquiera de los siguientes métodos:

  • Usa las opciones de Debian en la CLI de Docker o Podman. Docker depende de un daemon y requiere privilegios de administrador para la mayoría de las operaciones, mientras que Podman no tiene daemon ni privilegios de administrador.
  • Usa imágenes base universales (UBI) de Red Hat. Las imágenes del sistema operativo base del contenedor de UBI se compilan a partir de partes de Red Hat Enterprise Linux (RHEL).

Antes de comenzar

Instala el operador de Kubernetes de AlloyDB Omni en tu clúster de Kubernetes.

Agrega PostGIS a tu instalación de AlloyDB Omni

Para agregar la extensión de PostGIS a tu instalación de AlloyDB Omni, sigue estos pasos:

  1. Establece la variable de entorno OMNI_VERSION:

    OMNI_VERSION=VERSION
    

    Reemplaza VERSION por la versión completa del servidor de la base de datos de AlloyDB Omni, por ejemplo, 17.5.0.

  2. Compila una imagen de Docker personalizada que incluya la extensión de PostGIS:

    mkdir -p ~/alloydb-omni-postgis
    
    tee ~/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-17-postgis-3 \
          postgresql-17-address-standardizer \
          postgresql-17-postgis-tiger-geocoder && \
          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 .
    
  3. Etiqueta y envía tu imagen personalizada de PostGIS a un Container Registry al que pueda acceder tu clúster de Kubernetes:

    sudo docker tag google/alloydbomni-with-postgis:$OMNI_VERSION \
      CUSTOM_IMAGE_URI
    sudo docker push CUSTOM_IMAGE_URI
    

    Reemplaza CUSTOM_IMAGE_URI por el URI de la imagen de destino en tu Container Registry, por ejemplo, us-central1-docker.pkg.dev/my-project/my-repo/alloydbomni-with-postgis:17.5.0.

  4. Crea un archivo de manifiesto llamado db-cluster.yaml que especifique tu imagen personalizada de PostGIS en el campo databaseImage del recurso DBCluster:

    apiVersion: v1
    kind: Secret
    metadata:
      name: db-pw-DB_CLUSTER_NAME
      namespace: DB_CLUSTER_NAMESPACE
    type: Opaque
    data:
      DB_CLUSTER_NAME: "ENCODED_PASSWORD"
    ---
    apiVersion: alloydbomni.dbadmin.goog/v1
    kind: DBCluster
    metadata:
      name: DB_CLUSTER_NAME
      namespace: DB_CLUSTER_NAMESPACE
    spec:
      databaseVersion: "17.5.0"
      databaseImage: "CUSTOM_IMAGE_URI"
      databaseImageOSType: "OS_TYPE"
      primarySpec:
        adminUser:
          passwordRef:
            name: db-pw-DB_CLUSTER_NAME
        resources:
          cpu: CPU_COUNT
          memory: MEMORY_SIZE
          disks:
          - name: DataDisk
            size: DISK_SIZE
    

    Reemplaza lo siguiente:

    • DB_CLUSTER_NAME: Es el nombre de tu clúster de base de datos, por ejemplo, my-db-cluster.
    • DB_CLUSTER_NAMESPACE: Es el espacio de nombres de tu clúster de base de datos, por ejemplo, default.
    • ENCODED_PASSWORD: Es la contraseña codificada en Base64 para el usuario administrador de postgres.
    • CUSTOM_IMAGE_URI: Es el URI de la imagen personalizada de PostGIS que enviaste a tu Container Registry.
    • OS_TYPE: Es el tipo de sistema operativo base para tu imagen de base de datos personalizada. Especifica Debian o UBI9.
    • CPU_COUNT: Es la cantidad de CPU virtuales para la instancia principal, por ejemplo, 2.
    • MEMORY_SIZE: el tamaño de la memoria de la instancia principal, por ejemplo, 8Gi.
    • DISK_SIZE: Es el tamaño de almacenamiento del disco de datos de la instancia principal, por ejemplo, 10Gi.
  5. Aplica el manifiesto a tu clúster de Kubernetes:

    kubectl apply -f db-cluster.yaml
    

    Para obtener más información sobre el recurso DBCluster, consulta Crea un clúster de base de datos y la referencia de recursos personalizados de DBCluster.

  6. Conéctate al Pod de tu base de datos con psql:

    export DBPOD=$(kubectl get pod -n DB_CLUSTER_NAMESPACE \
      --selector=alloydbomni.internal.dbadmin.goog/dbcluster=DB_CLUSTER_NAME,alloydbomni.internal.dbadmin.goog/task-type=database \
      -o jsonpath='{.items[0].metadata.name}')
    
    kubectl exec -ti $DBPOD -n DB_CLUSTER_NAMESPACE \
      -c database -- psql -h localhost -U postgres
    
  7. Habilita PostGIS:

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

    El resultado es similar a lo siguiente:

    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)