Версия №1

docker/Dockerfile

@@ -0,0 +1,46 @@
+FROM alpine:latest AS builder
+
+ENV MKDOCS_VERSION=1.1.0 \
+    DOCS_DIRECTORY='/mkdocs' \
+    LIVE_RELOAD_SUPPORT='false' \
+    ADD_MODULES='false' \
+    FAST_MODE='false' \
+    PYTHONUNBUFFERED=1 \
+    GIT_REPO='false' \
+    GIT_BRANCH='master' \
+    AUTO_UPDATE='false' \
+    UPDATE_INTERVAL=15
+
+ADD docker/container-files/ /
+ADD mkdocs/requirements.txt  /mkdocs/requirements.txt
+RUN \
+    apk add --update \
+        ca-certificates \
+        bash \
+        git \
+        openssh \
+        python3 \
+        python3-dev \
+        py3-setuptools \
+        py-pip \
+        build-base \
+        libffi-dev cairo-dev cairo cairo-tools \
+        jpeg-dev zlib-dev freetype-dev lcms2-dev openjpeg-dev tiff-dev tk-dev tcl-dev
+RUN \
+    pip install --upgrade pip && \
+    pip install -r /mkdocs/requirements.txt && \
+    cd /bootstrap && pip install -e /bootstrap && \
+    rm -rf /tmp/* /var/tmp/* /var/cache/apk/* /var/cache/distfiles/* && \
+    chmod 600 /root/.ssh/config
+
+CMD ["/usr/bin/bootstrap", "start"]
+
+FROM builder as makestatic
+ADD docs /src/docs/
+ADD mkdocs.yml /src/ 
+RUN cd /src  && mkdocs build
+
+FROM nginx
+# RUN rm /etc/nginx/sites-enabled/default
+COPY docker/default.conf /etc/nginx/conf.d/default.conf
+COPY --from=makestatic /src/site /sites/app.lexema.ru/docs

docker/container-files/bootstrap/Pipfile

@@ -0,0 +1,12 @@
+[[source]]
+name = "pypi"
+url = "https://pypi.org/simple"
+verify_ssl = true
+
+[dev-packages]
+
+[packages]
+click = "*"
+
+[requires]
+python_version = "3.8"

docker/container-files/bootstrap/app/cli.py

@@ -0,0 +1,30 @@
+import click
+from app.mkdocs import common
+
+"""CLI commands interface
+
+    These are the primitive operation wrappers that the CLI
+    will expose and be available to invoke.
+    In order to do so, the comprehensive Click library is used to
+    create commands, subcommands, parameters, flags...
+
+    .. _Click CLI library docs:
+        https://click.palletsprojects.com/en/7.x/#documentation
+"""
+
+
+@click.group(chain=True)
+def cli() -> None:
+    """
+    Bootstrap CLI
+    """
+
+
+@cli.command('start', help='Start Application')
+def start():
+    common.start()
+
+
+@cli.command('update', help='Update documentation code from repository')
+def update():
+    common.update_repo()

docker/container-files/bootstrap/app/mkdocs/common.py

@@ -0,0 +1,138 @@
+import os
+from termcolor import colored
+import git
+from datetime import datetime
+from crontab import CronTab
+
+docks_dir = os.environ['DOCS_DIRECTORY']
+modules = os.environ['ADD_MODULES']
+repo = os.environ['GIT_REPO']
+git_branch = os.environ['GIT_BRANCH']
+auto_update = os.environ['AUTO_UPDATE']
+interval = int(os.environ['UPDATE_INTERVAL'])
+
+
+def start():
+    """
+    Start mkdocs server
+    :return:
+    """
+    if modules != 'false':
+        _install_modules(modules)
+    if repo != 'false':
+        _clone_repo(repo)
+    _check_previous_installation()
+    print('Starting MKDocs')
+    os.chdir(docks_dir)
+    if "DEV_ADDR" in os.environ:
+        _dev_addr = os.environ['DEV_ADDR']
+    else:
+        _dev_addr = '0.0.0.0:8000'
+    os.system(f'mkdocs serve -a {_dev_addr} {_live_reload()} {_fast_mode()}')
+
+
+def _install_modules(modules):
+    """
+    Install Additional Modules
+    :param modules: str - List of modules to install
+    :return:
+    """
+    print(colored(f'Installing python modules: {modules}', 'green'))
+    os.system(f'pip install -q {modules}')
+    print(colored(f'Modules installed.', 'green'))
+
+
+def _check_previous_installation():
+    """
+    Check if previous installation present
+    Creates empty documentation if none detected
+    :return:
+    """
+    if not os.path.exists(docks_dir + '/mkdocs.yml'):
+        print(colored(
+            f'No documentation found in ({docks_dir}). Creating new one.', 'yellow'))
+        if not os.path.exists(docks_dir):
+            os.mkdir(docks_dir)
+        print(colored(f'Starting fresh installation', 'green'))
+        os.system(f'mkdocs new {docks_dir}/')
+    else:
+        print(
+            colored(f'Detected previous installation in ({docks_dir}).', 'green'))
+
+
+def _live_reload():
+    """
+    Live Reload
+    Auto Reload on file change
+    :return:
+    """
+    if os.environ['LIVE_RELOAD_SUPPORT'] == 'false':
+        print(colored(f'LIVE RELOAD - [ DISABLED ]', 'red'))
+        reload = '--no-livereload'
+    else:
+        print(colored(f'LIVE RELOAD - [ ENABLED ]', 'green'))
+        reload = ''
+    return reload
+
+
+def _fast_mode():
+    """
+    Fast Mode
+    Enables/Disables fast reload.
+    Enabled: build only files that got changed
+    Disabled: builds all files regardless of changes
+    :return:
+    """
+    if os.environ['FAST_MODE'] == 'false':
+        print(colored(f'FAST_MODE - [ DISABLED ]', 'red'))
+        fast = ''
+    else:
+        print(colored(f'FAST_MODE - [ ENABLED ]', 'green'))
+        fast = '--dirtyreload'
+    return fast
+
+
+def _set_auto_update(interval):
+    """
+    Creates cron job for auto updating repository
+    :param interval: (every x minutes)
+    :return:
+    """
+    os.system(f'crond')
+    cron = CronTab(user='root')
+    cron.remove_all()
+    job = cron.new(command='bootstrap update', comment='update')
+    job.minute.every(interval)
+    cron.write()
+
+
+def _clone_repo(repo):
+    """
+    Clone Documentation Code from git repository
+    :return:
+    """
+    if not os.path.exists(docks_dir + '/mkdocs.yml'):
+        print(colored(f'Getting documentation from: {repo}', 'green'))
+        git.Repo.clone_from(repo, docks_dir, branch=git_branch)
+
+    if auto_update == 'true':
+        print(colored(f'AUTO_UPDATE - [ ENABLED ]', 'green'))
+        print(
+            colored(f'UPDATE_INTERVAL set to every {interval} minute/s', 'green'))
+        _set_auto_update(interval)
+
+
+def update_repo():
+    """
+    Fetching latest changes
+    :return:
+    """
+    repo = git.Repo(docks_dir)
+    for remote in repo.remotes:
+        remote.fetch()
+        remote.pull()
+        headcommit = repo.head.commit
+        commit_date = datetime.fromtimestamp(headcommit.authored_date)
+        print(colored(
+            f'Pulled branch: {git_branch} \nCommit: {headcommit.hexsha} \nCommit Message: {headcommit.message}Date: {commit_date} \nAuthor: {headcommit.committer.name}',
+            'green'))

docker/container-files/bootstrap/main.py

@@ -0,0 +1,4 @@
+from app.cli import cli
+
+if __name__ == '__main__':
+    cli()

docker/container-files/bootstrap/setup.py

@@ -0,0 +1,15 @@
+from setuptools import setup
+
+setup(
+    name='bootstrap',
+    version='1.0.0',
+    py_modules=['bootstrap'],
+    include_package_data=True,
+    install_requires=[
+        'click', 'termcolor', 'GitPython', 'python-crontab'
+    ],
+    entry_points='''
+        [console_scripts]
+        bootstrap=app.cli:cli
+    ''',
+)

docker/container-files/root/.ssh/config

@@ -0,0 +1,2 @@
+Host *
+    StrictHostKeyChecking no

docker/default.conf

@@ -0,0 +1,23 @@
+
+server {
+    listen 80;
+
+    #    location / {
+    root /sites/app.lexema.ru/docs;
+    #    }
+    #expires $expires;
+
+    client_max_body_size 500M;
+
+    gzip on;
+    gzip_comp_level 4;
+    gzip_types text/html text/plain text/css application/javascript;
+
+    proxy_redirect off;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-NginX-Proxy true;
+
+}