Devcafe: 새 문서: = Docker로 Postgresql 설치 및 환경설정 = == 개요 == {{틀:고지상자 |제목=Docker로 Postgresql 설치/삭제 및 데이터 외부저장 볼륨 생성 |내용=# Postgresql 설치 ## 설치후 Postgresql 유저/db/테이블 생성 # Docker로 컨테이너 삭제 ## 생성된 유저/db/테이블 도 같이 삭제됨을 확인 # 다시 컨테이너를 생성 ## 이전 설치된 유저/db/테이블이 있는지 확인 # 데이터 외부저장 볼륨 생성 ## 데...

2024-10-14T16:21:38Z

새 문서: = Docker로 Postgresql 설치 및 환경설정 = == 개요 == {{틀:고지상자 |제목=Docker로 Postgresql 설치/삭제 및 데이터 외부저장 볼륨 생성 |내용=# Postgresql 설치 ## 설치후 Postgresql 유저/db/테이블 생성 # Docker로 컨테이너 삭제 ## 생성된 유저/db/테이블 도 같이 삭제됨을 확인 # 다시 컨테이너를 생성 ## 이전 설치된 유저/db/테이블이 있는지 확인 # 데이터 외부저장 볼륨 생성 ## 데...

새 문서

= Docker로 Postgresql 설치 및 환경설정 =

== 개요 ==
{{틀:고지상자
|제목=Docker로 Postgresql 설치/삭제 및 데이터 외부저장 볼륨 생성
|내용=# Postgresql 설치
## 설치후 Postgresql 유저/db/테이블 생성
# Docker로 컨테이너 삭제
## 생성된 유저/db/테이블 도 같이 삭제됨을 확인
# 다시 컨테이너를 생성
## 이전 설치된 유저/db/테이블이 있는지 확인
# 데이터 외부저장 볼륨 생성
## 데이터를 저장할 볼륨을 별도로 생성하여 컨테이너가 삭제 되어도 이전 설치된 유저/db/테이블 정보 저장하는 방법
}}
{{틀:고지상자
|제목=도커 컨테이너를 삭제해도 데이터를 영구적으로 저장하는 방법
|내용=# docker는 프로세스 형태로 자원을 격리하여 사용하기 때문에 컨테이너가 삭제되면 기존에 저장되었던 데이터는 사라지는 문제점.
# docker volume을 사용하거나 로컬 컴퓨터 파일에 마운트하여 docker 내부에 생성되는 데이터를 docker 외부에 저장하여 영구적으로 데이터를 저장하는 방법
* 하단 상세 설명 참조 ([[#볼륨과 마운트로 데이터 저장하는 방법]])
}}

== Docker로 Postgresql 다운로드 및 실행 ==

=== Docker 이미지 다운 로드 ===
<source lang=shell>
# Docker 이미지 다운로드
$docker pull postgres
</source>
<source lang=shell>
# Docker 이미지 확인
$docker images
</source>

=== postgresql Docker 실행 ===
<source lang=shell>
$ docker run -p 5432:5432 --name postgres -e POSTGRES_PASSWORD=cafe1234 -d postgres
</source>

{{틀:고지상자
|제목= 파라미터 설명
|내용=* docker run : docker image에서 container 생성
* -p 5432:5432 : 해당 container의 port forwarding에 대해 inbound/outbound port 모두 5432으로 설정한다.
* -name postgres : container의 이름은 postgres로 한다.
* -e : container 내부의 환경변수 설정
* POSTGRES_PASSWORD="암호"" : ROOT 암호를 설정 따옴표 내의 내용은 암호이다.
* -d postgres : postgres이라는 이미지에서 분리하여 container를 생성한다.
}}

=== Docker 프로세스 확인 ===
<source lang=shell>
$ docker ps -a

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
2093fec3b2ac postgres "docker-entrypoint.s…" 2 minutes ago Up 2 minutes 0.0.0.0:5432->5432/tcp postgres
</source>

== Docker 컨테이너 내부 접속 및 사용자 , 데이터베이스 생성, 테이블 생성 ==

=== Docker 컨네이너(postgresql 이미지 내부) 쉘로 내부 접속 ===
* Docker 내부 쉘실행
<source lang=shell>
$ docker exec -it postgres /bin/bash
</source>

=== 컨테이너 내부 접속 ===

* postgresql 접속
<source lang=shell>
root@ac61c662ee4c:/# psql -U postgres

psql (13.0 (Debian 13.0-1.pgdg100+1))
Type "help" for help.
</source>

=== 사용자 생성 (dbcafe) ===
<source lang=sql>
postgres=# CREATE USER dbcafe PASSWORD 'cafe1234' SUPERUSER;
....
CREATE ROLE
</source>

=== DB 생성(test_db) ===
<source lang=sql>
postgres=# CREATE DATABASE test_db OWNER dbcafe;
....
CREATE DATABASE
</source>

=== 디비(test_db) 접속 ===
<source lang=sql>
postgres=# \c test_db dbcafe

You are now connected to database "test_db" as user "dbcafe".
</source>

=== 테이블 생성 ===
<source lang=sql>
test_db=# CREATE TABLE tb_emp (
emp_no integer NOT NULL,
emp_name character varying(255),
age integer,
dept_no integer,
CONSTRAINT pk_emp PRIMARY KEY (emp_no)
);

CREATE TABLE
</source>

=== 테이블 정보 조회 ===
<source lang=sql>
test_db=# \dt
List of relations
Schema | Name | Type | Owner
--------+------+-------+----------
public | tb_emp | table | dbcafe
(1 row)
</source>
<source lang=shell>
# postgresql 접속 종료
postgres=# \q

</source>

* 기본적인 데이터베이스 생성과정 완료
* 아래는 컨테이너를 종료하고 다시 시작했을 때, 생성된 정보가 있는지 확인

----

== 컨테이너 재접속 후 생성된 정보 확인 ==

=== 기존 docker 종료 후 재접속 ===
<source lang=shell>
$ docker exec -it postgres /bin/bash
</source>

* postgresql 접속
<source lang=shell>
root@ac61c662ee4c:/# psql -U postgres
psql (13.0 (Debian 13.0-1.pgdg100+1))
Type "help" for help.
</source>

* 사용자 정보 조회
<source lang=shell>
postgres=# \du
List of roles
Role name | Attributes | Member of
-----------+------------------------------------------------------------+-----------
postgres | Superuser, Create role, Create DB, Replication, Bypass RLS | {}
dbcafe | Superuser | {}
</source>

* dbcafe 유저로 test_db 디비접속
<source lang=shell>
postgres=# \c test_db dbcafe
You are now connected to database "test_db" as user "dbcafe".
</source>

* 테이블 정보 조회
<source lang=shell>
test_db=# \dt
List of relations
Schema | Name | Type | Owner
--------+------+-------+----------
public | tb_emp | table | dbcafe
(1 row)
</source>

* 컨테이너만 종료되고 다시 시작했을 때는 기존에 저장되어 있던 데이터가 잘 살아 있는 것을 확인할 수 있다.

----

== Docker 컨테이너 삭제 ==
* postgres 도커 중지
<source lang=shell>
$ docker stop postgres
postgres
</source>

* postgres 도커 삭제
<source lang=shell>
$ docker rm postgres
postgres
</source>

* postgres 컨테이너 없음
<source lang=shell>
$ docker exec -it postgres /bin/bash
Error: No such container: postgres
</source>

* 컨테이너가 삭제되었기 때문에 다시 접속할 수가 없음.

* 다시 컨테이너를 생성 하려면 docker run 실행
<source lang=shell>
$ docker run -p 5432:5432 --name postgres -e POSTGRES_PASSWORD=cafe1234 -d postgres
</source>
<source lang=shell>
$ docker exec -it postgres /bin/bash
root@fd7f90041ffa:/# psql -U postgres
psql (13.0 (Debian 13.0-1.pgdg100+1))
Type "help" for help.
</source>
<source lang=sql>
postgres=# SELECT * FROM PG_USER;
usename | usesysid | usecreatedb | usesuper | userepl | usebypassrls | passwd | valuntil | useconfig
----------+----------+-------------+----------+---------+--------------+----------+----------+-----------
postgres | 10 | t | t | t | t | ******** | |
(1 row)
</source>
<source lang=shell>
postgres=# \q
</source>

* 생성했던 계정 존재하지 않음.
* 컨테이너 자체를 삭제하는 경우 해당 베이스 이미지만 그대로 사용하기 때문에 더이상 데이터가 남아 있지 않음.
* 데이터를 종속시키기 위해서는 컨테이너 볼륨이나 로컬 컴퓨터에 데이터를 저장할 수 있는 공간을 따로 생성하여 외부에 저장할 수 있는 상태로 만들어야 함

----

== 볼륨과 마운트로 데이터 저장하는 방법 ==
* 데이터를 영구적으로 보관하는 방법

=== 모든 컨테이너를 종료하고 삭제 ===
<source lang=shell>
$ docker stop $(docker ps -a -q)
</source>
<source lang=shell>
$ docker rm $(docker ps -a -q)
</source>

* 데이터를 저장할 볼륨 생성
<source lang=shell>
$ docker volume create pgdata
pgdata
</source>
* -v 옵션으로 생성된 볼륨 지정

<source lang=shell>
$ docker run -p 5432:5432 --name postgres -e POSTGRES_PASSWORD=cafe1234 -d -v pgdata:/var/lib/postgresql/data postgres
</source>
* 다시 컨테이너에 접속하여 계정을 생성해 보고, 컨테이너 삭제후에 계정 정보가 남아 있는지 확인

<source lang=shell>
docker exec -it postgres /bin/bash
</source>
<source lang=shell>
root@608f0aa10061:/# psql -U postgres
psql (13.0 (Debian 13.0-1.pgdg100+1))
Type "help" for help.
</source>
<source lang=sql>
postgres=# CREATE USER dbcafe PASSWORD 'cafe1234' SUPERUSER;
</source>
<source lang=sql>
postgres=# \du
List of roles
Role name | Attributes | Member of
-----------+------------------------------------------------------------+-----------
postgres | Superuser, Create role, Create DB, Replication, Bypass RLS | {}
dbcafe | Superuser | {}
</source>
<source lang=shell>
$ docker stop postgres
</source>
<source lang=shell>
$ docker rm postgres
</source>
<source lang=shell>
$ docker run -p 5432:5432 --name postgres -e POSTGRES_PASSWORD=cafe1234 -d -v pgdata:/var/lib/postgresql/data postgres
791984a503b91542aaadd48703c6b694e745b3004c3a7c2f00d0eedf91cf27ea
</source>
<source lang=shell>
$ docker exec -it postgres /bin/bash
</source>
<source lang=shell>
root@791984a503b9:/# psql -U postgres
psql (13.0 (Debian 13.0-1.pgdg100+1))
Type "help" for help.
</source>
<source lang=shell>
postgres=# \du
List of roles
Role name | Attributes | Member of
-----------+------------------------------------------------------------+-----------
postgres | Superuser, Create role, Create DB, Replication, Bypass RLS | {}
dbcafe | Superuser | {}

postgres=# \q
</source>

* 컨테이너를 삭제했음에도 불구하고 계정정보가 저장 되어 있는것을 확인
* 그렇다면 볼륨 정보는 어디에 저장되어 있을까?

=== 저장된 볼륨정보 조회 ===
* Docker 볼륨 조회
<source lang=shell>
$ docker volume list
local pgdata
</source>

<source lang=shell>
$ docker volume inspect pgdata
[
{
"CreatedAt": "2020-10-09T07:13:50Z",
"Driver": "local",
"Labels": {},
"Mountpoint": "/var/lib/docker/volumes/pgdata/_data",
"Name": "pgdata",
"Options": {},
"Scope": "local"
}
]
</source>
* 각 운영체제별로 상의할 수 있음
* 위 명령으로 볼륨 리스트와 해당 볼륨의 위치 및 상세 정보 확인

=== 해당 볼륨 삭제 후 로컬 컴퓨터에 디렉토리에 데이터 저장하는 방법 ===
<source lang=shell>
$ docker volume remove pgdata
Error response from daemon: remove pgdata: volume is in use - [791984a503b91542aaadd48703c6b694e745b3004c3a7c2f00d0eedf91cf27ea]
</source>

* docker 컨테이너가 실행되고 있는 상태에서 볼륨을 삭제하는 경우에는 에러가 발생하기 때문에 컨테이너를 종료하고 볼륨을 삭제한다.
<source lang=shell>
$ docker stop postgres
postgres
</source>
<source lang=shell>
$ docker rm postgres
postgres
</source>

<source lang=shell>
$ docker volume remove pgdata
pgdata
</source>

* docker에서 모든 볼륨을 삭제하고 싶다면 "docker volume prune" 명령을 입력한다.
<source lang=shell>
$ docker volume prune
WARNING! This will remove all local volumes not used by at least one container.
Are you sure you want to continue? [y/N] y
Total reclaimed space: 7.402GB
</source>
<source lang=shell>
$ mkdir pgdata
</source>
<source lang=shell>
$ docker run -p 5432:5432 --name postgres -e POSTGRES_PASSWORD=cafe1234 -d -v ~/pgdata:/var/lib/postgresql/data postgres
06006c5d1160b471eaeb73b429e6a08329f9087a7f32b86aab811fe7e4246a65
</source>
# 상대경로에 pgdata라는 디렉토리 생성
# -v 옵션으로 해당 디렉토리를 마운트
# 해당 디렉터리로 이동하여 postgresql 데이터가 저장되어 있는지 확인.

<source lang=shell>
$ cd pgdata
$ ls -l
total 112
-rw------- 1 dbcafe staff 3 10 9 16:35 PG_VERSION
drwx------ 5 dbcafe staff 160 10 9 16:35 base
drwx------ 59 dbcafe staff 1888 10 9 16:35 global
drwx------ 2 dbcafe staff 64 10 9 16:35 pg_commit_ts
drwx------ 2 dbcafe staff 64 10 9 16:35 pg_dynshmem
-rw------- 1 dbcafe staff 4782 10 9 16:35 pg_hba.conf
-rw------- 1 dbcafe staff 1636 10 9 16:35 pg_ident.conf
drwx------ 5 dbcafe staff 160 10 9 16:35 pg_logical
drwx------ 4 dbcafe staff 128 10 9 16:35 pg_multixac
...
</source>

* 실제 로컬 컴퓨터에 postgresql를 사용하기 위한 데이터가 저장되어 있는 것을 확인할 수 있다.
* 이 상태에서 위와 동일한 방법으로 진행하면 컨테이너 내부에서 변경된 모든 데이터는 해당 디렉토리가 삭제되지 않는 이상 사라지지 않으며, 설정파일을 직접 수정하여 적용할 수도 있다.
* CIFS나 NFS를 통한 외부 스토리지에 저장하여 데이터를 저장하는 방식도 가능하다.
* 리눅스의 경우 해당 디렉토리에 권한문제(퍼미션)로 인해 접속이 되지 않을 수도 있다. 이 경우 root 권한으로 접속해서 볼 수 있으며, 만약 디렉토리를 만들었음에도 불구하고 데이터가 저장되지 않거나 컨테이너가 재대로 실행되지 않은 경우, 소유자 권한 오류로 인해서 docker 컨테이너가 해당 디렉토리에 접근하지 못할 가능성이 크다. 따라서 이런 에러가 발생하는 경우에는 소유자 권한을 변경하면 정상적으로 사용할 수 있다.
<source lang=shell>
$ sudo chown -R 200:200 some_dir
</source>
* 컨테이너를 실행할 때, 디렉토리를 마운트 하는 경우에 절대경로를 사용하는 것을 추천한다.

Docker Postgresql 설치 환경설정 - 편집 역사