Í þessari grein notum við bash, SSH, bryggju и nginx Við munum skipuleggja hnökralaust skipulag á vefforritinu. Blágræn dreifing er tækni sem gerir þér kleift að uppfæra forrit samstundis án þess að hafna einni beiðni. Það er ein af dreifingaraðferðum án niðurtíma og hentar best fyrir forrit með eitt tilvik, en getu til að hlaða annað tilvik sem er tilbúið til að keyra í nágrenninu.
Segjum að þú sért með vefforrit sem margir viðskiptavinir eru virkir að vinna með og það er nákvæmlega engin leið fyrir það að leggjast niður í nokkrar sekúndur. Og þú þarft virkilega að setja út bókasafnsuppfærslu, villuleiðréttingu eða nýjan flottan eiginleika. Í venjulegum aðstæðum þarftu að stöðva forritið, skipta um það og ræsa það aftur. Þegar um er að ræða docker geturðu fyrst skipt um það, síðan endurræst það, en það mun samt vera tímabil þar sem beiðnir til umsóknarinnar verða ekki afgreiddar, því venjulega tekur forritið nokkurn tíma að hlaðast upphaflega. Hvað ef það byrjar, en reynist vera óstarfhæft? Þetta er vandamálið, við skulum leysa það með lágmarks leiðum og eins glæsilega og mögulegt er.
FYRIRVARI: Megnið af greininni er sett fram á tilraunaformi - í formi upptöku af leikjatölvulotu. Vonandi verður þetta ekki of erfitt að skilja og kóðinn mun skrá sig nægilega vel. Fyrir andrúmsloftið, ímyndaðu þér að þetta séu ekki bara kóðabútar, heldur pappír úr „járni“ fjarstýringu.
Áhugaverðum aðferðum sem erfitt er að gúgla bara með því að lesa kóðann er lýst í upphafi hvers hluta. Ef eitthvað annað er óljóst skaltu googla það og athuga það. útskýrir skel (sem betur fer virkar það aftur, vegna opnunar á símskeyti). Ef þú getur ekki gúglað neitt skaltu spyrja í athugasemdunum. Ég mun vera fús til að bæta við samsvarandi hluta „Áhugaverðar aðferðir“.
Byrjum.
$ mkdir blue-green-deployment && cd $_
Service
Gerum tilraunaþjónustu og setjum hana í ílát.
Áhugaverð tækni
cat << EOF > file-name (Hér skjal + I/O Tilvísun) er leið til að búa til fjöllínuskrá með einni skipun. Allt bash les úr /dev/stdin á eftir þessari línu og á undan línunni EOF verður skráð í file-name.
wget -qO- URL (útskýrir skel) — úttak skjal sem er móttekið með HTTP til /dev/stdout (hliðstæða curl URL).
Prenta út
Ég brýt sérstaklega brotið til að virkja auðkenningu fyrir Python. Í lokin verður annað eins verk. Íhuga að á þessum stöðum var pappírinn klipptur til að senda til yfirlitsdeildarinnar (þar sem kóðinn var handlitaður með yfirlitum) og síðan voru þessir bitar límdir aftur.
$ 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
Reverse proxy
Til þess að forritið okkar geti breyst án þess að það sé tekið eftir, er nauðsynlegt að það sé einhver önnur aðili fyrir framan hana sem mun fela skipti hennar. Það gæti verið vefþjónn nginx в öfug proxy háttur. Öfugt umboð er komið á milli viðskiptavinarins og forritsins. Það tekur við beiðnum frá viðskiptavinum og sendir þær áfram í umsóknina og sendir svör umsóknarinnar til viðskiptavina.
Hægt er að tengja forritið og andstæða umboðið inni í Docker með því að nota bryggjukerfi. Þannig þarf gámurinn með forritinu ekki einu sinni að senda gátt á hýsingarkerfinu; þetta gerir forritinu kleift að einangra forritið að hámarki frá utanaðkomandi ógnum.
Ef andstæða umboðið býr á öðrum hýsingaraðila, verður þú að yfirgefa bryggjunetið og tengja forritið við öfuga umboðið í gegnum hýsilnetið og framsenda tengið приложения breytu --publish, eins og við fyrstu ræsingu og eins og með öfugt umboð.
Við munum keyra andstæða umboðið á port 80, því þetta er einmitt einingin sem ætti að hlusta á ytra netið. Ef höfn 80 er upptekin á prófunarhýslinum þínum skaltu breyta færibreytunni --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
Á þessu stigi er myndin byggð beint á þjóninum, sem krefst þess að forritsheimildir séu til staðar, og hleður einnig þjóninum óþarfa vinnu. Næsta skref er að úthluta myndsamstæðunni á sérstaka vél (til dæmis á CI kerfi) og flytja hana síðan á netþjóninn.
Flytja myndir
Því miður er ekki skynsamlegt að flytja myndir frá localhost til localhost, svo þennan hluta er aðeins hægt að skoða ef þú ert með tvo gestgjafa með Docker við höndina. Að minnsta kosti lítur þetta einhvern veginn svona út:
$ 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
Team docker save vistar myndgögnin í .tar skjalasafni, sem þýðir að þau vega um 1.5 sinnum meira en þau myndu vega í þjöppuðu formi. Svo skulum við hrista það í nafni þess að spara tíma og umferð:
Nú skulum við safna öllu sem við gerðum handvirkt í eitt handrit. Byrjum á efstu aðgerðinni og skoðum síðan hina sem notuð eru í henni.
Áhugaverð tækni
${parameter?err_msg} - einn af bash galdra galdra (aka breytuskipti). Ef parameter ekki tilgreint, framleiðsla err_msg og farðu út með kóða 1.
docker --log-driver journald — Sjálfgefið er að skjalaskráningarstjórinn er textaskrá án nokkurs snúnings. Með þessari nálgun fylla annálarnir fljótt allan diskinn, þannig að fyrir framleiðsluumhverfi er nauðsynlegt að breyta reklum í snjallari.
Dreifingarhandrit
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
}
Eiginleikar notaðir:
ensure-reverse-proxy - Gakktu úr skugga um að andstæða umboðið virki (gagnlegt fyrir fyrstu dreifingu)
get-active-slot service_name — Ákveður hvaða rifa er virkt fyrir tiltekna þjónustu (BLUE eða GREEN)
get-service-status service_name deployment_slot — Ákveður hvort þjónustan sé tilbúin til að vinna úr beiðnum sem berast
set-active-slot service_name deployment_slot — Breytir nginx stillingunni í öfugri umboðsílátinu
Til þess:
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
}
Virka get-active-slot þarfnast smá útskýringar:
Af hverju skilar það tölu og gefur ekki út streng?
Engu að síður, í kallaðgerðinni athugum við niðurstöðu vinnu hennar og að athuga útgöngukóða með bash er miklu auðveldara en að athuga streng. Að auki er mjög einfalt að fá streng úr því: get-active-slot service && echo BLUE || echo GREEN.
Eru þrjú skilyrði virkilega nóg til að greina öll ríki að?
Jafnvel tveir munu duga, sá síðasti er hér bara til fullnaðar, svo að ekki sé skrifað else.
Aðeins fallið sem skilar nginx stillingum er óskilgreint: get-nginx-config service_name deployment_slot. Á hliðstæðan hátt við heilsufarsskoðun, hér geturðu stillt hvaða stillingar sem er fyrir hvaða þjónustu sem er. Af áhugaverðum hlutum - aðeins cat <<- EOF, sem gerir þér kleift að fjarlægja alla flipa í upphafi. Að vísu er verðið á góðu sniði blandað flipa og bilum, sem í dag er talið mjög slæmt form. En bash þvingar fram flipa og það væri líka gaman að hafa venjulegt snið í nginx stillingunni. Í stuttu máli, að blanda flipa við bil hér virðist í raun vera besta lausnin af því versta. Hins vegar muntu ekki sjá þetta í brotinu hér að neðan, þar sem Habr „gerir það vel“ með því að breyta öllum flipum í 4 bil og gera EOF ógilt. Og hér er það áberandi.
Til þess að standa ekki upp tvisvar, segi ég þér strax frá cat << 'EOF', sem verður uppvíst síðar. Ef þú skrifar einfaldlega cat << EOF, þá inni í heredoc er strengurinn millifærður (breytur eru stækkaðar ($foo), skipanakall ($(bar)) o.s.frv.), og ef þú setur endann á skjalinu í gæsalappir, þá er innskotið óvirkt og táknið $ birtist eins og hún er. Það sem þú þarft til að setja handrit inn í annað handrit.
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
}
Þetta er allt handritið. Og svo kjarni með þessu handriti til að hlaða niður í gegnum wget eða curl.
Að keyra breytubreytt forskriftir á ytri netþjóni
Það er kominn tími til að banka á miðþjóninn. Þetta skipti localhost alveg hentugur:
$ 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.
Við höfum skrifað dreifingarforskrift sem hleður niður fyrirframbyggðri mynd á markþjóninn og kemur óaðfinnanlega í stað þjónustuílátsins, en hvernig getum við keyrt það á ytri vél? Handritið hefur rök, þar sem það er alhliða og getur sett upp nokkrar þjónustur í einu undir einum öfugri umboði (þú getur notað nginx stillingar til að ákvarða hvaða vefslóð verður hvaða þjónusta). Handritið er ekki hægt að geyma á þjóninum, þar sem í þessu tilfelli munum við ekki geta uppfært það sjálfkrafa (í þeim tilgangi að laga villu og bæta við nýjum þjónustum) og almennt ástand = illt.
Lausn 1: Geymdu samt handritið á þjóninum, en afritaðu það í hvert skipti scp. Tengdu síðan í gegnum ssh og keyrðu handritið með nauðsynlegum rökum.
Gallar:
Tvær aðgerðir í stað einnar
Það getur verið að það sé ekki staður þar sem þú afritar, eða það er ekki aðgangur að því, eða handritið gæti verið keyrt á þeim tíma sem skipt er út.
Það er ráðlegt að þrífa upp eftir sig (eyða handritinu).
Nú þegar þrjár aðgerðir.
Lausn 2:
Haltu aðeins aðgerðaskilgreiningum í handritinu og keyrðu alls ekkert
Með sed bæta aðgerðarkalli í lokin
Sendu þetta allt beint til shh í gegnum pípu (|)
Kostir:
Sannarlega ríkisfangslaus
Engar boilerplate einingar
Finnst flott
Við skulum bara gera það án Ansible. Já, allt hefur þegar verið fundið upp. Já, reiðhjól. Sjáðu hversu einfalt, glæsilegt og minimalískt hjólið er:
$ 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'
Hins vegar getum við ekki verið viss um að ytri gestgjafinn hafi fullnægjandi bash, svo við munum bæta við smá ávísun í byrjun (þetta er í stað þess að shellbang):
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
Og nú er það raunverulegt:
$ 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!
Nú geturðu opnað http://localhost/ í vafranum skaltu keyra dreifinguna aftur og ganga úr skugga um að hún gangi óaðfinnanlega með því að uppfæra síðuna í samræmi við geisladiskinn meðan á útlitinu stendur.