Знакомство с проектированием многослойной архитектуры Web-API (веб-приложений, микро-сервисов). Сооздание микросервиса, реализующего CRUD на примере ранжирования пользователей в Kaggle.
simpleapi-это Spring приложение написаное на JAVA, с добавленной БД postgres в виде docker образа.
1.Загрузите проект из Github. Для клонирования репозитория необходимо выполнить команду:
git clone https://github.com/lsemenov/mylab1.git
2.Необходимо подготовить виртуальную среду для развёртывания БД . Установите Docker Toolbox,
3.Установите postgresql (локально или на удаленном сервере). Чтобы установить PostgreSQL образ, вы можете выполнить следующую команду в Docker Quickstart Terminal:
docker pull postgres
4.Подготовка базы данных для добавления к Spring-приложению. Чтобы запустить Postgres Docker-контейнер, необходимо выполнить следующие команды в Docker Quickstart Terminal:
docker run -e POSTGRES_PASSWORD=root -p 5432:5432
5.Добавляем базу данных (БД) в Spring приложение. Зайдите в репозиторий с проектом ...\src\main\resources. Заполните следующие поля в файле ...\src\main\resources..application.properties.
Настройки БД для Postgres:
spring.datasource.username=postgres spring.datasource.password=root spring.datasource.url=jdbc:postgresql:https://XXX.XXX.XX.XX:5432/postgres
где, XXX.XXX.XXX.XXX:5432 -IP адрес виртуальной машины Docker
Чтобы узнать IP виртуальной машины Docker, необходимо в Docker Terminal выполнить следующую команду:
docker-machine ip default
После настройки БД, необходимо пересобрать приложение, используя для этого maven.
6.Для сборки приложения из командной строки с помощью maven, необходимо выполнить следующую команду из корневой директории проекта:
mvn package -Dmaven.test.skip=true
Создастся JAR-файл в директории проекта .../target/XXX-1.0.jar. Необходимо в Dockerfile заменить строчки для пересобранного проекта:
COPY /target/simpleapi-1.0.jar XXX-1.0.JAR
ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom","-jar","/XXX-1.0.jar"]
где, XXX-1.0.jar -ваш пересобранный проект (simpleapi-1.0.jar)
7.Создаем образ Docker для того, чтобы запустить приложения в контейнере. Чтобы создать образ, необходимо выполнить следующую команду из директории проекта:
docker buil . -t <ImageName>
8.В терминале Docker запускаем контейнер с нашим приложением следующей командой:
docker run -p 8080:8080 <ImageName>
-p, означает что порт в локальной системе привязан к порту docker.
Где, XXX.XXX.XXX.XXX:8080 - IP и порт виртуальной машины docker на которой работает приложение.
- Получить список топ 10 пользователей Kaggle:
curl https://XXX.XXX.XXX.XXX:8080/api/v1/kaggle
В ответ будет получен JSON ответ с информацией о всех пользователях которые имеются в БД.
- Получить информацию о пользователе по id:
curl https://XXX.XXX.XXX.XXX:8080/api/v1/kaggle/{id}
В ответ будет получен JSON ответ с информацией о пользователе.
- Добавить запись о пользователе:
Формат: {rank: "string", department: "string ",room: integer, callnumber: integer}
curl -d "{"rank": 53, "tier": "Expert", "username": "icecuber", "points":52396}" https://XXX.XXX.XXX.XXX:8080/api/v1/kaggle -H "Content-Type:application/json"
- Удалить запись о пользователе:
Формат: {rank: "string", department: "string ",room: integer, callnumber: integer}
curl -i -X DELETE https://XXX.XXX.XXX.XXX:8080/api/v1/kaggle/del/{id}
- Получит значение hostname:
curl https://XXX.XXX.XXX.XXX:8080/api/v1/status
В ответ будет получен JSON в виде {hostname: "hostname"}.
Знакомство с CI/CD и его реализацией на примере Travis CI и Heroku.