התחברות למופע של Memorystore for Valkey

בדף הזה מוסבר איך להתחבר למכונה של Memorystore for Valkey.

תמיכה בלקוחות

דוגמאות והנחיות לגבי לקוחות שמתחברים ל-Cloud Storage מופיעות במאמר דוגמאות קוד בספריית הלקוח.

אישור יציאות בחומת האש

אם לא תאפשרו את היציאות הנכונות בחומת האש, יכול להיות שיהיו שגיאות בחיבור למכונה כי חומת האש עלולה לחסום את היציאות שמשמשות את Memorystore for Valkey.

בכל נקודות הקצה של Private Service Connect במכונה, צריך לאפשר את יציאת TCP‏ 6379 ואת יציאות TCP‏ 11000 עד 13047. למידע נוסף, ראו פתרון בעיות.

גישה בין אזורים שונים

אפשר לגשת למופע של Memorystore for Valkey מלקוח שנמצא באזור אחר מזה שבו נמצא המופע.

התחברות למכונה שמופעל בה מצב אשכול

בקטע הזה מוסבר איך להתחבר למכונה של Memorystore for Valkey עם מצב אשכול מופעל.

הצגת נקודת הקצה של הגילוי במופע

לכל מופע שמופעל בו Cluster Mode (מצב אשכול) יש נקודת קצה לגילוי שהלקוח מתחבר אליה. נקודת הקצה הזו היא שילוב של כתובת IP ומספר יציאה.

אפשר לראות את נקודת הקצה לזיהוי של מכון Memorystore for Valkey באמצעות מסוף Google Cloud או ה-CLI של gcloud.

gcloud

כדי לראות את נקודת הקצה של הגילוי של המופע, מריצים את describeה-CLI של gcloud כמו שמוסבר במאמר הצגת מידע על מופע.

הפלט אמור להיראות כך:

authorizationMode: AUTH_DISABLED
createTime: '2024-08-06T22:02:55.224704101Z'
deletionProtectionEnabled: false
engineVersion: VALKEY_7_2
name: projects/myproject/locations/us-central1/instances/my-instance
nodeConfig:
  sizeGb: 6.5
nodeType: STANDARD_SMALL
persistenceConfig:
  mode: DISABLED
endpoints:
- connections:
  - pscAutoConnection:
       connectionType: CONNECTION_TYPE_DISCOVERY
       forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-ec00907a-3ee3-4740-8092-ae832428f8e4
       ipAddress: 10.128.0.58
       network: projects/my-project/global/networks/default
       port: 6379
       projectId: my-project
       pscConnectionId: '38876592440606778'
       serviceAttachment: projects/129109085717/regions/us-east1/serviceAttachments/gcp-memorystore-auto-58e78f71-fdb7-48-psc-sa
    - pscAutoConnection:
       forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-5ce5518f-1c59-4b46-aa74-799fad70d7b1
       ipAddress: 10.128.0.59
       network: projects/my-project/global/networks/default
       port: 6379
       projectId: my-project
       pscConnectionId: '38876592440606779'
       serviceAttachment: projects/129109085717/regions/us-east1/serviceAttachments/gcp-memorystore-auto-58e78f71-fdb7-48-psc-sa-2
replicaCount: 2
shardCount: 5
state: ACTIVE
transitEncryptionMode: TRANSIT_ENCRYPTION_DISABLED
uid: 869f2d09-d20b-46d8-94ba-be83c48ceb54
updateTime: '2024-08-06T22:18:59.389980051Z'
zoneDistributionConfig:
  mode: MULTI_ZONE

רושמים את כתובת נקודת הקצה ואת מספר היציאה שמופיעים בקטע endpoints: של הרשומה connectionType: CONNECTION_TYPE_DISCOVERY. שני הערכים האלה ביחד הם נקודת הקצה לגילוי של המכונה.

התחברות ממכונה וירטואלית ב-Compute Engine באמצעות valkey-cli

אתם יכולים להתחבר למכונה של Memorystore for Valkey מכל מכונה וירטואלית של Compute Engine שמשתמשת ברשת המורשית של מכונת Memorystore.

