У овом чланку користимо треснути, sSH, доцкер и Апацхе Организоваћемо беспрекоран изглед веб апликације. Плаво-зелено распоређивање је техника која вам омогућава да тренутно ажурирате апликацију без одбијања једног захтева. То је једна од стратегија примене без застоја и најпогоднија је за апликације са једном инстанцом, али могућношћу учитавања друге инстанце спремне за покретање у близини.
Рецимо да имате веб апликацију са којом многи клијенти активно раде и апсолутно не постоји начин да легне пар секунди. И заиста морате да објавите ажурирање библиотеке, исправку грешака или нову сјајну функцију. У нормалној ситуацији, мораћете да зауставите апликацију, замените је и поново покренете. У случају доцкер-а, прво можете да га замените, а затим поново покренете, али ће и даље постојати период у коме захтеви према апликацији неће бити обрађени, јер је обично потребно неко време да се апликација учита. Шта ако се покрене, али се испостави да није у функцији? Ово је проблем, хајде да га решимо са минималним средствима и што је могуће елегантније.
ОДРИЦАЊЕ ОДГОВОРНОСТИ: Већина чланка је представљена у експерименталном формату – у облику снимка сесије на конзоли. Надамо се да ово неће бити тешко разумети и да ће се код довољно документовати. За атмосферу, замислите да ово нису само исечци кода, већ папир са „гвозденог” телетипа.
На почетку сваког одељка описане су интересантне технике које је тешко за Гоогле само читањем кода. Ако још нешто није јасно, прогуглајте и проверите. објаснисхелл (на срећу, опет ради, због деблокаде телеграма). Ако не можете ништа да изгуглате, питајте у коментарима. Радо ћу додати у одговарајући одељак „Занимљиве технике“.
Хајде да почнемо.
$ mkdir blue-green-deployment && cd $_
Сервис
Хајде да направимо експериментални сервис и ставимо га у контејнер.
Занимљиве технике
cat << EOF > file-name (Овде документ + И/О преусмеравање) је начин за креирање датотеке са више линија са једном командом. Све из чега басх чита /dev/stdin после овог реда и пре реда EOF биће забележено у file-name.
wget -qO- URL (објаснисхелл) — излаз документа примљен преко ХТТП-а на /dev/stdout (аналогно curl URL).
Одштампати
Посебно сам разбио исечак да бих омогућио истицање за Питхон. На крају ће бити још један овакав комад. Узмите у обзир да је на овим местима папир исечен за слање у одељење за истицање (где је шифра ручно обојена маркерима), а затим су ови делови залепљени назад.
$ 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
Реверсе проки
Да би се наша апликација могла непримећено мењати, потребно је да испред ње стоји неки други ентитет који ће сакрити њену замену. То може бити веб сервер Апацхе в режим обрнутог проксија. Између клијента и апликације успоставља се обрнути прокси. Прихвата захтеве клијената и прослеђује их апликацији и клијентима прослеђује одговоре апликације.
Апликација и обрнути прокси могу се повезати унутар доцкер-а помоћу доцкер мрежа. Дакле, контејнер са апликацијом не мора чак ни да прослеђује порт на хост систему; ово омогућава да апликација буде максимално изолована од спољних претњи.
Ако обрнути прокси живи на другом хосту, мораћете да напустите доцкер мрежу и повежете апликацију са обрнутим проксијем преко мреже хоста, прослеђујући порт апликације параметар --publish, као при првом покретању и као код обрнутог проксија.
Покренућемо обрнути прокси на порту 80, јер је то управо ентитет који треба да слуша спољну мрежу. Ако је порт 80 заузет на вашем тест хосту, промените параметар --publish 80:80 на --publish ANY_FREE_PORT:80.
$ docker network create web-gateway
5dba128fb3b255b02ac012ded1906b7b4970b728fb7db3dbbeccc9a77a5dd7bd
$ docker run --detach --rm --name uptimer --network web-gateway uptimer
a1105f1b583dead9415e99864718cc807cc1db1c763870f40ea38bc026e2d67f
$ docker run --rm --network web-gateway alpine wget -qO- http://uptimer:8080
<h2>Uptimer v1.0 is running for 11.5 seconds.</h2>
$ docker run --detach --publish 80:80 --network web-gateway --name reverse-proxy nginx:alpine
80695a822c19051260c66bf60605dcb4ea66802c754037704968bc42527bf120
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
80695a822c19 nginx:alpine "/docker-entrypoint.…" 27 seconds ago Up 25 seconds 0.0.0.0:80->80/tcp reverse-proxy
a1105f1b583d uptimer "python -u ./app.py" About a minute ago Up About a minute 8080/tcp uptimer
$ cat << EOF > uptimer.conf
server {
listen 80;
location / {
proxy_pass http://uptimer:8080;
}
}
EOF
$ docker cp ./uptimer.conf reverse-proxy:/etc/nginx/conf.d/default.conf
$ docker exec reverse-proxy nginx -s reload
2020/06/23 20:51:03 [notice] 31#31: signal process started
$ wget -qSO- http://localhost
HTTP/1.1 200 OK
Server: nginx/1.19.0
Date: Sat, 22 Aug 2020 19:56:24 GMT
Content-Type: text/html
Transfer-Encoding: chunked
Connection: keep-alive
<h2>Uptimer v1.0 is running for 104.1 seconds.</h2>
Беспрекорна примена
Хајде да представимо нову верзију апликације (са двоструким повећањем перформанси при покретању) и покушамо да је применимо неприметно.
Занимљиве технике
echo 'my text' | docker exec -i my-container sh -c 'cat > /my-file.txt' — Напишите текст my text да поднесе /my-file.txt унутар контејнера my-container.
$ 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
У овој фази, слика се гради директно на серверу, што захтева да извори апликације буду тамо, а такође оптерећује сервер непотребним радом. Следећи корак је додељивање склопа слике засебној машини (на пример, ЦИ систему), а затим пребацивање на сервер.
Пренос слика
Нажалост, нема смисла преносити слике са локалног хоста на локални хост, тако да се овај одељак може истражити само ако имате два хоста са Доцкер-ом при руци. У најмању руку то изгледа отприлике овако:
$ 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 чува податке о слици у .тар архиви, што значи да је тежи око 1.5 пута више него што би тежио у компримованом облику. Па хајде да га протресемо у име уштеде времена и саобраћаја:
Сада сакупимо све што смо урадили ручно у једну скрипту. Почнимо са функцијом највишег нивоа, а затим погледајмо остале које се у њој користе.
Занимљиве технике
${parameter?err_msg} - једна од басх магијских чаролија (ака замена параметара). Ако 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 — Мења нгинк конфигурацију у контејнеру обрнутог проксија
Да би:
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 захтева мало објашњење:
Зашто враћа број, а не исписује стринг?
У сваком случају, у функцији за позивање проверавамо резултат њеног рада, а провера излазног кода помоћу басх-а је много лакша него провера стринга. Поред тога, добијање стринга из њега је врло једноставно: get-active-slot service && echo BLUE || echo GREEN.
Да ли су три услова заиста довољна за разликовање свих држава?
И два ће бити довољна, последња је ту само ради комплетности, да не пишем else.
Само функција која враћа нгинк конфигурације остаје недефинисана: get-nginx-config service_name deployment_slot. По аналогији са провером здравља, овде можете подесити било коју конфигурацију за било коју услугу. Од занимљивости – само cat <<- EOF, што вам омогућава да уклоните све картице на почетку. Истина, цена доброг форматирања су помешани табови са размацима, што се данас сматра веома лошим обликом. Али басх форсира картице, а такође би било лепо имати нормално форматирање у нгинк конфигурацији. Укратко, мешање картица са размацима овде заиста изгледа као најбоље решење од најгорих. Међутим, ово нећете видети у исечку испод, пошто Хабр то „ради добро“ мењајући све табове на 4 размака и чини ЕОФ неважећим. И овде је то приметно.
Да не бих устао двапут, одмах ћу вам рећи о томе cat << 'EOF', који ће се касније срести. Ако пишете једноставно cat << EOF, онда се унутар хередоц стринг интерполира (променљиве се проширују ($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.
Написали смо скрипту за примену која преузима унапред изграђену слику на циљни сервер и неприметно замењује сервисни контејнер, али како можемо да је извршимо на удаљеној машини? Скрипта има аргументе, пошто је универзална и може да примени неколико услуга одједном под једним реверзним проксијем (можете користити нгинк конфигурације да одредите који ће УРЛ бити који сервис). Скрипта се не може чувати на серверу, јер у овом случају нећемо моћи да је ажурирамо аутоматски (у сврху исправљања грешака и додавања нових сервиса), и уопште, стање = зло.
Решење 1: И даље чувајте скрипту на серверу, али је копирајте сваки пут scp. Затим се повежите преко ssh и изврши скрипту са потребним аргументима.
Против:
Две акције уместо једне
Можда не постоји место где копирате, или му можда нема приступа, или се скрипта може извршити у тренутку замене.
Препоручљиво је да почистите за собом (избришите скрипту).
Већ три акције.
Решење 2:
Задржите само дефиниције функција у скрипти и не покрените ништа
Са sed додајте позив функције на крај
Пошаљите све директно у пссст путем цеви (|)
Предности:
Заиста без држављанства
Нема шаблонских ентитета
Осећам се цоол
Урадимо то без Ансибле-а. Да, све је већ измишљено. Да, бицикл. Погледајте како је бицикл једноставан, елегантан и минималистички:
$ 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'
Међутим, не можемо бити сигурни да удаљени хост има адекватан басх, па ћемо додати малу проверу на почетку (ово је уместо схеллбанг):
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/ у претраживачу, поново покрените примену и уверите се да ради беспрекорно ажурирањем странице према ЦД-у током изгледа.