Бұл мақалада біз қолданамыз bash, SSH, доккер и nginx Біз веб-қосымшаның біркелкі орналасуын ұйымдастырамыз. Көк-жасыл орналастыру бір сұранысты қабылдамаусыз қолданбаны лезде жаңартуға мүмкіндік беретін әдіс. Бұл нөлдік тоқтау уақытын орналастыру стратегияларының бірі және бір данасы бар қолданбалар үшін ең қолайлы, бірақ жақын жерде екінші, іске қосуға дайын дананы жүктеу мүмкіндігі.
Сізде көптеген клиенттер белсенді жұмыс істейтін веб-бағдарлама бар делік және оның бір-екі секунд жатып қалуына мүлдем мүмкіндік жоқ. Сізге шынымен де кітапхана жаңартуын, қатені түзетуді немесе жаңа керемет мүмкіндікті шығару керек. Қалыпты жағдайда қолданбаны тоқтатып, оны ауыстырып, қайта бастау керек болады. Докер жағдайында сіз алдымен оны ауыстыра аласыз, содан кейін оны қайта іске қоса аласыз, бірақ әлі де қосымшаға сұраулар өңделмейтін кезең болады, себебі әдетте қолданбаның бастапқы жүктелуіне біраз уақыт кетеді. Егер ол басталса, бірақ жұмыс істемейтін болып шықса ше? Мәселе мынада, оны аз қаражатпен және мүмкіндігінше талғампаздықпен шешейік.
БАС ТАРТУ: Мақаланың көп бөлігі эксперименттік форматта – консольдік сессияның жазбасы түрінде ұсынылған. Мұны түсіну қиын болмайды және код өзін жеткілікті түрде құжаттайды деп үміттенеміз. Атмосфера үшін бұл жай ғана код үзінділері емес, «темір» телетайптың қағазы деп елестетіңіз.
Кодты оқу арқылы Google-ге қиын болатын қызықты әдістер әр бөлімнің басында сипатталған. Басқа бірдеңе түсініксіз болса, оны Google-ден іздеп, оны тексеріңіз. түсіндіру қабығы (бақытымызға орай, ол жеделхаттың блоктануына байланысты қайтадан жұмыс істейді). Егер сіз Google-де ештеңе жасай алмасаңыз, түсініктемелерде сұраңыз. Мен «Қызықты әдістер» сәйкес бөлімін қосуға қуаныштымын.
Бастайық.
$ mkdir blue-green-deployment && cd $_
қызмет көрсету
Эксперименттік қызмет жасап, оны контейнерге салайық.
Қызықты техникалар
cat << EOF > file-name (Мұнда Құжат + Енгізу/шығару бағытын өзгерту) – бір пәрмен арқылы көп жолды файлды құру тәсілі. Барлық bash оқиды /dev/stdin осы жолдан кейін және жолдың алдында EOF ішінде жазылады file-name.
wget -qO- URL (түсіндіру қабығы) — HTTP арқылы алынған құжатты келесіге шығару /dev/stdout (аналог curl URL).
Шығару
Мен Python үшін бөлектеуді қосу үшін үзіндіні арнайы бұзамын. Соңында осындай тағы бір туынды болады. Бұл жерлерде қағазды бөлектеу бөліміне жіберу үшін кесілгенін ескеріңіз (мұнда код қолмен жарықтандырғыштармен боялған), содан кейін бұл бөліктер қайтадан желімделген.
$ cat << EOF > uptimer.py
from http.server import BaseHTTPRequestHandler, HTTPServer
from time import monotonic
app_version = 1
app_name = f'Uptimer v{app_version}.0'
loading_seconds = 15 - app_version * 5
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
if self.path == '/':
try:
t = monotonic() - server_start
if t < loading_seconds:
self.send_error(503)
else:
self.send_response(200)
self.send_header('Content-Type', 'text/html')
self.end_headers()
response = f'<h2>{app_name} is running for {t:3.1f} seconds.</h2>n'
self.wfile.write(response.encode('utf-8'))
except Exception:
self.send_error(500)
else:
self.send_error(404)
httpd = HTTPServer(('', 8080), Handler)
server_start = monotonic()
print(f'{app_name} (loads in {loading_seconds} sec.) started.')
httpd.serve_forever()
EOF
$ cat << EOF > Dockerfile
FROM python:alpine
EXPOSE 8080
COPY uptimer.py app.py
CMD [ "python", "-u", "./app.py" ]
EOF
$ docker build --tag uptimer .
Sending build context to Docker daemon 39.42kB
Step 1/4 : FROM python:alpine
---> 8ecf5a48c789
Step 2/4 : EXPOSE 8080
---> Using cache
---> cf92d174c9d3
Step 3/4 : COPY uptimer.py app.py
---> a7fbb33d6b7e
Step 4/4 : CMD [ "python", "-u", "./app.py" ]
---> Running in 1906b4bd9fdf
Removing intermediate container 1906b4bd9fdf
---> c1655b996fe8
Successfully built c1655b996fe8
Successfully tagged uptimer:latest
$ docker run --rm --detach --name uptimer --publish 8080:8080 uptimer
8f88c944b8bf78974a5727070a94c76aa0b9bb2b3ecf6324b784e782614b2fbf
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
8f88c944b8bf uptimer "python -u ./app.py" 3 seconds ago Up 5 seconds 0.0.0.0:8080->8080/tcp uptimer
$ docker logs uptimer
Uptimer v1.0 (loads in 10 sec.) started.
$ wget -qSO- http://localhost:8080
HTTP/1.0 503 Service Unavailable
Server: BaseHTTP/0.6 Python/3.8.3
Date: Sat, 22 Aug 2020 19:52:40 GMT
Connection: close
Content-Type: text/html;charset=utf-8
Content-Length: 484
$ wget -qSO- http://localhost:8080
HTTP/1.0 200 OK
Server: BaseHTTP/0.6 Python/3.8.3
Date: Sat, 22 Aug 2020 19:52:45 GMT
Content-Type: text/html
<h2>Uptimer v1.0 is running for 15.4 seconds.</h2>
$ docker rm --force uptimer
uptimer
Кері прокси
Қолданбамыз байқалмай өзгере алуы үшін оның алдында оның ауыстырылуын жасыратын басқа нысан болуы керек. Бұл веб-сервер болуы мүмкін nginx в кері прокси режимі. Клиент пен қолданба арасында кері прокси орнатылады. Ол клиенттердің сұраныстарын қабылдайды және оларды қолданбаға жібереді және қолданбаның жауаптарын клиенттерге жібереді.
Қолданбаны және кері проксиді докердің көмегімен байланыстыруға болады докер желісі. Осылайша, қолданбасы бар контейнерге тіпті хост жүйесіндегі портты қайта жіберудің қажеті жоқ, бұл қолданбаны сыртқы қауіптерден барынша оқшаулауға мүмкіндік береді.
Егер кері прокси басқа хостта тұрса, сізге докер желісінен бас тартуға және портты қайта бағыттай отырып, бағдарламаны кері проксиге хост желісі арқылы қосуға тура келеді. бағдарламалар параметр --publish, бірінші бастаудағыдай және кері проксидегідей.
Біз 80-ші портта кері проксиді іске қосамыз, себебі бұл сыртқы желіні тыңдауы керек нысан. Сынақ хостында 80 порт бос емес болса, параметрді өзгертіңіз --publish 80:80 туралы --publish ANY_FREE_PORT:80.
$ sed -i "s/app_version = 1/app_version = 2/" uptimer.py
$ docker build --tag uptimer .
Sending build context to Docker daemon 39.94kB
Step 1/4 : FROM python:alpine
---> 8ecf5a48c789
Step 2/4 : EXPOSE 8080
---> Using cache
---> cf92d174c9d3
Step 3/4 : COPY uptimer.py app.py
---> 3eca6a51cb2d
Step 4/4 : CMD [ "python", "-u", "./app.py" ]
---> Running in 8f13c6d3d9e7
Removing intermediate container 8f13c6d3d9e7
---> 1d56897841ec
Successfully built 1d56897841ec
Successfully tagged uptimer:latest
$ docker run --detach --rm --name uptimer_BLUE --network web-gateway uptimer
96932d4ca97a25b1b42d1b5f0ede993b43f95fac3c064262c5c527e16c119e02
$ docker logs uptimer_BLUE
Uptimer v2.0 (loads in 5 sec.) started.
$ docker run --rm --network web-gateway alpine wget -qO- http://uptimer_BLUE:8080
<h2>Uptimer v2.0 is running for 23.9 seconds.</h2>
$ sed s/uptimer/uptimer_BLUE/ uptimer.conf | docker exec --interactive reverse-proxy sh -c 'cat > /etc/nginx/conf.d/default.conf'
$ docker exec reverse-proxy cat /etc/nginx/conf.d/default.conf
server {
listen 80;
location / {
proxy_pass http://uptimer_BLUE:8080;
}
}
$ docker exec reverse-proxy nginx -s reload
2020/06/25 21:22:23 [notice] 68#68: signal process started
$ wget -qO- http://localhost
<h2>Uptimer v2.0 is running for 63.4 seconds.</h2>
$ docker rm -f uptimer
uptimer
$ wget -qO- http://localhost
<h2>Uptimer v2.0 is running for 84.8 seconds.</h2>
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
96932d4ca97a uptimer "python -u ./app.py" About a minute ago Up About a minute 8080/tcp uptimer_BLUE
80695a822c19 nginx:alpine "/docker-entrypoint.…" 8 minutes ago Up 8 minutes 0.0.0.0:80->80/tcp reverse-proxy
Бұл кезеңде кескін тікелей серверде құрастырылады, ол қолданба көздерінің сонда болуын талап етеді, сонымен қатар серверді қажетсіз жұмыспен жүктейді. Келесі қадам - кескін жинағын бөлек құрылғыға (мысалы, CI жүйесіне) бөліп, содан кейін оны серверге тасымалдау.
Суреттерді тасымалдау
Өкінішке орай, кескіндерді localhost-тен localhost-қа тасымалдау мағынасы жоқ, сондықтан бұл бөлімді Docker-пен екі хостыңыз болса ғана зерттеуге болады. Кем дегенде, ол келесідей көрінеді:
$ ssh production-server docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
$ docker image save uptimer | ssh production-server 'docker image load'
Loaded image: uptimer:latest
$ ssh production-server docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
uptimer latest 1d56897841ec 5 minutes ago 78.9MB
команда docker save кескін деректерін .tar мұрағатында сақтайды, яғни оның салмағы қысылған пішіндегі салмағынан шамамен 1.5 есе артық. Уақыт пен трафикті үнемдеу үшін оны шайқап көрейік:
Енді қолмен жасаған барлық нәрсені бір сценарийге жинайық. Жоғары деңгейлі функциядан бастайық, содан кейін онда қолданылатын басқаларды қарастырайық.
Қызықты техникалар
${parameter?err_msg} - бас сиқырлы заклинаниелердің бірі (aka параметрді ауыстыру). Егер parameter көрсетілмеген, шығыс err_msg және 1 коды арқылы шығыңыз.
docker --log-driver journald — әдепкі бойынша докерлік журнал жүргізу драйвері ешқандай айналусыз мәтіндік файл болып табылады. Бұл тәсілмен журналдар бүкіл дискіні тез толтырады, сондықтан өндіріс ортасы үшін драйверді ақылдыға ауыстыру қажет.
Орналастыру сценарийі
deploy() {
local usage_msg="Usage: ${FUNCNAME[0]} image_name"
local image_name=${1?$usage_msg}
ensure-reverse-proxy || return 2
if get-active-slot $image_name
then
local OLD=${image_name}_BLUE
local new_slot=GREEN
else
local OLD=${image_name}_GREEN
local new_slot=BLUE
fi
local NEW=${image_name}_${new_slot}
echo "Deploying '$NEW' in place of '$OLD'..."
docker run
--detach
--restart always
--log-driver journald
--name $NEW
--network web-gateway
$image_name || return 3
echo "Container started. Checking health..."
for i in {1..20}
do
sleep 1
if get-service-status $image_name $new_slot
then
echo "New '$NEW' service seems OK. Switching heads..."
sleep 2 # Ensure service is ready
set-active-slot $image_name $new_slot || return 4
echo "'$NEW' service is live!"
sleep 2 # Ensure all requests were processed
echo "Killing '$OLD'..."
docker rm -f $OLD
docker image prune -f
echo "Deployment successful!"
return 0
fi
echo "New '$NEW' service is not ready yet. Waiting ($i)..."
done
echo "New '$NEW' service did not raise, killing it. Failed to deploy T_T"
docker rm -f $NEW
return 5
}
Қолданылатын мүмкіндіктер:
ensure-reverse-proxy — Кері прокси жұмыс істеп тұрғанын тексеріңіз (алғашқы орналастыру үшін пайдалы)
get-active-slot service_name — Берілген қызмет үшін қазіргі уақытта қай ұяшық белсенді екенін анықтайды (BLUE немесе GREEN)
get-service-status service_name deployment_slot — Қызметтің кіріс сұрауларын өңдеуге дайын екенін анықтайды
set-active-slot service_name deployment_slot — Кері прокси контейнеріндегі nginx конфигурациясын өзгертеді
мақсатында:
ensure-reverse-proxy() {
is-container-up reverse-proxy && return 0
echo "Deploying reverse-proxy..."
docker network create web-gateway
docker run
--detach
--restart always
--log-driver journald
--name reverse-proxy
--network web-gateway
--publish 80:80
nginx:alpine || return 1
docker exec --interactive reverse-proxy sh -c "> /etc/nginx/conf.d/default.conf"
docker exec reverse-proxy nginx -s reload
}
is-container-up() {
local container=${1?"Usage: ${FUNCNAME[0]} container_name"}
[ -n "$(docker ps -f name=${container} -q)" ]
return $?
}
get-active-slot() {
local service=${1?"Usage: ${FUNCNAME[0]} service_name"}
if is-container-up ${service}_BLUE && is-container-up ${service}_GREEN; then
echo "Collision detected! Stopping ${service}_GREEN..."
docker rm -f ${service}_GREEN
return 0 # BLUE
fi
if is-container-up ${service}_BLUE && ! is-container-up ${service}_GREEN; then
return 0 # BLUE
fi
if ! is-container-up ${service}_BLUE; then
return 1 # GREEN
fi
}
get-service-status() {
local usage_msg="Usage: ${FUNCNAME[0]} service_name deployment_slot"
local service=${1?usage_msg}
local slot=${2?$usage_msg}
case $service in
# Add specific healthcheck paths for your services here
*) local health_check_port_path=":8080/" ;;
esac
local health_check_address="http://${service}_${slot}${health_check_port_path}"
echo "Requesting '$health_check_address' within the 'web-gateway' docker network:"
docker run --rm --network web-gateway alpine
wget --timeout=1 --quiet --server-response $health_check_address
return $?
}
set-active-slot() {
local usage_msg="Usage: ${FUNCNAME[0]} service_name deployment_slot"
local service=${1?$usage_msg}
local slot=${2?$usage_msg}
[ "$slot" == BLUE ] || [ "$slot" == GREEN ] || return 1
get-nginx-config $service $slot | docker exec --interactive reverse-proxy sh -c "cat > /etc/nginx/conf.d/$service.conf"
docker exec reverse-proxy nginx -t || return 2
docker exec reverse-proxy nginx -s reload
}
функция get-active-slot аздап түсіндіруді қажет етеді:
Неліктен ол санды қайтарады және жолды шығармайды?
Қалай болғанда да, шақыру функциясында біз оның жұмысының нәтижесін тексереміз және bash көмегімен шығу кодын тексеру жолды тексеруден әлдеқайда оңай. Сонымен қатар, одан жолды алу өте қарапайым: get-active-slot service && echo BLUE || echo GREEN.
Барлық мемлекеттерді ажырату үшін үш шарт шынымен жеткілікті ме?
Тіпті екеуі де жетеді, соңғысы жазылмас үшін толықтық үшін осында else.
Nginx конфигурацияларын қайтаратын функция ғана анықталмаған болып қалады: get-nginx-config service_name deployment_slot. Денсаулықты тексеруге ұқсас, мұнда кез келген қызмет үшін кез келген конфигурацияны орнатуға болады. Қызықты нәрселерден - тек cat <<- EOF, ол басында барлық қойындыларды жоюға мүмкіндік береді. Рас, жақсы пішімдеудің бағасы бос орындар бар аралас қойындылар болып табылады, ол бүгінгі күні өте нашар пішін болып саналады. Бірақ bash қойындыларды күшейтеді және nginx конфигурациясында қалыпты пішімдеу жақсы болар еді. Қысқаша айтқанда, қойындыларды бос орындармен араластыру шынымен де ең нашар шешім сияқты көрінеді. Дегенмен, сіз мұны төмендегі үзіндіде көрмейсіз, өйткені Хабр барлық қойындыларды 4 бос орынға өзгертіп, EOF-ті жарамсыз етіп «жақсы жасайды». Және бұл жерде байқалады.
Екі рет тұрмас үшін мен сізге бірден айтамын cat << 'EOF', ол кейінірек кездеседі. Қарапайым жазсаңыз cat << EOF, содан кейін heredoc ішінде жол интерполяцияланады (айнымалылар кеңейтіледі ($foo), командалық шақырулар ($(bar)) және т.б.) және құжаттың соңын жалғыз тырнақшаға алсаңыз, интерполяция өшіріледі және таңба $ сол күйінде көрсетіледі. Басқа сценарийге сценарий енгізу үшін не қажет.
get-nginx-config() {
local usage_msg="Usage: ${FUNCNAME[0]} service_name deployment_slot"
local service=${1?$usage_msg}
local slot=${2?$usage_msg}
[ "$slot" == BLUE ] || [ "$slot" == GREEN ] || return 1
local container_name=${service}_${slot}
case $service in
# Add specific nginx configs for your services here
*) nginx-config-simple-service $container_name:8080 ;;
esac
}
nginx-config-simple-service() {
local usage_msg="Usage: ${FUNCNAME[0]} proxy_pass"
local proxy_pass=${1?$usage_msg}
cat << EOF
server {
listen 80;
location / {
proxy_pass http://$proxy_pass;
}
}
EOF
}
Қашықтағы серверде параметрленген сценарийлерді орындау
Мақсатты серверді қағу уақыты келді. Бұл жолы localhost өте қолайлы:
$ ssh-copy-id localhost
/usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s), to filter out any that are already installed
/usr/bin/ssh-copy-id: INFO: 1 key(s) remain to be installed -- if you are prompted now it is to install the new keys
himura@localhost's password:
Number of key(s) added: 1
Now try logging into the machine, with: "ssh 'localhost'"
and check to make sure that only the key(s) you wanted were added.
Біз мақсатты серверге алдын ала жасалған кескінді жүктеп алатын және қызмет контейнерін біркелкі ауыстыратын орналастыру сценарийін жаздық, бірақ оны қашықтағы компьютерде қалай орындауға болады? Сценарийдің дәлелдері бар, себебі ол әмбебап және бір кері прокси астында бірден бірнеше қызметтерді қолдана алады (қай url қай қызмет болатынын анықтау үшін nginx конфигурацияларын пайдалануға болады). Сценарийді серверде сақтау мүмкін емес, өйткені бұл жағдайда біз оны автоматты түрде жаңарта алмаймыз (қателерді түзету және жаңа қызметтерді қосу үшін) және жалпы күй = зұлымдық.
1-шешім: Сценарийді әлі де серверде сақтаңыз, бірақ оны әр уақытта көшіріп алыңыз scp. Содан кейін арқылы қосылыңыз ssh және сценарийді қажетті дәлелдермен орындаңыз.
Кемшіліктері:
Бір әрекеттің орнына екі әрекет
Көшіретін орын болмауы мүмкін немесе оған қол жетімділік болмауы мүмкін немесе ауыстыру кезінде сценарий орындалуы мүмкін.
Өзіңізден кейін тазалаған жөн (сценарийді жойыңыз).
Қазірдің өзінде үш әрекет.
2-шешім:
Сценарийде тек функция анықтамаларын сақтаңыз және ештеңені іске қоспаңыз
Көмегімен sed соңына функция шақыруын қосыңыз
Барлығын құбыр арқылы тікелей shh жіберіңіз (|)
Артықшылықтары:
Нағыз азаматтығы жоқ
Жоқ
Салқын сезіну
Мұны Ansibleсіз жасайық. Иә, бәрі бұрыннан ойлап табылған. Иә, велосипед. Велосипедтің қаншалықты қарапайым, талғампаз және минималистік екенін қараңыз:
$ cat << 'EOF' > deploy.sh
#!/bin/bash
usage_msg="Usage: $0 ssh_address local_image_tag"
ssh_address=${1?$usage_msg}
image_name=${2?$usage_msg}
echo "Connecting to '$ssh_address' via ssh to seamlessly deploy '$image_name'..."
( sed "$a deploy $image_name" | ssh -T $ssh_address ) << 'END_OF_SCRIPT'
deploy() {
echo "Yay! The '${FUNCNAME[0]}' function is executing on '$(hostname)' with argument '$1'"
}
END_OF_SCRIPT
EOF
$ chmod +x deploy.sh
$ ./deploy.sh localhost magic-porridge-pot
Connecting to localhost...
Yay! The 'deploy' function is executing on 'hut' with argument 'magic-porridge-pot'
Дегенмен, қашықтағы хостта жеткілікті bash бар екеніне сенімді бола алмаймыз, сондықтан біз басында шағын чек қосамыз (бұл орнына шелбанг):
if [ "$SHELL" != "/bin/bash" ]
then
echo "The '$SHELL' shell is not supported by 'deploy.sh'. Set a '/bin/bash' shell for '$USER@$HOSTNAME'."
exit 1
fi
Ал енді бұл нақты:
$ docker exec reverse-proxy rm /etc/nginx/conf.d/default.conf
$ wget -qO deploy.sh https://git.io/JUURc
$ chmod +x deploy.sh
$ ./deploy.sh localhost uptimer
Sending gzipped image 'uptimer' to 'localhost' via ssh...
Loaded image: uptimer:latest
Connecting to 'localhost' via ssh to seamlessly deploy 'uptimer'...
Deploying 'uptimer_GREEN' in place of 'uptimer_BLUE'...
06f5bc70e9c4f930e7b1f826ae2ca2f536023cc01e82c2b97b2c84d68048b18a
Container started. Checking health...
Requesting 'http://uptimer_GREEN:8080/' within the 'web-gateway' docker network:
HTTP/1.0 503 Service Unavailable
wget: server returned error: HTTP/1.0 503 Service Unavailable
New 'uptimer_GREEN' service is not ready yet. Waiting (1)...
Requesting 'http://uptimer_GREEN:8080/' within the 'web-gateway' docker network:
HTTP/1.0 503 Service Unavailable
wget: server returned error: HTTP/1.0 503 Service Unavailable
New 'uptimer_GREEN' service is not ready yet. Waiting (2)...
Requesting 'http://uptimer_GREEN:8080/' within the 'web-gateway' docker network:
HTTP/1.0 200 OK
Server: BaseHTTP/0.6 Python/3.8.3
Date: Sat, 22 Aug 2020 20:15:50 GMT
Content-Type: text/html
New 'uptimer_GREEN' service seems OK. Switching heads...
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
2020/08/22 20:15:54 [notice] 97#97: signal process started
The 'uptimer_GREEN' service is live!
Killing 'uptimer_BLUE'...
uptimer_BLUE
Total reclaimed space: 0B
Deployment successful!
Енді сіз аша аласыз http://localhost/ шолғышта орналастыруды қайта іске қосыңыз және орналасу кезінде бетті ықшам дискіге сәйкес жаңарту арқылы оның үздіксіз жұмыс істейтініне көз жеткізіңіз.