ప్రోహోస్టర్ > బ్లాగ్ > పరిపాలన > ఒకే పేజీ అప్లికేషన్ పంపిణీ కోసం డాకర్ చిత్రం

ఒకే పేజీ అప్లికేషన్ పంపిణీ కోసం డాకర్ చిత్రం

సింగిల్-పేజీ అప్లికేషన్ (SPA) అనేది స్టాటిక్ జావాస్క్రిప్ట్ మరియు HTML ఫైల్‌లు, అలాగే చిత్రాలు మరియు ఇతర వనరుల సమితి. అవి డైనమిక్‌గా మారవు కాబట్టి, వాటిని ఆన్‌లైన్‌లో ప్రచురించడం చాలా సులభం. దీని కోసం పెద్ద సంఖ్యలో చౌకైన మరియు ఉచిత సేవలు ఉన్నాయి, సాధారణ GitHub పేజీలతో (మరియు కొన్నింటికి narod.ruతో కూడా) మరియు Amazon S3 వంటి CDNతో ముగుస్తుంది. అయితే, నాకు ఇంకేదో కావాలి.

నాకు SPAతో డాకర్ ఇమేజ్ అవసరం, తద్వారా ఇది కుబెర్నెట్స్ క్లస్టర్‌లో భాగంగా ఉత్పత్తిలో మరియు SPA అంటే ఏమిటో తెలియని బ్యాక్-ఎండ్ డెవలపర్ మెషీన్‌లో సులభంగా ప్రారంభించబడుతుంది.

నేను నా కోసం క్రింది చిత్ర అవసరాలను నిర్ణయించుకున్నాను:

  • వాడుకలో సౌలభ్యం (కానీ అసెంబ్లీ కాదు);
  • డిస్క్ మరియు RAM పరంగా కనీస పరిమాణం;
  • ఎన్విరాన్మెంట్ వేరియబుల్స్ ద్వారా కాన్ఫిగరేషన్, తద్వారా ఇమేజ్ వివిధ వాతావరణాలలో ఉపయోగించబడుతుంది;
  • ఫైళ్ల యొక్క అత్యంత సమర్థవంతమైన పంపిణీ.

ఈ రోజు నేను మీకు ఎలా చెప్తాను:

  • గట్ nginx;
  • మూలాల నుండి బ్రోట్లీని నిర్మించండి;
  • ఎన్విరాన్మెంట్ వేరియబుల్స్ అర్థం చేసుకోవడానికి స్టాటిక్ ఫైల్స్ నేర్పండి;
  • మరియు వాస్తవానికి వీటన్నింటి నుండి డాకర్ చిత్రాన్ని ఎలా సమీకరించాలి.

ఈ వ్యాసం యొక్క ఉద్దేశ్యం నా అనుభవాన్ని పంచుకోవడం మరియు అనుభవజ్ఞులైన సంఘ సభ్యులను నిర్మాణాత్మక విమర్శలకు ప్రేరేపించడం.

అసెంబ్లీ కోసం చిత్రాన్ని నిర్మించడం

చివరి డాకర్ చిత్రాన్ని పరిమాణంలో చిన్నదిగా చేయడానికి, మీరు రెండు నియమాలకు కట్టుబడి ఉండాలి: కనిష్ట లేయర్‌లు మరియు మినిమలిస్టిక్ బేస్ ఇమేజ్. అతిచిన్న బేస్ ఇమేజ్‌లలో ఆల్పైన్ లైనక్స్ ఇమేజ్ ఒకటి, కాబట్టి నేను దానిని ఎంచుకుంటాను. ఆల్పైన్ ఉత్పత్తికి తగినది కాదని కొందరు వాదించవచ్చు మరియు అవి సరైనవి కావచ్చు. కానీ వ్యక్తిగతంగా, అతనితో నాకు ఎప్పుడూ సమస్యలు లేవు మరియు అతనిపై ఎటువంటి వాదనలు లేవు.

తక్కువ లేయర్‌లను కలిగి ఉండటానికి, నేను చిత్రాన్ని 2 దశల్లో సమీకరించుతాను. మొదటిది డ్రాఫ్ట్; అన్ని సహాయక వినియోగాలు మరియు తాత్కాలిక ఫైల్‌లు అందులోనే ఉంటాయి. మరియు చివరి దశలో నేను అప్లికేషన్ యొక్క చివరి సంస్కరణను మాత్రమే వ్రాస్తాను.

సహాయక చిత్రంతో ప్రారంభిద్దాం.

