PostgreSQL 사용
많은 애플리케이션이 데이터베이스로 PostgreSQL을 사용하므로 테스트를 실행하기 위해 결국 필요할 수 있습니다. 아래에서는 GitLab Runner의 Docker 및 Shell 실행기를 사용하여 이를 수행하는 방법을 안내합니다.
Docker 실행기로 PostgreSQL 사용
참고:
GitLab UI에서 설정된 변수를 서비스 컨테이너에 전달하려면 변수를 정의해야 합니다. 변수를 그룹 또는 프로젝트로 정의한 다음 다음 해결책에 표시된대로 작업에서 해당 변수를 호출해야 합니다.
Postgres 15.4 이상에서는 이름에 따옴표, 백슬래시 또는 달러 기호가 포함된 경우 확장 스크립트에서 스키마 또는 소유자 이름을 대체하지 않습니다.
CI 변수가 구성되지 않으면 값을 현재 환경 변수 이름으로 문자열로 사용합니다. 예를 들어 POSTGRES_USER: $USER는 POSTGRES_USER 변수를 ‘$USER’로 설정하여 Postgres에서 다음 오류를 표시합니다:
Fatal: invalid character in extension
해결책은 GitLab CI/CD 변수에서 변수를 설정하거나 문자열 형식으로 변수를 설정하는 것입니다:
-
GitLab에서 Postgres 변수 설정. 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: trustHost에 대해postgres를 사용하는 방법에 대한 자세한 내용은 작업에 서비스가 연결되는 방법을 참조하십시오. -
데이터베이스를 사용하도록 애플리케이션을 구성합니다. 예:
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 실행기를 사용하는 GitLab Runner를 수동으로 구성한 서버에서도 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이 localhost에 연결하여 md5 인증을 사용하도록 지시합니다. 이 단계를 생략하면 액세스가 거부됩니다.
마지막으로 애플리케이션을 데이터베이스를 사용하도록 구성합니다. 예를 들어:
Host: localhost
User: runner
Password: $password
Database: nice_marmot
예제 프로젝트
예제 PostgreSQL 프로젝트를 만들어 두었습니다. GitLab.com에서 공개 실행기를 사용하여 실행됩니다.
여기에서 작업을 해보고 싶으신가요? 포크하고, 커밋하고, 변경 사항을 푸시하세요. 잠시 후에 공개 실행기가 변경 사항을 수용하고 작업이 시작됩니다.
도움말