התחברות למופע של 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 Enabled.

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

לכל מופע שמופעל בו 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 ואילך במכונת ה-VM של Compute Engine לפי ההוראות במאמר התקנת Valkey.

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

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

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

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

    כאשר:

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

  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 הוא מספר היציאה של הצומת שמצאתם בשלב הקודם.

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

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

    PING

    תוצאה:

    PONG

התחברות למכונה שבה Cluster Mode Disabled (מצב אשכול מושבת)

בקטע הזה מוסבר איך להתחבר למופע של Memorystore for Valkey במצב Cluster Mode Disabled.

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

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

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. אם עדיין אין לכם מכונת וירטואלית של Linux Compute Engine שמשתמשת ברשת המורשית עבור מופע 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 ואילך במכונת ה-VM של Compute Engine לפי ההוראות במאמר התקנת Valkey.

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

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

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

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

    כאשר:

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

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

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

    כאשר:

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

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

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

    PING

    תוצאה:

    PONG