Comment se connecter à CockroachDB en utilisant docker-compose ?

l'éditeur php Strawberry vous présentera comment utiliser docker-compose pour vous connecter à CockroachDB. Docker-compose est un outil permettant de définir et d'exécuter plusieurs conteneurs Docker, et CockroachDB est un système de gestion de bases de données relationnelles distribuées. En utilisant docker-compose, nous pouvons facilement créer et gérer des conteneurs CockroachDB et les connecter à d'autres conteneurs. Dans cet article, nous détaillerons comment configurer votre fichier docker-compose pour vous connecter à CockroachDB et fournirons quelques conseils et considérations pratiques. Que vous soyez débutant ou développeur expérimenté, cet article vous fournira des conseils utiles pour vous aider à démarrer rapidement en utilisant docker-compose pour vous connecter à CockroachDB.

Contenu de la question

J'ai un fichier docker-compose dans lequel je déploie la base de données et accède à l'application localement

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

Aller au dossier :

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)
    }
}

Une connexion à la base de données est établie. Mais la connexion a échoué et le mauvais port a été transféré : au lieu de 26257, c'était 26258. Comment résoudre ce problème?

Solution

1. N’utilisez pas links ; cette fonctionnalité est obsolète depuis de nombreuses années et n’est conservée que pour des raisons de compatibilité ascendante. Docker gère le DNS pour les conteneurs, vous n'avez donc besoin d'utiliser que le nom du service comme nom d'hôte lors de l'établissement d'une connexion.

2. Vous ne pouvez pas transférer de ports avec network_mode 结合使用：host.

3. Votre utilisation de depends_on est en fait inutile ; votre application tentera probablement de se connecter à la base de données avant que celle-ci ne soit prête à gérer la connexion.

   En fait, votre cluster de base de données n'acceptera pas les connexions tant que vous n'aurez pas exécuté cockroach init, vous certainement rencontrez ce problème.

4. Votre fichier de composition ne parviendra pas à se lancer node_1 avec l'erreur suivante :

   * 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. Votre redirection de port node_1 est incorrecte ; rien dans le conteneur n'écoute sur le port 8081. Vous voudrez peut-être quelque chose comme :

   ports:
     - 8081:8080

Enfin, vous n'avez pas indiqué d'où vient le module storage dans votre exemple de code, je ne peux donc pas l'utiliser pour des tests. J'ai écrit ce programme de test qui comprend une boucle attendant que la base de données accepte la connexion :

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")
}

Si nous résolvons tous les problèmes ci-dessus et nettoyons le fichier de composition, nous obtiendrons :

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

Veuillez noter que cette configuration ne publie pas intentionnellement le port de la base de données sur l'hôte, car cela n'est pas requis pour que les applications accèdent à la base de données.

Lorsque nous docker 编写 cette configuration, nous verrons ce qui suit à partir du service de base de données :

* 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.

Et ce qui suit dans l'exemple d'application (nous nous attendons) :

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...

Nous devons initialiser la base de données :

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

Ensuite, nous voyons ce qui suit à partir du service de base de données :

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

Exemple d'application est capable de se connecter et d'exécuter des requêtes :

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

L'interface utilisateur Web de ces nœuds sera exposée sur le port hôte 8080 和 8081.

Enfin, vous souhaiterez peut-être créer des volumes pour contenir les données de votre base de données. Voir par exemple ce documentmontage des volumes.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!