SPA అప్లికేషన్‌ను కంపైల్ చేయడానికి, మీకు సాధారణంగా node.js అవసరం. నేను అధికారిక చిత్రాన్ని తీసుకుంటాను, ఇది npm మరియు నూలు ప్యాకేజీ నిర్వాహకులతో కూడా వస్తుంది. నా స్వంత తరపున, నేను కొన్ని npm ప్యాకేజీలను రూపొందించడానికి అవసరమైన node-gypని మరియు Google నుండి Brotli కంప్రెసర్‌ని జోడిస్తాను, ఇది మాకు తర్వాత ఉపయోగకరంగా ఉంటుంది.

వ్యాఖ్యలతో డాకర్ ఫైల్.

# Базовый образ
FROM node:12-alpine
LABEL maintainer="Aleksey Maydokin <[email protected]>"
ENV BROTLI_VERSION 1.0.7
# Пакеты, которые нужны, чтобы собрать из исходников Brotli
RUN apk add --no-cache --virtual .build-deps 
        bash 
        gcc 
        libc-dev 
        make 
        linux-headers 
        cmake 
        curl 
    && mkdir -p /usr/src 
    # Исходники Brotli скачиваем из официального репозитория
    && curl -LSs https://github.com/google/brotli/archive/v$BROTLI_VERSION.tar.gz | tar xzf - -C /usr/src 
    && cd /usr/src/brotli-$BROTLI_VERSION 
    # Компилируем Brotli
    && ./configure-cmake --disable-debug && make -j$(getconf _NPROCESSORS_ONLN) && make install 
    # Добавляем node-gyp
    && yarn global add node-gyp 
    # Убираем за собой мусор
    && apk del .build-deps && yarn cache clean && rm -rf /usr/src

ఇప్పటికే ఇక్కడ నేను మినిమలిజం కోసం పోరాడుతున్నాను, కాబట్టి చిత్రాన్ని ఒక పెద్ద బృందం కలిసి ఉంచింది.

పూర్తయిన చిత్రాన్ని ఇక్కడ చూడవచ్చు: https://hub.docker.com/r/alexxxnf/spa-builder. ఇతరుల చిత్రాలపై ఆధారపడవద్దని మరియు మీ స్వంత చిత్రాలను సేకరించవద్దని నేను సిఫార్సు చేస్తున్నాను.

వికీపీడియా

స్టాటిక్ కంటెంట్‌ని పంపిణీ చేయడానికి మీరు ఏదైనా వెబ్ సర్వర్‌ని ఉపయోగించవచ్చు. నేను nginxతో పని చేయడం అలవాటు చేసుకున్నాను, కాబట్టి నేను ఇప్పుడు దాన్ని ఉపయోగిస్తాను.

Nginx అధికారిక డాకర్ ఇమేజ్‌ని కలిగి ఉంది, కానీ ఇది సాధారణ స్టాటిక్ డిస్ట్రిబ్యూషన్ కోసం చాలా మాడ్యూల్‌లను కలిగి ఉంది. డెలివరీలో చేర్చబడిన వాటిని ప్రత్యేక బృందం లేదా అధికారిక డాకర్‌ఫైల్‌లో చూడవచ్చు.

$ డాకర్ రన్ --rm nginx:1-ఆల్పైన్ nginx -V

nginx version: nginx/1.17.9
built by gcc 8.3.0 (Alpine 8.3.0) 
built with OpenSSL 1.1.1d  10 Sep 2019
TLS SNI support enabled
configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --http-client-body-temp-path=/var/cache/nginx/client_temp --http-proxy-temp-path=/var/cache/nginx/proxy_temp --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp --http-scgi-temp-path=/var/cache/nginx/scgi_temp --with-perl_modules_path=/usr/lib/perl5/vendor_perl --user=nginx --group=nginx --with-compat --with-file-aio --with-threads --with-http_addition_module --with-http_auth_request_module --with-http_dav_module --with-http_flv_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_mp4_module --with-http_random_index_module --with-http_realip_module --with-http_secure_link_module --with-http_slice_module --with-http_ssl_module --with-http_stub_status_module --with-http_sub_module --with-http_v2_module --with-mail --with-mail_ssl_module --with-stream --with-stream_realip_module --with-stream_ssl_module --with-stream_ssl_preread_module --with-cc-opt='-Os -fomit-frame-pointer' --with-ld-opt=-Wl,--as-needed

