במאמר הזה מוסבר איך להוריד את הקובץ הבינארי של 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
תמונת Distroless
אנחנו מפרסמים גם קובץ אימג' של Docker ללא הפצה בתג gcr.io/cloud-spanner-pg-adapter/pgadapter-distroless. התמונה הזו מריצה את PGAdapter כמשתמש שאינו Root.
כדי למשוך את קובץ האימג' ללא הפצה, מריצים את הפקודה הבאה:
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:
שימוש ב-Spanner PG Connector (spgc)
כדי להריץ כלי שורת פקודה של PostgreSQL כמו psql או pg_dump בלי להתקין את Java או Docker, משתמשים ב-spanner-pg-connector (עם הכינוי spgc). spgc כולל את PGAdapter וסביבת זמן ריצה מינימלית של Java. הוראות להתקנה ולשימוש מפורטות במאמר הפעלת PGAdapter.