במאמר הזה מוסבר איך להוריד את קובץ ה-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 ולאסוף תלויות מהמקור, מריצים את הפקודות הבאות:
משכפלים את המאגר:
git clone https://github.com/GoogleCloudPlatform/pgadapter.gitיוצרים את החבילה:
mvn package -P assembly
תהליך ה-build יוצר את הקבצים הבינאריים בתיקייה target/pgadapter.
שימוש בתהליך Java
מוסיפים את google-cloud-spanner-pgadapter כתלות לפרויקט.
Maven
אם משתמשים ב-Maven, מוסיפים את התלות הבאה לקובץ pom.xml: