Wie verbinde ich mich mit Docker-Compose mit CockroachDB?

Der PHP-Editor Strawberry zeigt Ihnen, wie Sie mit Docker-Compose eine Verbindung zu CockroachDB herstellen. Docker-Compose ist ein Tool zum Definieren und Ausführen mehrerer Docker-Container, und CockroachDB ist ein verteiltes relationales Datenbankverwaltungssystem. Durch die Verwendung von Docker-Compose können wir CockroachDB-Container einfach erstellen, verwalten und mit anderen Containern verbinden. In diesem Artikel erklären wir detailliert, wie Sie Ihre Docker-Compose-Datei für die Verbindung mit CockroachDB konfigurieren und geben einige praktische Tipps und Überlegungen. Unabhängig davon, ob Sie Anfänger oder erfahrener Entwickler sind, bietet Ihnen dieser Artikel nützliche Anleitungen, die Ihnen den schnellen Einstieg in die Verwendung von Docker-Compose zum Herstellen einer Verbindung mit CockroachDB erleichtern.

Frageninhalt

Ich habe eine Docker-Compose-Datei, in der ich die Datenbank bereitstelle und die Anwendung lokal starte

services:
      node_1:
          container_name: node_1
          image: cockroachdb/cockroach:latest
          command: start --insecure
          ports:
              - "26258:26258"
              - "8081:8081"
          networks:
            - network_cockroachdb 
      node_2:
          container_name: node_2
          image: cockroachdb/cockroach:latest
          hostname: node_2
          ports:
            - "26257:26257"
            - "8080:8080"
          command: start --insecure --join=node_1
          networks:
            - network_cockroachdb 
          network_mode: 'host'
      app:
          build: .
          ports:
            - "12121:12121"
          environment:
            app_port: '12121'
            db_host: "node_2"
            db_port: 26257
            db_user: root
            db_password: 123
            db_database: mydb
          depends_on:
            - node_2
          links:
            - node_2
          networks:
            - network_cockroachdb 
    networks:
        network_cockroachdb:
            driver: bridge

Zur Datei gehen:

func main() {  
    port, _ := strconv.Atoi(os.Getenv("db_port"))

    dbConfig := storage.ConnectionConfig{
        Host:     os.Getenv("db_host"),
        Port:     port,
        User:     os.Getenv("db_user"),
        Password: os.Getenv("db_password"),
        DBName:   os.Getenv("db_database"),
        SSLMode:  "verify-full",
    }

    log.Println("url: ", dbConfig.String())

    db, err := storage.NewCockroachDB(context.Background(), dbConfig)

    if err != nil {
        log.Fatal(err)
    }
}

Eine Verbindung zur Datenbank wird hergestellt. Doch die Verbindung schlug fehl und der falsche Port wurde weitergeleitet: Statt 26257 war es 26258. Wie kann dieses Problem gelöst werden?

Lösung

1. Nicht verwenden links; diese Funktion ist seit vielen Jahren veraltet und wird nur aus Gründen der Abwärtskompatibilität beibehalten. Docker verwaltet DNS für Container, sodass Sie beim Herstellen einer Verbindung nur den Dienstnamen als Hostnamen verwenden müssen.

2. Sie können mit network_mode 结合使用：host keine Portweiterleitung durchführen.

3. Ihre Verwendung von depends_on ist praktisch ein No-Op; Ihre Anwendung wird höchstwahrscheinlich versuchen, eine Verbindung zur Datenbank herzustellen, bevor die Datenbank für die Verarbeitung der Verbindung bereit ist.

   Tatsächlich akzeptiert Ihr Datenbankcluster keine Verbindungen, bis Sie ihn ausführen cockroach init, sodass Sie definitiv auf dieses Problem stoßen.

4. Ihre Compose-Datei kann nicht gestartet werden node_1 mit der folgenden Fehlermeldung:

   * ERROR: ERROR: no --join flags provided to 'cockroach start'
   * HINT: Consider using 'cockroach init' or 'cockroach start-single-node' instead
   *
   ERROR: no --join flags provided to 'cockroach start'
   HINT: Consider using 'cockroach init' or 'cockroach start-single-node' instead
   Failed running "start"

