volker.raschek/db-wait
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Wait until database connection can be successfully established
92 Commits 1 Branch 1 Tag 869 KiB
Go 51.7%
Makefile 34.3%
Dockerfile 14%
9ed2b834f1
Go to file
Markus Pesch 9ed2b834f1
All checks were successful
continuous-integration/drone/push Build is passing
Details
feat(ci): use git.cryptic.systems/volker.raschek/git v1.2.1
2023-06-17 16:22:05 +02:00
cmd fix: update go sums 2022-08-08 18:50:51 +02:00
pkg/dbwait fix(oracle): select 1 from dual 2022-09-13 17:31:24 +02:00
.dockerignore Initial Commit 2021-09-15 22:18:06 +02:00
.drone.yml feat(ci): use git.cryptic.systems/volker.raschek/git v1.2.1 2023-06-17 16:22:05 +02:00
.editorconfig Initial Commit 2021-09-15 22:18:06 +02:00
.gitattributes Initial Commit 2021-09-15 22:18:06 +02:00
.gitignore Initial Commit 2021-09-15 22:18:06 +02:00
.golangci.yml Initial Commit 2021-09-15 22:18:06 +02:00
.markdownlint.yaml Initial Commit 2021-09-15 22:18:06 +02:00
Dockerfile chore(deps): update dependency docker.io/library/alpine to v3.18 2023-05-18 16:23:09 +02:00
go.mod chore(deps): update module github.com/lib/pq to v1.10.9 2023-05-18 14:04:56 +02:00
go.sum chore(deps): update module github.com/lib/pq to v1.10.9 2023-05-18 14:04:56 +02:00
LICENSE Initial Commit 2021-09-15 22:18:06 +02:00
main.go fix: update go sums 2022-08-08 18:50:51 +02:00
Makefile Initial Commit 2021-09-15 22:18:06 +02:00
manifest.tmpl fix(ci): adapt .drone.yml to latest version 2021-10-24 13:16:15 +02:00
README.md Initial Commit 2021-09-15 22:18:06 +02:00
renovate.json fix(renovate): enable automerge for droneci manager 2022-02-09 22:48:19 +01:00

README.md

db-wait

Build Status Docker Pulls

With db-wait is it possible to wait in CI/CD environments until a database connection can be established and SQL queries are possible.

This is very useful for example when a database is started for an integration test and it needs time to start and initialize all schemes before the test connects to it.

Usage

As argument db-wait expects a database URI. This can be different depending on the backend. Currently only oracle and postgres are supported. The supported URI patterns can be found in the respective library or directly in the documentation of the database backend.

For example:

# postgres
db-wait postgres://user:password@localhost:5432/postgres?sslmode=disable

# oracle
db-wait oracle://user:password@localhost:1521/xe

More about URI Pattern is documented here for oracle and postgres.

Installation

There are two ways to install db-wait. Directly via go or via make in combination with git and go. The advantage of the second option is that the binary is installed with all the additional files that the developer specifies.

# go
$ go install git.cryptic.systems/volker.raschek/db-wait

# git, make, go
$ git clone https://git.cryptic.systems/volker.raschek/db-wait.git && \
  cd db-wait && \
  make install PREFIX=/usr

Usage as container image

Alternatively can be db-wait used as container image. A local installation is not necessary.

# postgres
$ docker run --rm --network host docker.io/volkerraschek/db-wait:latest \
    postgres://user:password@localhost:5432/postgres?sslmode=disable

# oracle
$ docker run --rm --network host docker.io/volkerraschek/db-wait:latest \
    oracle://user:password@localhost:1521/xe