כדי להתחבר למכונה:

  1. אם אין לכם מכונה וירטואלית של Linux ב-Compute Engine שמשתמשת ברשת המורשית של מכונת Memorystore for Valkey, אתם יכולים ליצור מכונה כזו ולהתחבר אליה לפי ההוראות במאמר המדריך למתחילים: יצירת מכונה וירטואלית של Linux.

  2. מתקינים את valkey-cli במכונה וירטואלית ב-Compute Engine לפי ההוראות במאמר התקנת Valkey.

  3. צופים בנקודת הקצה של הגילוי של המופע ורושמים אותה.

  4. כדי להתחבר לנקודת הקצה של ה-Discovery של המופע, מריצים את הפקודה הבאה:

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c

    כאשר:

    • ‫DISCOVERY_ENDPOINT_ADDRESS ו-PORT_NUMBER הם הערכים שציינתם בשלב הקודם.

  5. מריצים את הפקודה CLUSTER SHARDS כדי לראות את טופולוגיית הצומת. רושמים את אחת מכתובות ה-IP ומספרי היציאות של הצומת.

  6. מריצים את הפקודה הבאה כדי להתחבר לצומת הרצוי:

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫NODE_IP_ADDRESS היא כתובת ה-IP של הצומת שמצאתם בשלב הקודם.
    • ‫NODE_PORT הוא מספר היציאה של הצומת שמצאתם בשלב הקודם.

  7. אחרי שמתחברים לצומת, מזינים כמה פקודות Valkey:

    צריך להזין את הפרטים הבאים:

    PING

    תוצאה:

    PONG

    Enter

    SET HELLO WORLD

    תוצאה:

    OK

    צריך להזין את הפרטים הבאים:

    GET HELLO

    תוצאה:

    "WORLD"

  8. אחרי שתסיימו לבדוק את החיבור לצומת Valkey, כדאי למחוק את המכונה הווירטואלית ב-Compute Engine שבה השתמשתם כדי להתחבר למופע Valkey. כך תוכלו להימנע מחיובים בחשבון לחיוב ב-Cloud.

התחברות למכונה שמופעלת בה הצפנה בזמן העברה

בקטע הזה מוצגת דוגמה לחיבור למופע של Memorystore for Valkey עם הפעלה של מצב אשכול והצפנה במעבר.

  1. אם עדיין אין לכם מכונה וירטואלית ב-Compute Engine שמשתמשת באותה רשת מורשית כמו מכונת Valkey מהשלב הקודם, אתם צריכים ליצור מכונה כזו ולהתחבר אליה לפי ההוראות במאמר התחלה מהירה באמצעות מכונה וירטואלית של Linux.

    1. מתקינים את valkey-cli בגרסה 6.0 ואילך במכונה הווירטואלית של Compute Engine לפי ההוראות במאמר התקנת Valkey.

  2. מבצעים את ההוראות שבמאמר התקנת אישורי CA בלקוח כדי להתקין את אישורי רשות האישורים (CA) של המופע במכונה הווירטואלית של Linux.

  3. צופים בנקודת הקצה של הגילוי של המופע ורושמים את כתובת ה-IP ומספר היציאה של נקודת הקצה.

  4. כדי להתחבר לנקודת הקצה של ה-Discovery של המופע, מריצים את הפקודה הבאה:

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls --cacert /tmp/server_ca.pem

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫DISCOVERY_ENDPOINT_ADDRESS: כתובת ה-IP של נקודת הקצה של הגילוי שרשמתם בשלב הקודם
    • ‫PORT_NUMBER: מספר היציאה שרשמתם בשלב הקודם

    כדי להפעיל את מצב התמיכה של valkey-cli, משתמשים במתג -c. אם לא תציינו את המתג הזה, כשתנסו לגשת למפתחות משבר (shard) אחר מזה שאליו אתם מחוברים, המכונה תחזיר את השגיאה MOVED. עם זאת, אם משתמשים במתג, הלקוח מתחבר מחדש באופן אוטומטי לכתובת שצוינה בתגובת השגיאה.

    אם מפעילים באינסטנס אימות של ניהול זהויות והרשאות גישה (IAM) או אימות בסיסי שמבוסס על טוקנים, צריך לספק פרטי אימות לצד הדגלים של Transport Layer Security ‏ (TLS). לדוגמה:

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls --cacert /tmp/server_ca.pem --user USERNAME -a TOKEN

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫USERNAME: שם המשתמש של המכונה
    • ‫TOKEN: טוקן האימות

    מידע נוסף על יצירה או ניהול של פרטי אימות זמין במאמרים ניהול אימות IAM וגישה מאובטחת למופעים באמצעות אימות בסיסי מבוסס-טוקן.

  5. מריצים את הפקודה CLUSTER SHARDS כדי להציג את הטופולוגיה של הצומת. שימו לב לכתובת ה-IP ולמספר היציאה של אחד מהצמתים.

  6. מריצים את הפקודה הבאה כדי להתחבר לצומת:

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls --cacert /tmp/server_ca.pem

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫NODE_IP_ADDRESS: כתובת ה-IP של הצומת שרשמתם בשלב הקודם.
    • ‫NODE_PORT: מספר היציאה של הצומת שרשמתם בשלב הקודם.

    אם האשכול משתמש ב-IAM או באימות בסיסי שמבוסס על אסימון, ודאו שאתם כוללים את הדגלים --user ו--a, כמו שעשיתם בשלב של נקודת הקצה לזיהוי.

  7. אחרי שמתחברים לצומת, מזינים את פקודות Valkey הבאות:

    צריך להזין את הפרטים הבאים:

    PING

    תוצאה:

    PONG

