Version 1.0.0
Language EN

Postgres Example

Example Yaml configuration for a project with a Postgres service dependency. The Postgres service will be available at database:5432.

kind: pipeline
name: default

steps:
- name: test
  image: postgres:9-alpine
  commands:
  - psql -U postgres -d test -h database

services:
- name: database
  image: postgres:9-alpine
  environment:
    POSTGRES_USER: postgres
    POSTGRES_DB: test

The official Postgres image provides environment variables used at startup to create the default username, password, database and more. Please see the official image documentation for more details.

services:
- name: database
  image: postgres
  environment:
    POSTGRES_USER: postgres
    POSTGRES_DB: test

Common Problems

Initialization

If you are unable to connect to the Postgres container please make sure you are giving Postgres adequate time to initialize and begin accepting connections.

kind: pipeline
name: default

steps:
- name: test
  image: postgres
  commands:
  - sleep 15
  - psql -U postgres -d test -h database

Incorrect Hostname

You cannot use 127.0.0.1 or localhost to connect with the Postgres container. If you are unable to connect to the Postgres container please verify you are using the correct hostname, corresponding with the name of the postgres service container.

Bad:

steps:
- name: test
  image: postgres
  commands:
  - sleep 15
  - psql -U postgres -d test -h localhost

Good:

steps:
- name: test
  image: postgres
  commands:
  - sleep 15
  - psql -U postgres -d test -h database

On This Page:

Getting Help

Mailing List
Search for information in the mailing list archives, or post a question.
Chat Support
Real-time chat support from maintainers and community members.