Halò, Habr! Bheir mi gu d’ aire eadar-theangachadh den phost: .
Tha Envoy na fhrithealaiche proxy sgaoilte àrd-choileanadh (sgrìobhte ann an C ++) air a dhealbhadh airson seirbheisean agus tagraidhean fa leth, tha e cuideachd na bhus conaltraidh agus “plèana dàta uile-choitcheann” air a dhealbhadh airson ailtireachd mòr “mogal seirbheis” microservice. Nuair a chaidh a chruthachadh, chaidh aire a thoirt do fhuasglaidhean do dhuilgheadasan a dh’ èirich ri linn leasachadh luchd-frithealaidh leithid NGINX, HAProxy, luchd-cothromachaidh luchdan bathar-cruaidh agus luchd-cothromachaidh luchdan sgòthan. Bidh Tosgaire ag obair còmhla ri gach tagradh agus a’ toirt geàrr-chunntas air an lìonra gus gnìomhachd coitcheann a thoirt seachad ge bith dè an àrd-ùrlar. Nuair a bhios a h-uile trafaic seirbheis ann am bun-structar a’ sruthadh tro mhogal Envoy, bidh e furasta raointean duilgheadas fhaicinn le faicsinneachd cunbhalach, gleusadh coileanadh iomlan, agus cuir ris prìomh ghnìomhachd ann an àite sònraichte.
Feartan
- Ailtireachd taobh a-muigh pròiseas: tha tosgaire na fhrithealaiche fèin-chumanta, àrd-choileanadh a bheir suas beagan RAM. Bidh e ag obair còmhla ri cànan no frèam tagraidh sam bith.
- http/2 agus taic grpc: tha taic http/2 agus grpc den chiad ìre aig tosgaire airson ceanglaichean a-steach is a-mach. Is e neach-ionaid follaiseach a tha seo bho http/1.1 gu http/2.
- Cothromachadh luchdan Adhartach: tha tosgaire a’ toirt taic do fheartan cothromachaidh luchdan adhartach a’ toirt a-steach ath-chuiridhean fèin-ghluasadach, briseadh slabhraidh, cuingealachadh reata cruinneil, sgàileadh iarrtasan, cothromachadh luchdan sòn ionadail, msaa.
- API Riaghladh Configuration: tha tosgaire a’ toirt seachad API làidir airson do rèiteachadh a riaghladh gu dinamach.
- Amharcachd: Amharc domhainn air trafaic L7, taic dhùthchasach airson lorg sgaoilte agus faicsinneachd mongodb, dynamodb agus mòran thagraidhean eile.
Ceum 1 - Eisimpleir NGINX Config
Bidh an sgriobt seo a’ cleachdadh faidhle a chaidh a dhealbhadh gu sònraichte nginx.conf, stèidhichte air an eisimpleir slàn bho . Faodaidh tu an rèiteachadh fhaicinn san deasaiche le bhith a’ fosgladh nginx.conf
config stòr nginx
user www www;
pid /var/run/nginx.pid;
worker_processes 2;
events {
worker_connections 2000;
}
http {
gzip on;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain;
log_format main '$remote_addr - $remote_user [$time_local] '
'"$request" $status $bytes_sent '
'"$http_referer" "$http_user_agent" '
'"$gzip_ratio"';
log_format download '$remote_addr - $remote_user [$time_local] '
'"$request" $status $bytes_sent '
'"$http_referer" "$http_user_agent" '
'"$http_range" "$sent_http_content_range"';
upstream targetCluster {
172.18.0.3:80;
172.18.0.4:80;
}
server {
listen 8080;
server_name one.example.com www.one.example.com;
access_log /var/log/nginx.access_log main;
error_log /var/log/nginx.error_log info;
location / {
proxy_pass http://targetCluster/;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
}Mar as trice tha trì prìomh eileamaidean ann an rèiteachadh NGINX:
- A’ rèiteachadh frithealaiche NGINX, structar log agus gnìomh Gzip. Tha seo air a mhìneachadh air feadh na cruinne anns a h-uile cùis.
- A’ rèiteachadh NGINX gus gabhail ri iarrtasan don òstair aon.eisimpleir.com aig port 8080.
- A 'suidheachadh an targaid location, mar a làimhsicheas tu trafaig airson diofar phàirtean den URL.
Cha bhith a h-uile rèiteachadh a’ buntainn ri Envoy Proxy, agus chan fheum thu cuid de shuidheachaidhean a rèiteachadh. Tha aig Envoy Proxy ceithir prìomh sheòrsaichean, a bheir taic don bhun-structar bunaiteach a tha NGINX a’ tabhann. Is e am prìomh rud:
- Luchd-èisteachd: Bidh iad a’ dearbhadh mar a ghabhas Envoy Proxy ri iarrtasan a tha a’ tighinn a-steach. Chan eil Envoy Proxy an-dràsta a’ toirt taic ach do luchd-èisteachd stèidhichte air TCP. Aon uair ‘s gu bheil ceangal air a stèidheachadh, thèid a chuir gu seata de shìoltachain airson a ghiullachd.
- Criathragan: Tha iad nam pàirt de dh'ailtireachd loidhne-phìoban as urrainn dàta a-steach agus a-mach a phròiseasadh. Tha an gnìomh seo a’ toirt a-steach sìoltachain leithid Gzip, a bhios a’ teannachadh an dàta mus cuir e chun neach-dèiligidh e.
- Routers: Bidh iad a’ cur trafaic air adhart chun cheann-uidhe a tha a dhìth, air a mhìneachadh mar bhuidheann.
- Cruinneachaidhean: Bidh iad a’ mìneachadh a’ phuing crìochnachaidh airson paramadairean trafaic is rèiteachaidh.
Cleachdaidh sinn na ceithir pàirtean sin gus rèiteachadh Envoy Proxy a chruthachadh gus a bhith co-ionnan ri rèiteachadh sònraichte NGINX. Is e amas Envoy a bhith ag obair le APIan agus rèiteachadh fiùghantach. Anns a ’chùis seo, cleachdaidh an rèiteachadh bunaiteach roghainnean statach, le còd cruaidh bho NGINX.
Ceum 2 - Configuration NGINX
A 'chiad phàirt nginx.conf a’ mìneachadh cuid de inntearnasan NGINX a dh’ fheumas a bhith air an rèiteachadh.
Ceanglaichean Luchd-obrach
Tha an rèiteachadh gu h-ìosal a’ dearbhadh an àireamh de phròiseasan agus cheanglaichean luchd-obrach. Tha seo a’ sealltainn mar a nì NGINX sgèile gus coinneachadh ri iarrtas.
worker_processes 2;
events {
worker_connections 2000;
}Bidh Envoy Proxy a’ riaghladh sruthan obrach agus ceanglaichean ann an diofar dhòighean.
Bidh an tosgaire a’ cruthachadh snàithlean obraiche airson gach snàithlean bathar-cruaidh air an t-siostam. Bidh gach snàithlean neach-obrach a’ cur an gnìomh lùb tachartais neo-bacadh air a bheil uallach
- Ag èisteachd ri gach neach-èisteachd
- A’ gabhail ri ceanglaichean ùra
- A 'cruthachadh seata de shìoltachain airson ceangal
- Pròiseas a h-uile gnìomh I / O rè beatha a’ cheangail.
Bidh a h-uile giollachd ceangail eile air a làimhseachadh gu tur ann an snàithlean an neach-obrach, a’ toirt a-steach giùlan air adhart sam bith.
Airson gach snàthainn neach-obrach ann an Envoy, tha amar ceangail ann. Mar sin chan eil amaran ceangail HTTP / 2 a’ stèidheachadh ach aon cheangal airson gach aoigh a-muigh aig an aon àm, ma tha ceithir snàithleanan luchd-obrach ann bidh ceithir ceanglaichean HTTP / 2 airson gach aoigh a-muigh ann an staid sheasmhach. Le bhith a 'cumail a h-uile càil ann an aon snàthainn neach-obrach, faodar cha mhòr a h-uile còd a sgrìobhadh gun bhacadh, mar gum biodh e na shnàthainn singilte. Ma tha barrachd snàithleanan luchd-obrach air an riarachadh na tha riatanach, faodaidh seo leantainn gu caitheamh cuimhne, a ’cruthachadh àireamh mhòr de cheanglaichean leisg, agus a’ lughdachadh an àireamh de thursan a thèid ceanglaichean air ais don amar.
Airson tuilleadh fiosrachaidh tadhal air .
Rèiteachadh HTTP
Tha am bloc rèiteachaidh NGINX a leanas a’ mìneachadh roghainnean HTTP leithid:
- Dè na seòrsaichean mime a tha a’ faighinn taic
- Clàr-ama bunaiteach
- Gzip rèiteachadh
Faodaidh tu na taobhan sin a ghnàthachadh le bhith a’ cleachdadh sìoltachain ann an Envoy Proxy, air am bi sinn a’ bruidhinn nas fhaide air adhart.
Ceum 3 - Server Configuration
Anns a 'bhloc rèiteachaidh HTTP, tha an rèiteachadh NGINX a' sònrachadh a bhith ag èisteachd air port 8080 agus a 'freagairt iarrtasan a tha a' tighinn a-steach airson raointean aon.eisimpleir.com и www.one.example.com.
server {
listen 8080;
server_name one.example.com www.one.example.com;Taobh a-staigh Envoy, tha e fo smachd Luchd-èisteachd.
Luchd-èisteachd teachdaire
Is e an rud as cudromaiche de bhith a’ tòiseachadh le Envoy Proxy an luchd-èisteachd agad a mhìneachadh. Feumaidh tu faidhle rèiteachaidh a chruthachadh a mhìnicheas mar a tha thu airson an eisimpleir Envoy a ruith.
Cruthaichidh a' chriomag gu h-ìosal neach-èisteachd ùr agus ceangailidh e ri port 8080 e. Tha an rèiteachadh ag innse do Envoy Proxy dè na puirt air am bu chòir dha ceangal airson iarrtasan a tha a' tighinn a-steach.
Bidh Envoy Proxy a’ cleachdadh comharradh YAML airson a rèiteachadh. Airson ro-ràdh don chomharra seo, thoir sùil an seo .
Copy to Editorstatic_resources:
listeners:
- name: listener_0
address:
socket_address: { address: 0.0.0.0, port_value: 8080 }Chan eil feum air mìneachadh server_name, oir làimhsichidh sìoltachain Envoy Proxy seo.
Ceum 4 - Suidheachadh Suidheachadh
Nuair a thig iarrtas a-steach do NGINX, bidh am bloc suidheachaidh a’ dearbhadh mar a làimhsicheas tu agus càite an tèid an trafaic a stiùireadh. Anns a’ chriomag a leanas, tha an trafaic gu lèir chun làraich air a ghluasad gu brabhsair shuas an abhainn (nota eadar-theangair: mar as trice is e frithealaiche tagraidh a th’ ann an shuas an abhainn) ainmichte targaidCluster. Bidh an cruinneachadh shuas an abhainn a’ mìneachadh nan nodan a bu chòir an t-iarrtas a phròiseasadh. Bruidhnidh sinn seo san ath cheum.
location / {
proxy_pass http://targetCluster/;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}Aig Envoy, bidh Filters a’ dèanamh seo.
Filters Envoy
Airson rèiteachadh statach, bidh sìoltachain a’ dearbhadh mar a làimhsicheas iad iarrtasan a tha a’ tighinn a-steach. Anns a 'chùis seo bidh sinn a' suidheachadh sìoltachain a tha co-ionnan ainmean_frithealaidh anns a' cheum roimhe. Nuair a thig iarrtasan a-steach a tha a rèir raointean agus slighean sònraichte, thèid trafaic a chuir chun bhuidheann. Tha seo co-ionann ri rèiteachadh bun-os-cionn NGINX.
Copy to Editor filter_chains:
- filters:
- name: envoy.http_connection_manager
config:
codec_type: auto
stat_prefix: ingress_http
route_config:
name: local_route
virtual_hosts:
- name: backend
domains:
- "one.example.com"
- "www.one.example.com"
routes:
- match:
prefix: "/"
route:
cluster: targetCluster
http_filters:
- name: envoy.routerainm teachdaire.http_connection_manaidsear na chriathrag togte ann an Envoy Proxy. Tha sìoltachain eile a’ toirt a-steach Redis, Mongo, TCP. Gheibh thu an liosta iomlan aig .
Airson tuilleadh fiosrachaidh mu phoileasaidhean cothromachaidh luchdan eile, tadhal air .
Ceum 5 - Proxy agus Upstream Configuration
Ann an NGINX, tha an rèiteachadh shuas an abhainn a’ mìneachadh seata de luchd-frithealaidh targaid a bhios a’ làimhseachadh trafaic. Anns a 'chùis seo, chaidh dà bhuidheann a shònrachadh.
upstream targetCluster {
172.18.0.3:80;
172.18.0.4:80;
}Ann an Envoy, tha seo air a riaghladh le cruinneachaidhean.
Cnuasaichean teachdaire
Tha an co-ionann shuas an abhainn air a mhìneachadh mar chlàran. Anns a 'chùis seo, chaidh na h-aoighean a bhios a' frithealadh an trafaig a chomharrachadh. Tha an dòigh anns am faighear luchd-aoigheachd, leithid amannan-ama, air a mhìneachadh mar rèiteachadh brabhsair. Leigidh seo le barrachd smachd granular air taobhan leithid latency agus cothromachadh luchdan.
Copy to Editor clusters:
- name: targetCluster
connect_timeout: 0.25s
type: STRICT_DNS
dns_lookup_family: V4_ONLY
lb_policy: ROUND_ROBIN
hosts: [
{ socket_address: { address: 172.18.0.3, port_value: 80 }},
{ socket_address: { address: 172.18.0.4, port_value: 80 }}
]Nuair a bhios tu a 'cleachdadh lorg seirbheis STRICT_DNS Fuasglaidh Tosgaire gu leantainneach agus gu neo-chunbhalach na targaidean DNS ainmichte. Bithear a’ beachdachadh air gach seòladh IP a thilleas bho thoradh DNS mar aoigh follaiseach anns a’ bhuidheann shuas an abhainn. Tha seo a’ ciallachadh ma thilleas iarrtas dà sheòladh IP, gabhaidh an Tosgaire ris gu bheil dà aoigh anns a’ bhuidheann, agus gum feum an dà chuid a bhith air an cothromachadh le luchd. Ma thèid aoigheachd a thoirt air falbh bhon toradh, gabhaidh an Tosgaire ris nach eil e ann tuilleadh agus tarraingidh e trafaic bho amaran ceangail sam bith a th’ ann.
Airson tuilleadh fiosrachaidh faic .
Ceum 6 - Log Cothrom agus Mearachdan
Is e an rèiteachadh mu dheireadh clàradh. An àite a bhith a’ putadh logaichean mearachd gu diosc, bidh Envoy Proxy a’ cleachdadh dòigh-obrach stèidhichte air sgòthan. Tha a h-uile clàr tagraidh air a thoirt a-mach gu stdout и stderr.
Nuair a nì luchd-cleachdaidh iarrtas, tha logaichean ruigsinneachd roghainneil agus ciorramach gu bunaiteach. Gus logaichean ruigsinneachd a chomasachadh airson iarrtasan HTTP, cuir an comas an rèiteachadh inntrigeadh_log airson manaidsear ceangail HTTP. Faodaidh an t-slighe a bhith an dàrna cuid inneal mar stdout, no faidhle air diosc, a rèir do fheumalachdan.
Bidh an rèiteachadh a leanas ag ath-stiùireadh a h-uile log ruigsinneachd gu stdout (nota an eadar-theangair - feumar stdout tosgaire taobh a-staigh docker a chleachdadh. Ma thèid a chleachdadh às aonais docker, cuir an t-slighe gu faidhle log àbhaisteach na àite /dev/stdout). Dèan lethbhreac den chriomag chun roinn rèiteachaidh airson a’ mhanaidsear ceangail:
Copy to Clipboardaccess_log:
- name: envoy.file_access_log
config:
path: "/dev/stdout"Bu chòir dha na toraidhean coimhead mar seo:
- name: envoy.http_connection_manager
config:
codec_type: auto
stat_prefix: ingress_http
access_log:
- name: envoy.file_access_log
config:
path: "/dev/stdout"
route_config:Gu gnàthach, tha sreang cruth aig Envoy a tha a’ toirt a-steach mion-fhiosrachadh mun iarrtas HTTP:
[%START_TIME%] "%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%" %RESPONSE_CODE% %RESPONSE_FLAGS% %BYTES_RECEIVED% %BYTES_SENT% %DURATION% %RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)% "%REQ(X-FORWARDED-FOR)%" "%REQ(USER-AGENT)%" "%REQ(X-REQUEST-ID)%" "%REQ(:AUTHORITY)%" "%UPSTREAM_HOST%"nIs e toradh an t-sreath cruth seo:
[2018-11-23T04:51:00.281Z] "GET / HTTP/1.1" 200 - 0 58 4 1 "-" "curl/7.47.0" "f21ebd42-6770-4aa5-88d4-e56118165a7d" "one.example.com" "172.18.0.4:80"Faodar an susbaint toraidh a ghnàthachadh le bhith a’ suidheachadh an raon cruth. Mar eisimpleir:
access_log:
- name: envoy.file_access_log
config:
path: "/dev/stdout"
format: "[%START_TIME%] "%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%" %RESPONSE_CODE% %RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)% "%REQ(X-REQUEST-ID)%" "%REQ(:AUTHORITY)%" "%UPSTREAM_HOST%"n"Faodar an loidhne log a chuir a-mach cuideachd ann an cruth JSON le bhith a’ suidheachadh an raoin json_cruth. Mar eisimpleir:
access_log:
- name: envoy.file_access_log
config:
path: "/dev/stdout"
json_format: {"protocol": "%PROTOCOL%", "duration": "%DURATION%", "request_method": "%REQ(:METHOD)%"}Airson tuilleadh fiosrachaidh air Modh Clàraidh Tosgaire, tadhal air
Chan e logadh an aon dòigh air sealladh fhaighinn air a bhith ag obair le Envoy Proxy. Tha comasan lorg agus meatrach adhartach air an togail a-steach dha. Gheibh thu barrachd a-mach aig no troimhe .
Ceum 7 - Launch
Tha thu a-nis air do rèiteachadh a ghluasad bho NGINX gu Envoy Proxy. Is e an ceum mu dheireadh eisimpleir Envoy Proxy a chuir air bhog gus deuchainn a dhèanamh air.
Ruith mar neach-cleachdaidh
Aig mullach loidhne rèiteachaidh NGINX neach-cleachdaidh www; a’ sònrachadh NGINX a ruith mar neach-cleachdaidh le sochair ìosal gus tèarainteachd a leasachadh.
Bidh Envoy Proxy a’ cleachdadh dòigh-obrach stèidhichte air sgòthan airson a bhith a’ riaghladh cò aig a bheil pròiseas. Nuair a ruitheas sinn Envoy Proxy tro shoitheach, is urrainn dhuinn cleachdaiche sochair ìosal a shònrachadh.
A' cur air bhog Envoy Proxy
Bidh an àithne gu h-ìosal a’ ruith Envoy Proxy tro shoitheach Docker air an òstair. Tha an àithne seo a 'toirt comas do Envoy èisteachd ri iarrtasan a tha a' tighinn a-steach air port 80. Ach, mar a tha air a shònrachadh ann an rèiteachadh an neach-èisteachd, bidh Envoy Proxy ag èisteachd airson trafaig a tha a 'tighinn a-steach air port 8080. Leigidh seo leis a' phròiseas ruith mar neach-cleachdaidh le sochair ìseal.
docker run --name proxy1 -p 80:8080 --user 1000:1000 -v /root/envoy.yaml:/etc/envoy/envoy.yaml envoyproxy/envoyDeuchainn
Leis an neach-ionaid a’ ruith, faodar deuchainnean a dhèanamh a-nis agus an giullachd. Bidh an àithne cURL a leanas a’ toirt a-mach iarrtas leis a’ bhann-cinn aoigheachd a tha air a mhìneachadh ann an rèiteachadh an neach-ionaid.
curl -H "Host: one.example.com" localhost -iMar thoradh air an iarrtas HTTP bidh mearachd 503. Tha seo air sgàth 's nach eil ceanglaichean suas an abhainn ag obair agus nach eil iad rim faighinn. Mar sin, chan eil cinn-uidhe aig Envoy Proxy airson an iarrtais. Tòisichidh an àithne a leanas sreath de sheirbheisean HTTP a tha a rèir an rèiteachadh a chaidh a mhìneachadh airson Tosgaire.
docker run -d katacoda/docker-http-server; docker run -d katacoda/docker-http-server;Leis na seirbheisean a tha rim faighinn, faodaidh Tosgaire trafaic neach-ionaid gu soirbheachail chun cheann-uidhe aige.
curl -H "Host: one.example.com" localhost -iBu chòir dhut freagairt fhaicinn a’ sealltainn dè an soitheach Docker a phròiseasadh an t-iarrtas. Anns na logaichean Envoy Proxy bu chòir dhut cuideachd toradh sreang ruigsinneachd fhaicinn.
Cinn-cinn freagairt HTTP a bharrachd
Chì thu bannan-cinn HTTP a bharrachd ann an cinn freagairt an fhìor iarrtas. Tha an ceann-cinn a’ taisbeanadh na h-ùine a chuir an aoigh shuas an abhainn seachad a’ làimhseachadh an iarrtais. Air a chur an cèill ann am milliseconds. Tha seo feumail ma tha an neach-dèiligidh airson ùine seirbheis a dhearbhadh an taca ri latency lìonra.
x-envoy-upstream-service-time: 0
server: envoyAn rèiteachadh deireannach
static_resources:
listeners:
- name: listener_0
address:
socket_address: { address: 0.0.0.0, port_value: 8080 }
filter_chains:
- filters:
- name: envoy.http_connection_manager
config:
codec_type: auto
stat_prefix: ingress_http
route_config:
name: local_route
virtual_hosts:
- name: backend
domains:
- "one.example.com"
- "www.one.example.com"
routes:
- match:
prefix: "/"
route:
cluster: targetCluster
http_filters:
- name: envoy.router
clusters:
- name: targetCluster
connect_timeout: 0.25s
type: STRICT_DNS
dns_lookup_family: V4_ONLY
lb_policy: ROUND_ROBIN
hosts: [
{ socket_address: { address: 172.18.0.3, port_value: 80 }},
{ socket_address: { address: 172.18.0.4, port_value: 80 }}
]
admin:
access_log_path: /tmp/admin_access.log
address:
socket_address: { address: 0.0.0.0, port_value: 9090 }Fiosrachadh a bharrachd bhon eadar-theangair
Gheibhear stiùireadh airson stàladh Envoy Proxy air an làrach-lìn
Gu gnàthach, chan eil rèiteachadh seirbheis systemd aig rpm.
Cuir ris config seirbheis systemd /etc/systemd/system/envoy.service:
[Unit]
Description=Envoy Proxy
Documentation=https://www.envoyproxy.io/
After=network-online.target
Requires=envoy-auth-server.service
Wants=nginx.service
[Service]
User=root
Restart=on-failure
ExecStart=/usr/bin/envoy --config-path /etc/envoy/config.yaml
[Install]
WantedBy=multi-user.targetFeumaidh tu eòlaire a chruthachadh /etc/envoy/ agus cuir an config.yaml config ann.
Tha còmhradh teileagram ann a’ cleachdadh neach-ionaid tosgaire:
Chan eil Envoy Proxy a’ toirt taic do bhith a’ frithealadh susbaint statach. Mar sin, cò as urrainn bhòtadh airson an fheart:
Chan fhaod ach luchd-cleachdaidh clàraichte pàirt a ghabhail san sgrùdadh. , mas e do thoil e.
An do bhrosnaich am post seo thu gus neach-ionaid tosgaire a stàladh agus fheuchainn?
-
tha
-
sam bith
Bhòt 75 neach-cleachdaidh. Sheall 18 neach-cleachdaidh.
Source: www.habr.com