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

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

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

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

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

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

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

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

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

לכל מופע שמופעל בו מצב אשכול יש נקודת קצה לגילוי שהלקוח מתחבר אליה. נקודת הקצה הזו היא שילוב של כתובת 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. אם עדיין אין לכם מכונת וירטואלית (VM) של Linux ב-Compute Engine שמשתמשת ברשת המורשית עבור מופע Memorystore for Valkey, אתם יכולים ליצור אחת ולהתחבר אליה באמצעות המדריך להתחלה מהירה ליצירת מכונת וירטואלית של Linux.

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

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

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

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

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

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

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

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

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

    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. אם עדיין אין לכם מכונת וירטואלית (VM) של 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