התחברות למכונה שבה מצב אשכול מושבת

בקטע הזה מוסבר איך להתחבר למכונה של Memorystore for Valkey עם מצב אשכול מושבת.

הצגת נקודת הקצה הראשית ונקודת הקצה לקריאה של המכונה

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

gcloud

כדי לראות את נקודת הקצה הראשית של המופע ואת נקודת הקצה של הקורא, מריצים את describe ה-CLI של gcloud, כמו שמוסבר במאמר הצגת פרטי המופע.

הפלט אמור להיראות כך:

authorizationMode: AUTH_DISABLED
createTime: '2024-08-06T22:02:55.224704101Z'
deletionProtectionEnabled: false
engineVersion: VALKEY_7_2
name: projects/myproject/locations/us-central1/instances/my-instance
nodeConfig:
  sizeGb: 6.5
nodeType: STANDARD_SMALL
persistenceConfig:
  mode: DISABLED
endpoints:
- connections:
  - pscAutoConnection:
      connectionType: CONNECTION_TYPE_PRIMARY
      forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-ec00907a-3ee3-4740-8092-ae832428f8e4
      ipAddress: 10.128.0.124
      network: projects/my-project/global/networks/default
      port: 6379
      projectId: my-project
      pscConnectionId: '38876592440606778'
      serviceAttachment: projects/448055306617/regions/us-central1/serviceAttachments/gcp-memorystore-auto-b3c43536-4a77-40-psc-sa
  - pscAutoConnection:
      connectionType: CONNECTION_TYPE_READER
      forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-5ce5518f-1c59-4b46-aa74-799fad70d7b1
      ipAddress: 10.128.0.125
      network: projects/my-project/global/networks/default
      port: 6379
      projectId: my-project
      pscConnectionId: '38876592440606779'
      serviceAttachment: projects/448055306617/regions/us-central1/serviceAttachments/gcp-memorystore-auto-b3c43536-4a77-40-psc-sa-2
replicaCount: 2
shardCount: 1
mode: CLUSTER_DISABLED
state: ACTIVE
transitEncryptionMode: TRANSIT_ENCRYPTION_DISABLED
uid: 869f2d09-d20b-46d8-94ba-be83c48ceb54
updateTime: '2024-08-06T22:18:59.389980051Z'
zoneDistributionConfig:
  mode: MULTI_ZONE

נקודת קצה ראשית: רושמים את כתובת נקודת הקצה ואת מספר היציאה שמופיעים בקטע endpoints: מתחת ל-CONNECTION_TYPE_PRIMARY. שני הערכים האלה ביחד הם נקודת הקצה הראשית של המופע.

נקודת קצה לקריאה: שימו לב לכתובת של נקודת הקצה ולמספר היציאה שמופיעים בקטע endpoints:, מתחת ל-CONNECTION_TYPE_READER. שני הערכים האלה ביחד הם נקודת הקצה לקריאה של המכונה.

התחברות ממכונה וירטואלית ב-Compute Engine באמצעות valkey-cli

אתם יכולים להתחבר למכונה של Memorystore for Valkey מכל מכונה וירטואלית של Compute Engine שמשתמשת ברשת המורשית של מכונת Memorystore.

