התאמה אישית של תוכנית העברה לשרתי Apache

כדאי לבדוק את קובץ תוכנית המיגרציה שנוצר בעקבות יצירת מיגרציה. לפני שמבצעים את ההעברה, אפשר להתאים אישית את הקובץ. הפרטים של תוכנית ההעברה משמשים לחילוץ של ארטיפקטים של קונטיינר של עומס העבודה מהמקור.

במאמר הזה מתואר התוכן של ההעברה וסוגי ההתאמות האישיות שכדאי לשקול לפני שמבצעים את ההעברה ויוצרים את הארטיפקטים של הפריסה.

לפני שמתחילים

ההנחה במאמר הזה היא שכבר יצרתם העברה ויש לכם את קובץ תוכנית ההעברה.

עריכת תוכנית ההעברה

אחרי שמעתיקים את מערכת הקבצים ומנתחים אותה, אפשר למצוא את תוכנית ההעברה בספרייה החדשה שנוצרת בנתיב הפלט שצוין: ANALYSIS_OUTPUT_PATH/config.yaml.

עורכים את תוכנית ההעברה לפי הצורך ושומרים את השינויים.

המבנה של תוכנית ההעברה

תוכנית המיגרציה לעומסי עבודה של Apache2 בנויה באופן הבא, ואפשר להתאים אותה אישית כמו שמתואר בקטעים הבאים.

apacheServer:
  # Apache configuration for directories on the system
  # Content is the configuration as understood by apache
  directories:
  - Content: |-
      Options FollowSymLinks
      AllowOverride None
      Require all denied
    Path: /
  - Content: |-
      AllowOverride None
      Require all granted
    Path: /usr/share
  - Content: |-
      Options Indexes FollowSymLinks
      AllowOverride None
      Require all granted
    Path: /var/www/
  - Content: "#\tOptions Indexes FollowSymLinks\n#\tAllowOverride None\n#\tRequire
      all granted"
    Path: /srv/
  - Content: |-
      #   AllowOverride None
      #   Require all denied
    Path: /
  # Environment variables used by apache
  envVars:
  - Value: www-data
    Var: APACHE_RUN_USER
  - Value: www-data
    Var: APACHE_RUN_GROUP
  - Value: /var/run/apache2$SUFFIX/apache2.pid
    Var: APACHE_PID_FILE
  - Value: /var/run/apache2$SUFFIX
    Var: APACHE_RUN_DIR
  - Value: /var/lock/apache2$SUFFIX
    Var: APACHE_LOCK_DIR
  - Value: /var/log/apache2$SUFFIX
    Var: APACHE_LOG_DIR
  - Value: C
    Var: LANG
  # The port the service will listen on
  listen:
  - "80"
  - "443"
  # Apache modules to be loaded and installed
  loadModules:
  - Module: access_compat_module
  - Module: alias_module
  - Module: auth_basic_module
  - Module: authn_core_module
  - Module: authn_file_module
  - Module: authz_core_module
  - Module: authz_host_module
  - Module: authz_user_module
  - Module: autoindex_module
  - Module: deflate_module
  - Module: dir_module
  - Module: env_module
  - Module: filter_module
  - Module: mime_module
  - Module: mpm_prefork_module
  - Module: negotiation_module
  - Module: php7_module
  - Module: proxy_module
  - Module: proxy_fcgi_module
  - Module: reqtimeout_module
  - Module: rewrite_module
  - Module: setenvif_module
  - Module: socache_shmcb_module
  - Module: ssl_module
  - Module: status_module
  # The sites to be extracted
  virtualHosts:
  - address: '*:80'
    documentRoot: /var/www/html
    # should the site be enabled in extracted VM
    includeInContainerImage: true
    originalConfig: |-
      # The ServerName directive sets the request scheme, hostname and port that
      # the server uses to identify itself. This is used when creating
      # redirection URLs. In the context of virtual hosts, the ServerName
      # specifies what hostname must appear in the request's Host: header to
      # match this virtual host. For the default virtual host (this file) this
      # value is not decisive as it is used as a last resort host regardless.
      # However, you must set it for any further virtual host explicitly.
      #ServerName www.example.com

      ServerAdmin webmaster@localhost
      DocumentRoot /var/www/html

      # Available loglevels: trace8, ..., trace1, debug, info, notice, warn,
      # error, crit, alert, emerg.
      # It is also possible to configure the loglevel for particular
      # modules, e.g.
      #LogLevel info ssl:warn

      ErrorLog ${APACHE_LOG_DIR}/error.log
      CustomLog ${APACHE_LOG_DIR}/access.log combined

      # For most configuration files from conf-available/, which are
      # enabled or disabled at a global level, it is possible to
      # include a line for only one particular virtual host. For example the
      # following line enables the CGI configuration for this host only
      # after it has been globally disabled with "a2disconf".
      #Include conf-available/serve-cgi-bin.conf
    serverName: server-0
  - address: '*:443'
    # The location of the site content (will be copied to the same location the extracted container)
    documentRoot: /var/www/html
    includeInContainerImage: false
    originalConfig: |-
      ServerAdmin [e-mail]
      DocumentRoot /var/www/html
      SSLEngine on
      SSLCertificateFile /etc/ssl/certs/c2d-temporary-self-signed-cert.pem
      SSLCertificateKeyFile /etc/ssl/private/c2d-temporary-self-signed-cert.key

      <Directory /var/www/html>
      Options -Indexes
      AllowOverride FileInfo
      </Directory>
    serverName: server-1