నేను డాకర్‌ఫైల్‌ను ప్రాతిపదికగా ఉపయోగిస్తాను, కానీ స్టాటిక్ కంటెంట్‌ని పంపిణీ చేయడానికి అవసరమైన వాటిని మాత్రమే అందులో ఉంచుతాను. నా సంస్కరణ HTTPS ద్వారా పని చేయదు, అధికారానికి మద్దతు ఇవ్వదు మరియు మరెన్నో. కానీ నా వెర్షన్ Brotli అల్గారిథమ్‌తో కంప్రెస్ చేయబడిన ఫైల్‌లను పంపిణీ చేయగలదు, ఇది gzip కంటే కొంచెం ఎక్కువ ప్రభావవంతంగా ఉంటుంది. మేము ఫైల్‌లను ఒకసారి కంప్రెస్ చేస్తాము; ఫ్లైలో దీన్ని చేయవలసిన అవసరం లేదు.

ఇది నేను ముగించిన డాకర్‌ఫైల్. రష్యన్ భాషలో వ్యాఖ్యలు నావి, ఆంగ్లంలో - అసలు నుండి.

Dockerfile

# Базовый образ снова Alpine
FROM alpine:3.9
LABEL maintainer="Aleksey Maydokin <[email protected]>"
ENV NGINX_VERSION 1.16.0
ENV NGX_BROTLI_VERSION 0.1.2
ENV BROTLI_VERSION 1.0.7
RUN set -x 
    && addgroup -S nginx 
    && adduser -D -S -h /var/cache/nginx -s /sbin/nologin -G nginx nginx 
# Устанавливаем пакеты, которые нужны чтобы собрать nginx и модуль ngx_brotli к нему
    && apk add --no-cache --virtual .build-deps 
            gcc 
            libc-dev 
            make 
            linux-headers 
            curl 
    && mkdir -p /usr/src 
# Скачиваем исходники
    && curl -LSs https://nginx.org/download/nginx-$NGINX_VERSION.tar.gz | tar xzf - -C /usr/src 
    && curl -LSs https://github.com/eustas/ngx_brotli/archive/v$NGX_BROTLI_VERSION.tar.gz | tar xzf - -C /usr/src 
    && curl -LSs https://github.com/google/brotli/archive/v$BROTLI_VERSION.tar.gz | tar xzf - -C /usr/src 
    && rm -rf /usr/src/ngx_brotli-$NGX_BROTLI_VERSION/deps/brotli/ 
    && ln -s /usr/src/brotli-$BROTLI_VERSION /usr/src/ngx_brotli-$NGX_BROTLI_VERSION/deps/brotli 
    && cd /usr/src/nginx-$NGINX_VERSION 
    && CNF="
            --prefix=/etc/nginx 
            --sbin-path=/usr/sbin/nginx 
            --modules-path=/usr/lib/nginx/modules 
            --conf-path=/etc/nginx/nginx.conf 
            --error-log-path=/var/log/nginx/error.log 
            --http-log-path=/var/log/nginx/access.log 
            --pid-path=/var/run/nginx.pid 
            --lock-path=/var/run/nginx.lock 
            --http-client-body-temp-path=/var/cache/nginx/client_temp 
            --http-proxy-temp-path=/var/cache/nginx/proxy_temp 
            --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp 
            --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp 
            --http-scgi-temp-path=/var/cache/nginx/scgi_temp 
            --user=nginx 
            --group=nginx 
            --without-http_ssi_module 
            --without-http_userid_module 
            --without-http_access_module 
            --without-http_auth_basic_module 
            --without-http_mirror_module 
            --without-http_autoindex_module 
            --without-http_geo_module 
            --without-http_split_clients_module 
            --without-http_referer_module 
            --without-http_rewrite_module 
            --without-http_proxy_module 
            --without-http_fastcgi_module 
            --without-http_uwsgi_module 
            --without-http_scgi_module 
            --without-http_grpc_module 
            --without-http_memcached_module 
            --without-http_limit_conn_module 
            --without-http_limit_req_module 
            --without-http_empty_gif_module 
            --without-http_browser_module 
            --without-http_upstream_hash_module 
            --without-http_upstream_ip_hash_module 
            --without-http_upstream_least_conn_module 
            --without-http_upstream_keepalive_module 
            --without-http_upstream_zone_module 
            --without-http_gzip_module 
            --with-http_gzip_static_module 
            --with-threads 
            --with-compat 
            --with-file-aio 
            --add-dynamic-module=/usr/src/ngx_brotli-$NGX_BROTLI_VERSION 
    " 
# Собираем
    && ./configure $CNF 
    && make -j$(getconf _NPROCESSORS_ONLN) 
    && make install 
    && rm -rf /usr/src/ 
# Удаляем динамический brotli модуль, оставляя только статический
    && rm /usr/lib/nginx/modules/ngx_http_brotli_filter_module.so 
    && sed -i '$ d' /etc/apk/repositories 
