Verbindung über die Befehlszeilenschnittstelle (CLI) herstellen

Greifen Sie direkt über eine Befehlszeilenschnittstelle (CLI) auf Ihre Redis-Datenbank zu. Die CLI ermöglicht die direkte Interaktion und Überwachung der Datenstrukturen, die in der Datenbank erstellt werden. Des Weiteren ist ein solcher Client nützlich für die Verwaltung und Überwachung des Schlüsselbereichs und der Leistung, für die Installation und Änderung von Scripts sowie für andere Managementaktivitäten.

Der redli-Client muss für die Benutzerverwaltungsfunktionen aktualisiert werden, die in Redis. Wenn Sie versuchen, eine Verbindung herzustellen, ohne den Client zu aktualisieren, erhalten Sie eine Fehlermeldung wie: (error) WRONGPASS invalid username-password pair.

Verbindungszeichenfolgen

Die Verbindungszeichenfolgen werden im Bereich Endpunkte auf der Übersichtsseite Ihrer Bereitstellung angezeigt und können auch über das Cloud Databases CLI-Plug-in und die Cloud Databases API abgerufen werden.

Die Informationen, die die Clients benötigen, um eine Verbindung zu Ihrer Bereitstellung herzustellen, befinden sich im Abschnitt "CLI" eines Berechtigungsnachweises, der auf der Seite Dienstberechtigungsnachweise erstellt wurde. Die Tabelle enthält eine Aufgliederung zu Referenzzwecken.

redis /cli Verbindungsinformationen
Feldname Index Beschreibung
Bin Die empfohlene Binärdatei zum Erstellen einer Verbindung. In diesem Fall ist dies redli.
Composed Ein formatierter Befehl zum Aufbauen einer Verbindung zu Ihrer Bereitstellung. Der Befehl kombiniert die ausführbare Binärdatei (Bin) und die Einstellungen der Variablen für die Environment und verwendet Arguments als Befehlszeilenparameter.
Environment Eine Liste von Schlüsseln/Werten, die Sie als Umgebungsvariablen festlegen.
Arguments 0... Die Informationen, die als Argumente an den im Feld 'Bin' angezeigten Befehl übergeben werden.
Certificate Base64 Ein diensteigenes Zertifikat, das verwendet wird, um zu bestätigen, dass eine Anwendung eine Verbindung zum entsprechenden Server herstellt. Das Zertifikat liegt in Base64-Codierung vor.
Certificate Name Der zugewiesene Name für das diensteigene Zertifikat.
Type Der Typ des Pakets, das diese Verbindungsinformationen verwendet; in diesem Fall cli.
  • 0... Gibt an, dass es möglicherweise weitere derartige Einträge in einem Array gibt.

Installieren von redis-cli

redis-cli ist die offizielle unterstützte Befehlszeilenschnittstelle für Redis. Wenn Sie redis-cli verwenden möchten, müssen Sie einige zusätzliche Konfigurationsschritte durchführen.

redis-cli ist Teil des Pakets Redis. Installieren Sie daher zunächst Redis lokal. Installieren Sie auf macOS, brew und verwenden Sie dann brew install redis, um das System zum Laufen zu bringen. Unter Linux finden Sie im Paketmanager Ihrer Distribution das neueste Redis-Paket, oder laden Sie den Quellcode herunter und bauen Sie ihn selbst.

Installieren von redli

Bei redli handelt es sich um einen quelloffenen Redis-Befehlszeilenclient. Es handelt sich um ein eigenständiges Programm, das die Befehlszeilenargumente von redis-cli imitiert und Unterstützung für TLS/SSL-Verbindungen Redis bietet. Er erkennt das Protokoll rediss: in URIs und unterstützt das Flag --tls für Nicht-URI-Verbindungen. Der Client ist in der Lage, eine Verbindung zu Redis-Instanzen herzustellen, die über TLS/SSL gesichert sind, ohne dass hierfür Tunnel erforderlich sind. Laden Sie es von der Seite für Releasesherunter und installieren Sie es.

Verbindung zu redli herstellen

Der Befehl ibmcloud cdb deployment-connections ist für alle Elemente geeignet, die beim Erstellen der Clientverbindung infrage kommen. Beispiel: Verwenden Sie zum Herstellen einer Verbindung zu einer Bereitstellung namens 'NewRedis' folgenden Befehl:

ibmcloud cdb deployment-connections NewRedis --start

oder

ibmcloud cdb cxn NewRedis -s

Der Befehl fordert zur Eingabe des Passworts admin auf und führt dann den redli Befehlszeilen-Client aus, um eine Verbindung zur Datenbank herzustellen.

Wenn Sie das Cloud Databases-Plug-in nicht installiert haben, können Sie mithilfe des Befehls redli eine Verbindung zu Ihren Redis-Datenbanken herstellen. Laden Sie das diensteigene Zertifikat aus Ihrer Bereitstellung herunter und speichern Sie es. Verwenden Sie dann redli, indem Sie ihm die Verbindungszeichenfolge "composed" und den Pfad zum diensteigenen Zertifikat angeben.

redli --uri rediss://admin:$PASSWORD@e6b2c3f8-54a6-439e-8d8a-aa6c4a78df49.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:32371/0 --certfile /path/to/redis-cert.pem

Es gibt noch andere Verbindungsoptionen und Parameter, die von redli unterstützt werden. Weitere Informationen finden Sie in der Dokumentation im redli GitHub repo.

Verwendung des diensteigenen Zertifikats

  1. Kopieren Sie die Zertifikatsinformationen aus dem Bereich Endpunkte oder aus dem Feld Base64 der Verbindungsinformationen der Dienstanmeldeinformationen.
  2. Decodieren Sie bei Bedarf die Base64-Zeichenfolge in Text.
  3. Speichern Sie das Zertifikat in einer Datei. (Sie können den vorgegebenen Namen übernehmen oder einen eigenen Dateinamen angeben. )
  4. Geben Sie gegenüber dem Treiber oder Client den Pfad zum Zertifikat an.

CLI-Plugin-Unterstützung für das diensteigene Zertifikat

Sie können das dekodierte Zertifikat für Ihren Einsatz mit dem CLI-Plugin mit einem Befehl wie diesem anzeigen:

ibmcloud cdb deployment-cacert <INSTANCE_NAME_OR_CRN>

Dieser Befehl dekodiert die Base64 in Text. Kopieren Sie die Ausgabe des Befehls in eine Datei, speichern Sie die Datei und geben Sie den Pfad zur Datei für den Client an.