Installa PostGIS per AlloyDB Omni

Seleziona una versione della documentazione:

Per archiviare, indicizzare ed eseguire query sui dati geospaziali in AlloyDB Omni, puoi aggiungere manualmente l'estensione PostGIS alla tua installazione.

Puoi installare PostGIS utilizzando uno dei seguenti metodi:

  • Utilizza le opzioni Debian nell'interfaccia a riga di comando di Docker o Podman. Docker si basa su un daemon e richiede privilegi root per la maggior parte delle operazioni, mentre Podman è daemonless e rootless.
  • Utilizza Red Hat Universal Base Images (UBI). Le immagini del sistema operativo di base dei container UBI sono create da parti di Red Hat Enterprise Linux (RHEL).

Prima di iniziare

Installa l'operatore AlloyDB Omni Kubernetes sul tuo cluster Kubernetes.

Aggiungi PostGIS all'installazione di AlloyDB Omni

Per aggiungere l'estensione PostGIS alla tua installazione di AlloyDB Omni, segui questi passaggi:

  1. Imposta la variabile di ambiente OMNI_VERSION:

    OMNI_VERSION=VERSION
    

    Sostituisci VERSION con la versione completa del server di database AlloyDB Omni, ad esempio 16.13.0.

  2. Crea un'immagine Docker personalizzata che includa l'estensione 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-16-postgis-3 \
          postgresql-16-address-standardizer \
          postgresql-16-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. Tagga ed esegui il push dell'immagine PostGIS personalizzata in un Container Registry a cui il tuo cluster Kubernetes può accedere:

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

    Sostituisci CUSTOM_IMAGE_URI con l'URI dell'immagine di destinazione nel Container Registry, ad esempio us-central1-docker.pkg.dev/my-project/my-repo/alloydbomni-with-postgis:16.13.0.

  4. Crea un file manifest denominato db-cluster.yaml che specifichi l'immagine PostGIS personalizzata nel campo databaseImage della risorsa 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: "16.13.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
    

    Sostituisci quanto segue:

    • DB_CLUSTER_NAME: il nome del cluster di database, ad esempio my-db-cluster.
    • DB_CLUSTER_NAMESPACE: lo spazio dei nomi del tuo cluster di database, ad esempio default.
    • ENCODED_PASSWORD: la password codificata in Base64 per l'utente amministratore postgres.
    • CUSTOM_IMAGE_URI: l'URI dell'immagine PostGIS personalizzata di cui hai eseguito il push nel container registry.
    • OS_TYPE: il tipo di sistema operativo di base per l'immagine del database personalizzata. Specifica Debian o UBI9.
    • CPU_COUNT: il numero di vCPU per l'istanza principale, ad esempio 2.
    • MEMORY_SIZE: la dimensione della memoria per l'istanza principale, ad esempio 8Gi.
    • DISK_SIZE: le dimensioni di archiviazione del disco dati dell'istanza principale, ad esempio 10Gi.
  5. Applica il manifest al tuo cluster Kubernetes:

    kubectl apply -f db-cluster.yaml
    

    Per saperne di più sulla risorsa DBCluster, consulta Crea un cluster di database e il riferimento alla risorsa personalizzata DBCluster.

  6. Connettiti al pod del database utilizzando 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. Abilita PostGIS:

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

    L'output è simile al seguente:

    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)