הורדת PGAdapter

במאמר הזה מוסבר איך להוריד את קובץ ה-PGAdapter הבינארי. משתמשים ב-PGAdapter עם מסדי נתונים בניב PostgreSQL.

אפשר להריץ את PGAdapter בקונטיינר Docker, כתהליך עצמאי או כתהליך בתוך אפליקציית Java.

הרצה בקונטיינר Docker

מריצים את PGAdapter בקונטיינר ב-Docker באמצעות אחת מהאפשרויות הבאות:

תמונה רגילה

כדי לקבל את הגרסה העדכנית של תמונת הדיסק הסטנדרטית, מריצים את הפקודה הבאה:

docker pull gcr.io/cloud-spanner-pg-adapter/pgadapter

כדי לקבל גרסה קודמת, מוסיפים את הגרסה כתג:

docker pull gcr.io/cloud-spanner-pg-adapter/pgadapter:vVERSION_NUMBER

תמונה ללא הפצה

אנחנו מפרסמים גם קובץ אימג' של Docker ללא הפצה עם התג gcr.io/cloud-spanner-pg-adapter/pgadapter-distroless. התמונה הזו מריצה את PGAdapter כמשתמש שאינו Root.

כדי למשוך את קובץ האימג' distroless, מריצים את הפקודה הבאה:

docker pull gcr.io/cloud-spanner-pg-adapter/pgadapter-distroless

הפעלה כתהליך עצמאי

מריצים את PGAdapter כתהליך עצמאי ב-JVM על ידי קבלת קובץ ה-JAR באחת מהאפשרויות הבאות:

קובץ JAR שנוצר מראש (הגרסה האחרונה)

כדי להוריד את קובץ ה-JAR העדכני ואת התלויות, מריצים את הפקודה הבאה:

wget https://storage.googleapis.com/pgadapter-jar-releases/pgadapter.tar.gz \
  && tar -xzvf pgadapter.tar.gz

קובץ JAR שנוצר מראש (גרסה ספציפית)

כדי להוריד גרסה ספציפית של קובץ ה-JAR, צריך להגדיר את הגרסה כשמורידים אותו.

VERSION=VERSION_NUMBER
wget https://storage.googleapis.com/pgadapter-jar-releases/pgadapter-${VERSION}.tar.gz \
  && tar -xzvf pgadapter-${VERSION}.tar.gz

קובץ JAR שנבנה באופן מקומי (ממקור)

כדי ליצור את קובץ ה-JAR ולאסוף תלויות מהמקור, מריצים את הפקודות הבאות:

  1. משכפלים את המאגר:

    git clone https://github.com/GoogleCloudPlatform/pgadapter.git
    
  2. יוצרים את החבילה:

    mvn package -P assembly
    

תהליך ה-build יוצר את הקבצים הבינאריים בתיקייה target/pgadapter.

שימוש בתהליך Java

מוסיפים את google-cloud-spanner-pgadapter כתלות לפרויקט.

Maven

אם משתמשים ב-Maven, מוסיפים את התלות הבאה לקובץ pom.xml:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-spanner-pgadapter</artifactId>
  <version>0.55.3</version>
</dependency>

המאמרים הבאים