php:
  # list of php modules to be installed in the extracted container (add/remove entries to change what will be installed)
  modules:
  - calendar
  - ctype
  - curl
  - exif
  - ffi
  - fileinfo
  - filter
  - gd
  - gettext
  - iconv
  - json
  - mysqli
  - pcntl
  - pdo
  - pdo_mysql
  - posix
  - shmop
  - sockets
  - sysvmsg
  - sysvsem
  - sysvshm
  - tokenizer
  - xsl

הגדרת מדיניות אבטחה בספריות

בקטע directories, אפשר להחיל הגדרות ספציפיות כדי לאכוף מדיניות אבטחה בספריות מסוימות. כדי למלא ולערוך את הקטע הזה בתוכנית, משתמשים בתחביר של ההנחיה Directory.

טעינה והתקנה של מודולים

בקטע loadModules, אפשר לציין את המודולים שרוצים לטעון ולהתקין. הכלי Migrate to Containers מזהה באופן אוטומטי את המודולים הנדרשים על ידי סריקת ההגדרה המקורית של ההנחיה LoadModule.

מודולים נתמכים

access_compat_module
alias_module
auth_basic_module
authn_core_module
authn_file_module
authz_core_module
authz_host_module
authz_user_module
autoindex_module
deflate_module
dir_module
env_module
expires_module
filter_module
mime_module
mpm_prefork_module
negotiation_module
php7_module
proxy_fcgi_module
proxy_module
remoteip_module
reqtimeout_module
rewrite_module
setenvif_module
socache_shmcb_module
ssl_module
status_module

הערה: אם כוללים מודולים לא ידועים בתוכנית ההעברה, ההעברה תיכשל ותוצג הודעת שגיאה שמפרטת את המודולים הלא ידועים.

ציון והגדרה של מארחים וירטואליים

בקטע virtualHosts, הכלי 'העברה לקונטיינרים' מעתיק את כל ההנחיות שמופיעות בבלוק <VirtualHost> ו-</VirtualHost>.

בשדה address, כתובת ה-IP של האתר מוחלפת ב-*.

בקטע originalConfig, השדה DocumentRoot מציין את הנתיב שממנו Apache מציג את הקבצים המבוקשים. לכל נתיב שצוין ב-DocumentRoot, הכלי Migrate to Containers מבצע את הפעולות הבאות:

• הוא דוחס כל נתיב לקובץ tar נפרד.
• הוא מעתיק את קובץ ה-tar בפריטי המידע שנוצר בתהליך הפיתוח (Artifact) לצורך חילוץ.
• היא משנה את ההרשאות של המשתמש בקובץ אימג' של Docker באמצעות האפשרות ADD --chown ב-Dockerfile.

בדיקת תוספי ה-PHP

הכלי Migrate to Containers מזהה באופן אוטומטי את מודולי ה-PHP שמותקנים במכונה הווירטואלית וכולל אותם בקטע php של תוכנית המיגרציה. בודקים את הקטע הזה ומוסיפים או מסירים מודולים לפי הצורך.

המאמרים הבאים

• איך מבצעים את ההעברה