lora application server
version tuned with small adjustements and updated documentation
There are two options how to run application. Develop and deploy mode.
Both modes are using same docker volume (same database is loaded).
.env.example to .envclient/.env.development.example to client/.env.development , если вы хотите запустить приложение в режиме разработкиclient/.env.production.example to client/.env.production если вы хотите запустить приложение в производственном режиме${REACT_APP_GOOGLE_API} Следуйте этим шагам This will just run db and pgadmin containers. React and server instances are running separately, outside of containers.
${DB_HOST} от .env на: localhostdocker-compose -f docker-compose.dev.yml up -dnpm i && npm run server${REACT_APP_BASE_URL} переменную в файле client/.env.development соответственно с ${SERVER_PORT} указанный в .env filecd client && npm i && cd .. && npm run clientlocalhost:3000 This will run db, pgadmin, server and build react with disabled redux devtools.
${DB_HOST} с .env на postgres .docker-compose up -d .localhost:${SERVER_PORT} .Для правильного функционирования приложения база данных должна быть заполнена сначала. Мы будем использовать командную строку для этого.
Из корневого каталога перейдите в каталог, где расположены экспортируемые данные.
cd dummy Затем скопируйте данные в запуск контейнера Postgres (для режима разработки используйте dev_postgres_container ).
docker cp dbexport.sql postgres_container:/
Затем введите контейнер (для режима разработки используйте dev_postgres_container ).
docker exec -it postgres_container /bin/bash
Если вы хотите импортировать данные в уже заполненную базу данных, вам нужно сначала удалить существующую таблицу, а затем создать новую. В консоли -консоли выпадает существующая база данных. (Пропустите этот шаг, если вы еще не создали базу данных)
dropdb -U ${DB_USER} ${DB_NAME}Войдите в Postgres Server как пользователь.
su - ${DB_USER}Затем создайте новую базу данных.
createdb ${DB_NAME}Выйдите из консоли сервера Postgres.
exitЗаполнение базы данных с новыми данными.
psql -d ${DB_NAME} -U ${DB_USER} -f dbexport.sql Теперь вы можете войти в приложение. Оба, name по умолчанию и password : admin .
localhost:${DB_PORT}${DB_USER}${DB_PASSWORD}http://localhost:${PGADMIN_PORT}${PGADMIN_EMAIL}${PGADMIN_PASSWORD}postgres${DB_PORT}${DB_NAME}${DB_PASSWORD} Файл Docker расположен на корневом уровне проекта и используется только для режима развертывания.
# Dockerfile
FROM node:latest
WORKDIR /server
COPY . ./
RUN npm install
RUN npm install --prefix client
CMD npm run build Сначала, последний узел загружается, а рабочая каталог /server создается в недавно созданном контейнере. В этот рабочий каталог весь исходный код копируется, ожидайте файлов, указанных в client/.dockerignore . Эти файлы опущены. Затем зависимости узлов устанавливаются в рабочий каталог как для сервера, так и для клиентов. Наконец, команда npm run build называется, которая находится в package.json . Эта команда сначала создает приложение React, а затем запускает сервер. Когда сервер запускается таким образом, переменная среды NODE_ENV устанавливается для production и используется встроенная версия приложения React.
Мы используем два файла докера. docker-compose.dev.yml для разработки mode и docker-compose.yml для производственного режима, оба расположенных в корневом каталоге. Каждый составной файлы загружает переменные среды, указанные в .env -файле.
# docker-compose.dev.yml
version : " 3.5 "
# inspired by https://github.com/khezen/compose-postgres
services :
postgres :
container_name : postgres_container
image : postgres:11
environment :
POSTGRES_USER : ${DB_USER}
POSTGRES_PASSWORD : ${DB_PASSWORD}
PGDATA : /data/postgres
volumes :
- postgres:/data/postgres
ports :
- " ${DB_PORT}:5432 "
networks :
- postgres
restart : always
pgadmin :
container_name : pgadmin_container
image : dpage/pgadmin4
environment :
PGADMIN_DEFAULT_EMAIL : ${PGADMIN_EMAIL}
PGADMIN_DEFAULT_PASSWORD : ${PGADMIN_PASSWORD}
PGADMIN_CONFIG_SERVER_MODE : " False "
volumes :
- pgadmin:/root/.pgadmin
ports :
- " ${PGADMIN_PORT}:80 "
networks :
- postgres
restart : always
server :
container_name : server_container
build :
context : .
dockerfile : Dockerfile
depends_on :
- postgres
ports :
- " ${SERVER_PORT}:${SERVER_PORT} "
networks :
- postgres
restart : always
networks :
postgres :
driver : bridge
volumes :
postgres :
pgadmin : Эта конфигурация создает 3 контейнера, 1 сеть и 1 том для хранения постоянных данных. Каждый контейнер использует одну и ту же сеть для связи с другими контейнерами. Каждый контейнер после сбоя автоматически перезапускается. Контейнер postgres_container создает сервер PostgreSQL, где постоянные данные хранятся в томе. Существует также контейнер pgadmin_container , который является клиентом SQL. Последний контейнер, названный server_container , - это то, где работает наше главное приложение. Вместо изображения он использует сборку, определенную в Dockerfile, обсуждается в предыдущем разделе.
Конфигурация Compose для режима разработки очень похожа на один для режима развертывания. Единственная разница в том, что нет server_container , потому что сервер и клиент - это отдельные экземпляры, исходящие из Docker.
.env.example to .env и установить значение ${DB_HOST} в postgres .client/.env.production.example to client/.env.production .${REACT_APP_GOOGLE_API} в client/.env.production , выполните эти шаги. Обратный прокси должен быть установлен для пересылки доступа к Дженкинсу и серверу приложений. Порты, указанные в ./env
Во -первых, перейдите к доступным сайтам Config Directory.
cd /etc/nginx/sites-available/ Создать файл конфигурации. Вы можете назвать это, как будто. Хорошая практика - назвать это так же, как и ваш адрес DNS. В нашем случае это lora.fiit.stuba.sk .
touch lora.fiit.stuba.sk Скопируйте и вставьте следующий код в недавно созданный файл. Измените конфигурацию proxy_pass для каждого местоположения, чтобы соответствовать портам, указанным в .env . Не забудьте также настроить server_name в соответствии с вашим DNS.
upstream jenkins {
keepalive 32; # keepalive connections
server 127.0.0.1:8080; # jenkins ip and port
}
# Required for Jenkins websocket agents
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
server_name lora.fiit.stuba.sk www.lora.fiit.stuba.sk;
# this is the jenkins web root directory
# (mentioned in the /etc/default/jenkins file)
root /var/run/jenkins/war/;
access_log /var/log/nginx/jenkins/access.log;
error_log /var/log/nginx/jenkins/error.log;
# pass through headers from Jenkins that Nginx considers invalid
ignore_invalid_headers off;
location /jenkins/ {
autoindex on ;
sendfile off ;
proxy_pass http://jenkins/jenkins/;
proxy_redirect default ;
proxy_http_version 1.1 ;
# Required for Jenkins websocket agents
proxy_set_header Connection $connection_upgrade ;
proxy_set_header Upgrade $http_upgrade ;
proxy_set_header Host $host ;
proxy_set_header X-Real-IP $remote_addr ;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for ;
proxy_set_header X-Forwarded-Proto $scheme ;
proxy_max_temp_file_size 0 ;
#this is the maximum upload size
client_max_body_size 10m ;
client_body_buffer_size 128k ;
proxy_connect_timeout 90 ;
proxy_send_timeout 90 ;
proxy_read_timeout 90 ;
proxy_buffering off ;
proxy_request_buffering off; # Required for HTTP CLI commands
proxy_set_header Connection "" ; # Clear for keepalive
}
location / {
#Add serving gzipped files
gzip_static on ;
gzip on ;
gzip_proxied no-cache no-store private expired auth;
gzip_min_length 256 ;
gzip_types
text/plain
text/css
application/json
application/javascript
text/xml
application/xml
application/xml+rss text/javascript
application/atom+xml
application/geo+json
application/x-javascript
application/ld+json
application/manifest+json
application/rdf+xml
application/rss+xml
application/xhtml+xml
font/eot
font/otf
font/ttf
image/svg+xml;
proxy_pass http://127.0.0.1:5000/;
proxy_set_header Host $host ;
proxy_set_header X-Real-IP $remote_addr ;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for ;
proxy_set_header X-Forwarded-Proto $scheme ;
# enable WebSockets
proxy_http_version 1.1 ;
proxy_set_header Upgrade $http_upgrade ;
proxy_set_header Connection "upgrade" ;
}
listen 443 ssl; # managed by Certbot
# SSL Configuration
ssl_certificate /etc/letsencrypt/live/lora.fiit.stuba.sk/fullchain.pem; # managed by Certbot
ssl_certificate_key /etc/letsencrypt/live/lora.fiit.stuba.sk/privkey.pem; # managed by Certbot
include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
}
# SSL redirect from HTTP to HTTPS
server {
if ( $host = lora.fiit.stuba.sk) {
return 301 https:// $host$request_uri ;
} # managed by Certbot
listen 80 ;
server_name lora.fiit.stuba.sk www.lora.fiit.stuba.sk;
return 404 ; # managed by Certbot
}Сохранить файл и перезагрузить сервис Nginx
sudo systemctl restart nginx Приложение Jenkins должно быть доступно по адресу lora.fiit.stuba.sk/jenkins . В вашем случае это будет ваше имя DNS вместо lora.fiit.stuba.sk .
Когда вы хотите изменить дом по умолчанию для Дженкинса, вы можете изменить переменную JENKINS_HOME . Гид сильно вдохновлен этим руководством.
Создайте новый каталог, где бы вы ни захотели переместить Дженкинс. В нашем случае это /data/jenkins .
mkdir /data/jenkinsИзмените право собственности на недавно созданный каталог.
sudo chown jenkins:jenkins /data/jenkins Скопируйте контент из Home Directory Old Jenkins, /var/lib/jenkins/ , в новый каталог Jenkins Home, /data/jenkins/ , с помощью следующей команды.
sudo cp -prv /var/lib/jenkins /data/jenkins/Затем измените пользователь Jenkins Home.
sudo usermod -d /data/jenkins/ jenkins Обновите новый путь домашнего каталога Jenkins в /etc/default/jenkins . Вы можете использовать любой редактор по вашему выбору. В нашем случае мы используем VI.
sudo vi /etc/default/jenkinsПрокрутите вниз до дома Дженкинса и обновите новый путь домашнего каталога.
# defaults for Jenkins automation server
# pulled in from the init script; makes things easier.
NAME=jenkins
# arguments to pass to java
# Allow graphs etc. to work even when an X server is present
JAVA_ARGS= " -Djava.awt.headless=true "
# JAVA_ARGS="-Xmx256m"
# make jenkins listen on IPv4 address
# JAVA_ARGS="-Djava.net.preferIPv4Stack=true"
PIDFILE=/var/run/$NAME/$NAME.pid
# user and group to be invoked as (default to jenkins)
JENKINS_USER=$NAME
JENKINS_GROUP=$NAME
# location of the jenkins war file
JENKINS_WAR=/usr/share/$NAME/$NAME.war
# jenkins home location
JENKINS_HOME=/data/$NAME
# set this to false if you don't want Jenkins to run by itself
# in this set up, you are expected to provide a servlet container
# to host jenkins.
RUN_STANDALONE=trueНачните службу Jenkins, используя следующую команду.
sudo service jenkins start
Посетите Дженкинс из вашего браузера по адресу lora.fiit.stuba.sk/jenkins .
Войдите в приложение.
Перейдите, чтобы Manage Jenkins , расположенной в левой стороне экрана.
Нажмите на вкладку Manage Credentials , расположенная в Security group .
Затем нажмите на (global) ссылку, расположенную в таблице.
Нажмите кнопку addCredentials в левой стороне экрана.
Выберите опцию Secret file из Kind меню.
Загрузите выполненный файл .env и установите поле идентификатора для env .
Повторите шаг 6, а затем загрузите выполненный файл client/.env.production и установите поле идентификатора для envClient .
Создайте другие учетные данные, но на этот раз выберите SSH Username with private key из выпадающего меню. Установите поле ID на lora-application-server-ssh . Чтобы получить клавиши SSH для вашего репозитория (где находится исходный код сервера приложений), следуйте этим инструкциям.
На приборной панели нажмите на New Item , расположенную в левой стороне экрана.
Введите желаемое имя, нажмите на кнопку Pipeline и подтвердите ее нажатие на кнопку OK
В сценарий трубопровода вставьте следующий код
node {
/*** 1 Pull new changes from git branch deploy ***/
stage ( 'Pull master branch' ) {
git credentialsId : 'lora-application-server-ssh' , url : '[email protected]:danielhros/lora-application-server.git'
}
/*** 2 Add secret enviroment variables stored securely in Jenkins ***/
stage ( 'Add enviroment variables' ) {
/* 2.1 Remove .env file if exists */
sh 'rm -f -- .env'
/* 2.2 Add .env file to server */
withCredentials ( [ file ( credentialsId : 'env' , variable : 'env' ) ] ) {
sh "cp $env ./"
}
/* 2.2 Add .env file to client */
withCredentials ( [ file ( credentialsId : 'envClient' , variable : 'envClient' ) ] ) {
sh 'cp $envClient client/.env.production'
}
}
/*** 3 Build docker image ***/
stage ( 'Build docker image' ) {
sh '(docker-compose build)'
}
/*** 4 Run docker image in production ***/
stage ( 'Run docker images' ) {
sh '(docker-compose up -d)'
}
/*** 5 Clean after build ***/
stage ( 'Clean workspace' ) {
sh 'docker system prune -f'
cleanWs ( )
}
}Сохраните изменения и запустите свой первый трубопровод
Поздравляю! После успешного создания и развертывания приложения ваше приложение доступно по адресу lora.fiit.stuba.sk .