5. Ihre node_1 Portweiterleitung ist falsch; nichts im Container lauscht auf Port 8081. Vielleicht möchten Sie so etwas wie:

   ports:
     - 8081:8080

Schließlich haben Sie nicht angegeben, woher das storage-Modul in Ihrem Beispielcode stammt, daher kann ich es nicht zum Testen verwenden. Ich habe dieses Testprogramm geschrieben, das eine Schleife enthält, die darauf wartet, dass die Datenbank die Verbindung akzeptiert:

package main

import (
    "context"
    "fmt"
    "log"
    "os"
    "time"

    pgx "github.com/jackc/pgx/v4"
)

func main() {
    connectionString := os.Getenv("db_uri")

    if connectionString == "" {
        connectionString = fmt.Sprintf("postgresql://%s@%s:%s/%s?sslmode=disable",
            os.Getenv("db_user"),
            os.Getenv("db_host"),
            os.Getenv("db_port"),
            os.Getenv("db_database"),
        )
    }

    var conn *pgx.Conn
    var err error

    for {
        conn, err = pgx.Connect(context.Background(), connectionString)
        if err == nil {
            break
        }

        log.Printf("connection failed (%v); will retry...", err)
        time.Sleep(1 * time.Second)
    }
    log.Printf("connected to database")

    var value int
    if err := conn.QueryRow(context.Background(), "select 1").Scan(&value); err != nil {
        panic(err)
    }

    fmt.Printf("All done.\n")
}

<小时/>

Wenn wir alle oben genannten Probleme lösen und die Compose-Datei bereinigen, erhalten wir am Ende:

services:
  node_1:
    image: cockroachdb/cockroach:latest
    ports:
      - "8080:8080"
    command:
      - start
      - --insecure
      - --join=node_1,node_2

  node_2:
    image: cockroachdb/cockroach:latest
    ports:
      - "8081:8080"
    command:
      - start
      - --insecure
      - --join=node_1,node_2

  app:
    build: .
    environment:
      db_host: "node_2"
      db_port: 26257
      db_user: root
      db_password: 123
      db_database: mydb

Bitte beachten Sie, dass diese Konfiguration den Datenbank-Port absichtlich nicht auf dem Host veröffentlicht, da dieser nicht erforderlich ist, damit Anwendungen auf die Datenbank zugreifen können.

Wenn wir diese Konfiguration docker 编写 , sehen wir Folgendes vom Datenbankdienst:

* INFO: initial startup completed.
* Node will now attempt to join a running cluster, or wait for `cockroach init`.
* Client connections will be accepted after this completes successfully.
* Check the log file(s) for progress.

Und Folgendes in der Musterbewerbung (wir erwarten):

2023/09/01 12:53:20 connection failed (failed to connect to `host=node_2 user=root database=mydb`: dial error (dial tcp 10.89.1.46:26257: connect: connection refused)); will retry...

Wir müssen die Datenbank initialisieren:

docker compose exec node_1 ./cockroach init --insecure --host=node_1

Danach sehen wir Folgendes vom Datenbankdienst:

CockroachDB node starting at 2023-09-01 12:54:38.494304014 +0000 UTC m=+77.639236046 (took 77.4s)
[...]

Beispielanwendung kann Abfragen verbinden und ausführen:

2023/09/01 12:54:38 connected to database
All done.

Die Web-Benutzeroberfläche für diese Knoten wird auf dem Host-Port verfügbar gemacht 8080 和 8081.

Abschließend möchten Sie möglicherweise Volumes erstellen, um Ihre Datenbankdaten zu speichern. Siehe z. B. dieses DokumentMontagevolumina.

Das obige ist der detaillierte Inhalt vonWie verbinde ich mich mit Docker-Compose mit CockroachDB?. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!