כדי להתחבר למכונה:

  1. אם עדיין אין לכם מכונה וירטואלית ב-Compute Engine עם מערכת Linux שמשתמשת ברשת המורשית עבור מופע Memorystore for Valkey, אתם יכולים ליצור אחת ולהתחבר אליה באמצעות המדריך לתחילת העבודה ליצירת מכונה וירטואלית עם מערכת Linux.

  2. מתקינים את valkey-cli במכונה הווירטואלית של Compute Engine לפי ההוראות במאמר התקנת Valkey.

  3. צופים בנקודת הקצה הראשית ובנקודת הקצה של הקורא של המופע ורושמים אותן.

  4. מריצים את הפקודה הבאה כדי להתחבר לנקודת הקצה הראשית של המכונה:

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER

    כאשר:

    • ‫PRIMARY_ENDPOINT_ADDRESS ו-PORT_NUMBER הם הערכים שציינתם בשלב הקודם.

  5. אחרי שמתחברים לצומת הראשי, מזינים את פקודות Valkey הבאות:

    צריך להזין את הפרטים הבאים:

    PING

    תוצאה:

    PONG

    Enter

    SET HELLO WORLD

    תוצאה:

    OK

    צריך להזין את הפרטים הבאים:

    GET HELLO

    תוצאה:

    "WORLD"

  6. מריצים את הפקודה הבאה כדי להתחבר לנקודת הקצה של הקורא במכונה:

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER

    כאשר:

    • ‫READER_ENDPOINT_ADDRESS ו-PORT_NUMBER הם הערכים שציינתם בשלב הקודם.

  7. אחרי שמתחברים לצומת הראשי, מזינים את פקודות Valkey Get הבאות:

    צריך להזין את הפרטים הבאים:

    PING

    תוצאה:

    PONG

    צריך להזין את הפרטים הבאים:

    GET HELLO

    תוצאה:

    "WORLD"

  8. אחרי שבודקים את החיבור לצומת Valkey, צריך למחוק את ה-VM ב-Compute Engine ששימש להתחברות למכונה של Valkey. כך תוכלו להימנע מחיובים בחשבון לחיוב ב-Cloud.

התחברות למכונה שמופעלת בה הצפנה במעבר

בקטע הזה מוצגת דוגמה לחיבור למופע של Memorystore for Valkey שבו מצב האשכול מושבת וההצפנה במעבר מופעלת.

  1. אם עדיין אין לכם מכונה וירטואלית ב-Compute Engine שמשתמשת באותה רשת מורשית כמו מכונת Valkey מהשלב הקודם, אתם צריכים ליצור מכונה כזו ולהתחבר אליה לפי ההוראות במאמר התחלה מהירה באמצעות מכונה וירטואלית של Linux.

    1. מתקינים את valkey-cli גרסה 6.0 ואילך במכונה וירטואלית של Compute Engine לפי ההוראות במאמר התקנת Valkey.

  2. בודקים את מצב רשות האישורים (CA) שבו משתמשים במכונה.

  3. מציגים את נקודות הקצה הראשיות ונקודות הקצה לקריאה של המכונה, ורושמים את כתובת ה-IP ואת מספר היציאה של כל נקודת קצה.

  4. כדי להתחבר לנקודת הקצה הראשית של המופע, מריצים את הפקודה הבאה:

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls --cacert /tmp/server_ca.pem

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PRIMARY_ENDPOINT_ADDRESS: כתובת ה-IP של נקודת הקצה הראשית שציינתם בשלב הקודם
    • ‫PORT_NUMBER: מספר היציאה של נקודת הקצה הזו שציינתם בשלב הקודם

  5. מריצים את הפקודה הבאה כדי להתחבר לנקודת הקצה של הקורא במכונה:

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls --cacert /tmp/server_ca.pem

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫READER_ENDPOINT_ADDRESS: כתובת ה-IP של נקודת הקצה של הקורא שרשמתם
    • ‫PORT_NUMBER: מספר היציאה של נקודת הקצה הזו שציינתם

    אם מפעילים באינסטנס אימות IAM או אימות בסיסי מבוסס-טוקן, צריך לספק פרטי אימות לצד דגלי ה-TLS גם לנקודות הקצה הראשיות וגם לנקודות הקצה של הקורא.

    לדוגמה:

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls --cacert /tmp/server_ca.pem --user USERNAME -a TOKEN

    וגם

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls --cacert /tmp/server_ca.pem --user USERNAME -a TOKEN

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫USERNAME: שם המשתמש של המכונה
    • ‫TOKEN: טוקן האימות

    מידע נוסף על יצירה או ניהול של פרטי אימות זמין במאמרים ניהול אימות IAM וגישה מאובטחת למופעים באמצעות אימות בסיסי מבוסס-טוקן.

  6. אחרי שמתחברים לצומת, מזינים כמה פקודות של Valkey:

    צריך להזין את הפרטים הבאים:

    PING

    תוצאה:

    PONG