PostgreSQL 사용하기
많은 응용 프로그램이 데이터베이스로 PostgreSQL을 사용하기 때문에, 테스트가 실행되기 위해서는 결국 이를 필요로 합니다. 아래에서는 GitLab Runner의 Docker 및 Shell 실행기를 사용하여 어떻게 하는지 안내합니다.
Docker 실행기에서 PostgreSQL 사용하기
Postgres 15.4 이상에서, 확장 스크립트에 스키마나 소유자 이름을 작은따옴표, 역슬래시 또는 달러 기호가 있는 경우, Postgres는 대체하지 않습니다.
CI 변수가 구성되지 않은 경우, 값은 환경 변수 이름을 문자열로 사용합니다. 예를 들어 POSTGRES_USER: $USER와 같은 경우, POSTGRES_USER 변수가 ‘$USER’로 설정되어, Postgres가 다음 오류를 표시합니다.
Fatal: invalid character in extension
해결책은 GitLab CI/CD 변수에 변수를 설정하거나 변수를 문자열 형식으로 설정하는 것입니다:
-
GitLab에서 PostgreSQL 변수 설정. GitLab UI에서 설정된 변수는 서비스 컨테이너로 전달되지 않습니다.
-
.gitlab-ci.yml파일에서 Postgres 이미지를 지정합니다:default: services: - postgres -
.gitlab-ci.yml파일에 정의된 변수를 추가합니다:variables: POSTGRES_DB: $POSTGRES_DB POSTGRES_USER: $POSTGRES_USER POSTGRES_PASSWORD: $POSTGRES_PASSWORD POSTGRES_HOST_AUTH_METHOD: trustpostgres를Host로 사용하는 더 많은 정보는 작업에 서비스가 연결되는 방법을 참조하세요. -
애플리케이션을 데이터베이스 사용하도록 구성합니다. 예를 들어:
Host: postgres User: $POSTGRES_USER Password: $POSTGRES_PASSWORD Database: $POSTGRES_DB
또는, .gitlab-ci.yml 파일에서 변수를 문자열로 설정할 수 있습니다:
variables:
POSTGRES_DB: DB_name
POSTGRES_USER: username
POSTGRES_PASSWORD: password
POSTGRES_HOST_AUTH_METHOD: trust
Docker Hub에서 사용 가능한 다른 Docker 이미지를 사용할 수 있습니다.
예를 들어, PostgreSQL 14.3을 사용하려면, 서비스는 postgres:14.3가 됩니다.
postgres 이미지는 몇 가지 환경 변수를 수락할 수 있습니다. 자세한 내용은 Docker Hub의 문서를 참조하세요.
Shell 실행기에서 PostgreSQL 사용하기
Shell 실행기를 사용하는 매뉴얼으로 구성된 서버에서 또한 PostgreSQL을 사용할 수 있습니다.
먼저 PostgreSQL 서버를 설치합니다:
sudo apt-get install -y postgresql postgresql-client libpq-dev
다음 단계는 사용자를 생성하는 것인데, PostgreSQL에 로그인합니다:
sudo -u postgres psql -d template1
그런 다음 (우리의 경우 runner라고 하는) 사용자를 생성합니다. 아래 명령어에서 $password를 실제 강력한 암호로 변경하세요.
template1=#을 입력하지 않도록 주의하세요. PostgreSQL 프롬프트의 일부입니다.template1=# CREATE USER runner WITH PASSWORD '$password' CREATEDB;
생성된 사용자는 데이터베이스를 생성할 수 있는 권한 (CREATEDB)을 가지게 됩니다. 다음 단계에서는 해당 사용자를 위해 명시적으로 데이터베이스를 생성하는 방법을 설명하지만, 테스트 프레임워크에서 데이터베이스를 삭제하고 생성하는 도구가 있는 경우 이러한 권한이 유용할 수 있습니다.
사용자 runner를 위해 데이터베이스를 생성하고 그 사용자에게 모든 권한을 부여하세요:
template1=# CREATE DATABASE nice_marmot OWNER runner;
모든 것이 정상적으로 진행되었다면, 이제 데이터베이스 세션을 종료할 수 있습니다:
template1=# \q
이제 사용자 runner로 새로 생성된 데이터베이스에 연결해 모든 것이 제 위치에 있는지 확인해보세요.
psql -U runner -h localhost -d nice_marmot -W
이 명령은 명시적으로 psql이 로컬호스트에 연결하여 md5 인증을 사용하도록 지시합니다. 이 단계를 빠뜨리면 액세스가 거부됩니다.
마지막으로, 애플리케이션을 데이터베이스 사용하도록 구성합니다. 예를 들어:
Host: localhost
User: runner
Password: $password
Database: nice_marmot
예제 프로젝트
편리하게 사용할 수 있도록 예제 PostgreSQL 프로젝트를 설정해 두었습니다. 이 프로젝트는 GitLab.com에서 저희가 공개적으로 사용 가능한 인스턴스 러너를 사용합니다.
이 프로젝트에 참여하고 싶으신가요? 이를 Fork하여 변경 사항을 커밋하고 push하세요. 잠시 후에 변경 사항이 공개 러너에 의해 선택되고 작업이 시작됩니다.
도움말