# Bring in gettext so we can get `envsubst`, then throw
# the rest away. To do this, we need to install `gettext`
# then move `envsubst` out of the way so `gettext` can
# be deleted completely, then move `envsubst` back.
    && apk add --no-cache --virtual .gettext gettext 
    && mv /usr/bin/envsubst /tmp/ 
    && runDeps="$( 
        scanelf --needed --nobanner /usr/sbin/nginx /usr/lib/nginx/modules/*.so /tmp/envsubst 
            | awk '{ gsub(/,/, "nso:", $2); print "so:" $2 }' 
            | sort -u 
            | xargs -r apk info --installed 
            | sort -u 
    )" 
    && apk add --no-cache $runDeps 
    && apk del .build-deps 
    && apk del .gettext 
    && mv /tmp/envsubst /usr/local/bin/ 
# Bring in tzdata so users could set the timezones through the environment
# variables
    && apk add --no-cache tzdata 
# forward request and error logs to docker log collector
    && ln -sf /dev/stdout /var/log/nginx/access.log 
    && ln -sf /dev/stderr /var/log/nginx/error.log
COPY nginx.conf /etc/nginx/nginx.conf
EXPOSE 80
STOPSIGNAL SIGTERM
CMD ["nginx", "-g", "daemon off;"]

నేను వెంటనే nginx.confని పరిష్కరిస్తాను, తద్వారా gzip మరియు brotli డిఫాల్ట్‌గా ప్రారంభించబడతాయి. నేను కాషింగ్ హెడర్‌లను కూడా చేర్చుతాను, ఎందుకంటే మనం ఎప్పటికీ స్టాటిక్‌ని మార్చలేము. మరియు తుది స్పర్శ మొత్తం 404 అభ్యర్థనలను index.htmlకి మళ్లించడం, SPAలో నావిగేషన్ కోసం ఇది అవసరం.

nginx.conf

user nginx;
worker_processes  1;
error_log /var/log/nginx/error.log warn;
pid       /var/run/nginx.pid;
load_module /usr/lib/nginx/modules/ngx_http_brotli_static_module.so;
events {
    worker_connections 1024;
}
http {
    include      mime.types;
    default_type application/octet-stream;
    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_x_forwarded_for"';
    access_log /var/log/nginx/access.log main;
    sendfile on;
    keepalive_timeout 65;
    gzip_static   on;
    brotli_static on;
    server {
        listen      80;
        server_name localhost;
        charset utf-8;
        location / {
            root html;
            try_files $uri /index.html;
            etag on;
            expires max;
            add_header Cache-Control public;
            location = /index.html {
                expires 0;
                add_header Cache-Control "no-cache, public, must-revalidate, proxy-revalidate";
            }
        }
    }
}

మీరు పూర్తి చేసిన చిత్రాన్ని ఇక్కడ డౌన్‌లోడ్ చేసుకోవచ్చు: https://hub.docker.com/r/alexxxnf/nginx-spa. ఇది 10,5 MB పడుతుంది. అసలు nginx 19,7 MBని తీసుకుంది. నా క్రీడా ఆసక్తి సంతృప్తికరంగా ఉంది.

ఎన్విరాన్మెంట్ వేరియబుల్స్ అర్థం చేసుకోవడానికి స్టాటిక్స్ బోధించడం

SPAలో సెట్టింగ్‌లు ఎందుకు అవసరం కావచ్చు? ఉదాహరణకు, ఏ RESTful APIని ఉపయోగించాలో పేర్కొనడానికి. సాధారణంగా, కావలసిన వాతావరణం కోసం సెట్టింగ్‌లు నిర్మాణ దశలో SPAకి బదిలీ చేయబడతాయి. మీరు ఏదైనా మార్చవలసి వస్తే, మీరు అప్లికేషన్‌ను పునర్నిర్మించవలసి ఉంటుంది. నాకు అది వద్దు. అప్లికేషన్‌ను CI దశలో ఒకసారి నిర్మించాలని మరియు ఎన్విరాన్‌మెంట్ వేరియబుల్స్‌ని ఉపయోగించి CD దశలో అవసరమైనంత కాన్ఫిగర్ చేయాలని నేను కోరుకుంటున్నాను.

వాస్తవానికి, స్టాటిక్ ఫైల్‌లు ఏ ఎన్విరాన్‌మెంట్ వేరియబుల్స్‌ను అర్థం చేసుకోలేవు. అందువల్ల, మీరు ఒక ఉపాయాన్ని ఉపయోగించాలి. చివరి చిత్రంలో, నేను nginxని ప్రారంభించను, కానీ ఎన్విరాన్మెంట్ వేరియబుల్స్‌ను చదివే ప్రత్యేక షెల్ స్క్రిప్ట్, వాటిని స్టాటిక్ ఫైల్‌లకు వ్రాసి, వాటిని కుదించండి మరియు ఆపై మాత్రమే నియంత్రణను nginxకి బదిలీ చేస్తుంది.

ఈ ప్రయోజనం కోసం, Dockerfile ENTRYPOINT పరామితిని అందిస్తుంది. అతనికి ఈ క్రింది స్క్రిప్ట్‌ని ఇద్దాం (కోణీయాన్ని ఉదాహరణగా ఉపయోగించి):

docker-entrypoint.sh

#!/bin/sh
set -e
FLAG_FILE="/configured"
TARGET_DIR="/etc/nginx/html"
replace_vars () {
  ENV_VARS='$(awk 'BEGIN{for(v in ENVIRON) print "



quot;v}')'

# В Angular ищем плейсхолдеры в main-файлах

for f in "$TARGET_DIR"/main*.js; do

# envsubst заменяет в файлах плейсхолдеры на значения из переменных окружения

echo "$(envsubst "$ENV_VARS" < "$f")" > "$f"

done

}

compress () {

for i in $(find "$TARGET_DIR" | grep -E ".css$|.html$|.js$|.svg$|.txt$|.ttf




quot;); do

# Используем максимальную степень сжатия

gzip -9kf "$i" && brotli -fZ "$i"

done

}

if [ "$1" = 'nginx' ]; then

# Флаг нужен, чтобы выполнить скрипт только при самом первом запуске

if [ ! -e "$FLAG_FILE" ]; then

echo "Running init script"

echo "Replacing env vars"

replace_vars

echo "Compressing files"

compress

touch $FLAG_FILE

echo "Done"

fi

fi

exec "$@"

స్క్రిప్ట్ దాని పనిని చేయడానికి, సెట్టింగ్‌లు తప్పనిసరిగా js ఫైల్‌లలో ఈ రూపంలో వ్రాయబడాలి: ${API_URL}.


చాలా ఆధునిక SPAలు నిర్మించేటప్పుడు వారి ఫైల్‌లకు హాష్‌లను జోడించడం గమనించదగ్గ విషయం. బ్రౌజర్ చాలా కాలం పాటు ఫైల్‌ను సురక్షితంగా కాష్ చేయగలదు కాబట్టి ఇది అవసరం. ఫైల్ మారితే, దాని హాష్ మారుతుంది, ఇది ఫైల్‌ను మళ్లీ డౌన్‌లోడ్ చేయమని బ్రౌజర్‌ని బలవంతం చేస్తుంది.


దురదృష్టవశాత్తూ, నా పద్ధతిలో, ఎన్విరాన్మెంట్ వేరియబుల్స్ ద్వారా కాన్ఫిగరేషన్‌ను మార్చడం ఫైల్ హాష్‌లో మార్పుకు దారితీయదు, అంటే బ్రౌజర్ కాష్ వేరే విధంగా చెల్లుబాటు కాకుండా ఉండాలి. విభిన్న కాన్ఫిగరేషన్‌లు వేర్వేరు వాతావరణాలలో అమలు చేయబడినందున నాకు ఈ సమస్య లేదు.


చివరి చిత్రాన్ని కలపడం


చివరగా.


Dockerfile


# Первый базовый образ для сборки
FROM alexxxnf/spa-builder as builder
# Чтобы эффктивнее использовать кэш Docker-а, сначала устанавливаем только зависимости
COPY ./package.json ./package-lock.json /app/
RUN cd /app && npm ci --no-audit
# Потом собираем само приложение
COPY . /app
RUN cd /app && npm run build -- --prod --configuration=docker

# Второй базовый образ для раздачи
FROM alexxxnf/nginx-spa
# Забираем из первого образа сначала компрессор
COPY --from=builder /usr/local/bin/brotli /usr/local/bin
# Потом добавляем чудо-скрипт
COPY ./docker/docker-entrypoint.sh /docker-entrypoint.sh
# И в конце забираем само приложение
COPY --from=builder /app/dist/app /etc/nginx/html/
ENTRYPOINT ["/docker-entrypoint.sh"]
CMD ["nginx", "-g", "daemon off;"]


ఇప్పుడు ఫలిత చిత్రాన్ని సమీకరించవచ్చు మరియు ఎక్కడైనా ఉపయోగించవచ్చు.


మూలం: www.habr.com