diff --git a/README.md b/README.md index 8befa34..9297913 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,10 @@ Для зачёта необходимо выполнить набор относительно несложных действий, см. [Что обязательно сделать](#что-обязательно-сделать). +В файле [local_instruction.md](./local_instruction.md) можно найти инструкцию +как локально (на Вашем пк) поднять базу данных и админку [pgAdmin][pgadmin] +с помощью [docker]. + ## Что обязательно сделать 0. _Пока_ пытаться нарешивать задачки с [sql-ex.ru], все нарешанные @@ -92,3 +96,5 @@ _Пример:_ условный аэропорт, для которого мы [drawsql]: https://drawsql.app/ [postgre-cheat]: https://tableplus.com/blog/2018/06/postgresql-data-types.html [constraints]: https://www.postgresql.org/docs/current/ddl-constraints.html +[docker]: https://www.docker.com/ +[pgadmin]: https://www.pgadmin.org/ diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..ec52f71 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,24 @@ +version: '3.8' + +services: + postgres: + container_name: postgres_container + image: postgres + environment: + POSTGRES_USER: pgadmin + POSTGRES_PASSWORD: changeme + POSTGRES_DB: postgres + ports: + - "5432:5432" + restart: always + + pgadmin: + container_name: pgadmin4_container + image: dpage/pgadmin4 + environment: + PGADMIN_DEFAULT_EMAIL: "pgadmin@pgadmin.org" + PGADMIN_DEFAULT_PASSWORD: "pgadmin" + PGADMIN_LISTEN_ADDRESS: "0.0.0.0" + ports: + - "5050:80" + restart: always diff --git a/local_instruction.md b/local_instruction.md new file mode 100644 index 0000000..3eb53f7 --- /dev/null +++ b/local_instruction.md @@ -0,0 +1,29 @@ +# Как поднять PostgreSQL локально + +1. Установить [docker desktop]; +2. Как-то сохранить `docker-compose.yml`, т.е.: + - либо скачать файл [./docker-compose.yml]; + - либо склонировать репозиторий в терминале с git (`git clone +https://cs-shelter.xyz/ottergottaott/minor-sql-2022.git`); +3. Открыть терминал: + - PowerShell в Windows, _а лучше [Windows Subsystem for Linux][wsl]_; + - iTerm в macOS; +4. С помощью команд, приведённых ниже, перейдите в склонированный +репозиторий/место, куда сохранили `docker-compose.yml`: + - `cd` - перейти в директорию; + - `pwd` - вывести текущую директорию; + - `ls` - вывести содержимое текущей директории; +5. Выполните команду, написанную ниже, она запустит контейнер, +в котором будет база данных: +```sh +docker-compose up -d +``` +6. Теперь можно открыть в браузере [localhost:5050](http://localhost:5050). + - **логин/email**: `pgadmin@pgadmin.org` + - **пароль**: `pgadmin` + +7. + + +[docker desktop]: https://www.docker.com/products/docker-desktop/ +[wsl]: https://learn.microsoft.com/en-us/windows/wsl/install